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

Encadenar conversaciones

Lección 5 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Conversaciones sin gestionar el historial
  2. Ejemplo completo en Python
  3. Equivalente en curl
  4. Encadenamiento e instrucciones
  5. Límites del encadenamiento
  6. Puntos clave

Conversaciones sin gestionar el historial

Una gran ventaja de la API de Responses es la posibilidad de encadenar conversaciones mediante previous_response_id. En lugar de reenviar todo el historial en cada petición, basta con pasar el ID de la respuesta anterior. El servidor de xAI se encarga de reconstruir el contexto completo.

1

Primera petición

Envía tu indicación inicial. Recupera el ID de la respuesta (resp-xxx).

2

Peticiones posteriores

Pasa previous_response_id junto con tu nuevo mensaje. El servidor reconstruye el contexto.

3

Conversación completa

Encadena tantos mensajes como necesites. Cada respuesta apunta a la anterior.

Ejemplo completo en Python

from openai import OpenAI

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

# Turno 1: Introducción
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    instructions="Eres un profesor de matemáticas paciente y claro.",
    input="Hola, me gustaría entender las derivadas."
)
print(response1.output[0].content[0].text)

# Turno 2: El modelo recuerda el contexto
response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="¿Puedes darme un ejemplo concreto?",
    previous_response_id=response1.id
)
print(response2.output[0].content[0].text)

# Turno 3: Profundización
response3 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="¿Y cómo calculo la derivada de x² + 3x?",
    previous_response_id=response2.id
)
print(response3.output[0].content[0].text)

Observa que cada petición, salvo la primera, contiene únicamente el nuevo mensaje y la referencia a la respuesta anterior. El servidor de xAI reconstruye automáticamente todo el historial.

Equivalente en curl

# Turno 1
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-reasoning",
    "input": "Hola, explícame los fundamentos de Python."
  }'
# Recupera el ID de la respuesta: "id": "resp-abc123"

# Turno 2
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-reasoning",
    "input": "¿Cómo escribo un bucle for?",
    "previous_response_id": "resp-abc123"
  }'

Encadenamiento e instrucciones

Las instructions (indicación del sistema) definidas en la primera petición persisten durante toda la conversación encadenada. No hace falta repetirlas.

Si modificas instructions en una petición encadenada, las nuevas instrucciones sustituyen a las anteriores para esa petición y para las siguientes.

Límites del encadenamiento

  • La respuesta de referencia debe existir en el servidor (ya sea con store: true o por ser una petición reciente)
  • El encadenamiento acumula tokens de historial: cada petición se cobra sobre toda la conversación
  • No hay límite en el número de turnos, pero se aplica la ventana de contexto del modelo

Puntos clave

  • previous_response_id permite encadenar conversaciones sin reenviar el historial
  • El servidor reconstruye automáticamente el contexto completo
  • Las instrucciones del sistema persisten de un turno a otro
  • Cada turno se cobra sobre todo el historial acumulado
  • La respuesta de referencia debe haberse almacenado en el servidor