Înlănțuirea conversațiilor
Pe această pagină
Conversații fără gestionarea istoricului
Un avantaj major al API-ului Responses este posibilitatea de a înlănțui conversațiile prin intermediul parametrului previous_response_id. În loc să retrimiteți întregul istoric la fiecare cerere, transmiteți simplu ID-ul răspunsului anterior. Serverul xAI se ocupă de reconstrucția contextului complet.
Prima cerere
Trimiteți promptul inițial. Recuperați ID-ul răspunsului (resp-xxx).
Cererile ulterioare
Transmiteți previous_response_id împreună cu noul mesaj. Serverul reconstruiește contextul.
Conversație completă
Înlănțuiți câte mesaje este necesar. Fiecare răspuns face referire la cel anterior.
Exemplu complet în Python
from openai import OpenAI
client = OpenAI(
api_key="xai-...",
base_url="https://api.x.ai/v1"
)
# Runda 1: Introducere
response1 = client.responses.create(
model="grok-4.20-0309-reasoning",
instructions="Ești un profesor de matematică răbdător și clar.",
input="Salut, aș dori să înțeleg derivatele."
)
print(response1.output[0].content[0].text)
# Runda 2: Modelul își amintește contextul
response2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Îmi poți da un exemplu concret?",
previous_response_id=response1.id
)
print(response2.output[0].content[0].text)
# Runda 3: Aprofundare
response3 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Și cum calculez derivata lui x² + 3x?",
previous_response_id=response2.id
)
print(response3.output[0].content[0].text)
Observați că fiecare cerere, după prima, conține doar noul mesaj și referința către răspunsul anterior. Serverul xAI reconstruiește automat întregul istoric.
Echivalent în curl
# Runda 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": "Salut, explică-mi bazele Python."
}'
# Recuperați ID-ul din răspuns: "id": "resp-abc123"
# Runda 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": "Cum scriu o buclă for?",
"previous_response_id": "resp-abc123"
}'
Înlănțuirea și instrucțiunile
Instrucțiunile (instructions sau promptul de sistem) definite în prima cerere persistă pe tot parcursul conversației înlănțuite. Nu este nevoie să le repetați.
Dacă modificați instructions într-o cerere înlănțuită, noile instrucțiuni le înlocuiesc pe cele anterioare pentru acea cerere și pentru cele următoare.
Limitele înlănțuirii
- Răspunsul de referință trebuie să existe pe server (fie
store: true, fie o cerere recentă) - Înlănțuirea acumulează tokeni de istoric – fiecare cerere este taxată pentru întreaga conversație
- Nu există o limită a numărului de runde, dar se aplică fereastra de context a modelului
Puncte cheie
previous_response_idpermite înlănțuirea conversațiilor fără retransmiterea istoricului- Serverul reconstruiește automat contextul complet
- Instrucțiunile de sistem persistă de la o rundă la alta
- Fiecare rundă este taxată pentru întregul istoric acumulat
- Răspunsul de referință trebuie să fi fost stocat pe server