Crie a definição de uma ferramenta que um modelo de IA pode chamar, com nome, descrição e parâmetros. Exporte como JSON Schema simples ou nos formatos que as APIs comuns de chamada de ferramentas e os servidores MCP esperam e veja os problemas antes de um modelo tropeçar neles. Roda no seu navegador e é grátis e privado.
Como montar a definição de uma ferramenta
- Dê o Nome da ferramenta e uma Descrição clara.
- Toque em Adicionar parâmetro para cada entrada e defina o nome, o tipo, a descrição e se é obrigatório.
- Toque em Adicionar outra ferramenta para ter mais de uma ou em Remover esta ferramenta para excluir uma. Recomeçar limpa tudo.
- Escolha a saída: JSON Schema, um dos formatos de provedor ou MCP. Ative o Modo estrito (saídas estruturadas) se precisar.
- Toque em Copiar JSON ou Baixar. Copiar argumentos de exemplo dá uma chamada de exemplo.
Já tem uma definição? Cole em JSON a importar e toque em Importar.
Escrevendo ferramentas que os modelos usam bem
Os modelos escolhem uma ferramenta lendo o nome e a descrição dela, então diga com clareza o que ela faz e quando usar, por exemplo “Pesquisa a central de ajuda. Use quando o usuário perguntar como fazer algo no app.” Descreva cada parâmetro, incluindo unidades e formatos, como “data ISO, AAAA-MM-DD”. Use uma lista fixa de valores permitidos sempre que a escolha for limitada e marque como obrigatórios só os campos realmente necessários.
Como os formatos diferem
O esquema dos parâmetros é o mesmo JSON Schema em toda parte; o que muda é o invólucro. Um provedor o aninha em function.parameters, outro o chama de input_schema, outro lista declarações de funções, e os servidores MCP retornam inputSchema. Os modos estritos adicionam regras: toda propriedade precisa ser listada como obrigatória e propriedades extras precisam ser recusadas, então campos opcionais são escritos como permitindo null.
O que as verificações pegam
Nomes que quebram as regras da API, como espaços ou mais de 64 caracteres, nomes duplicados de ferramentas ou parâmetros, valores permitidos que não combinam com o tipo, objetos sem propriedades e descrições ausentes. Os erros impedem uma chamada de API; os avisos são coisas que tendem a fazer um modelo escolher a ferramenta errada ou preencher o valor errado.
Dicas
- Use nomes curtos baseados em verbos, como search_orders ou get_weather, só com letras, números e sublinhados.
- Mantenha pequeno o número de ferramentas. Os modelos escolhem melhor de uma lista curta.
- Dê a cada parâmetro um exemplo na descrição quando o formato não for óbvio.
- Teste o esquema com respostas reais usando a verificação de esquema de respostas de IA.
Quem usa
Desenvolvedores, freelancers que criam assistentes para clientes e estudantes que aprendem como funciona a chamada de ferramentas. Para transformar um objeto JSON de exemplo em tipos para o seu código, veja JSON para tipos.
Perguntas
O que é o modo estrito?
Ele faz o modelo seguir o esquema exatamente. Exige que todas as propriedades estejam listadas como obrigatórias e que propriedades extras sejam recusadas.
Minha definição é enviada?
Não. Ela é montada no seu navegador.
Posso editar uma definição existente?
Sim. Cole na caixa de importação, altere e exporte de novo.