Schema da ferramenta

É a descrição formal de uma ferramenta: seu nome, uma descrição em linguagem natural, os parâmetros de entrada com tipos e obrigatoriedade, e o formato da saída. O modelo lê o schema para decidir se usa a ferramenta e como preencher os parâmetros. O sistema usa o schema para validar a chamada antes de executá-la. Um schema ambíguo gera chamadas erradas; um schema preciso reduz erros sem precisar trocar de modelo.

Em Produto, o schema deve ser tratado como uma interface pública: versionado, testado e com exemplos. É a forma como o modelo “entende” o que a ferramenta faz. Nomes de parâmetros autoexplicativos, como “data_devolucao_iso” em vez de “dt”, melhoram muito a taxa de preenchimento correto. A descrição deve dizer quando usar e quando não usar a ferramenta. Toda chamada precisa ser validada antes de executar, porque o modelo pode inventar um parâmetro ou passar um valor inválido. A validação é o que impede que um erro do modelo vire uma ação errada no sistema.

Use schema da ferramenta para a interface técnica exposta ao modelo. Use contrato de capacidade para o bloco funcional inteiro, incluindo dono, critérios de aceite e comportamento em falha. Use validação de saída para conferir o que o modelo retornou, e não apenas o que ele pediu. Uma forma simples de diferenciar: o schema diz como chamar a ferramenta; o contrato diz o que a capacidade promete; a validação garante que o pedido está correto.

JSON Schema aplicado a function calling (OpenAI, 2023); primitiva central do Model Context Protocol.

OpenAI Platform docs, Function calling; Model Context Protocol specification, Tools