Como funciona
Tool calling é um padrão em que um modelo de linguagem solicita que uma aplicação execute uma ferramenta, como consultar uma base de dados, buscar uma informação ou chamar uma função do produto. O modelo não executa automaticamente o código externo: ele produz uma solicitação estruturada, e a aplicação decide se deve executá-la.
Um fluxo comum tem quatro etapas. A aplicação informa ao modelo quais ferramentas existem e quais argumentos cada uma aceita. O modelo seleciona uma ferramenta e retorna os argumentos. A aplicação valida a solicitação, executa a função permitida e devolve o resultado ao modelo. Por fim, o modelo usa esse resultado para formular a resposta ou solicitar outra ação.
Na documentação de function calling da OpenAI, a chamada de ferramenta é apresentada como uma interação entre o modelo e a aplicação: o sistema hospedeiro executa a função e retorna a saída. APIs diferentes podem usar nomes e formatos distintos, e alguns sistemas aceitam ferramentas personalizadas com entradas que não são JSON.
O modelo pode pedir uma ferramenta que não existe, enviar argumentos inválidos ou interpretar mal o resultado. Por isso, a aplicação precisa validar tipos, limites, permissões e efeitos colaterais. Para operações que alteram dados, enviam mensagens ou movimentam recursos, controles de autorização devem estar no software, não apenas no prompt.
Exemplo prático
Um assistente de uma loja recebe a pergunta: “O pedido 4821 já foi enviado?”. A aplicação disponibiliza uma ferramenta limitada chamada consultar_pedido, que aceita um identificador. O modelo pode solicitar a consulta; o servidor verifica se o usuário está autorizado a ver aquele pedido, consulta o sistema e retorna apenas o status permitido.
O modelo então pode responder que o pedido foi despachado, caso essa informação exista no retorno. Se o pedido não for encontrado, deve comunicar isso em vez de inventar uma atualização. O acesso ao banco e as regras de autorização ficam sob controle da aplicação, não do modelo.
Uma ferramenta de ação exige mais cuidado. Se houver uma função cancelar_pedido, o sistema pode exigir confirmação explícita, conferir o estado atual e registrar a operação antes de executar. Não basta aceitar qualquer argumento porque o modelo pediu; valide a identidade, o escopo e as consequências.
Para que serve
Tool calling conecta modelos a dados e operações que não estão disponíveis apenas no texto de entrada. Isso pode habilitar busca em documentos, consulta a sistemas internos, cálculos, execução de tarefas e integrações com APIs.
O recurso é útil quando a aplicação precisa combinar linguagem natural com ações controladas. Para tarefas que exigem várias ferramentas, um agente pode selecionar e encadear chamadas, mas o desenvolvedor continua responsável por limitar o que pode ser acessado e por tratar erros, atrasos e respostas incompletas.
Uma boa ferramenta tem nome e descrição claros, parâmetros estritos, permissões mínimas e retorno fácil de verificar. Registre o que foi solicitado e executado conforme as políticas de privacidade, e peça confirmação humana para operações de alto impacto. Assim, o modelo ajuda a escolher o próximo passo sem receber autoridade ilimitada sobre o sistema.