Gerador de JSON Schema para Tool Calling

Tool calling (ou function calling) é o mecanismo que permite LLMs como Claude, GPT e Gemini executarem funções externas. O formato do schema segue o JSON Schema draft 7.

Uso com Anthropic Claude

import Anthropic from '@anthropic-ai/sdk';
const client = new Anthropic();

const response = await client.messages.create({
  model: 'claude-sonnet-4-5',
  max_tokens: 1024,
  tools: [{
    name: 'get_weather',
    description: '...',
    input_schema: { type: 'object', properties: {...}, required: [...] }
  }],
  messages: [{ role: 'user', content: 'Como está o clima?' }]
});

Boas práticas

1. Description rica: A AI decide QUANDO chamar a tool baseado na description. Seja explícito sobre "quando usar" e "quando não usar"
2. Parâmetros mínimos: Menos parâmetros = menos chance de erro
3. Use enums quando há valores discretos conhecidos
4. Campos required: Marque só o essencial

Tags

schema, json, tool-calling, function-calling, anthropic, openai, agent