Atbilžu glabāšana un noturība
Šajā lapā
Kontrolē savu datu dzīves ciklu
Atbilžu API ietver iebūvētu krātuvi: ar store: true xAI serveri saglabā tavas atbildes 30 dienas. Tu vari tās jebkurā brīdī izgūt, apskatīt un dzēst, izmantojot specializētus galapunktus.
store: true pret store: false
Glabāšanas režīms (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Atbilde tiek saglabāta 30 dienas. Tu vari:
- Atsaukties uz to, izmantojot
previous_response_id, lai turpinātu sarunu - Vēlāk to izgūt ar
GET /v1/responses/{id} - Dzēst to ar
DELETE /v1/responses/{id}
Privātais režīms (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Atbilde netiek saglabāta pēc pieprasījuma izpildes. Tu joprojām saņem rezultātu HTTP atbildē, taču pēc tam tā kļūst nepieejama. Ķēdes veidošana, izmantojot previous_response_id, nav iespējama.
Izmanto store: false, lai apstrādātu sensitīvus datus vai gadījumos, kad nav nepieciešams turpināt sarunu.
Izgūt saglabātu atbildi
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
API atgriež pilnu atbildes objektu, kas ir identisks tam, kurš tika saņemts izveides brīdī. Tas ir noderīgi:
- Iepriekšējo mijiedarbību auditēšanai
- Sarunu vēstures atjaunošanai
- Izmaksu pārbaudei pēc fakta
Python valodā
# Izgūt saglabātu atbildi
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")
Dzēst atbildi
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Dzēšana ir neatgriezeniska. Ja citas ķēdē savienotas atbildes atsaucas uz šo atbildi, izmantojot previous_response_id, attiecīgais konteksts vairs nebūs pieejams.
Python valodā
client.responses.delete("resp-abc123")
Krātuves lietojuma gadījumi
Čatbots ar vēsturi
Aktivizē store: true visiem pieprasījumiem. Lietotājs var atsākt sarunu pat pēc pārlūka aizvēršanas, kamēr vien tu glabā pēdējo response_id.
Sensitīvu datu analīze
Izmanto store: false pieprasījumiem, kas satur personiskus vai konfidenciālus datus. Atbilde tiek apstrādāta operatīvajā atmiņā un netiek saglabāta.
Audits un atbilstība
Izgūt saglabātās atbildes, lai izveidotu auditēšanas žurnālus. Dzēs tās, kad tās vairs nav nepieciešamas, lai ievērotu datu glabāšanas politiku.
Glabāšanas periods
Saglabātās atbildes tiek automātiski dzēstas pēc 30 dienām. Tu nevari pagarināt šo periodu, izmantojot API. Ja tev ir nepieciešama ilgāka vēsture, saglabā atbildes savā datubāzē.
Galvenās atziņas
store: truesaglabā atbildi 30 dienas —store: falseneko nesaglabāGET /v1/responses/{id}izgūst saglabātu atbildiDELETE /v1/responses/{id}neatgriezeniski dzēš atbildi- Ķēdes veidošana, izmantojot
previous_response_id, prasa, lai atbilde tiktu saglabāta - Atbildes tiek automātiski iztīrītas pēc 30 dienām
- Izmanto
store: false, lai apstrādātu sensitīvus datus