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

> Crie um agente e configure o prompt, a primeira mensagem, a voz e o modelo que processa a chamada.

O **agente de voz** é quem fala na chamada. Ele define o que é dito, como soa e quanto a conversa pode durar.

Os agentes ficam na aba **Agentes** do Voice. A tabela lista cada agente com o **nome**, o **ID** e a **data de criação**, e a partir dela você os abre para editar ou cria novos com **+ Criar agente**.

<Frame caption="Listagem 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="Tabela de agentes mostrando as colunas Nome, ID e Criado, com o botão Criar agente no canto superior direito" width="1914" height="1063" data-path="assets/images/voice/centro-de-voz-agentes.png" />
</Frame>

<Note>
  O **ID** do agente (no formato `agent_...`) é o que você usa para referenciá-lo pelo CLI e pelas campanhas. A tabela o mostra pronto para copiar.
</Note>

## O editor

Ao abrir um agente você encontra quatro abas e o botão **Salvar alterações**. As alterações valem para as chamadas seguintes, não para as que já estão em andamento.

<Frame caption="Editor de agente na aba Comportamento">
  <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 do agente com as abas Comportamento, Ferramentas, Knowledge base e Análise, o prompt do sistema, a primeira mensagem e o painel lateral de voz e idioma" width="1903" height="1061" data-path="assets/images/voice/agente-comportamiento.png" />
</Frame>

## Comportamento

### Prompt do sistema

Define **a personalidade, o objetivo e as regras** que o agente deve seguir durante a chamada. É o equivalente ao prompt de um AI Agent do Brain Studio, mas escrito para uma conversa falada.

Escreva `{{variable}}` para inserir variáveis dinâmicas; o editor as destaca automaticamente. Além das suas, você tem variáveis de sistema:

| Variável               | Conteúdo                   |
| ---------------------- | -------------------------- |
| `{{system__time}}`     | Data e hora atuais.        |
| `{{system__time_utc}}` | Data e hora atuais em UTC. |

<Tip>
  Incluir a data e a hora no início do prompt evita que o agente use referências temporais incorretas — "ontem", "este mês" — quando a chamada acontece em um momento diferente daquele em que você o escreveu.
</Tip>

Como o prompt vai ser **ouvido**, e não lido, vale escrevê-lo pensando em voz alta: frases curtas, sem listas longas que o agente recite por inteiro, e uma regra clara sobre o que fazer quando a pessoa interrompe ou muda de assunto.

### Primeira mensagem

É **a primeira coisa que o agente dirá ao iniciar a conversa**. Use-a para se apresentar, dizer em nome de quem você liga e dar o motivo em uma frase.

Logo abaixo há um ajuste importante:

**Bloquear interrupções na primeira mensagem.** Se estiver ativado, o usuário não pode interromper o agente enquanto ele pronuncia a saudação.

<Warning>
  Ativar o bloqueio garante que a saudação seja ouvida por completo, mas pode soar rígido se ela for longa. Se você precisa dizer algo obrigatório — que a chamada está sendo gravada, por exemplo — ative e mantenha o texto breve.
</Warning>

## Voz e idioma

Este painel define **como o agente soa**.

<Frame caption="Painel 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="Painel com os seletores de Voz, Idioma e Modelo de voz, e os controles de Velocidade, Estabilidade, Similaridade e Estilo" width="355" height="686" data-path="assets/images/voice/agente-voz-e-idioma.png" />
</Frame>

| Ajuste            | O que faz                                                                                      |
| ----------------- | ---------------------------------------------------------------------------------------------- |
| **Voz**           | A voz do banco disponível para a sua conta.                                                    |
| **Idioma**        | O idioma no qual o agente vai falar.                                                           |
| **Modelo de voz** | O modelo de síntese. Só são exibidos os modelos compatíveis com o idioma escolhido.            |
| **Velocidade**    | O ritmo da fala. `1.00x` é o ritmo natural da voz; reduza para que o agente fale mais devagar. |
| **Estabilidade**  | Mais alto significa uma voz mais consistente, porém menos expressiva.                          |
| **Similaridade**  | Quanto o resultado se mantém fiel à voz original.                                              |
| **Estilo**        | Quanta expressividade adicional é aplicada.                                                    |

<Warning>
  Escolha sempre uma voz que corresponda ao idioma configurado. Uma voz pensada para outro idioma produz sotaques e pronúncias pouco naturais.
</Warning>

<Tip>
  Para cobrança, suporte ou qualquer caso em que a precisão importe mais que a simpatia, aumente a estabilidade e reduza o estilo: o agente soará mais monótono, mas muito mais previsível. Para vendas ou boas-vindas, o contrário.
</Tip>

## Modelo e chamada

Aqui você define qual modelo raciocina durante a conversa e os limites da chamada.

<Frame caption="Painel de modelo e chamada">
  <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="Painel com o seletor de Modelo de linguagem, o campo Duração máxima em segundos e o seletor de Fuso horário" width="354" height="351" data-path="assets/images/voice/agente-modelo-y-llamada.png" />
</Frame>

* **Modelo de linguagem**: o modelo que interpreta o que o usuário diz e decide a resposta.
* **Duração máxima (seg.)**: o limite rígido da chamada. Ao alcançá-lo, a chamada é encerrada, não importa em que ponto a conversa esteja.
* **Fuso horário**: o agente interpretará e expressará as horas nesse fuso.

<Tip>
  A duração máxima protege o seu consumo de créditos contra chamadas que ficam abertas — por exemplo quando uma caixa postal continua falando do outro lado. Esse caso específico também pode ser resolvido com a ferramenta nativa de [detecção de caixa postal](/pt/guias/voice/tools).
</Tip>

<Note>
  O fuso horário importa mais do que parece em operações multipaís: se o agente agendar um compromisso ou mencionar um horário de atendimento, ele o fará no fuso que você configurar aqui, não no do interlocutor.
</Note>

## Próximo passo

Com o agente configurado, você precisa de um número de telefone que receba e emita chamadas.

<CardGroup cols={2}>
  <Card title="Provisionar um número" icon="phone" href="/pt/guias/voice/numbers">
    Ative um canal do ElevenLabs com SIP trunk ou Twilio e atribua este agente a ele.
  </Card>

  <Card title="Dar ferramentas a ele" icon="wrench" href="/pt/guias/voice/tools">
    Habilite funções de telefonia e conecte o agente às suas APIs.
  </Card>
</CardGroup>
