Gesprekken koppelen
Op deze pagina
Gesprekken voeren zonder geschiedenisbeheer
Een groot voordeel van de Responses API is het koppelen van gesprekken via previous_response_id. In plaats van bij elk verzoek de volledige geschiedenis opnieuw te verzenden, geeft u eenvoudigweg de ID van het vorige antwoord door. De xAI-server zorgt voor het reconstrueren van de volledige context.
Eerste verzoek
Verstuur uw initiële prompt. Haal de antwoord-ID op (resp-xxx).
Volgende verzoeken
Geef previous_response_id door samen met uw nieuwe bericht. De server reconstrueert de context.
Volledig gesprek
Koppel zoveel berichten als nodig. Elk antwoord verwijst naar het vorige.
Volledig Python-voorbeeld
from openai import OpenAI
client = OpenAI(
api_key="xai-...",
base_url="https://api.x.ai/v1"
)
# Beurt 1: Introductie
response1 = client.responses.create(
model="grok-4.20-0309-reasoning",
instructions="You are a patient and clear math teacher.",
input="Hello, I would like to understand derivatives."
)
print(response1.output[0].content[0].text)
# Beurt 2: Het model onthoudt de context
response2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Can you give me a concrete example?",
previous_response_id=response1.id
)
print(response2.output[0].content[0].text)
# Beurt 3: Verdieping
response3 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="And how do I calculate the derivative of x² + 3x?",
previous_response_id=response2.id
)
print(response3.output[0].content[0].text)
Merk op dat elk verzoek na het eerste alleen het nieuwe bericht en de referentie naar het vorige antwoord bevat. De xAI-server reconstrueert automatisch de volledige geschiedenis.
curl-equivalent
# Beurt 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": "Hello, explain the basics of Python to me."
}'
# Haal de ID op uit het antwoord: "id": "resp-abc123"
# Beurt 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": "How do I write a for loop?",
"previous_response_id": "resp-abc123"
}'
Koppelen en instructies
De instructions (systeemprompt) die in het eerste verzoek zijn gedefinieerd, blijven behouden tijdens het gekoppelde gesprek. U hoeft deze niet te herhalen.
Als u instructions wijzigt in een gekoppeld verzoek, vervangen de nieuwe instructies de vorige voor dat verzoek en alle daaropvolgende verzoeken.
Limieten voor koppelen
- Het geraadpleegde antwoord moet op de server bestaan (hetzij
store: true, hetzij een recent verzoek) - Koppelen bouwt geschiedenistokens op: elk verzoek wordt gef factureerd voor het volledige gesprek
- Er is geen limiet aan het aantal beurten, maar het contextvenster van het model is wel van toepassing
Belangrijkste punten
previous_response_idkoppelt gesprekken zonder de geschiedenis opnieuw te verzenden- De server reconstrueert automatisch de volledige context
- Systeeminstructies blijven van beurt tot beurt behouden
- Elke beurt wordt gefactureerd voor de volledige opgebouwde geschiedenis
- Het geraadpleegde antwoord moet op de server zijn opgeslagen