Consultas por agentes de voz: ferramentas e chamadas de função
Como funciona a chamada de função em agentes de voz: consultas x ações, o que faz uma boa ferramenta, os riscos da entrada por voz e como manter a naturalidade.
Informações que mudam a cada hora não podem morar em um prompt. O status de um pedido, um nível de estoque ou um horário disponível só estão corretos por um momento. Para usar esse tipo de informação, um agente de voz precisa de um jeito de consultar outro sistema, e esse mecanismo costuma ser chamado de chamada de função ou uso de ferramentas.

Este guia explica em termos simples como isso funciona, o que faz uma boa ferramenta, onde estão os riscos e como a ideia se relaciona com o funcionamento atual dos agentes de IA do Call. Para entender o processo de voz em si, veja Como a IA de voz funciona em uma ligação telefônica.
Como funciona uma chamada de ferramenta
Um modelo de linguagem escreve texto. Ele não consegue abrir um banco de dados nem apertar um botão. A chamada de função é uma convenção: você descreve ao modelo um conjunto de funções, com nome, finalidade e as entradas que cada uma espera, e o modelo pode responder com um pedido para usar uma delas.
O ciclo de uma chamada de ferramenta
- A pessoa perguntaPor exemplo: onde está o meu pedido?
- O modelo propõe uma chamadaEle devolve o nome de uma função e os argumentos, como o número do pedido.
- O seu software validaEle confere os argumentos, a permissão de quem liga e eventuais limites.
- O sistema executaEle consulta o sistema de pedidos e obtém um resultado.
- O resultado volta ao modeloO modelo transforma os dados em uma resposta falada curta.
O ponto principal é que quem executa a ação é o seu software, não o modelo. Isso dá a você um lugar para impor regras, registrar o que aconteceu e recusar qualquer coisa descabida.
Consultas x ações
Nem todas as ferramentas têm o mesmo risco. Uma consulta lê informações. Uma ação altera algo no mundo. Trate-as de forma diferente.
Consultas só de leitura x ações que alteram dados
| Consulta | Ação | |
|---|---|---|
| Exemplos | Horário de funcionamento, status do pedido, tamanho da fila | Cancelar um agendamento, emitir um reembolso, atualizar um endereço |
| Risco se der errado | Uma resposta errada, que pode ser corrigida | Uma mudança que pode ser difícil de desfazer |
| Proteções típicas | Verificação de identidade, campos limitados | Etapa de confirmação, aprovação humana, log de auditoria |
| Bom ponto de partida? | Sim | Só depois que as consultas funcionarem bem |
Um caminho cauteloso é lançar só com consultas, observar as ligações reais e acrescentar ações aos poucos, com uma pessoa confirmando tudo o que tiver consequências. É a mesma postura por trás de Salvaguardas para agentes de IA de voz.
O que faz uma boa ferramenta
- Uma finalidade clara. Uma ferramenta chamada get_order_status é mais fácil de o modelo escolher corretamente que uma ferramenta que faz cinco coisas.
- Poucas entradas simples. Peça um número de pedido, não um campo longo de texto livre.
- Um resultado curto e estruturado. Devolva os poucos campos que o agente vai dizer em voz alta, não o registro completo.
- Mensagens de erro simples. Devolva "não encontrado" ou "tente mais tarde" em uma forma que o modelo consiga transformar em uma frase educada.
- Uma resposta rápida. Ferramentas lentas deixam a pessoa esperando em silêncio.
Nomes e descrições importam
O modelo escolhe as ferramentas pelos nomes e descrições que você fornece. Textos vagos levam a escolhas erradas. Escreva as descrições como instruções para um colega novo: quando usar a ferramenta, quando não usar e o que significa cada entrada.
A entrada falada é bagunçada
Os argumentos vêm da fala. Um número de pedido pode chegar com um dígito errado, ou um nome com uma grafia incomum. Repita os valores principais para a pessoa antes de usá-los e desenhe a ferramenta para devolver um resultado útil quando o valor for quase certo. O guia Como acertar nomes, números e endereços por voz trata das técnicas de confirmação em detalhes.
Os riscos que o desenho precisa contornar
Onde o uso de ferramentas dá errado
- Ferramenta ou argumentos erradosO modelo entende mal o pedido, então valide tudo antes de executar.
- Excesso de informaçãoUma consulta devolve mais do que a pessoa deveria ouvir, então devolva só o necessário.
- Identidade não verificadaLer dados de conta para a pessoa errada; por isso, verifique antes de divulgar.
- Sistemas lentos ou com falhaSilêncio ou um erro confuso; por isso, defina limites de tempo e alternativas faladas.
- Instruções injetadasTexto em um resultado de consulta que tenta dar ordens ao modelo; por isso, trate os resultados só como dados.
Cada risco tem uma resposta de engenharia, mas o princípio de desenho mais seguro é dar ao agente o menor acesso que resolva a tarefa. Não entregue a ele uma conexão genérica com o banco de dados quando uma única consulta restrita basta.
Como manter a ligação natural
Uma chamada de ferramenta acrescenta tempo: o modelo decide, o seu sistema responde, o modelo escreve a resposta e a fala é gerada. A pessoa ouve silêncio. Táticas que ajudam incluem uma confirmação bem curta antes de uma consulta, guardar em cache valores que raramente mudam e limitar cada turno a uma chamada de ferramenta. O guia Latência em IA de voz descreve de onde vem o atraso. Se uma consulta falhar ou demorar demais, o agente deve dizer isso brevemente e oferecer um recado ou uma pessoa, em vez de ficar esperando.
Um exemplo passo a passo
Imagine uma loja de móveis hipotética cujo agente responde perguntas sobre entregas. A loja define uma única ferramenta só de leitura, que recebe um número de pedido e devolve o status e a janela de entrega. O agente é instruído a usá-la só depois que a pessoa informar um número de pedido e confirmá-lo ao ouvi-lo repetido.
- A pessoa diz que está esperando um sofá e informa um número de pedido.
- O agente repete o número em grupos e a pessoa confirma.
- A ferramenta devolve o status "saiu para entrega" e a janela "à tarde".
- O agente diz que o pedido saiu para entrega e deve chegar à tarde, e pergunta se precisa de mais alguma coisa.
- Se a ferramenta devolver "não encontrado", o agente diz que não consegue localizar o pedido e oferece anotar um recado para a equipe.
Repare no que falta: o agente não pode reagendar a entrega. Se a pessoa quiser outro dia, o agente registra o pedido e a equipe cuida disso. Começar com uma ferramenta restrita e segura como essa ensina como as pessoas realmente falam antes de ampliar o escopo. Mantenha um registro de cada chamada que a ferramenta recebe para identificar padrões, como um dígito frequentemente mal entendido, e corrigi-los na etapa de confirmação.
Como isso se relaciona com o Call
No Call, um agente de IA responde com base nas instruções, na persona, no roteiro vinculado à linha e nos trechos da base de conhecimento que correspondem à pergunta. Ele não foi pensado para executar ações como agendar ou confirmar horários, retornar ligações, enviar nada ou oferecer descontos durante a ligação. Ele diz isso e indica o caminho descrito nas suas fontes, por exemplo, um link de agendamento ou um retorno da sua equipe. Para informações que mudam com frequência, mantenha-as nas fontes do agente e atualize-as, e use a central de atendimento para o trabalho de seguimento que exige uma pessoa. Se quiser conectar o Call aos seus próprios sistemas, a interface para desenvolvedores está descrita em Call para desenvolvedores e API; confira o que ela oferece antes de desenhar qualquer coisa em torno de um comportamento específico.
Ao avaliar qualquer plataforma que anuncie uso de ferramentas, faça as perguntas práticas do checklist abaixo.
Perguntas sobre ferramentas em um agente de voz
- Quais sistemas ele consegue acessar, e com quais permissões?
- As consultas são separadas das ações que alteram dados?
- Existe um log de cada chamada feita, com argumentos e resultados?
- O que acontece quando uma consulta falha ou é lenta?
- Uma pessoa pode aprovar ações com consequências?
- Como a identidade de quem liga é verificada antes que dados sejam ditos?
- É possível testar as ferramentas com entrada falada realista antes do lançamento?
Para o lado da avaliação, veja Como avaliar as conversas de um agente de voz.
Perguntas frequentes
O que é chamada de função, em termos simples?
É uma forma de um modelo de IA pedir ao seu software que faça algo, como consultar um pedido. O modelo escreve o pedido, o seu sistema o executa e devolve o resultado para o modelo explicar.
A IA executa a função sozinha?
Não. O modelo só propõe a chamada. O seu próprio código confere e executa, e é aí que você pode aplicar regras, limites e registros.
É seguro deixar um agente de voz alterar registros?
Dá para fazer com cuidado, mas comece com consultas só de leitura. Para tudo o que altera dados, acrescente confirmação, limites e aprovação humana quando houver muito em jogo.
Por que uma consulta deixa a ligação lenta?
Cada etapa leva tempo: decidir a chamada, executá-la, escrever a resposta e falá-la. Ferramentas rápidas, uma confirmação curta e uma consulta por turno mantêm o atraso tolerável.
Alguém pode enganar o agente para que use uma ferramenta de forma errada?
Pode tentar. Valide os argumentos, confira as permissões no seu código e dê ao agente ferramentas restritas, para que um pedido mal-intencionado não cause danos reais.
O agente de IA do Call faz consultas nos meus sistemas?
O agente do Call trabalha a partir das instruções, do roteiro e das fontes de conhecimento e não agenda, envia nem confirma nada durante a ligação. Mantenha as informações que mudam nas fontes dele e conte com a equipe para o seguimento.