Keskusteluketjut
Tällä sivulla
Keskustelut ilman historian hallintaa
Responses API:n suurin etu on mahdollisuus ketjuttaa keskusteluja käyttämällä parametria previous_response_id. Sen sijaan, että lähettäisit koko keskusteluhistorian uudelleen jokaisella pyynnöllä, välität vain edellisen vastauksen tunnisteen. xAI-palvelin hoitaa koko kontekstin uudelleenrakentamisen.
Ensimmäinen pyyntö
Lähetä ensimmäinen kehotteesi. Tallenna saamasi vastauksen tunniste (resp-xxx).
Myöhemmät pyynnöt
Välitä uusi viestisi yhdessä parametrin previous_response_id kanssa. Palvelin rakentaa kontekstin uudelleen.
Koko keskustelu
Ketjuta niin monta viestiä kuin tarvitset. Jokainen vastaus viittaa edelliseen.
Täydellinen Python-esimerkki
from openai import OpenAI
client = OpenAI(
api_key="xai-...",
base_url="https://api.x.ai/v1"
)
# Kierros 1: Esittely
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)
# Kierros 2: Malli muistaa kontekstin
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)
# Kierros 3: Syventäminen
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)
Huomaa, että ensimmäisen jälkeen jokainen pyyntö sisältää vain uuden viestin ja viittauksen edelliseen vastaukseen. xAI-palvelin rakentaa koko historian automaattisesti uudelleen.
Vastaava curl-komento
# Kierros 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": "Hello, explain the basics of Python to me."
}'
# Nouda tunniste vastauksesta: "id": "resp-abc123"
# Kierros 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": "How do I write a for loop?",
"previous_response_id": "resp-abc123"
}'
Ketjutus ja ohjeistukset
Ensimmäisessä pyynnössä määritetyt instructions (järjestelmäkehotus) säilyvät koko ketjutetun keskustelun ajan. Sinun ei tarvitse toistaa niitä.
Jos muutat parametria instructions ketjutetussa pyynnössä, uudet ohjeet korvaavat edelliset kyseistä ja sitä seuraavia pyyntöjä varten.
Ketjutuksen rajoitukset
- Viitatun vastauksen on oltava olemassa palvelimella (joko
store: truetai tuore pyyntö) - Ketjutus kerryttää historiatokeneita – jokaisesta pyynnöstä veloitetaan koko keskustelu
- Kierrosten määrälle ei ole rajoitusta, mutta mallin konteksti-ikkuna asettaa rajan
Keskeiset asiat
previous_response_idketjuttaa keskustelut ilman historian uudelleenlähetystä- Palvelin rakentaa koko kontekstin automaattisesti
- Järjestelmäohjeet säilyvät kierroksesta toiseen
- Jokaisesta kierroksesta veloitetaan koko kertynyt historia
- Viitatun vastauksen on täytynyt tallentua palvelimelle