Run a Test

Execute your scenario against an agent and watch the results come in.

Start a run

A run executes all the tests in your scenario against a specific agent.

1. On the scenario detail page, click Run scenario in the top-right corner.
2. The Run Scenario dialog appears.
3. Select an agent - this is the chatbot you want to test. If you don’t have one connected yet, use a Demo agent to try things out.
4. Select a personality. The default Neutral personality uses straightforward, standard communication. You can create custom personalities later - see Personalities.
5. Click Run scenario.

Watch results

After clicking Run, you’re taken to the test results page. Voxli starts executing each test in your scenario one by one.

• Each test shows its current status: running, passed, or failed.
• Results appear as each test completes. You don’t need to wait for all tests to finish.
• The page header shows the scenario name, agent, personality, and timestamp.

Read the results page

Each row in the results table shows:

• Test name - the name you gave the test.
• Summary - how many assertions passed and failed, with a warning if any blockers failed.
• Score - the weighted percentage of passed assertions. A green bar means all assertions passed. A partially filled bar shows the score visually.

Click any test row to open the detailed result view with the full conversation and assertion outcomes. See Results for a deep dive.

What’s next

• Results - learn how to inspect conversations and read assertion outcomes.
• Advanced Run Options - select specific tests, use multiple personalities, or run tests multiple times to detect flaky behavior.
• Personalities - create custom communication styles for the AI tester.