GuíasDesarrollo de IA
Tutorial: obtener un JSON fiable de un modelo de IA
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
- 1Instrucción y ejemploEl formato descrito en el prompt, con un ejemplo.
- 2Herramienta forzadaUna herramienta cuyos parámetros siguen el esquema y que el modelo debe llamar.
- 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
nullen 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.