> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/ai-voice-agents/creating-a-voice-agent/test-agent.md).

# Test Agent

Test your voice agent before it calls customers: talk to it in your browser, call your own phone, chat with it by text, or let AI play the customer in a simulated conversation.

Every voice agent has a **Test Agent** tab. Its **Try your Agent** panel has four ways to try the agent before it calls a customer, with the prompt on the right so you can change it and try again.

| Tab            | What it does                                                                     |
| -------------- | -------------------------------------------------------------------------------- |
| **Web Call**   | You talk to the agent through your browser and microphone. No phone rings.       |
| **Phone Call** | The agent calls a phone number you add, so you hear it as a customer would.      |
| **Test Chat**  | You chat with the agent by text, exactly as the conversation would go on a call. |
| **Simulation** | AI plays the customer and has the whole conversation with your agent for you.    |

The first three tabs ask for the **Receiver's information**: sample values for the variables in your prompt, such as `contact_name`, so the agent greets the person by name.

***

## Web Call

1. Open **Web Call**, fill in the receiver's information and click **Start Web Call**.
2. Allow the microphone when your browser asks, and talk. The **Call Transcript** follows the conversation as it happens.
3. Click **End Call** when you're done.

**Test an inbound agent.** An agent that answers your phone number expects a caller, not a call it places. Turn on **Test as an inbound call** before you start: the agent answers as if a customer called its number, and the `direction` variable is `inbound`. You don't need a phone number. The switch starts off, and your browser remembers it for each agent. It isn't offered while you create your first agent.

### If the microphone doesn't work

Before the call, the panel reminds you: **Your browser will ask for microphone access. Choose Allow so you can talk to your agent.** If something goes wrong, the panel says what and how to fix it, with the steps for your browser:

| Message                                      | What to do                                                                                                                                                                                                            |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Microphone blocked for this site**         | Your browser won't ask again until you unblock it. Follow the steps shown for your browser (Chrome, Edge, Firefox, Safari, iPhone or Android), then click **I've enabled it, call**.                                  |
| **Your computer is blocking the microphone** | The site is allowed, but your system blocks the browser. On Windows: **Settings > Privacy & security > Microphone**. On Mac: **System Settings > Privacy & Security > Microphone**. Allow your browser and try again. |
| **We can't find a microphone**               | Connect a microphone or a headset and try again.                                                                                                                                                                      |
| **This browser can't use the microphone**    | Open the page directly in Chrome, Safari or Edge. Inside another app's browser, open it in Chrome or Safari.                                                                                                          |
| **We couldn't start your microphone**        | Close other apps that may be using it (Zoom, Meet, Teams...), check that it's connected and try again.                                                                                                                |
| **Lucy can't hear you**                      | No audio is coming from your microphone during the call. Check that it isn't muted and that the right input is selected.                                                                                              |
| **Your microphone was disconnected**         | Plug it back in. If the call doesn't recover, end it and start a new one.                                                                                                                                             |

When the microphone can't be fixed, test with a **Phone Call** instead.

***

## Phone Call

1. Open **Phone Call** and pick the number to call under **Phone number**. To use a new one, click **Add Test Number** and verify it first.
2. Fill in the receiver's information and click **Start Phone Call**. Your phone rings with your agent on the line.

{% content-ref url="/pages/Q74xtPbnEVm6J4Qedsk5" %}
[How to add a Phone Number for Testing in Dapta](https://docs.dapta.ai/ai-voice-agents/phone-numbers/how-to-add-a-phone-number-for-testing-in-dapta.md)
{% endcontent-ref %}

***

## Test Chat

The fastest way to check the greeting and the answers.

1. Open **Test Chat**, fill in the receiver's information and click **Start Chat**. The agent opens with its greeting in the **Call Transcript**.
2. Type your reply in **Ask assistant anything...** and press **Enter**. The agent answers in real time.
3. End the chat with the red button, then **New chat** to start over.

***

## Simulation

Let AI act as a customer and run the whole conversation, without typing a message.

1. Open **Simulation**. Dapta writes a **Simulated user profile** with the customer's **Goal** and **Personality**. Edit it to test a specific situation.
2. Click **Simulate Conversation** and watch the exchange in the **Call Transcript**.
3. When it ends you see how, such as **The user achieved their goal** or **The agent ended the call**. Click **Run again** for another round.

**Use real conversations** makes the simulated customer behave like your real ones, based on this agent's last 5 successful conversations. It's available once the agent has at least 5 successful calls.

{% hint style="info" %}
A simulation checks the prompt's logic and the agent's actions through text. It doesn't reproduce the voice (audio, interruptions or response timing), and call transfers aren't made.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/ai-voice-agents/creating-a-voice-agent/test-agent.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
