Reparar la salida JSON de un LLM: manejar el casi-JSON de la IA

Los LLM suelen devolver JSON envuelto en vallas ```json, con comillas simples, literales de Python o claves sin comillas. Repara la sintaxis, valida de forma estricta y luego deriva tipos de TypeScript de la salida limpia.

Cuando llegas aquí

Un LLM devolvió JSON que JSON.parse rechaza. Los culpables más comunes son las vallas de código markdown que envuelven el documento, las comillas simples, las claves sin comillas, los literales de Python como True/None y los objetos serializados. Repara la sintaxis y luego valida de forma estricta antes de entregar el resultado a tu app.

Reparar casi-JSON de los LLMValidar el JSON limpio de forma estrictaAbrir el JSON limpio como un árbolGenerar interfaces de TypeScript desde el JSON

El flujo de reparación para la salida de un LLM

Ejecuta primero la reparación: tolera vallas, comillas simples, claves sin comillas, literales de Python y comas finales. Valida en segundo lugar para confirmar que el texto limpio va y vuelve. Usa el árbol limpio para derivar tipos o alimentar tu app.

Reparar la salida JSON de un LLM (guía)Corregir claves sin comillas en JSONCorregir comillas simples en JSONEscapar JSON como un literal de cadenaReparar JSON roto en JavaScriptReparar JSON en línea (guía completa)

Una vez que analiza, deriva tipos

Después de que la salida del LLM se valide, deriva interfaces de TypeScript o un JSON Schema para que la siguiente llamada tenga un contrato contra el que validar. Esa es la diferencia entre reparar una vez y reparar para siempre.

JSON a interfaces de TypeScriptConversor de JSON a objeto de JavaScript (guía)Comillas simples vs literal de objeto de JavaScriptCarácter de escape no válido en JSONUnexpected end of JSON inputAcceso a la fuente en JSON.parse: números sin pérdida y salida de LLM más segura

Lo que viene en los estándares

Dos próximas propuestas de JavaScript importan para los flujos de JSON de los LLM: el acceso a la fuente en JSON.parse (leer errores con el texto original junto al valor) y JSON.parseImmutable. Reducen la cantidad de código de reparación a medida que vive en cada app.

Acceso a la fuente en JSON.parse (Baseline 2025)En profundidad: el acceso a la fuente en JSON.parse en la prácticaJSON.parseImmutable (Etapa 2)Filtración de datos en un formateador de JSON en línea: no pegues secretos

Ruta recomendada

Pega la salida del LLM, límpiala, tipifícala.

    1. Herramienta: / — pega la salida de la IA, haz clic en «Reparar y formatear».
    1. Guía: /guides/repair-llm-json-output — maneja vallas, comillas, literales de Python.
    1. Blog: /blog/repair-broken-json-in-javascript — el mismo flujo en código.
    1. Referencia: /news/json-parse-source-access-baseline-2025 — qué soporte estándar está llegando.
Abrir Arreglar JSONComparar cambios de JSON

Guías de reparación de JSON

Centros temáticos

  1. Errores de análisis de JSON: lee el mensaje, ve directo a la solución
  2. Reparar JSON no válido: de «qué falla» a un archivo limpio
  3. Formateador, validador y visor de JSON: elige la herramienta correcta
  4. Privacidad: herramientas JSON que no salen de tu navegador
  5. Interoperabilidad de JSON: YAML, CSV, XML, JWT, Schema

Guías específicas

  1. Cómo decodificar cadenas Base64 (y payloads JWT)
  2. Codificación URL: codifica parámetros de consulta y rutas
  3. Convertir YAML a JSON (y evitar errores de indentación)
  4. Convertir JSON a CSV: aplanar un arreglo de objetos
  5. Convertir JSON a XML: raíz, atributos y arreglos
  6. Escapar JSON como literal de cadena (y decodificar JSON con doble codificación)
  7. Arreglar comas finales en JSON
  8. Arreglar comillas simples en JSON
  9. Arreglar claves sin comillas en JSON
  10. Reparar JSON generado por LLM
  11. Arreglar el error de parse JSON: Expected Property Name
  12. JSON frente a literal de objeto JavaScript
  13. Valida el JSON antes de las solicitudes API
  14. Formateador JSON frente a JSON Repair
  15. Arreglar errores JSON Unexpected Token
  16. Convertidor JSON a objeto JavaScript