> ## 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.

# Agentes de voz

> Crea un agente y configura su prompt, su primer mensaje, su voz y el modelo que procesa la llamada.

El **agente de voz** es quien habla en la llamada. Define qué dice, cómo suena y cuánto puede durar la conversación.

Los agentes viven en la pestaña **Agentes** de Voice. La tabla lista cada agente con su **nombre**, su **ID** y su **fecha de creación**, y desde ahí los abres para editarlos o los creas con **+ Crear agente**.

<Frame caption="Listado de agentes de voz">
  <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="Tabla de agentes mostrando las columnas Nombre, ID y Creado, con el botón Crear agente arriba a la derecha" width="1914" height="1063" data-path="assets/images/voice/centro-de-voz-agentes.png" />
</Frame>

<Note>
  El **ID** del agente (con el formato `agent_...`) es el que usas para referenciarlo desde el CLI y desde las campañas. La tabla lo muestra listo para copiar.
</Note>

## El editor

Al abrir un agente encuentras cuatro pestañas y el botón **Guardar cambios**. Los cambios aplican a las llamadas siguientes, no a las que estén en curso.

<Frame caption="Editor de agente en la pestaña Comportamiento">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/agente-comportamiento.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=7bd3562f4cd2999748d2c4e3563925e6" alt="Editor del agente con las pestañas Comportamiento, Herramientas, Knowledge base y Análisis, el prompt del sistema, el primer mensaje y el panel lateral de voz e idioma" width="1903" height="1061" data-path="assets/images/voice/agente-comportamiento.png" />
</Frame>

## Comportamiento

### Prompt del sistema

Define **la personalidad, el objetivo y las reglas** que debe seguir el agente durante la llamada. Es el equivalente al prompt de un AI Agent de Brain Studio, pero escrito para una conversación hablada.

Escribe `{{variable}}` para insertar variables dinámicas; el editor las resalta automáticamente. Además de las tuyas, tienes variables de sistema:

| Variable               | Contenido                   |
| ---------------------- | --------------------------- |
| `{{system__time}}`     | Fecha y hora actual.        |
| `{{system__time_utc}}` | Fecha y hora actual en UTC. |

<Tip>
  Incluir la fecha y hora al inicio del prompt evita que el agente use referencias temporales incorrectas — "ayer", "este mes" — cuando la llamada ocurre en un momento distinto al que tenías en mente al escribirlo.
</Tip>

Como el prompt se va a **escuchar**, no leer, conviene escribirlo pensando en voz alta: frases cortas, sin listas largas que el agente recite completas, y una regla clara sobre qué hacer cuando la persona interrumpe o cambia de tema.

### Primer mensaje

Es **lo primero que el agente dirá al iniciar la conversación**. Úsalo para presentarte, decir de parte de quién llamas y dar el motivo en una frase.

Justo debajo hay un ajuste importante:

**Bloquear interrupciones en el primer mensaje.** Si está activado, el usuario no puede interrumpir al agente mientras pronuncia su saludo.

<Warning>
  Activar el bloqueo garantiza que el saludo se escuche completo, pero puede sentirse rígido si el saludo es largo. Si necesitas decir algo obligatorio — que la llamada está siendo grabada, por ejemplo — actívalo y manténlo breve.
</Warning>

## Voz e idioma

Este panel define **cómo suena** el agente.

<Frame caption="Panel de voz e idioma">
  <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 con los selectores de Voz, Idioma y Modelo de voz, y los controles de Velocidad, Estabilidad, Similitud y Estilo" width="355" height="686" data-path="assets/images/voice/agente-voz-e-idioma.png" />
</Frame>

| Ajuste            | Qué hace                                                                                                 |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| **Voz**           | La voz del banco disponible para tu cuenta.                                                              |
| **Idioma**        | El idioma en el que hablará el agente.                                                                   |
| **Modelo de voz** | El modelo de síntesis. Solo se muestran los modelos compatibles con el idioma elegido.                   |
| **Velocidad**     | El ritmo del habla. `1.00x` es el ritmo natural de la voz; bájalo para que el agente hable más despacio. |
| **Estabilidad**   | Más alto significa una voz más consistente, pero menos expresiva.                                        |
| **Similitud**     | Qué tanto se apega el resultado a la voz original.                                                       |
| **Estilo**        | Cuánta expresividad adicional se aplica.                                                                 |

<Warning>
  Elige siempre una voz que corresponda al idioma configurado. Una voz pensada para otro idioma produce acentos y pronunciaciones poco naturales.
</Warning>

<Tip>
  Para cobranza, soporte o cualquier caso donde la precisión importe más que la calidez, sube la estabilidad y baja el estilo: el agente sonará más monótono pero mucho más predecible. Para ventas o bienvenidas, al revés.
</Tip>

## Modelo y llamada

Aquí defines qué modelo razona durante la conversación y los límites de la llamada.

<Frame caption="Panel de modelo y llamada">
  <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 con el selector de Modelo de lenguaje, el campo Duración máxima en segundos y el selector de Zona horaria" width="354" height="351" data-path="assets/images/voice/agente-modelo-y-llamada.png" />
</Frame>

* **Modelo de lenguaje**: el modelo que interpreta lo que dice el usuario y decide la respuesta.
* **Duración máxima (seg.)**: el límite duro de la llamada. Al alcanzarlo la llamada se corta, sin importar en qué punto esté la conversación.
* **Zona horaria**: el agente interpretará y expresará las horas en esta zona.

<Tip>
  La duración máxima protege tu consumo de créditos frente a llamadas que se quedan abiertas — por ejemplo cuando queda un buzón de voz hablando al otro lado. Ese caso concreto también se puede atajar con la herramienta nativa de [detección de buzón de voz](/guides/voice/tools).
</Tip>

<Note>
  La zona horaria importa más de lo que parece en operaciones multipaís: si el agente agenda una cita o menciona un horario de atención, lo hará en la zona que configures aquí, no en la del interlocutor.
</Note>

## Siguiente paso

Con el agente configurado, necesitas un número de teléfono que reciba y emita llamadas.

<CardGroup cols={2}>
  <Card title="Aprovisionar un número" icon="phone" href="/guides/voice/numbers">
    Activa un canal de ElevenLabs con SIP trunk o Twilio y asígnale este agente.
  </Card>

  <Card title="Darle herramientas" icon="wrench" href="/guides/voice/tools">
    Habilita funciones de telefonía y conecta el agente a tus APIs.
  </Card>
</CardGroup>
