Ir al contenido principal
Español— Elegir un idioma
Menú

Tipos no compatibles y limitaciones

Lección 3 de 12 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Qué no pueden hacer los esquemas
  2. Las tres restricciones principales
  3. Otras limitaciones que debes conocer
  4. La estrategia: esquema + prompt
  5. Puntos clave

Qué no pueden hacer los esquemas

Comprender los límites de las salidas estructuradas es tan importante como dominar sus capacidades. La API de Grok no admite ciertas restricciones de JSON Schema. Intentar utilizarlas provocará un error o causará un comportamiento inesperado.

Las tres restricciones principales

allOf — composición no permitida

En JSON Schema, la palabra clave allOf combina múltiples subesquemas que un objeto debe satisfacer simultáneamente. La API de Grok no admite esta función.

// NO FUNCIONA
{
  "allOf": [
    { "properties": { "nom": { "type": "string" } } },
    { "properties": { "age": { "type": "number" } } }
  ]
}

Alternativa: utiliza un único objeto con todas las propiedades:

// FUNCIONA
{
  "type": "object",
  "properties": {
    "nom": { "type": "string" },
    "age": { "type": "number" }
  }
}

minLength / maxLength — sin restricciones de longitud de cadena

No puedes obligar al modelo a generar una cadena con una longitud mínima o máxima.

// NO FUNCIONA
{
  "properties": {
    "code": {
      "type": "string",
      "minLength": 3,
      "maxLength": 10
    }
  }
}

Alternativa: especifica la restricción en el prompt en lugar de en el esquema:

messages=[{
    "role": "user",
    "content": "Genera un código de producto de entre 3 y 10 caracteres."
}]

El modelo seguirá la instrucción en la mayoría de los casos, pero no está garantizado como lo estaría una restricción de esquema.

minItems / maxItems — sin restricciones de tamaño de array

No puedes imponer un número mínimo o máximo de elementos en un array.

// NO FUNCIONA
{
  "properties": {
    "tags": {
      "type": "array",
      "items": { "type": "string" },
      "minItems": 1,
      "maxItems": 5
    }
  }
}

Alternativa: utiliza el prompt para guiar al modelo:

messages=[{
    "role": "user",
    "content": "Enumera entre 1 y 5 etiquetas relevantes para este artículo."
}]

Otras limitaciones que debes conocer

Sin patrones regex

La API no admite restricciones pattern en cadenas. No puedes imponer un formato de correo electrónico, UUID o número de teléfono mediante el esquema.

// NO FUNCIONA
{
  "properties": {
    "email": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
    }
  }
}

Sin valores por defecto

La palabra clave default no tiene efecto. Si un campo está en el esquema, el modelo siempre lo rellenará.

Sin condicionales

Las palabras clave de JSON Schema if, then y else no están disponibles.

La estrategia: esquema + prompt

El mejor enfoque combina ambos:

  1. El esquema garantiza la estructura: nombres de campos, tipos, anidamiento
  2. El prompt guía el contenido: longitudes, formatos específicos, reglas de negocio
class Report(BaseModel):
    title: str
    summary: str
    key_points: list[str]
    score: float
    category: str

messages=[{
    "role": "user",
    "content": """Analiza este texto y produce un informe.
    - El resumen debe tener 2-3 frases.
    - Enumera exactamente 5 puntos clave.
    - La puntuación está entre 0 y 10.
    - Categoría entre: positive, negative, neutral."""
}]

El esquema garantiza los tipos y la estructura. El prompt controla los valores y las restricciones de contenido.

Puntos clave

  • allOf, minLength, maxLength, minItems y maxItems no son compatibles
  • Las restricciones pattern, default e if/then/else tampoco son compatibles
  • Utiliza anyOf en lugar de allOf cuando sea posible
  • Traslada las restricciones de contenido al prompt
  • Combinar esquema (estructura) + prompt (contenido) es la estrategia óptima