Vastausten tallennus ja pysyvyys
Tällä sivulla
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_idkeskustelun 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: truesäilyttää vastauksen 30 päivää –store: falseei säilytä mitäänGET /v1/responses/{id}hakee tallennetun vastauksenDELETE /v1/responses/{id}poistaa vastauksen pysyvästi- Ketjutus parametrin
previous_response_idavulla vaatii, että vastaus on tallennettu - Vastaukset tyhjennetään automaattisesti 30 päivän jälkeen
- Käytä asetusta
store: falsearkaluonteiselle datalle