Function calling em ligação: a IA consulta seu sistema ao vivo

Uma conversa por telefone quase sempre precisa de algum dado que não está no roteiro: o horário livre de amanhã, a situação de um pedido, o endereço de um CEP. O function calling em ligação é o recurso que permite à IA buscar esse dado no seu sistema enquanto ainda está falando com a pessoa. Na respondendo.app, ele se chama ferramentas, e funciona com uma URL sua e um pouco de JSON.

Neste artigo você entende como o recurso funciona, quando usar e quais cuidados deixam a conversa natural mesmo com consultas no meio.

O que é function calling em ligação

Function calling é a capacidade de um modelo de IA decidir, no meio de uma tarefa, que precisa chamar uma função externa, montar os parâmetros dessa chamada e usar a resposta para continuar. Numa ligação, isso significa que a IA percebe que precisa de uma informação, pede essa informação ao seu sistema e responde à pessoa com o dado certo, sem desligar e sem inventar.

Você declara cada ferramenta com um nome, uma descrição de quando usá-la e os parâmetros que ela recebe. Durante a conversa, a IA chama a sua URL com esses parâmetros, espera a resposta e segue falando. A página de ferramentas mostra o formato da declaração.

Usos mais comuns

• Agenda: consultar horários livres e reservar o horário que a pessoa escolheu.
• Pedidos: informar se a encomenda saiu, quando chega ou se há pendência.
• Cadastro: conferir dados, atualizar um telefone ou registrar um interesse.
• Endereço: buscar a rua a partir do CEP para confirmar com a pessoa.
• CRM: criar ou mover um card assim que a pessoa toma uma decisão.

Alguns desses usos já vêm prontos nas integrações do painel, como a consulta de horários no Google Agenda ou na Respondendo Agenda e o registro no CRM. Para o resto, a ferramenta aponta para uma rota do seu próprio sistema.

Como configurar uma ferramenta

1. Crie a rota no seu sistema. Ela recebe os parâmetros em JSON e devolve uma resposta curta, também em JSON.
2. Declare a ferramenta no agente ou no pedido. Dê um nome claro, explique quando a IA deve chamá-la e liste os parâmetros, com tipo e descrição.
3. Oriente o roteiro. Diga em que momento da conversa a consulta faz sentido e o que a IA deve falar com a resposta.
4. Teste. Faça uma ligação para você mesmo e confira na transcrição se a IA chamou a ferramenta no momento certo.

A documentação da API traz o exemplo completo de declaração e o formato do pedido que chega na sua URL.

Boas práticas de function calling em ligação

Ao telefone, cada segundo de silêncio pesa. Algumas práticas mantêm a conversa fluida:

• Responda rápido. A sua rota deve devolver a resposta em poucos segundos. Consultas pesadas podem ser preparadas antes e só lidas na hora.
• Devolva só o que a IA precisa dizer. Em vez de um objeto enorme, mande os dois ou três horários livres ou a frase sobre o pedido.
• Descreva bem a ferramenta. A descrição é o que faz a IA chamar no momento certo. Diga quando usar e quando não usar.
• Trate o erro. Se a sua rota não encontrar o dado, devolva uma mensagem que a IA possa repetir com naturalidade, como "não encontrei esse pedido".
• Não peça dados sensíveis sem necessidade. Pergunte só o que a consulta exige.

Ferramenta ou resultado no fim?

Nem tudo precisa acontecer no meio da conversa. Se a informação só é usada depois, como mover o contato no funil, o resultado que chega no webhook no fim da ligação é suficiente e mais simples. Use ferramentas quando a resposta muda o que a IA vai falar a seguir, como oferecer um horário que realmente existe.

Exemplo: uma loja que informa pedidos

A loja virtual fictícia do André recebia muitas mensagens perguntando sobre entregas. Ele criou um agente que liga para clientes com pedido atrasado e uma ferramenta chamada consultar_pedido, que recebe o número do pedido e devolve a situação e a previsão de entrega.

Na ligação, a IA confirma o nome da pessoa, consulta o pedido e informa a nova previsão. Se o cliente prefere cancelar, a IA registra o resultado e a equipe trata no dia seguinte. O suporte passou a receber só os casos que exigem decisão humana.

Perguntas frequentes

Preciso programar para usar ferramentas?

Para consultar o seu próprio sistema, sim, é preciso uma rota que responda em JSON. Para agenda e CRM, as integrações do painel já trazem ferramentas prontas.

A pessoa percebe a consulta?

Ela ouve a IA continuar a conversa com o dado certo. Com uma rota rápida, a pausa é curta, como a de um atendente conferindo uma informação.

Posso ter várias ferramentas no mesmo agente?

Pode. Cada uma com o seu nome e a sua descrição, para a IA saber qual chamar em cada situação.

Teste uma ferramenta hoje

Veja como a ligação acontece passo a passo e crie sua conta com o Google. Com o crédito de teste, você monta um agente com uma ferramenta simples e ouve o function calling em ligação funcionando na sua própria chamada.