Skip to main content
A simulation is an AI caller talking to your agent for real: it rings your number (or connects directly to the agent), improvises within a scenario you set, and produces a normal call log — transcript, recording, grading — in Call History. It’s how you test a prompt before real callers hear it, and how you catch regressions after every change.

Run one from the agent builder

1

Click Simulation

In the agent builder’s top bar, click Simulation.
2

Set the scene

Generate a caller scenario with AI or write your own — who the caller is, what they want, how difficult they’re being. Then approve the charge and place the call. (Simulations are real calls and bill like them; the dialog shows the cost before you commit.)
3

Watch it happen

A floating activity pill appears as soon as the run is placed — your agent is on a call right now. Open the call to follow along; you can even listen in live.

Build a scenario library

The Simulations page (/dashboard/simulations) manages scenarios per agent. Pick an agent and click Generate scenarios with AI — it drafts scenarios from the agent’s own prompt, with an optional Include edge case scenarios pass for the hard stuff (angry callers, wrong numbers, half-answers). Edit and keep the ones you like. Scenarios group into suites with a minimum pass rate, which can gate releases in CI — see Test an agent end-to-end (API) for the suite runner and the programmatic version of everything on this page.

What to do with the result

Every simulation lands in Call History like any other call. Read the transcript to spot where the prompt needs tightening, check the grade, and fix-then-rerun. When a real call exposes a gap, promote it: the call detail page’s Create test case button turns a real conversation into a reusable scenario.

Next steps

Review the call

Transcript, recording, listen-in, whisper.

Test-calls API

Run simulations and batches programmatically.

Suites in CI

Release gates with pass rates and regression tracking.

Experiments (A/B)

Compare variants on live traffic once simulations pass.