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

# Ferramentas do agente

> Habilite funções nativas de telefonia e conecte o agente às suas APIs com ferramentas HTTP.

As **ferramentas** são as ações que o agente pode executar durante a chamada, além de falar. Elas se dividem em dois grupos: as **nativas**, que são funções de telefonia já integradas, e as **HTTP**, que você define para que o agente consuma as suas próprias APIs.

Ficam na aba **Ferramentas** do editor do agente.

<Frame caption="Aba Ferramentas com as funções nativas e as ferramentas HTTP">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/agente-herramientas.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=8226cb9995fd13279dc89c575c574517" alt="Lista de ferramentas nativas com os seus interruptores e, abaixo, a seção de ferramentas HTTP com uma ferramenta configurada" width="1446" height="941" data-path="assets/images/voice/agente-herramientas.png" />
</Frame>

## Ferramentas nativas

São funções integradas que o agente pode usar durante a conversa. Cada uma é um interruptor independente, e o canto da seção indica quantas estão ativas.

| Ferramenta                       | O que permite                                          |
| -------------------------------- | ------------------------------------------------------ |
| **Finalizar chamada**            | Que o agente desligue quando a conversa terminar.      |
| **Detecção de idioma**           | Mudar automaticamente para o idioma do interlocutor.   |
| **Pular turno**                  | Que o agente espere e deixe o interlocutor continuar.  |
| **Detecção de caixa postal**     | Detectar quando a chamada cai em uma caixa postal.     |
| **Discagem DTMF**                | Que o agente emita tons de teclado para navegar menus. |
| **Transferir para outro agente** | Escalar a chamada para outro agente de voz.            |
| **Transferir para um número**    | Redirecionar a chamada para um número externo.         |

<Note>
  **Finalizar chamada** tem ainda uma opção **Configurar** ao lado do interruptor, para ajustar o comportamento dela em mais detalhe.
</Note>

### Quando ativar cada uma

**Finalizar chamada** é a que você quase sempre vai querer ligada: sem ela o agente não tem como encerrar e a chamada fica aberta até o limite de duração máxima.

**Detecção de caixa postal** é a que mais economiza créditos em campanhas de saída. Sem ela, uma chamada que cai na caixa postal se torna o agente falando com um gravador até esgotar o tempo.

**Pular turno** ajuda quando a pessoa fala devagar ou faz pausas longas para pensar; sem ela o agente tende a interromper ou a preencher o silêncio.

**Discagem DTMF** só faz sentido se o agente for atravessar um menu telefônico automático, por exemplo ao transferir para uma central que pede ramal.

**Detecção de idioma** vale a pena somente se você realmente espera interlocutores em vários idiomas. Se a sua operação é monolíngue, deixá-la desligada evita que o agente troque de idioma por um mal-entendido da transcrição.

<Warning>
  **Transferir para outro agente** e **Transferir para um número** são as duas que tiram a chamada do agente atual. Antes de ativá-las, defina no prompt do sistema quando ele deve usá-las: caso contrário o agente pode transferir cedo demais e perder casos que conseguiria resolver.
</Warning>

## Ferramentas HTTP

Permitem ao agente **consumir APIs externas durante a conversa**: consultar um saldo, validar um documento, registrar um pedido ou disparar uma cobrança sem sair da chamada.

A seção lista as que você já tem, mostrando o método, o nome, a URL e a descrição, com ações para editá-las ou excluí-las. São criadas com **+ Adicionar ferramenta**.

<Frame caption="Painel de configuração de uma ferramenta HTTP">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/agente-herramienta-http.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=f646a48413995ce044fcb253a0608a9b" alt="Painel lateral com o nome da ferramenta, a descrição para o modelo, o método e a URL do endpoint, a seção de autenticação, os headers adicionais e os parâmetros do body" width="1839" height="1060" data-path="assets/images/voice/agente-herramienta-http.png" />
</Frame>

### Os campos

<Steps>
  <Step title="Nome da ferramenta">
    O identificador interno **em snake\_case** que o modelo usará para invocar a ferramenta. Não é um texto que o usuário escute; é o nome pelo qual o agente a chama.
  </Step>

  <Step title="Descrição para o modelo">
    Explica **quando** a ferramenta deve ser usada. Esse texto é tudo o que o modelo tem para decidir se a invoca ou não, portanto vale dizer explicitamente em qual situação ela se aplica e quais dados precisa.
  </Step>

  <Step title="Método e URL do endpoint">
    O verbo HTTP e o endereço para o qual a Jelou fará a requisição.
  </Step>

  <Step title="Autenticação">
    Reutilize uma conexão salva no ElevenLabs ou crie uma nova com **Criar autenticação**. As credenciais nunca são exibidas depois de salvas.
  </Step>

  <Step title="Headers adicionais">
    Cabeçalhos extras enviados em cada requisição, se a sua API precisar deles.
  </Step>

  <Step title="Parâmetros do body">
    São enviados como JSON no corpo da requisição.
  </Step>

  <Step title="Descrição do corpo">
    Campo obrigatório. Descreva **em detalhe como extrair os dados da transcrição** para montar o corpo da requisição.
  </Step>
</Steps>

<Tip>
  A qualidade de uma ferramenta HTTP depende quase inteiramente de dois textos: a **descrição para o modelo** e a **descrição do corpo**. Se o agente não invoca a ferramenta quando deveria, o problema normalmente está no primeiro; se a invoca com dados incompletos ou mal formados, no segundo.
</Tip>

<Warning>
  O agente extrai os parâmetros do que **entendeu** da conversa, e uma transcrição de voz pode confundir dígitos ou nomes próprios. Em operações sensíveis como pagamentos ou alterações de dados, faça o agente repetir o dado em voz alta e pedir confirmação antes de invocar a ferramenta, e valide no seu backend antes de executar.
</Warning>

## Próximo passo

<CardGroup cols={2}>
  <Card title="Knowledge base" icon="book" href="/pt/guias/voice/knowledge-base">
    Para perguntas frequentes, um documento costuma resolver melhor do que uma chamada à sua API.
  </Card>

  <Card title="Análise" icon="chart-line" href="/pt/guias/voice/analysis">
    Defina o que você quer avaliar e extrair de cada conversa.
  </Card>
</CardGroup>
