> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Testing and debugging Voice AI

> How to test your Voice AI agents, diagnose issues, and iterate on your configuration.

Testing is essential before deploying a Voice AI agent to live callers. This guide covers how to test your agent, interpret test results, and debug common issues.

## Testing your agent

<Steps>
  <Step title="Use the built-in test call">
    In your Voice AI agent settings, click **Test Call** to initiate a test conversation. This lets you interact with your agent as a caller would, without using a live phone number.

    <Frame caption="The built-in test call interface for Voice AI agents">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/5ekJMua0ICwwZhKE/images/ai-agents-how-to-test-voice-ai-agents-0-image.png?fit=max&auto=format&n=5ekJMua0ICwwZhKE&q=85&s=6f1a0411df00cb948e20937ffbd8f864" alt="Test call interface in the Voice AI agent dashboard" width="1695" height="791" data-path="images/ai-agents-how-to-test-voice-ai-agents-0-image.png" />
    </Frame>

    <Frame caption="Click the Call Me button to start a test call with your Voice AI agent">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/pvNCpCCULfbeMUAk/images/voice-ai-test-call-me-button.png?fit=max&auto=format&n=pvNCpCCULfbeMUAk&q=85&s=a6fcd166c8400590049f95b0eb0020e6" alt="Call Me button in the Voice AI agent testing interface" width="1695" height="791" data-path="images/voice-ai-test-call-me-button.png" />
    </Frame>
  </Step>

  <Step title="Review the conversation transcript">
    After each test call, review the full transcript in the agent dashboard. Look for:

    * Correct understanding of caller intent
    * Appropriate responses and tone
    * Successful action execution (appointment booking, data collection)
    * Proper escalation behavior

    <Frame caption="Review the conversation transcript after a test call">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/5ekJMua0ICwwZhKE/images/ai-agents-how-to-test-voice-ai-agents-1-image.png?fit=max&auto=format&n=5ekJMua0ICwwZhKE&q=85&s=b5dbf5437095dc147f515ac30e6a2df0" alt="Test call transcript and review screen" width="583" height="692" data-path="images/ai-agents-how-to-test-voice-ai-agents-1-image.png" />
    </Frame>

    <Frame caption="Call history log showing all test and live calls with status and duration">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/pvNCpCCULfbeMUAk/images/voice-ai-test-call-history.png?fit=max&auto=format&n=pvNCpCCULfbeMUAk&q=85&s=99d0cbdf4decd7798952bab999709edb" alt="Voice AI call history with timestamps, status, and duration" width="583" height="692" data-path="images/voice-ai-test-call-history.png" />
    </Frame>
  </Step>

  <Step title="Iterate on your prompt">
    Adjust your system prompt based on test results. Common improvements include:

    * Adding specific handling for edge cases
    * Clarifying the agent role and boundaries
    * Improving fallback responses
    * Refining appointment booking instructions
  </Step>

  <Step title="Review test call results and metrics">
    After multiple test calls, review the aggregated results to identify patterns. Check the success rate for each action (appointment bookings, transfers, data collection) and look for recurring failure points.

    <Frame caption="Test call results showing conversation metrics and action success rates">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/5ekJMua0ICwwZhKE/images/ai-agents-how-to-test-voice-ai-agents-2-image.png?fit=max&auto=format&n=5ekJMua0ICwwZhKE&q=85&s=9e0b41592426def6406ecfdf414c4656" alt="Test call results and metrics dashboard" width="552" height="689" data-path="images/ai-agents-how-to-test-voice-ai-agents-2-image.png" />
    </Frame>

    <Frame caption="Detailed call results showing conversation outcome and action completions">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/pvNCpCCULfbeMUAk/images/voice-ai-test-call-results.png?fit=max&auto=format&n=pvNCpCCULfbeMUAk&q=85&s=0349b60e0b9ccd81585bfb4c300da9d9" alt="Call results panel with outcome details and completed actions" width="552" height="689" data-path="images/voice-ai-test-call-results.png" />
    </Frame>
  </Step>
</Steps>

## Common issues

<AccordionGroup>
  <Accordion title="Agent does not understand caller intent">
    Review your system prompt for clarity. Make sure the agent role and supported topics are explicitly defined. Add example scenarios for common caller requests.
  </Accordion>

  <Accordion title="Agent provides incorrect information">
    Check your knowledge base and system prompt for outdated or conflicting information. Ensure business hours, pricing, and service details are current.
  </Accordion>

  <Accordion title="Call quality issues">
    Verify your phone number is properly configured. Check that the speech-to-text and text-to-speech settings match your expected language and accent.
  </Accordion>

  <Accordion title="Appointments not booking correctly">
    Confirm your calendar is connected and the agent has the correct calendar ID. Test that free slots are available for the time ranges your agent offers.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Creating agents" icon="plus" href="/ai/voice-ai/creating-agents">
    Review agent configuration options
  </Card>

  <Card title="Call escalation" icon="phone-arrow-up-right" href="/ai/voice-ai/call-escalation">
    Set up human handoff for complex situations
  </Card>
</CardGroup>