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

# Voice agents

> Create an agent and configure its prompt, first message, voice, and the model that processes the call.

The **voice agent** is who speaks on the call. It defines what gets said, how it sounds, and how long the conversation can run.

Agents live in the **Agents** tab of Voice. The table lists each agent with its **name**, its **ID**, and its **creation date**, and from there you open them to edit or create new ones with **+ Create agent**.

<Frame caption="Voice agents listing">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/centro-de-voz-agentes.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=e5b4997da3f690993768dfcc9ad46249" alt="Agents table showing the Name, ID, and Created columns, with the Create agent button at the top right" width="1914" height="1063" data-path="assets/images/voice/centro-de-voz-agentes.png" />
</Frame>

<Note>
  The agent **ID** (in the `agent_...` format) is what you use to reference it from the CLI and from campaigns. The table shows it ready to copy.
</Note>

## The editor

Opening an agent gives you four tabs and a **Save changes** button. Changes apply to subsequent calls, not to ones already in progress.

<Frame caption="Agent editor on the Behavior tab">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/agente-comportamiento.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=7bd3562f4cd2999748d2c4e3563925e6" alt="Agent editor with the Behavior, Tools, Knowledge base, and Analysis tabs, the system prompt, the first message, and the voice and language side panel" width="1903" height="1061" data-path="assets/images/voice/agente-comportamiento.png" />
</Frame>

## Behavior

### System prompt

Defines **the personality, the objective, and the rules** the agent must follow during the call. It's the equivalent of a Brain Studio AI Agent prompt, but written for a spoken conversation.

Type `{{variable}}` to insert dynamic variables; the editor highlights them automatically. Beyond your own, you have system variables:

| Variable               | Content                       |
| ---------------------- | ----------------------------- |
| `{{system__time}}`     | Current date and time.        |
| `{{system__time_utc}}` | Current date and time in UTC. |

<Tip>
  Including the date and time at the start of the prompt keeps the agent from using wrong time references — "yesterday", "this month" — when the call happens at a different moment than the one you had in mind while writing it.
</Tip>

Since the prompt will be **heard**, not read, it pays to write it out loud: short sentences, no long lists the agent will recite in full, and a clear rule about what to do when the person interrupts or changes the subject.

### First message

This is **the first thing the agent will say when the conversation starts**. Use it to introduce yourself, say who you're calling on behalf of, and give the reason in one sentence.

Right below it there's an important setting:

**Block interruptions on the first message.** When enabled, the user cannot interrupt the agent while it delivers its greeting.

<Warning>
  Blocking guarantees the greeting is heard in full, but it can feel rigid if the greeting is long. If you need to say something mandatory — that the call is being recorded, for instance — enable it and keep it brief.
</Warning>

## Voice and language

This panel defines **how the agent sounds**.

<Frame caption="Voice and language panel">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/agente-voz-e-idioma.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=bc7afa1b285e88858ceeffaabd5bc2d4" alt="Panel with the Voice, Language, and Voice model selectors, and the Speed, Stability, Similarity, and Style controls" width="355" height="686" data-path="assets/images/voice/agente-voz-e-idioma.png" />
</Frame>

| Setting         | What it does                                                                                          |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Voice**       | The voice from the bank available to your account.                                                    |
| **Language**    | The language the agent will speak.                                                                    |
| **Voice model** | The synthesis model. Only models compatible with the chosen language are shown.                       |
| **Speed**       | The speaking pace. `1.00x` is the voice's natural pace; lower it to make the agent speak more slowly. |
| **Stability**   | Higher means a more consistent voice, but less expressive.                                            |
| **Similarity**  | How closely the result sticks to the original voice.                                                  |
| **Style**       | How much extra expressiveness is applied.                                                             |

<Warning>
  Always choose a voice that matches the configured language. A voice designed for another language produces unnatural accents and pronunciation.
</Warning>

<Tip>
  For collections, support, or any case where precision matters more than warmth, raise stability and lower style: the agent will sound flatter but far more predictable. For sales or welcome calls, the opposite.
</Tip>

## Model and call

Here you define which model reasons during the conversation and the call's limits.

<Frame caption="Model and call panel">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/agente-modelo-y-llamada.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=08acac41f9f2865b991a3fa03538e9fd" alt="Panel with the Language model selector, the Maximum duration field in seconds, and the Time zone selector" width="354" height="351" data-path="assets/images/voice/agente-modelo-y-llamada.png" />
</Frame>

* **Language model**: the model that interprets what the user says and decides the response.
* **Maximum duration (sec.)**: the call's hard limit. When reached, the call is cut off regardless of where the conversation stands.
* **Time zone**: the agent will interpret and express times in this zone.

<Tip>
  The maximum duration protects your credit consumption against calls that stay open — for example when a voicemail keeps talking on the other end. That specific case can also be handled with the native [voicemail detection](/en/guides/voice/tools) tool.
</Tip>

<Note>
  The time zone matters more than it seems in multi-country operations: if the agent books an appointment or mentions business hours, it will do so in the zone you set here, not the caller's.
</Note>

## Next step

With the agent configured, you need a phone number to receive and place calls.

<CardGroup cols={2}>
  <Card title="Provision a number" icon="phone" href="/en/guides/voice/numbers">
    Activate an ElevenLabs channel with SIP trunk or Twilio and assign this agent to it.
  </Card>

  <Card title="Give it tools" icon="wrench" href="/en/guides/voice/tools">
    Enable telephony functions and connect the agent to your APIs.
  </Card>
</CardGroup>
