Skip to main content
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.
Lista de ferramentas nativas com os seus interruptores e, abaixo, a seção de ferramentas HTTP com uma ferramenta configurada

Aba Ferramentas com as funções nativas e as ferramentas HTTP

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.
Finalizar chamada tem ainda uma opção Configurar ao lado do interruptor, para ajustar o comportamento dela em mais detalhe.

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

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

Painel de configuração de uma ferramenta HTTP

Os campos

1

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

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

Método e URL do endpoint

O verbo HTTP e o endereço para o qual a Jelou fará a requisição.
4

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

Headers adicionais

Cabeçalhos extras enviados em cada requisição, se a sua API precisar deles.
6

Parâmetros do body

São enviados como JSON no corpo da requisição.
7

Descrição do corpo

Campo obrigatório. Descreva em detalhe como extrair os dados da transcrição para montar o corpo da requisição.
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.
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.

Próximo passo

Knowledge base

Para perguntas frequentes, um documento costuma resolver melhor do que uma chamada à sua API.

Análise

Defina o que você quer avaliar e extrair de cada conversa.