AI / LLM Dev Tools

Verificar esquema de saída estruturada

Cole o JSON Schema ou o conteúdo de parameters e selecione o destino. Os diagnósticos mostram o caminho e a regra que precisam de revisão.

Esquema de saída estruturada

JSON Schema

Relatório de validação

Cole um JSON Schema para começar.

Entradas e referências são processadas neste navegador, sem envio de dados de validação nem download de referências remotas.

Cole o esquema em si. Para funções, use apenas o objeto dentro de parameters.

Regras conferidas em 2026-09-15. Regras oficiais

Pré-validação local: não garante aceitação pela API nem suporte por um modelo específico.

Cole um JSON Schema para começar.

Um esquema de saída estruturada pode estar correto num validador genérico e ainda ser recusado por um provedor de modelos. Esta pré-validação separa a estrutura do esquema das exigências do perfil escolhido. O resultado ajuda a decidir se basta corrigir a sintaxe ou se o contrato de dados precisa mudar.

A validação de schemas para respostas estruturadas exige atenção ao destino. Um JSON Schema para LLM com campos opcionais pode precisar de outra representação no OpenAI strict. Isso também acontece numa chamada de função. Compare OpenAI e Gemini preservando a fonte e a data das regras usadas no relatório.

Por que revisar um esquema de saída estruturada?

Separar estrutura válida e regras do provedor

Propriedades opcionais e chaves extras podem fazer sentido num contrato comum. Um esquema de saída estruturada para OpenAI strict tem exigências adicionais. A ferramenta mostra o resultado do metaesquema e os diagnósticos do destino separadamente. Cada apontamento inclui um caminho e uma orientação para revisar a definição afetada.

Uma árvore de esquema passa numa verificação geral, enquanto outra marca dois ramos pendentes.

Comparar sem reescrever sua definição

Ao mudar de OpenAI para Gemini, a ferramenta recalcula os diagnósticos e mantém o texto original. Ela não adiciona required nem exclui palavras-chave desconhecidas para produzir um resultado favorável. Você pode primeiro analisar o impacto da sugestão no código que recebe os dados e só depois alterar o contrato.

Um esquema inalterado segue para dois perfis de destino, com marcações de diagnóstico diferentes.

Escolher o fragmento e usar o relatório atual

01

Extraia o conteúdo de parameters

No perfil de função OpenAI, cole somente o objeto dentro de parameters. O nome da função, strict e a requisição completa ficam no código de integração. O perfil identifica a finalidade do esquema no relatório, mas não confere o objeto externo, não chama o modelo e não executa a função.

02

Compare os dois exemplos

O exemplo válido contém um campo obrigatório que aceita null. O exemplo com problemas deixa de declarar condições de objeto exigidas pelo OpenAI. Troque depois para Gemini e veja quais apontamentos dependem do destino. Toda substituição mostra uma prévia do conteúdo e da quantidade de caracteres afetados antes de aplicar.

03

Exporte após a última alteração

A verificação automática espera 350 ms depois da edição. Desative-a para usar o botão ou Ctrl/Cmd + Enter. Mudar a entrada ou o perfil bloqueia imediatamente a exportação do relatório antigo. Desfazer restaura a fonte, o destino e o resultado anterior juntos, mantendo a revisão ligada ao conteúdo correto.

Diagnósticos que ajudam a revisar a integração

Verificação da estrutura do esquema

O metaesquema 2020-12 incluído verifica o formato e o tipo dos valores das palavras-chave. O parser rejeita chaves duplicadas e números que seriam arredondados pelo JavaScript. Comentários, vírgulas finais e blocos Markdown continuam sendo erros de sintaxe; a entrada não é reparada em silêncio.

Caminhos e referências locais

Os diagnósticos usam JSON Pointer, incluindo nomes com barra ou til. As referências locais precisam apontar para posições de esquema existentes. Uma propriedade chamada allOf é tratada como nome, não como composição. Da mesma forma, valores literais de enum e default não viram regras durante a inspeção.

Cobertura sem promessas implícitas

Os dois perfis OpenAI cobrem strict sem ajuste fino. Gemini usa o subconjunto JSON Schema conferido na documentação. Palavras-chave e formatos sem confirmação ficam marcados para revisão. Esse aviso mostra uma lacuna da verificação; não declara suporte nem afirma que a API vai recusar aquela regra.

