Ferramenta

É uma função exposta ao modelo, com nome, descrição e esquema de entrada e saída, que ele pode pedir para executar: consultar disponibilidade, calcular uma tarifa, abrir um chamado, buscar um documento. Ferramentas são o que devolvem exatidão e capacidade de ação ao fluxo generativo. O modelo decide quando chamar; o sistema executa; o resultado volta ao modelo como dado. O modelo nunca executa a ferramenta diretamente. Ele apenas indica que quer usá-la e com quais parâmetros, e o sistema decide se e como executar.

Em Produto, a regra é: menos ferramentas, melhor descritas. A descrição é o que o modelo lê para decidir se usa a ferramenta, então ela precisa ser escrita como instrução: quando usar, quando não usar, o que retorna quando não sabe. Ferramentas com efeito irreversível, como cobrar, enviar ou apagar, exigem aprovação humana ou execução em ambiente de teste. Ferramentas de leitura podem ser livres. Por exemplo, uma ferramenta consultar_contrato recebe um identificador e retorna cobertura, franquia e limites, ou um erro explícito, em no máximo 2 segundos. Esse contrato define o comportamento esperado em todos os casos.

Use ferramenta para qualquer dado ou ação que precisa ser exato ou real. Use skill quando a ferramenta vem acompanhada de contexto, instruções e critérios de qualidade sobre como executar uma tarefa. Use regra ou guardrail quando o que se quer é uma restrição de comportamento, não uma ação. Uma forma simples de diferenciar: ferramenta é uma ação que o modelo pode pedir; skill é um método que o modelo pode seguir; regra é um limite que o modelo não pode cruzar.

'Tool use' em LLMs: Toolformer (Meta, 2023) e function calling (OpenAI, 2023).

Anthropic docs, Tool use; OpenAI Platform docs, Function calling