Sobre esta ferramenta
As saídas estruturadas permitem que um modelo retorne JSON em conformidade com um esquema que você define, em vez de um texto livre que você precisa analisar na esperança de que sirva. Este construtor monta esse esquema campo a campo — nomes, tipos, descrições, indicadores required, enums e objetos ou arrays aninhados — e o exporta exatamente na forma que cada provedor espera: um JSON Schema bruto, os wrappers response_format e function-tool da OpenAI, o input_schema de ferramenta da Anthropic, o responseSchema do Google Gemini, além de definições Zod e Pydantic prontas para colar.
O modo estrito de saída estruturada da OpenAI tem regras que vale a pena conhecer: toda propriedade deve ser listada como required e additionalProperties deve ser false. O construtor as aplica automaticamente nos exports da OpenAI e sinaliza qualquer coisa que as violaria, para que o esquema que você copia funcione de verdade. Cole uma amostra de JSON existente para inferir um esquema inicial e depois refine-o.
Os esquemas são construídos e exportados inteiramente no seu navegador — nada do que você digita é enviado.
Perguntas frequentes
O que são saídas estruturadas e uso de ferramentas?
Ambos pedem que um modelo retorne JSON correspondente a um esquema. As saídas estruturadas restringem a resposta final do modelo a uma forma que você define; a chamada de ferramenta (de função) descreve os argumentos que um modelo pode produzir quando decide chamar uma de suas funções. O formato de esquema subjacente é o mesmo.
Por que o modo estrito da OpenAI exige que todo campo seja required?
O modo estrito garante que a saída seja validada em relação ao seu esquema sem surpresas e, para isso, ele proíbe propriedades opcionais e adicionais. Para tornar um campo efetivamente opcional, declare seu tipo como nullable — uma união com null — mantendo-o na lista required.
Qual é a diferença entre os exports OpenAI, Anthropic e Gemini?
O JSON Schema é em grande parte compartilhado, mas cada provedor o envolve de forma diferente: a OpenAI o aninha sob response_format ou uma function tool com strict: true, a Anthropic o espera como um input_schema de ferramenta e o Gemini usa responseSchema com seu próprio enum de tipos suportados. Esta ferramenta emite o wrapper correto para cada um.
Posso gerar código Zod ou Pydantic?
Sim. Além dos formatos dos provedores, o construtor produz um esquema Zod para TypeScript e um modelo Pydantic para Python, para que você possa validar a resposta no seu próprio código.