GuíasDesarrollo de IA

Tutorial: obtener un JSON fiable de un modelo de IA

Por el equipo de Banzai LabsActualizado el 2 min de lectura

{ "nom": … "total": … "date": …}Si no, se repiteUn esquema impuesto, una salida comprobada
Entra un texto libre, sale un JSON conforme al esquema y el código lo valida.

1. Describir el resultado esperado

import { z } from 'zod';

const Factura = z.object({
  proveedor: z.string(),
  total: z.number(),
  fecha: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
});

2. Restringir el modelo

De lo más flexible a lo más estricto
  1. 1Instrucción y ejemploEl formato descrito en el prompt, con un ejemplo.
  2. 2Herramienta forzadaUna herramienta cuyos parámetros siguen el esquema y que el modelo debe llamar.
  3. 3Salida estructuradaEl modo del proveedor que obliga a la salida a seguir el esquema, cuando existe.

3. Validar, siempre

const parsed = Factura.safeParse(JSON.parse(textoDelModelo));
if (!parsed.success) {
  // devolver parsed.error.issues al modelo y volver a pedir, una o dos veces
} else {
  guardar(parsed.data);
}

Las trampas

  • Los números escritos como texto («1.234,50 €»): indica el formato esperado.
  • Los campos ausentes del documento: permite null en lugar de forzar una invención.
  • Las fechas: impón un formato único.

Ver también las alucinaciones y la llamada a herramientas.

Preguntas frecuentes

¿Basta con pedir «responde en JSON» en el prompt?
A menudo, no siempre. Los mecanismos de salida estructurada o de herramienta forzada hacen los desvíos mucho más raros. La validación en el código sigue siendo obligatoria.
¿Qué hacer si falla la validación?
Devolver al modelo el error exacto y volver a pedir, una o dos veces. Más allá, apartar el caso para una persona.
¿Un JSON válido es necesariamente correcto?
No. Un JSON bien formado puede contener un valor falso. Los valores críticos se cotejan con tus datos.

Para leer después

Todas las guías