Ahelvestlused
Sellel lehel
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.
Esimene päring
Saada oma algne sisend. Salvesta saadud vastuse ID (nt resp-xxx).
Järgnevad päringud
Lisa oma uuele sõnumile parameeter previous_response_id. Server taastab konteksti automaatselt.
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: truevõ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_idaheldab 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