Tool overview
O que é Gerador de Saída Estruturada?
Gerador de Saída Estruturada é uma ferramenta que ajuda você a inferir JSON Schema a partir de exemplos.
Por que usar Gerador de Saída Estruturada?
Melhora a legibilidade e acelera seu fluxo quando você precisa inferir JSON Schema a partir de exemplos, sem enviar dados a um servidor.
Recursos principais
Privacidade no cliente, resultados instantâneos e cópia com um clique para gerador de Saída Estruturada. Inferir JSON Schema a partir de exemplos
Como usar
Siga estes passos para obter resultados precisos com a ferramenta acima.
- Cole um JSON de exemplo representativo da resposta ou argumentos de ferramenta no painel esquerdo.
- Omita chaves opcionais — só as presentes viram required.
- Ative Strict objects para emitir additionalProperties: false em cada objeto — recomendado para OpenAI.
- Opcionalmente defina um título de Schema para OpenAPI ou registros de ferramentas.
- Revise o JSON Schema draft 2020-12 gerado no painel direito.
- Se um array mostrar items: {}, adicione pelo menos um elemento representativo e regenere.
- Copie o schema para response_format, parâmetros de ferramenta ou sua config de agente.
- Itere o exemplo se os tipos estiverem errados; edite enum ou oneOf manualmente se precisar.
Gerador de Saída Estruturada — guia completo e casos de uso
Guia autoritativo: inferência draft 2020-12, additionalProperties estrito, casos OpenAI e parâmetros de ferramentas, arrays vazios e opcionalidade por omissão.
Guia do gerador de saída estruturada
Este guia explica como inferir JSON Schema draft 2020-12 de exemplos JSON no navegador.
O que o gerador faz
O gerador transforma um exemplo JSON em JSON Schema e pode fechar objetos com additionalProperties: false.
O que você recebe
- JSON Schema draft 2020-12
- O que você recebe: additionalProperties: false
- O que você recebe: required
- O que você recebe: integer / number / null
- O que você recebe: items
- Copie o schema em response_format
Use para inferir um schema
- Use para inferir um schema
- Use para inferir um schema: OpenAI
- Use para inferir um schema: JSON Schema
- Use para inferir um schema: strict
Prefira uma ferramenta relacionada
- Prefira uma ferramenta relacionada: AI Agent Builder
- Prefira uma ferramenta relacionada: MCP Validator
- Prefira uma ferramenta relacionada: LLM Token Counter
Como JSON de exemplo vira tipos de schema
A inferência percorre a árvore JSON; a entrada deve ser JSON estrito.
A inferência percorre a árvore JSON; a entrada deve ser JSON estrito.
| Valor de exemplo | Tipo inferido | Observações |
|---|---|---|
| "ok" | string | O que você recebe |
| 42 | integer | O que você recebe |
| 42.5 | number | O que você recebe |
| true | boolean | O que você recebe |
| null | null | Omita as chaves opcionais de |
| [] | array + items: {} | Arrays vazios não revelam o tipo de items. |
| { "a": 1 } | object | required + additionalProperties: false |
Arrays usam o tipo do primeiro elemento; edite oneOf para tipos mistos.
Passo a passo: exemplo → schema draft 2020-12
Primeiro percurso para um schema pronto para OpenAI.
- Cole um exemplo representativo de JSON.
- Omita as chaves opcionais de required.
- Ative strict additionalProperties: false.
- Revise JSON Schema draft 2020-12.
- Arrays vazios não revelam o tipo de items. items: {}.
- Copie o schema em response_format.
- oneOf, enum.
- Revise OpenAI.
Caso de uso: saídas estruturadas OpenAI
OpenAI: O gerador transforma um exemplo JSON em JSON Schema e pode fechar objetos com additionalProperties: false.
Como esta ferramenta ajuda
- Cole um exemplo representativo de OpenAI JSON.
- Ative strict.
- Copie o schema em response_format.
- Revise OpenAI.
Resultado: JSON Schema, OpenAI.
Caso de uso: parâmetros de ferramentas
O gerador transforma um exemplo JSON em JSON Schema e pode fechar objetos com additionalProperties: false.
Como esta ferramenta ajuda
- Cole um exemplo representativo de tools[].function.parameters.
- Ative strict.
- Copie o schema em tools[].function.parameters.
- Revise JSON Schema.
Resultado: tools[].function.parameters.
Caso de uso: campos opcionais por omissão
O gerador transforma um exemplo JSON em JSON Schema e pode fechar objetos com additionalProperties: false.
Como esta ferramenta ajuda
- Omita as chaves opcionais de required.
- Revise required.
- null.
- Copie o schema em required.
Resultado: required.
Caso de uso: classificador JSON estruturado
O gerador transforma um exemplo JSON em JSON Schema e pode fechar objetos com additionalProperties: false.
Como esta ferramenta ajuda
- Cole um exemplo representativo de JSON.
- Ative strict.
- Copie o schema em JSON Schema.
- enum.
Resultado: JSON Schema, strict.
Modo strict e additionalProperties: false
O modo strict define additionalProperties: false em cada objeto.
- Ative strict.
- Revise JSON Schema.
- O modo strict define additionalProperties: false em cada objeto.
- Revise additionalProperties: false.
Armadilha de array vazio — items: {}
Arrays vazios não revelam o tipo de items.
- Cole um exemplo representativo de items.
- Arrays vazios não revelam o tipo de items.
- oneOf.
- Revise items.
Correção: entrada JSON inválida
JSON.
Por que acontece
Por que acontece
Diagnóstico
Diagnóstico
Correções
- Revise JSON.
- Cole um exemplo representativo de JSON.
- Revise JSON Schema.
Correção: items do array inferidos como {}
items: {}.
Por que acontece
Arrays vazios não revelam o tipo de items.
Diagnóstico
Diagnóstico
Correções
- Cole um exemplo representativo de items.
- Revise JSON Schema.
- Revise items.
oneOf.
Correção: campo opcional marcado required
required.
Por que acontece
Por que acontece
Diagnóstico
Diagnóstico
Correções
- Omita as chaves opcionais de required.
- Revise JSON Schema.
- null.
Boas práticas de inferência
- Primeiro percurso para um schema pronto para OpenAI.
- Ative strict, OpenAI.
- Omita as chaves opcionais de required.
- Cole um exemplo representativo de items.
- enum, oneOf.
- Revise JSON Schema.
- Prefira uma ferramenta relacionada: AI Agent Builder.
Perguntas frequentes
Respostas para problemas comuns e questões de privacidade de dados.
Ferramentas relacionadas
Explore outros utilitários relacionados que complementam esta ferramenta.
Documentação oficial e referências
Especificações e documentação da plataforma para esta utilidade.