Encadenar conversaciones
En esta página
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.
Primera petición
Envía tu indicación inicial. Recupera el ID de la respuesta (resp-xxx).
Peticiones posteriores
Pasa previous_response_id junto con tu nuevo mensaje. El servidor reconstruye el contexto.
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: trueo 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_idpermite 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