> ## Documentation Index
> Fetch the complete documentation index at: https://www.getmaxim.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice Simulation Runs

> Test your Voice Agent's interaction capabilities with realistic voice simulations across thousands of scenarios.

## Test voice agents at scale with simulated conversations

Run tests with datasets containing multiple scenarios for your voice agent to evaluate performance across different situations.

<Steps>
  <Step title="Create a dataset for testing">
    Configure your agent dataset template with:

    * **Agent scenarios**: Define specific situations for testing (e.g., "Update address", "Order an iPhone")
    * **Expected steps**: List the actions and responses you expect

          <img src="https://mintcdn.com/maximai/9rS3OJQiawRxJVY0/images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/voice-agent-dataset.png?fit=max&auto=format&n=9rS3OJQiawRxJVY0&q=85&s=690a09a2b52909fa1ae7a2b06c786de2" alt="Voice Agent Dataset" width="2890" height="1326" data-path="images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/voice-agent-dataset.png" />
  </Step>

  <Step title="Set up the test run">
    * Navigate to your voice agent and click **Test**
    * **Simulated session** mode will be pre-selected (voice agents can't be tested in single-turn mode)
    * Select your agent dataset from the dropdown
    * Choose relevant evaluators — you can use [voice evaluators](/library/evaluators/pre-built-evaluators/voice-evaluators/abrupt-disconnection) to assess audio-specific metrics like sentiment, interruptions, and speech quality

    <Note>
      Only built-in evaluators are currently supported for voice simulation runs. Custom evaluators will be available soon.
    </Note>

    <img src="https://mintcdn.com/maximai/9rS3OJQiawRxJVY0/images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/trigger-voice-simulation-testrun.png?fit=max&auto=format&n=9rS3OJQiawRxJVY0&q=85&s=cdc730eab36bb52401ff4005395a8d1f" alt="Configure simulation test run" width="3024" height="1722" data-path="images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/trigger-voice-simulation-testrun.png" />
  </Step>

  <Step title="Trigger the test run">
    Click **Trigger test run** to start. The system will call your voice agent and simulate conversations for each scenario.
  </Step>

  <Step title="Review results">
    Each session runs end-to-end for thorough evaluation:

    * View detailed results for every scenario
    * Text-based evaluators assess turn-by-turn call transcription
    * Audio-based evaluators analyze the call recording

          <img src="https://mintcdn.com/maximai/9rS3OJQiawRxJVY0/images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/voice-simulation-testrun-report.png?fit=max&auto=format&n=9rS3OJQiawRxJVY0&q=85&s=e46297e0ec414338b5141e77f2240fc1" alt="Simulation test run result" width="3024" height="1722" data-path="images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/voice-simulation-testrun-report.png" />
  </Step>

  <Step title="Inspect individual entries">
    Click any entry to see detailed results for that specific scenario.

    By default, test runs evaluate these performance metrics from the recording audio file:

    * **Avg latency**: How long the agent took to respond
    * **Talk ratio**: Agent talk time compared to simulation agent talk time
    * **Avg pitch**: The average pitch of the agent's responses
    * **Words per minute**: The agent's speech rate

          <img src="https://mintcdn.com/maximai/9rS3OJQiawRxJVY0/images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/single-entry-result.png?fit=max&auto=format&n=9rS3OJQiawRxJVY0&q=85&s=efbcccff292d4ae0b4d6294465c39240" alt="Simulation test run entry" width="3024" height="1722" data-path="images/docs/evaluate/how-to/evaluate-workflows-via-api-endpoint/evaluate-simulated-voice-agent/single-entry-result.png" />
  </Step>
</Steps>