Stóráil agus Marthanacht Freagraí
Ar an leathanach seo
Rialú a dhéanamh ar shaolré do chuid sonraí
Tá stóráil ionsuite san API Freagraí: le store: true, coimeádann freastalaithe xAI do chuid freagraí ar feadh 30 lá. Is féidir leat iad a aisghabháil, a fheiceáil, agus a scriosadh ag am ar bith ag baint úsáide as críochphointí tiomnaithe.
store: true vs store: false
Mód stóráilte (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Maireann an freagra ar feadh 30 lá. Is féidir leat:
- Tagairt a dhéanamh dó le
previous_response_idchun an comhrá a leanúint - É a aisghabháil níos déanaí le
GET /v1/responses/{id} - É a scriosadh le
DELETE /v1/responses/{id}
Mód príobháideach (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Ní choinnítear an freagra tar éis an iarratais. Faigheann tú an toradh sa fhreagra HTTP fós, ach éiríonn sé dodhéanta ina dhiaidh sin. Níl slabhrú trí previous_response_id indéanta.
Úsáid store: false le haghaidh sonraí íogaire nó nuair nach gá duit an comhrá a leanúint.
Freagra stóráilte a aisghabháil
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Tugann an API an oibiacht freagra iomlán ar ais, atá comhionann leis an gceann a fuarthas le linn na cruthaithe. Tá sé seo úsáideach do:
- Iniúchadh a dhéanamh ar idirghníomhaíochtaí roimhe seo
- Stair comhrá a athchruthú
- Costais a fhíorú i ndiaidh an fhíric
I bPython
# Retrieve a stored response
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")
Freagra a scriosadh
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Tá an scriosadh buan. Má tá freagraí slabhraithe eile ag tagairt don fhreagra seo trí previous_response_id, ní bheidh an comhthéacs comhfhreagrach ar fáil a thuilleadh.
I bPython
client.responses.delete("resp-abc123")
Cásanna úsáide stórála
Chatbot le stair
Cumasaigh store: true do gach iarratas. Is féidir leis an úsáideoir a gcomhrá a aththosú fiú tar éis an brabhsálaí a dhúnadh, fad is a choinníonn tú an response_id deireanach.
Anailís ar shonraí íogaire
Úsáid store: false d’iarratais ina bhfuil sonraí pearsanta nó rúnda. Déantar an freagra a phróiseáil sa chuimhne agus ní dhéantar é a bhuanú.
Iniúchadh agus comhlíonadh
Aisghabh freagraí stóráilte chun logaí iniúchta a thógáil. Scrios iad nuair nach bhfuil gá leo a thuilleadh chun beartais coinneála a chomhlíonadh.
Tréimhse coinneála
Scriostar freagraí stóráilte go huathoibríoch tar éis 30 lá. Ní féidir leat an tréimhse seo a shíneadh tríd an API. Má theastaíonn stair níos faide uait, sábháil na freagraí i do bhunachar sonraí féin.
Príomhphointí
- Déanann
store: truean freagra a bhuanú ar feadh 30 lá — ní choinníonnstore: falseaon rud - Aisghabhann
GET /v1/responses/{id}freagra stóráilte - Scriosann
DELETE /v1/responses/{id}freagra go buan - Teastaíonn go mbeadh an freagra stóráilte le haghaidh slabhrú trí
previous_response_id - Glantar freagraí go huathoibríoch tar éis 30 lá
- Úsáid
store: falsele haghaidh sonraí íogaire