Qué comprobar antes de aceptar una respuesta estructurada como válida

Primero verifica la entrega

Comprueba el estado que expone la API o el canal utilizado. Diferencia una respuesta completa de una salida interrumpida, un rechazo del proveedor y un error técnico. La forma de detectarlos depende de la integración: revisa su documentación y no busques únicamente un texto que parezca JSON. Una recuperación parcial puede servir para diagnóstico, pero no debe dar por terminada una tarea que exige todos sus elementos.

Después valida el contrato

Usa un validador independiente para tipos, campos exigidos, estados y propiedades que no permites. Conserva el error de validación sin volcar datos sensibles innecesarios. Las salidas estructuradas del proveedor reducen ciertos defectos de formato bajo sus condiciones; no sustituyen las comprobaciones del consumidor. Si cambias el esquema, prueba las respuestas de versiones anteriores y decide cómo rechazar o convertir las incompatibles.

Aplica reglas que cruzan campos

Confirma que cliente y documento corresponden al mismo expediente; que fecha inicial y final tienen sentido; que cantidad y unidad forman una combinación permitida. Define estas reglas de manera comprobable. Un identificador con el tipo correcto puede señalar un registro ajeno. La lectura autorizada de una ficha tampoco concede permiso para modificarla: valida el ámbito de acceso y la autorización de la acción en el sistema de destino.

Exige respaldo antes del uso

Contrasta los campos determinantes con la fuente y revisa si el estado declarado permite continuar. OpenAI advierte que una salida estructurada todavía puede contener errores. Como prueba negativa, introduce una respuesta perfectamente formada con un importe falso y confirma que se bloquea. Añade otra con todos los valores correctos pero un estado incoherente. Conserva motivos de rechazo separados para saber si necesitas corregir transporte, formato, datos o reglas, sin reintentar a ciegas cada fallo.

Fuentes y documentación

• OpenAI · Structured Outputs — El formato estructurado no evita errores de contenido; comprueba las condiciones del proveedor.
• JSON Schema · Objetos — Presencia, tipos y propiedades adicionales; no valida la verdad de un dato.