Láncolt beszélgetések
Ezen az oldalon
Előzmények kezelése nélküli beszélgetések
A Responses API egyik legnagyobb előnye a previous_response_id segítségével megvalósítható beszélgetés-láncolás. Ahelyett, hogy minden kéréssel elküldenéd a teljes előzményt, csupán az előző válasz azonosítóját (ID) kell megadnod. Az xAI szerver automatikusan helyreállítja a teljes kontextust.
Első kérés
Küldd el a kezdeti promptot. Mentsd el a kapott válasz azonosítóját (resp-xxx).
További kérések
Add meg a `previous_response_id` paramétert az új üzeneted mellett. A szerver újraépíti a kontextust.
Teljes beszélgetés
Láncolj össze annyi üzenetet, amennyire szükséged van. Minden válasz az előzőre hivatkozik.
Teljes Python példa
from openai import OpenAI
client = OpenAI(
api_key="xai-...",
base_url="https://api.x.ai/v1"
)
# 1. kör: Bemutatkozás
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)
# 2. kör: A modell emlékszik a kontextusra
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)
# 3. kör: Mélyebb elemzés
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)
Vedd észre, hogy az első kérés után minden további kérés csak az új üzenetet és az előző válaszra való hivatkozást tartalmazza. Az xAI szerver automatikusan helyreállítja a teljes előzményt.
curl ekvivalens
# 1. kör
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."
}'
# Szerezd meg az azonosítót a válaszból: "id": "resp-abc123"
# 2. kör
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"
}'
Láncolás és utasítások
Az első kérésben meghatározott instructions (rendszer-prompt) a teljes láncolt beszélgetés során érvényben marad. Nem kell újra elküldened őket.
Ha egy láncolt kérésben módosítod az instructions értékét, az új utasítások felülírják az előzőeket ennél a kérésnél és az azt követőknél is.
A láncolás korlátai
- A hivatkozott válasznak léteznie kell a szerveren (vagy
store: truebeállítással, vagy egy friss kérés részeként) - A láncolás felhalmozza a történet tokenjeit – minden kérésért a teljes beszélgetés után számolnak fel díjat
- Nincs korlátozás a körök számára vonatkozóan, de a modell kontextusablaka érvényesül
Főbb megállapítások
- A
previous_response_idlehetővé teszi a beszélgetések láncolását az előzmények újbóli elküldése nélkül - A szerver automatikusan helyreállítja a teljes kontextust
- A rendszerutasítások körönről körre megmaradnak
- Minden körért a felhalmozott teljes előzmény után számítanak fel díjat
- A hivatkozott válasznak tárolva kell lennie a szerveren