Ħażna u Persistenza tar-Risposti
F'din il-paġna
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_idbiex 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: truejippersisti r-risposta għal 30 jum —store: falsema jżomm xejnGET /v1/responses/{id}jirkupra risposta maħżunaDELETE /v1/responses/{id}iħassar risposta b’mod permanenti- Il-katina permezz ta’
previous_response_idteħtieġ li r-risposta tkun maħżuna - Ir-risposti jitneħħew awtomatikament wara 30 jum
- Uża
store: falsegħal data sensittiva