Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Keskusteluketjut

Oppitunti 5 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Keskustelut ilman historian hallintaa
  2. Täydellinen Python-esimerkki
  3. Vastaava curl-komento
  4. Ketjutus ja ohjeistukset
  5. Ketjutuksen rajoitukset
  6. Keskeiset asiat

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.

1

Ensimmäinen pyyntö

Lähetä ensimmäinen kehotteesi. Tallenna saamasi vastauksen tunniste (resp-xxx).

2

Myöhemmät pyynnöt

Välitä uusi viestisi yhdessä parametrin previous_response_id kanssa. Palvelin rakentaa kontekstin uudelleen.

3

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: true tai 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_id ketjuttaa 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