Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Stóráil agus Marthanacht Freagraí

Ceacht 6 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Rialú a dhéanamh ar shaolré do chuid sonraí
  2. store: true vs store: false
  3. Freagra stóráilte a aisghabháil
  4. Freagra a scriosadh
  5. Cásanna úsáide stórála
  6. Tréimhse coinneála
  7. Príomhphointí

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_id chun 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: true an freagra a bhuanú ar feadh 30 lá — ní choinníonn store: false aon 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: false le haghaidh sonraí íogaire