Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Ahelvestlused

Õppetund 5 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Vestlused ilma ajaloo haldamiseta
  2. Täielik Pythoni näide
  3. curl-i samaväärne käsk
  4. Aheldamine ja juhised
  5. Aheldamise piirangud
  6. Peamised punktid

Vestlused ilma ajaloo haldamiseta

Responses API peamine eelis on võimalus aheldada vestlusi kasutades parameetrit previous_response_id. Selle asemel, et saadaksid iga päringuga kogu vestlusajaloo uuesti, edastad lihtsalt eelmise vastuse ID. xAI server hoolitseb ise täieliku konteksti taastamise eest.

1

Esimene päring

Saada oma algne sisend. Salvesta saadud vastuse ID (nt resp-xxx).

2

Järgnevad päringud

Lisa oma uuele sõnumile parameeter previous_response_id. Server taastab konteksti automaatselt.

3

Täielik vestlus

Ahelda nii palju sõnumeid kui vaja. Iga vastus viitab eelmisele.

Täielik Pythoni näide

from openai import OpenAI

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

# Voor 1: Sissejuhatus
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    instructions="Sa oled kannatlik ja selge matemaatikaõpetaja.",
    input="Tere, ma sooviksin mõista tuletisi."
)
print(response1.output[0].content[0].text)

# Voor 2: Mudel mäletab konteksti
response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Kas saad tuua konkreetse näite?",
    previous_response_id=response1.id
)
print(response2.output[0].content[0].text)

# Voor 3: Süvitsi minek
response3 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Ja kuidas ma arvutan tuletise avaldisele x² + 3x?",
    previous_response_id=response2.id
)
print(response3.output[0].content[0].text)

Pane tähele, et iga päring pärast esimest sisaldab ainult uut sõnumit ja viidet eelmisele vastusele. xAI server taastab kogu ajaloo automaatselt.

curl-i samaväärne käsk

# Voor 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": "Tere, selgita mulle Pythoni aluseid."
  }'
# Hangi ID vastusest: "id": "resp-abc123"

# Voor 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": "Kuidas kirjutada for-tsüklit?",
    "previous_response_id": "resp-abc123"
  }'

Aheldamine ja juhised

Esimeses päringus määratud instructions (süsteemne viip) kehtivad kogu ahelvestluse vältel. Sul pole vaja neid korrata.

Kui muudad instructions parameetrit aheldatud päringus, asendavad uued juhised eelmisi selle ja järgnevate päringute jaoks.

Aheldamise piirangud

  • Viidatud vastus peab serveris eksisteerima (kas store: true või hiljutine päring)
  • Aheldamine kogub ajaloo tokeneid – iga päringu eest tasutakse kogu vestluse ulatuses
  • Voorude arvule pole piirangut, kuid kehtib mudeli kontekstiakna suurus

Peamised punktid

  • previous_response_id aheldab vestlusi ilma ajaloo uuesti saatmiseta
  • Server taastab automaatselt täieliku konteksti
  • Süsteemsed juhised püsivad voorust vooru
  • Iga vooru eest tasutakse kogu kogunenud ajaloo ulatuses
  • Viidatud vastus peab olema serveris salvestatud