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

Vastausten tallennus ja pysyvyys

Oppitunti 6 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Hallitse datasi elinkaarta
  2. store: true vs store: false
  3. Haetun vastauksen noutaminen
  4. Vastauksen poistaminen
  5. Tallennuksen käyttökohteet
  6. Säilytysaika
  7. Keskeiset asiat

Hallitse datasi elinkaarta

Responses API sisältää sisäänrakennetun tallennustilan: asetuksella store: true xAI-palvelimet säilyttävät vastauksesi 30 päivän ajan. Voit hakea, tarkastella ja poistaa niitä milloin tahansa omien päätepisteidensä avulla.

store: true vs store: false

Tallennustila (store: true)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Write a summary of this project.",
  "store": true
}

Vastaus säilyy 30 päivän ajan. Voit:

  • Viitata siihen parametrilla previous_response_id keskustelun jatkamiseksi
  • Hakea sen myöhemmin komennolla GET /v1/responses/{id}
  • Poistaa sen komennolla DELETE /v1/responses/{id}

Yksityinen tila (store: false)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this confidential data.",
  "store": false
}

Vastausta ei säilytetä pyynnön jälkeen. Saat tuloksen HTTP-vastauksessa, mutta se muuttuu tämän jälkeen saavuttamattomaksi. Ketjutus parametrin previous_response_id avulla ei ole mahdollista.

Käytä asetusta store: false arkaluonteisen datan käsittelyyn tai silloin, kun keskustelua ei tarvitse jatkaa.

Haetun vastauksen noutaminen

curl https://api.x.ai/v1/responses/resp-abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"

API palauttaa täydellisen vastausobjektin, joka on identtinen luontihetkellä saadun kanssa. Tämä on hyödyllistä:

  • Menneiden vuorovaikutusten tarkastamiseen
  • Keskusteluhistorian uudelleenrakentamiseen
  • Kulujen varmentamiseen jälkikäteen

Pythonissa

# Haetun vastauksen noutaminen
stored = client.responses.retrieve("resp-abc123")
print(stored.output[0].content[0].text)
print(f"Cost: {stored.usage.cost_in_nano_usd / 1e9:.6f} USD")

Vastauksen poistaminen

curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"

Poistaminen on pysyvää. Jos muut ketjutetut vastaukset viittaavat tähän vastaukseen parametrin previous_response_id kautta, vastaava konteksti ei ole enää saatavilla.

Pythonissa

client.responses.delete("resp-abc123")

Tallennuksen käyttökohteet

Chatbot historialla

Ota käyttöön store: true kaikille pyynnöille. Käyttäjä voi jatkaa keskusteluaan jopa selaimen sulkemisen jälkeen, kunhan säilytät viimeisimmän response_id:n.

Arkaluonteisen datan analyysi

Käytä asetusta store: false pyynnöille, jotka sisältävät henkilökohtaista tai luottamuksellista dataa. Vastaus käsitellään muistissa eikä sitä tallenneta pysyvästi.

Tarkastus ja vaatimustenmukaisuus

Hae tallennettuja vastauksia tarkastuslokien rakentamista varten. Poista ne, kun niitä ei enää tarvita, noudattaaksesi säilytyskäytäntöjä.

Säilytysaika

Tallennetut vastaukset poistetaan automaattisesti 30 päivän kuluttua. Et voi pidentää tätä aikaa API:n kautta. Jos tarvitset pidempää historiaa, tallenna vastaukset omaan tietokantaasi.

Keskeiset asiat

  • store: true säilyttää vastauksen 30 päivää – store: false ei säilytä mitään
  • GET /v1/responses/{id} hakee tallennetun vastauksen
  • DELETE /v1/responses/{id} poistaa vastauksen pysyvästi
  • Ketjutus parametrin previous_response_id avulla vaatii, että vastaus on tallennettu
  • Vastaukset tyhjennetään automaattisesti 30 päivän jälkeen
  • Käytä asetusta store: false arkaluonteiselle datalle