JSON garantizado por esquema
En esta página
Por qué las salidas estructuradas lo cambian todo
Cuando utilizas un modelo de lenguaje en producción, necesitas respuestas que el código pueda consumir. No texto libre, ni JSON aproximado, sino JSON garantizado conforme a un esquema que tú defines. Eso es exactamente lo que te ofrecen las salidas estructuradas de la API de Grok.
El principio es sencillo: proporcionas un esquema JSON al modelo y la API garantiza que la respuesta seguirá esta estructura exactamente. Sin análisis improvisados, sin expresiones regulares frágiles, ni bloques try/catch para gestionar casos en los que el modelo se inventa un formato.
Cómo funciona
Las salidas estructuradas se basan en un mecanismo de restricción aplicado durante la generación del texto. En cada token producido, el modelo tiene la restricción de generar únicamente tokens compatibles con el esquema proporcionado. El resultado: un JSON que siempre es válido y siempre conforme.
Veamos un ejemplo concreto. Quieres extraer información de contacto de un correo electrónico:
from pydantic import BaseModel
class Contact(BaseModel):
nom: str
email: str
entreprise: str
telephone: str | None
# La respuesta SIEMPRE será un objeto Contact válido
Sin salidas estructuradas, el modelo podría devolver el teléfono como "tel", "phone" o "numéro". Con un esquema, el campo se llamará siempre telephone y su valor será siempre una cadena o null.
Disponibilidad
Las salidas estructuradas son compatibles con todos los modelos de lenguaje de xAI: Grok 4.5, Grok 4.3, las variantes grok-4.20 y versiones posteriores. Independientemente del modelo que utilices, la función está disponible sin coste adicional ni configuración extra.
Sin frente a con salidas estructuradas
Esto es lo que obtienes sin y con esta función:
Sin salidas estructuradas:
- El modelo puede devolver texto libre, JSON parcial o un formato inesperado
- Debes analizar manualmente y gestionar errores
- Los nombres de los campos pueden variar de una solicitud a otra
- Tu canal de procesamiento se rompe en cuanto el modelo cambia de formato
Con salidas estructuradas:
- El JSON es siempre sintácticamente válido
- La estructura coincide exactamente con el esquema proporcionado
- Los tipos se respetan (cadena, número, booleano, etc.)
- Tu código puede consumir la respuesta directamente
Dos enfoques disponibles
La API de Grok ofrece dos métodos para utilizar salidas estructuradas:
parse(): Método automático que devuelve directamente un objeto tipado. Ideal para la mayoría de los casos.response_format: Método manual que devuelve una cadena JSON. Ofrece más control, pero el análisis corre de tu cuenta.
Descubrirás estos dos métodos en detalle en las próximas lecciones.
Puntos clave
- Las salidas estructuradas garantizan un JSON conforme a tu esquema en cada llamada
- La restricción se aplica durante la generación, no después
- Todos los modelos de lenguaje de xAI son compatibles con esta función
- Hay dos métodos disponibles:
parse()(automático) yresponse_format(manual) - Esta es la base de cualquier canal de producción fiable con la API de Grok