Blog
#0052 min de lecturaMuestra

La salida estructurada es la mejora de confiabilidad más barata

El texto libre es donde los pipelines de IA se rompen en silencio. Dale al modelo una forma que llenar y valida cada respuesta contra ella.

Entrada de muestra Contenido provisional que muestra el diseño del blog. Reemplázalo antes del lanzamiento.

Un modelo de lenguaje responde feliz en prosa, en Markdown, en JSON a medio terminar o en las tres cosas a la vez. En una ventana de chat está bien. En un pipeline, el siguiente paso es un programa, y los programas no leen entre líneas.

Dale forma a la respuesta

El arreglo es decidir la forma de la salida desde el principio y hacer que el modelo la llene. En Python, un modelo de Pydantic hace el trabajo:

models.py
from pydantic import BaseModel, EmailStr, HttpUrl
class Contact(BaseModel):
email: EmailStr | None
phone: str | None
source_url: HttpUrl

La mayoría de las APIs de modelos ya pueden restringir la generación a un esquema JSON, y librerías como DSPy llevan la misma idea al propio programa. En cualquier caso, el esquema pasa a ser parte del contrato, no una línea esperanzada al final del prompt.

Valida de todas formas

La generación restringida acierta la forma. No puede prometer que el contenido tenga sentido. Así que cada respuesta pasa igual por validación antes de que algo más adelante la vea:

parse.py
from pydantic import ValidationError
def parse(raw: str) -> Contact | None:
try:
return Contact.model_validate_json(raw)
except ValidationError as err:
log_rejected(raw, err) # guárdalo: los rechazos son futuros casos de prueba
return None
Entran respuestas desordenadas; sale una sola forma.

Qué ganas

Una vez que las salidas tienen forma:

  • Los fallos hacen ruido. Una mala respuesta lanza un error en vez de colarse en un reporte.
  • Los tests se vuelven fáciles. Comparas campos, no párrafos.
  • Cambiar de modelo se vuelve más seguro. El contrato se mantiene cuando cambia el modelo detrás.

No es ingenioso, y ese es el punto. La salida estructurada es el paso que convierte una demo en un componente del que otro código puede depender.