Salt la conținutul principal
Română— Alege o limbă
Meniu

Înlănțuirea conversațiilor

Lecția 5 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Conversații fără gestionarea istoricului
  2. Exemplu complet în Python
  3. Echivalent în curl
  4. Înlănțuirea și instrucțiunile
  5. Limitele înlănțuirii
  6. Puncte cheie

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.

1

Prima cerere

Trimiteți promptul inițial. Recuperați ID-ul răspunsului (resp-xxx).

2

Cererile ulterioare

Transmiteți previous_response_id împreună cu noul mesaj. Serverul reconstruiește contextul.

3

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_id permite î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