How a run works
Each conversation in a run goes like this:- A simulated customer, played by another AI model, opens the conversation from the description you wrote. It only knows that description and the conversation so far. It never sees your agent’s instructions or the success criterion.
- Your agent replies with its real setup on that channel: its instructions (including the channel’s own wording), its knowledge, its actions and its procedures.
- They keep talking until the customer is done or the conversation reaches its max turns.
- A judge, another AI model, reads the finished conversation and every action the agent called, with what it sent and what came back, and passes or fails it against your success criterion, with a reason.
- If the test lists expected actions, the actions the agent called are checked too.
Test conversations never reach your customers. They don’t appear in Conversations, the inbox or Analytics, and nothing is booked, saved or sent unless you set a read-only action to Live. Each agent reply counts toward your usage and spend cap like a reply in a real conversation; the simulated customer and the judge are not charged.
Create a test
On Tests, click New test (Create a test before the first one).
Save and run 3 times saves the test and starts three conversations. Save only saves it.
Expected actions
Tick an action under Actions to expect it.- None ticked (the default): actions aren’t checked. The agent can call any action, or none, and only the judge grades. The test shows Not asserted.
- Any ticked: the agent must call exactly those actions, no more and no fewer. One that was never called, or one that wasn’t ticked, fails the conversation even when the judge passed it.
Action responses
By default every action returns a success without running, so a test never books a meeting, saves a lead, opens a ticket or notifies anyone. Choose what an action returns next to it:
Every action is marked Read-only or Writes data. Live is locked for actions that write data.
A success or a mock response is only returned when the call has what the real action needs. If the agent saves a lead without a required field, or takes a message without a way to reach the customer, the action fails with the same error it gives in a real conversation.
Run a test
- From the Tests page: tick tests and click Run selected, or open a test’s ⋯ menu and click Run 3 times.
- From a test’s page: click Run again.
Read the results
Open a test to see its latest run:- Pass rate: the share of graded conversations that passed. Conversations with No verdict aren’t counted.
- Conversations finished: how many of the run’s conversations are done.
- The runs table: one row per conversation with its status, turns, the actions the agent called, and how long it took.
Click a row to read the conversation. The judge’s reason is at the top, with Never called and Not expected under it when the action check failed. Under each reply, open the actions line to see what each action was sent and what it returned, labelled Mocked response or Response.
Earlier runs lists the test’s last ten runs with their pass rates. Click one to open it. Export results downloads the run as a CSV: one row per conversation with its status, turns, actions called, never called and not expected, how long it took, when it started, the judge’s reason and any error.
The Configuration card under the results shows how the test is set up.
Manage tests
Search the list by name, or show only tests that are Completed, In progress or Never run. From a test’s ⋯ menu on the Tests page:- Edit test: the next run uses the new setup. Earlier runs keep their results.
- Duplicate test: opens the editor with a copy, to make a variation.
- Export results: the latest run as CSV.
- Delete test: removes the test and its run history. This can’t be undone.
Limits
Related
- Test your agent: Preview in chat or on a call, and the demo page
- Fix a wrong answer
- Actions