# AI Voice Agent (/docs/workflows/reference/category/bot/aiVoiceAgent)

> For the complete documentation index, see [llms.txt](https://docs.tandemcx.ai/llms.txt). Any page on this site can be fetched as Markdown by appending `.md` to its URL.

Transfer the voice conversation to a self-hosted AI agent (agent-media), routing on the disposition the agent reports when the call ends.

**Category:** Bot  
**Provider:** Core  
**Latest version:** 1.0.0

## Fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| Agent (`agentId`) | dynamicDropdown | Yes | The AI voice agent to hand the call to. Configured under Voice Agents; the dropdown is populated from agent-media. |
| Dispositions (`dispositions`) | dynamic array of fields with options | No | Call outcomes this agent can report. Derived from the selected agent's configuration; each becomes a routable exit. Edit them under Voice Agents. |
| Pass to agent (`passToAgent`) | array of objects | No | Values from this call to hand the agent, referenced in its prompt and tools as {{vars.name}}. Use them for what changes call to call — a customer id, an account tier, the result of an earlier lookup. Up to 25 values, 2KB each and 16KB in total. A name the workflow does not pass reads as empty rather than failing the call. These reach the agent’s prompt, so do not pass a credential through them — store it as a secret instead. |

## Exits

- `default` (required)
- `invalidInput` (system)
- `fallback` (system)

System exits (auto-injected, hidden when unwired): `invalidInput`, `fallback`.