Definição
Tool calling é o mecanismo pelo qual o modelo solicita a chamada de uma ferramenta. Em vez de apenas responder com texto, o modelo emite um pedido estruturado com o nome da ferramenta e os argumentos necessários, e a aplicação decide como proceder.
A solicitação e a execução
O modelo descreve a ferramenta disponível, recebe a consulta e devolve um pedido de chamada com argumentos. A execução é feita pela aplicação, que retorna o resultado ao modelo para a composição da resposta final.
Solicitação do modelo
Pedido estruturado que indica a ferramenta e os argumentos para a chamada.
Execução da aplicação
Ação real que consulta o sistema e devolve o resultado ao modelo.
Solicitar não é executar
O modelo pode pedir uma ferramenta sem que ela tenha sido executada. A autorização da ação pertence à aplicação, que controla quais ferramentas existem e sob quais condições a chamada é liberada. O pedido do modelo não representa uma execução nem uma permissão concedida.
Quando a chamada diverge
No exemplo da consulta de cliente, o pedido carrega o identificador e a aplicação executa a busca. A falha provável aparece quando o modelo monta argumentos incorretos, como um identificador trocado, e a ferramenta devolve vazio ou erro. A verificação inspeciona o pedido estruturado, confirma se a autorização liberou a chamada e compara o resultado devolvido com o que a pergunta pede. Se a aplicação registra cada solicitação e cada execução, você localiza se o desvio veio dos argumentos, da permissão ou da própria ferramenta.
Veja como o agente usa tool callingDúvidas frequentes
Perguntas frequentes sobre Tool calling
- O modelo executa a ferramenta sozinho?
- Não. O modelo emite um pedido estruturado. A execução é feita pela aplicação, que controla autorização e retorna o resultado ao modelo.
- Tool calling é o mesmo que API?
- Não. Tool calling é o mecanismo pelo qual o modelo pede uma ferramenta. A API é um dos meios que a aplicação usa para executar essa chamada.
- O pedido do modelo garante que a ação ocorreu?
- Não. O modelo pode solicitar uma ferramenta sem que ela tenha sido executada. A aplicação decide se autoriza e quando a chamada acontece.
Para continuar
Recursos relacionados
Documentação
OpenAI: Function calling
Documenta como conectar modelos a funções e APIs externas.
Abrir recursoDocumentação
Anthropic: Tool use
Explica como o modelo solicita ferramentas com argumentos estruturados.
Abrir recursoDocumentação
Google Cloud: Function calling overview
Apresenta o fluxo de chamada de função com modelos generativos.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Na Formação Vibe Coding, o tool calling conecta o assistente a comandos e consultas reais do projeto.
Conhecer a formaçãoFontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.