Creating Tests
What should be a test?
A good example of a test is something a user would like to do, or achieve. A user story or user journey should probably map 1:1 to a test case.
Test examples
- Log in with correct credentials
- Log in with incorrect credentials
- Create a new task
- Edit a task’s due date
Creating a test
Creating a new test in QA.tech is very simple. You can create a test in the platform by following a few simple steps.
- Click the “Add Test Case” button
At the top of the page you will find a button to create a new test.
- Choose a Suggested Test or Create your own.
Our agents are continuously scanning your site for things to test. Things it finds will pop up as suggestions here in the suggested tests list. You can either choose one or many of the suggestions or create your own using a freetext description.
Suggested tests - Select a suggested test from the list and click continue
If you want to discover more test suggestions, you can click “Analyze my site” to initiate a new site crawl. This process takes up to 15 minutes and will scan your site to detect additional testable features and interactions.
Create your own test - Fill in the details for your test
- Name: Give your test a descriptive name (e.g., “Create a new user with admin permissions”)
- Goal: Describe what the test should accomplish (e.g., “Create an admin user and sign in with the new user”)
- Expected Result (optional): Define what success looks like (e.g., “A new admin user appears on the users page”)
- Run after: Choose which test this should run after, if any
- Configurations: Add any required configuration values needed for the test
- Advanced: Additional settings including agent selection (defaults to Latest)
Make sure the test name is clear and concise, and that the goal provides enough detail for the agent to understand what needs to be tested.
- Review the generated test
Once the new test is generated and starts to create a test plan you are able to review the test.
To review the test, click the review button next to your new test.
This will take you to the edit test page.
At this stage the agent will attempt to achieve the objective on its own and generate steps for you. Once finished you will have a suggested test plan.
The sidebar to the left shows you the generated goal, expected result and suggested steps. In the Settings tab you have the possibillity to change dependencies, add configs the test needs or change advanced options for the agent.
To the right you have the trace of the attempted execution. Inspect that the agent correctly achieved what you want to test.
If you want to change anything in the plan you can update it and click “Save & Run” to see a new attempt with the updated test plan.
It is always possible to stop the agent by clicking the “Stop” button.
- Activate the test
Once you have a test plan to your liking click on the “Activate” button in the top right corner. This will enable the test and make it part of your test suite.
- Move the test to a Scenario group
Back on the “Test cases” page you can drag and drop the test to a Scenario group of your choosing. Grouping tests in Scenarios is a good way to keep your tests organized and helps get a good overview during execution.
How to format your test
Writing a good goal
The goal is the main objective of the test case. The agent will use this both to build the steps and to solve the task if things change in the steps. Focus on describing what the agent should do during the test, rather than what it should validate (use expected result for that).
Good goal examples
- Search for ‘Chair’, navigate to a product and add it to the cart
- Invite a new member of the role Admin to the project
- Open the customer support chat and write a message
Keep your goals:
- Action-oriented: Start with verbs like “Create”, “Search”, “Navigate”, “Add”
- Specific: Include the exact details needed (e.g., product name, user role)
- Focused: Describe the actions to take, not the validation criteria
Writing a good expected result
The expected result defines what should be verified at the end of the test. It should clearly describe what the agent should see or experience when the test is completed successfully.
Good expected result examples
- The page should contain a user avatar
- A success message should be displayed and the user should be redirected to the product list
- The user should have received an email with a link to reset their password
Keep your expected results:
- Observable: Focus on things that can be verified visually or through system responses
- Specific: Include exact elements, messages, or states to check for
- Outcome-focused: Describe the end state, not the steps to get there
How many steps should a test have?
Try to keep your test to 10 steps or less. If your test requires more steps, consider creating a new test with a chained dependency instead. Tests with too many steps have the downside of taking longer to execute, and being harder to maintain.