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

Recuperar el razonamiento cifrado con include

Lección 5 de 12 Actualizado el 28 de julio de 2026 Desarrollador
En esta página
  1. Acceder al razonamiento interno de los modelos de razonamiento de xAI
  2. El parámetro include
  3. Estructura de la respuesta
  4. Sin include: no hay razonamiento en la respuesta
  5. Cuándo usar include
  6. Almacenar el razonamiento cifrado
  7. Puntos clave

Acceder al razonamiento interno de los modelos de razonamiento de xAI

Los modelos de razonamiento recientes de xAI (familias grok-4.5 y grok-4.20) generan un razonamiento interno que no puedes leer en texto plano. Sin embargo, xAI te permite recuperar este razonamiento en forma cifrada mediante el parámetro include. Este mecanismo habilita usos avanzados, especialmente la reutilización del razonamiento en solicitudes posteriores.

El parámetro include

Para recuperar el contenido del razonamiento cifrado, añade "reasoning.encrypted_content" al array include en tu solicitud a la API de Responses:

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze the algorithmic complexity of merge sort.",
    include=["reasoning.encrypted_content"]
)

Estructura de la respuesta

La respuesta contiene el razonamiento cifrado en un formato específico. Este contenido es un bloque de datos codificado que puedes almacenar, pero no interpretar. Su estructura interna es opaca por diseño.

# Iterar sobre los elementos de la respuesta
for item in response.output:
    if item.type == "reasoning":
        # Contenido del razonamiento cifrado
        encrypted = item.encrypted_content
        print(f"Encrypted reasoning size: {len(encrypted)} characters")
    elif item.type == "message":
        # Respuesta final del modelo
        print(f"Response: {item.content[0].text}")

Sin include: no hay razonamiento en la respuesta

Si no incluyes "reasoning.encrypted_content" en el parámetro include, la respuesta contiene únicamente el resultado final. El razonamiento se produce en el servidor, pero no se devuelve ningún rastro:

# Sin include: solo se devuelve la respuesta final
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze the algorithmic complexity of merge sort."
)
# response.output contiene solo el mensaje, sin razonamiento

Los tokens de razonamiento se cuentan y facturan igualmente, incluso sin include. La diferencia es que no recibes el contenido cifrado para su reutilización posterior.

Cuándo usar include

Recuperar el razonamiento cifrado tiene un coste: respuestas más grandes y mayor consumo de ancho de banda. Por tanto, usa include con un propósito concreto, no por defecto. El caso de uso principal es la conversación multi-turno: si planeas continuar el intercambio, reinyectar el razonamiento del turno anterior preserva la continuidad del pensamiento del modelo. Esto distingue una conversación que progresa de una serie de preguntas independientes. La caché de pensamiento (thought cache) es la extensión empresarial: almacenar el razonamiento de una solicitud para reutilizarlo en solicitudes similares evita que el modelo vuelva a calcularlo todo. Quedan dos casos de uso de gobernanza: la auditoría, cuando el cumplimiento normativo exige un rastro completo de cada respuesta producida, y la depuración con el soporte de xAI, que solicitará el razonamiento completo para analizar comportamientos inesperados.

Almacenar el razonamiento cifrado

Puedes almacenar el contenido cifrado como cualquier cadena de texto. En una base de datos, basta con un campo TEXT o JSONB:

import json

# Extraer y almacenar el razonamiento cifrado
reasoning_data = None
for item in response.output:
    if item.type == "reasoning":
        reasoning_data = item.encrypted_content

# Guardar junto con la respuesta
record = {
    "question": "Analyze the complexity of merge sort.",
    "response": response.output[-1].content[0].text,
    "encrypted_reasoning": reasoning_data,
    "model": "grok-4.20-0309-reasoning",
    "timestamp": "2026-04-03T10:00:00Z"
}

Puntos clave

  • El parámetro include=["reasoning.encrypted_content"] recupera el razonamiento cifrado de los modelos de razonamiento de xAI
  • Sin include, el razonamiento se produce pero no se devuelve (los tokens se facturan igual)
  • El contenido cifrado es un bloque opaco que no puedes leer en texto plano
  • Puedes almacenar y reutilizar este contenido en solicitudes posteriores (en la siguiente lección)
  • Usa include solo si tienes un uso específico para el razonamiento cifrado