Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Vastuste salvestamine ja püsivus

Õppetund 6 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Juhi oma andmete eluiga
  2. store: true vs store: false
  3. Salvestatud vastuse kättesaamine
  4. Vastuse kustutamine
  5. Salvestamise kasutusjuhud
  6. Säilitusperiood
  7. Peamised punktid

Juhi oma andmete eluiga

Vastuste API sisaldab sisseehitatud salvestusruumi: parameetriga store: true hoiavad xAI serverid sinu vastuseid 30 päeva. Saad neid igal ajal spetsiaalsete otspunktide abil kätte saada, vaadata ja kustutada.

store: true vs store: false

Salvestatud režiim (store: true)

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

Vastus säilib 30 päeva. Saad:

  • Viidata sellele previous_response_id abil vestluse jätkamiseks
  • Hiljem selle kätte saada päringuga GET /v1/responses/{id}
  • Selle kustutada päringuga DELETE /v1/responses/{id}

Privaatne režiim (store: false)

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

Vastust ei hoita pärast päringu lõppu alles. Saad tulemuse kätte HTTP-vastuses, kuid see muutub seejärel kättesaamatuks. Aheldamine previous_response_id kaudu pole võimalik.

Kasuta store: false tundlike andmete korral või siis, kui sul pole vaja vestlust jätkata.

Salvestatud vastuse kättesaamine

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

API tagastab täieliku vastuse objekti, mis on identne loomise ajal saaduga. See on kasulik:

  • Varasemate suhtluste auditeerimiseks
  • Vestlusajaloo taastamiseks
  • Kulude järelkontrolliks

Pythonis

# Salvestatud vastuse kättesaamine
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")

Vastuse kustutamine

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

Kustutamine on pöördumatu. Kui teised aheldatud vastused viitavad sellele vastusele previous_response_id kaudu, ei ole vastav kontekst enam kättesaadav.

Pythonis

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

Salvestamise kasutusjuhud

Ajalooga vestlusrobot

Luba store: true kõigile päringutele. Kasutaja saab vestlust jätkata isegi pärast brauseri sulgemist, kui hoiad alles viimase response_id.

Tundlike andmete analüüs

Kasuta store: false päringute puhul, mis sisaldavad isiku- või konfidentsiaalseid andmeid. Vastus töödeldakse mälus ja seda ei salvestata püsivalt.

Audit ja vastavus

Hangi salvestatud vastused auditilogide koostamiseks. Kustuta need, kui need pole enam vajalikud, et järgida andmete säilitamise poliitikat.

Säilitusperiood

Salvestatud vastused kustutatakse automaatselt 30 päeva pärast. Seda perioodi ei saa API kaudu pikendada. Kui vajad pikemat ajalugu, salvesta vastused oma andmebaasi.

Peamised punktid

  • store: true säilitab vastuse 30 päevaks – store: false ei jäta midagi alles
  • GET /v1/responses/{id} toob kätte salvestatud vastuse
  • DELETE /v1/responses/{id} kustutab vastuse pöördumatult
  • Aheldamine previous_response_id kaudu eeldab vastuse salvestamist
  • Vastused puhastatakse automaatselt 30 päeva pärast
  • Kasuta store: false tundlike andmete puhul