Reparar a saída JSON de um LLM: lidar com o quase-JSON da IA

Os LLMs frequentemente retornam JSON envolto em cercas ```json, com aspas simples, literais do Python ou chaves sem aspas. Repare a sintaxe, valide de forma rigorosa e depois derive tipos do TypeScript da saída limpa.

Quando você chega aqui

Um LLM retornou JSON que o JSON.parse rejeita. Os culpados mais comuns são as cercas de código markdown que envolvem o documento, as aspas simples, as chaves sem aspas, os literais do Python como True/None e os objetos serializados. Repare a sintaxe e depois valide de forma rigorosa antes de entregar o resultado ao seu app.

Reparar quase-JSON dos LLMsValidar o JSON limpo de forma rigorosaAbrir o JSON limpo como uma árvoreGerar interfaces TypeScript a partir do JSON

O fluxo de reparo para a saída de um LLM

Execute o reparo primeiro — ele tolera cercas, aspas simples, chaves sem aspas, literais do Python e vírgulas finais. Valide em segundo lugar para confirmar que o texto limpo faz a ida e volta. Use a árvore limpa para derivar tipos ou alimentar o seu app.

Reparar a saída JSON de um LLM (guia)Corrigir chaves sem aspas em JSONCorrigir aspas simples em JSONFazer escape de JSON como literal de stringReparar JSON quebrado em JavaScriptReparar JSON online (guia completo)

Assim que analisar, derive tipos

Depois que a saída do LLM for validada, derive interfaces TypeScript ou um JSON Schema para que a próxima chamada tenha um contrato a validar. Essa é a diferença entre reparar uma vez e reparar para sempre.

JSON para interfaces TypeScriptConversor de JSON para objeto JavaScript (guia)Aspas simples vs literal de objeto JavaScriptCaractere de escape inválido em JSONUnexpected end of JSON inputAcesso à fonte no JSON.parse: números sem perda e saída de LLM mais segura

O que vem nos padrões

Duas próximas propostas do JavaScript importam para os fluxos de JSON dos LLMs: o acesso à fonte no JSON.parse (ler erros com o texto original ao lado do valor) e o JSON.parseImmutable. Elas reduzem a quantidade de código de reparo sob medida que vive em cada app.

Acesso à fonte no JSON.parse (Baseline 2025)Aprofundamento: o acesso à fonte no JSON.parse na práticaJSON.parseImmutable (Stage 2)Vazamento de dados em formatador de JSON online — não cole segredos

Caminho recomendado

Cole a saída do LLM, limpe-a, tipifique-a.

    1. Ferramenta: / — cole a saída da IA, clique em «Reparar e formatar».
    1. Guia: /guides/repair-llm-json-output — lida com cercas, aspas, literais do Python.
    1. Blog: /blog/repair-broken-json-in-javascript — o mesmo fluxo em código.
    1. Referência: /news/json-parse-source-access-baseline-2025 — qual suporte padrão está chegando.
Abrir Corrigir JSONComparar alterações de JSON

Guias de reparação de JSON

Núcleos temáticos

  1. Erros de análise de JSON: leia a mensagem, vá direto à correção
  2. Reparar JSON inválido: de «o que está errado» a um arquivo limpo
  3. Formatador, validador e visualizador de JSON: escolha a ferramenta certa
  4. Privacidade: ferramentas JSON que não saem do seu navegador
  5. Interoperabilidade de JSON: YAML, CSV, XML, JWT, Schema

Guias específicos

  1. Como decodificar strings Base64 (e payloads JWT)
  2. Codificação URL: codifique parâmetros de consulta e caminhos
  3. Converter YAML para JSON (e evitar erros de indentação)
  4. Converter JSON para CSV: achatar um array de objetos
  5. Converter JSON para XML: raiz, atributos e arrays
  6. Escapar JSON como literal de string (e decodificar JSON com codificação dupla)
  7. Corrigir vírgulas finais em JSON
  8. Corrigir aspas simples em JSON
  9. Corrigir chaves sem aspas em JSON
  10. Reparar JSON gerado por LLM
  11. Corrigir o erro de parse JSON: Expected Property Name
  12. JSON x literal de objeto JavaScript
  13. Valide o JSON antes das requisições de API
  14. Formatador JSON x JSON Repair
  15. Corrigir erros JSON Unexpected Token
  16. Conversor de JSON para objeto JavaScript