Relatório completo em JSON

Copie ou baixe o perfil, a data das regras, o resultado da estrutura, contagens e códigos de diagnóstico. Listas longas mostram primeiro 50 itens e podem ser expandidas. A exportação inclui todos os diagnósticos do relatório, mesmo quando a tela ainda mostra apenas o primeiro grupo.

O que a pré-validação consegue estabelecer

Não é um teste de API
As regras foram conferidas em 2026-09-15. Permissões da conta, endpoints, normalização pelo SDK, recusas e versões específicas de modelos exigem um teste real. Não há perfis para OpenAI com ajuste fino, Anthropic, funções Gemini ou proxies de terceiros. Um resultado local sem problemas não certifica essas condições.
Um dialeto e referências locais
A estrutura é verificada segundo 2020-12. Uma versão antiga declarada explicitamente é apontada, sem migração automática. Referências remotas e âncoras nomeadas não são resolvidas. Definições recursivas são inspecionadas de forma finita, sem expandir toda resposta possível nem comprovar seu custo de complexidade no servidor.
Limites de processamento separados
A entrada aceita até 500000 caracteres, 50000 nós analisados e 40 níveis JSON. O worker para após cinco segundos; mais de 1000 diagnósticos interrompe a verificação sem um sucesso parcial. Esses limites do navegador são separados dos orçamentos OpenAI para propriedades, aninhamento, enumerações e strings.
Nenhuma alteração automática de significado
Adicionar required, permitir null ou proibir chaves extras muda o contrato. A ferramenta fornece apenas sugestões. Aceitar null não significa que a chave pode faltar; se há enum, revise também sua lista. Avalie essas decisões com o código consumidor antes de editar a definição e executar outra verificação.
Os valores retornados precisam de validação
Esta página inspeciona o esquema enviado ao modelo, não a resposta gerada. Ela não infere definições a partir de amostras, não produz respostas e não conserta JSON inválido. Depois da chamada real, valide os valores contra o contrato e as regras de negócio, pois tipos corretos não garantem conteúdo correto.

Dúvidas sobre esquema de saída estruturada

Como verificar um esquema antes de enviá-lo à API do provedor?

Comece pela sintaxe e pela estrutura, selecione o perfil correto e leia os diagnósticos por caminho. Confira também os avisos de regras não cobertas. Termine com uma chamada ao endpoint e ao modelo que serão usados: a verificação local antecipa problemas comuns, mas não comprova a aceitação da requisição.

Por que o OpenAI strict exige todos os campos em required?

O modo estrito restringe a forma do objeto gerado, exigindo as chaves declaradas. Um valor desconhecido pode ser null quando isso faz parte do contrato. Caso o campo tenha enum, a lista também precisa permitir null. Omitir uma chave e retornar uma chave obrigatória com valor null são casos diferentes.

Os formatos de OpenAI, Anthropic e Gemini são intercambiáveis?

Eles compartilham conceitos de JSON Schema, mas diferem nas regras aceitas e no objeto externo da requisição. Aqui há perfis OpenAI strict e saída Gemini; Anthropic não é verificado. Um relatório de um destino não aprova os demais, e o código de integração ainda deve escolher o campo correto da API.

Posso colar um exemplo JSON em vez de um esquema completo?

Uma amostra não define quais campos podem faltar, se chaves extras são permitidas ou quais valores são válidos. É necessário um esquema com tipos e restrições. Você pode partir do exemplo incluído, mas deve adaptar as condições ao contrato real e ao comportamento esperado pela aplicação que recebe os dados.

Qual é a diferença entre saída estruturada e uso de ferramentas?

A saída estruturada determina o formato da resposta final do modelo. O uso de ferramentas produz argumentos para uma função que a aplicação pode executar. Os perfis OpenAI desta página verificam as condições comuns do esquema strict. O perfil de função recebe somente parameters e não valida nem executa a ferramenta completa.

Encontrou um caso não coberto?

Volte à definição com um caminho concreto

Retome o esquema de saída estruturada com o destino correto e revise o primeiro diagnóstico. Antes de mudar required, null ou propriedades extras, confira como o código consumidor interpreta esses casos e mantenha uma referência do contrato original.