Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Ħażna u Persistenza tar-Risposti

Lezzjoni 6 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Ikkontrolla t-tul tal-ħajja tad-data tiegħek
  2. store: true vs store: false
  3. Irrikupera risposta maħżuna
  4. Ħassar risposta
  5. Każijiet ta’ użu tal-ħażna
  6. Perjodu ta’ żamma
  7. Punti Ewlenin

Ikkontrolla t-tul tal-ħajja tad-data tiegħek

L-API tar-Risposti tinkludi ħażna integrata: b’store: true, is-servers ta’ xAI jżommu r-risposti tiegħek għal 30 jum. Tista’ tirrikuprahom, tarahom, u tħassarhom fi kwalunkwe ħin billi tuża endpoints dedikati.

store: true vs store: false

Modalità maħżuna (store: true)

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

Ir-risposta tibqa’ għal 30 jum. Tista’:

  • Tirreferiha b’previous_response_id biex tkompli l-konversazzjoni
  • Tirrikuperaha aktar tard b’GET /v1/responses/{id}
  • Tħassarha b’DELETE /v1/responses/{id}

Modalità privata (store: false)

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

Ir-risposta ma tinżammx wara t-talba. Int xorta tirċievi r-riżultat fir-risposta HTTP, iżda ssir inaċċessibbli wara. Il-katina permezz ta’ previous_response_id mhix possibbli.

Uża store: false għal data sensittiva jew meta ma jkollokx bżonn tkompli l-konversazzjoni.

Irrikupera risposta maħżuna

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

L-API tirritorna l-oġġett sħiħ tar-risposta, identiku għal dak li rċevejt waqt il-ħolqien. Dan huwa utli għal:

  • Awditjar ta’ interazzjonijiet preċedenti
  • Rikostruzzjoni ta’ storja ta’ konversazzjoni
  • Verifika tal-ispejjeż a posteriori

F’Python

# Irrikupera risposta maħżuna
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")

Ħassar risposta

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

It-tħassir huwa permanenti. Jekk risposti oħra kkatinati jirreferu din ir-risposta permezz ta’ previous_response_id, il-kuntest korrispondenti ma jkunx disponibbli aktar.

F’Python

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

Każijiet ta’ użu tal-ħażna

Chatbot bl-istorja

Ippermetti store: true għat-talbiet kollha. L-utent jista’ jkompli l-konversazzjoni tiegħu anke wara li jagħlaq il-browser, sakemm iżżomm l-aħħar response_id.

Analiżi ta’ data sensittiva

Uża store: false għal talbiet li fihom data personali jew kunfidenzjali. Ir-risposta tiġi pproċessata fil-memorja u ma tinħażinx.

Awditjar u konformità

Irkupra r-risposti maħżuna biex tibni reġistri ta’ awditjar. Ħassarhom meta ma jkunux meħtieġa aktar biex tikkonforma mal-politiki ta’ żamma.

Perjodu ta’ żamma

Ir-risposti maħżuna jitħassru awtomatikament wara 30 jum. Ma tistx testendi dan il-perjodu permezz tal-API. Jekk teħtieġ storja itwal, salva r-risposti fil-bażi tad-data tiegħek stess.

Punti Ewlenin

  • store: true jippersisti r-risposta għal 30 jum — store: false ma jżomm xejn
  • GET /v1/responses/{id} jirkupra risposta maħżuna
  • DELETE /v1/responses/{id} iħassar risposta b’mod permanenti
  • Il-katina permezz ta’ previous_response_id teħtieġ li r-risposta tkun maħżuna
  • Ir-risposti jitneħħew awtomatikament wara 30 jum
  • Uża store: false għal data sensittiva