~/tools / Tool Definition Checker
Tool Definition Checker — Confira definições de ferramentas e funções para OpenAI, Anthropic e Gemini
Confira as definições de ferramentas (funções) que você envia para OpenAI, Anthropic ou Gemini com o formato documentado de cada API: nomes, descrições, esquemas de parâmetros, strict mode e exemplos de entrada. Encontre os erros antes que a requisição falhe. Nada sai do seu navegador.
Regras conferidas com a documentação em 2026-10-23.
Documentação: OpenAI / Anthropic / Referência da API do Gemini
Não verificado: se um modelo aceita a ferramenta, os detalhes do uso de ferramentas strict na Anthropic, as ferramentas que a própria Anthropic fornece e as regras que a documentação não afirma.
Tudo roda no seu navegador. As definições não são enviadas.
O uso de ferramentas (tool use), também chamado de chamada de função (function calling), permite que um modelo peça ao seu código para executar uma função. Você descreve cada função em uma definição JSON, e as três grandes APIs esperam formatos diferentes: a OpenAI Chat Completions aninha a função dentro de um objeto function, a OpenAI Responses mantém os campos em um único nível, a Anthropic usa name e input_schema, e o Gemini usa functionDeclarations. As regras de nome também variam. Esta ferramenta lê a definição que você colar, descobre para qual API ela foi escrita e a confere com o que a documentação de cada fornecedor diz: o nome, a descrição, o esquema de parâmetros, o strict mode e, no caso da Anthropic, se cada exemplo de entrada corresponde ao esquema. Ela também avisa quando um nome que funciona em uma API seria rejeitado por outra. As regras foram conferidas com a documentação na data indicada abaixo da ferramenta.
Casos de uso
- Conferir uma definição de ferramenta antes de incluí-la em uma requisição, para que um nome ruim ou um formato errado não faça a chamada falhar
- Descobrir por que o strict mode rejeita o esquema de uma função
- Migrar uma ferramenta de um fornecedor para outro e ver o que precisa mudar
Como usar
- Cole uma definição de ferramenta, uma lista de ferramentas ou um corpo de requisição que tenha uma lista tools, ou carregue o exemplo.
- Veja em qual API cada ferramenta foi reconhecida e, depois, a lista de achados. Corrigir significa que a documentação diz que será rejeitada ou é inválida, Verificar significa que vale a pena dar uma olhada, e Observação é só informação.
- Corrija as definições e cole de novo. Para problemas de strict mode, o Structured Output Schema Checker mostra cada um em detalhe.
FAQ
Como ele sabe para qual API uma definição foi escrita?
Pelo formato. Uma definição com input_schema é lida como Anthropic. Uma com type function e um objeto function aninhado é lida como OpenAI Chat Completions, e uma com type function e os campos no nível superior é lida como OpenAI Responses. Um objeto com functionDeclarations, ou com name, description e parameters, é lido como Gemini. O resultado mostra como cada ferramenta foi reconhecida.
Quais são as regras de nome?
A OpenAI documenta letras, números, sublinhados e hifens, com até 64 caracteres. A Anthropic documenta letras, números, sublinhados e hifens, com até 128 caracteres. O Gemini documenta letras, números, sublinhados, dois-pontos, pontos e hifens, com até 128 caracteres. Um nome válido em uma API pode ser rejeitado por outra, e a ferramenta avisa quando isso acontece.
Por que ele confere o esquema de novo quando strict é true?
A OpenAI diz que o strict mode exige additionalProperties igual a false em todo objeto e todas as propriedades listadas em required, com os valores opcionais escritos como um tipo que também aceita null. Um esquema que quebra essas regras é rejeitado. A ferramenta conta os problemas e mostra onde está o primeiro.
O que ele confere em input_examples?
A Anthropic diz que cada exemplo precisa ser válido segundo o input_schema da ferramenta e que um exemplo inválido retorna um erro 400. A ferramenta confere cada exemplo com o esquema e diz qual deles falha.
O que ele não confere?
Se um determinado modelo aceita a ferramenta, os detalhes do uso de ferramentas strict na Anthropic, as ferramentas que a própria Anthropic fornece e qualquer coisa que a documentação não afirme. Ele não chama nenhuma API, então uma definição aprovada ainda pode falhar em uma requisição real.
Minha definição é enviada a um servidor?
Não. A verificação roda no seu navegador.