Test Suites
A test suite is a collection of test cases grouped together for a specific agent. Suites let you run all your test scenarios at once and track results over time.
Accessing Test Suites
Navigate to Testing in the sidebar to see your list of test suites.
Test Suite List
The test suite list displays:
| Column | Description |
|---|---|
| Name | The name of the test suite |
| Agent | The agent this suite tests |
| Cases | Number of test cases in the suite |
| Last Run | Date of the most recent test run |
| Last Score | Pass rate from the most recent run (e.g., “8/10 passed”) |
Click any suite to view its details, manage its test cases, or run it.
Creating a Test Suite
- Go to Testing in the sidebar
- Click Create Test Suite
- Fill in the details:
- Name — A descriptive name (e.g., “Sales Qualifier - Core Scenarios”)
- Description — What this suite covers and when to run it
- Agent — Select the agent this suite will test
- Click Create
The suite is created empty. Next, add test cases to define the scenarios you want to validate.
Editing a Test Suite
To modify a suite’s name, description, or agent assignment:
- Open the test suite
- Click Edit in the top right
- Make your changes
- Click Save
Changing the agent on a test suite does not delete previous run results. You can compare how different agents perform on the same set of test cases.
Deleting a Test Suite
- Open the test suite
- Click Edit in the top right
- Click Delete Suite
- Confirm the deletion
Deleting a suite removes all its test cases and run history.
Running a Test Suite
To execute all test cases in a suite:
- Open the test suite
- Click Run Tests
- The suite begins executing each test case sequentially
See Test Runs for details on how runs work and how to interpret results.
Best Practices
Organize by Agent
Create one primary test suite per agent. Name it clearly so your team knows which agent it covers.
Cover the Critical Path
Start with test cases for the scenarios your agent encounters most often. A sales qualification agent should have cases for interested callers, uninterested callers, and callers with questions about pricing.
Add Edge Cases Over Time
After the core scenarios are covered, add cases for edge cases: callers who are rude, callers who ask off-topic questions, callers who speak very little, and callers who try to break the conversation flow.
Run After Every Prompt Change
Any time you modify an agent’s prompt, re-run the test suite to catch regressions. A change that improves one scenario may break another.
If your suite grows beyond 20 test cases, consider splitting it into focused sub-suites (e.g., “Sales Qualifier - Happy Path” and “Sales Qualifier - Edge Cases”) to keep run times manageable.