Salida estructurada: respuestas de IA en un formato fiable
Una salida estructurada es una respuesta de un modelo de IA generada en un formato impuesto, casi siempre un objeto JSON que sigue un esquema definido de antemano. El objetivo es que su programa pueda leer la respuesta sin apaños ni errores de formato.
Datos a 22 de octubre de 2026
Lo esencial en cifras
| Nivel | Intermedio |
|---|
Cómo funciona en la práctica
Sin restricciones, un modelo de lenguaje escribe texto libre. Aunque su prompt diga «responde en JSON», puede añadir una frase de introducción, olvidar un campo o dejar una llave sin cerrar, y su código falla.
Con una salida estructurada, usted pasa un esquema a través de la API. El proveedor limita entonces la generación para que cada token producido siga siendo compatible con ese esquema. Anthropic lo llama decodificación restringida; la gramática del esquema se compila en la primera petición, lo que añade algo de latencia a esa primera llamada. El mismo mecanismo puede aplicarse a los argumentos de la llamada a herramientas en modo estricto.
Un ejemplo concreto
Una gestoría recibe cientos de facturas en PDF. Pide al modelo que extraiga de cada una un objeto de este tipo: proveedor (texto), fecha (texto en formato AAAA-MM-DD), importe_total (número), moneda (un valor entre EUR, USD y GBP). Gracias a la salida estructurada, cada respuesta tiene exactamente esos cuatro campos y puede pasar directamente a la hoja de cálculo. Aun así, conviene comprobar por muestreo que los importes extraídos son correctos.
Para redactar una consigna clara que acompañe al esquema, nuestro generador de prompts puede ayudarle.
Por qué importa
Es lo que convierte un chatbot en una pieza de software fiable: extracción de datos, clasificación automática, rellenado de formularios, intercambios entre varios agentes de IA. Un formato garantizado también facilita añadir controles automáticos después.
Errores e ideas equivocadas frecuentes
- «Formato garantizado = contenido exacto.» El modelo puede seguir alucinando un valor, solo que en el formato correcto.
- «El esquema se respeta el 100 % de las veces.» Anthropic señala dos excepciones: un rechazo del modelo o una respuesta cortada por el límite de tokens pueden producir una salida no conforme. Su código debe gestionarlas.
- «Basta con pedir JSON en el prompt.» Suele funcionar, pero sin garantía. Las salidas estructuradas imponen el formato durante la generación.
- «Cualquier esquema sirve.» Solo se admite una parte de JSON Schema: consulte la documentación de su proveedor.
Términos relacionados
- Llamada a herramientas (function calling) · Capacidad de un modelo de IA para pedir que se ejecute una función externa con argumentos precisos y luego usar el resultado.
- API · Interfaz que permite a un programa enviar solicitudes a un servicio, por ejemplo un modelo de IA, y recibir sus respuestas.
- Alucinación · Respuesta de una IA que parece segura y verosímil pero es falsa o inventada: una cifra, una cita, una fuente o una referencia.
- Ingeniería de prompts · Práctica de redactar, probar y mejorar las instrucciones que se dan a una IA para obtener respuestas más fiables y útiles.
- Prompt de sistema · Instrucciones de fondo que recibe el modelo antes de la conversación (rol, tono, reglas) y que se aplican a todas sus respuestas.
- Agente de IA · IA que no solo responde: planifica y encadena acciones con herramientas para alcanzar un objetivo que usted le fija.
Para probar
Todo el glosario
Preguntas frecuentes
¿Qué diferencia hay con el simple modo JSON?
La documentación de OpenAI lo distingue: el modo JSON solo garantiza un JSON válido, mientras que las salidas estructuradas garantizan además que se respete el esquema proporcionado, con los campos y tipos correctos.
¿Desde cuándo existe esta función?
Las técnicas de generación restringida ya existían en proyectos de investigación y bibliotecas. Entre las grandes API, OpenAI lanzó Structured Outputs el 6 de agosto de 2024, y Anthropic ofrece también salidas estructuradas en su API de Claude.
¿La respuesta es necesariamente correcta?
No. Se garantiza el formato, no el contenido. La documentación de Anthropic lo deja claro: un JSON perfectamente válido puede contener un valor inexacto. Por eso hay que verificar siempre los datos importantes.
¿Se aceptan todos los esquemas JSON?
No. Los proveedores solo admiten una parte del estándar JSON Schema. Anthropic indica, por ejemplo, que no admite esquemas recursivos ni algunas restricciones numéricas.
Fuentes de los datos
Datos a 22 de octubre de 2026
Señalar un error
¿Una cifra, una fecha o un dato le parece incorrecto? Díganoslo: verificamos cada aviso.