Atsakymų saugojimas ir išsaugojimas
Šiame puslapyje
Valdyk savo duomenų gyvavimo trukmę
„Responses“ API turi integruotą saugyklą: nustatęs store: true, xAI serveriai tavo atsakymus saugo 30 dienų. Juos bet kada gali gauti, peržiūrėti arba ištrinti naudodamas specializuotus galinius punktus.
store: true prieš store: false
Saugojimo režimas (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Atsakymas išsaugomas 30 dienų. Gali:
- Nurodyti jį naudodamas
previous_response_id, kad tęstum pokalbį - Vėliau jį gauti su
GET /v1/responses/{id} - Jį ištrinti su
DELETE /v1/responses/{id}
Privatus režimas (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Atsakymas po užklausos nėra išsaugomas. Rezultatą vis tiek gauni HTTP atsakyme, tačiau vėliau jis tampa nepasiekiamas. Grandininis susiejimas naudojant previous_response_id neįmanomas.
Naudok store: false, kai dirbi su jautriais duomenimis arba kai tau nereikia tęsti pokalbio.
Gauti išsaugotą atsakymą
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
API grąžina visą atsakymo objektą, identišką tam, kurį gavai kūrimo metu. Tai naudinga:
- Audituojant ankstesnes sąveikas
- Atkuriant pokalbių istoriją
- Tikrinant išlaidas post factum
Python kalba
# Gauti išsaugotą atsakymą
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")
Ištrinti atsakymą
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Ištrynimas yra negrįžtamas. Jei kiti grandininiai atsakymai nuorodo į šį atsakymą per previous_response_id, atitinkamas kontekstas taps neprieinamas.
Python kalba
client.responses.delete("resp-abc123")
Saugojimo naudojimo atvejai
Pokalbių robotas su istorija
Įjunk store: true visiems prašymams. Naudotojas gali tęsti pokalbį net ir uždarius naršyklę, jei tik saugai paskutinį response_id.
Jautrių duomenų analizė
Naudok store: false prašymams, kuriuose yra asmens arba konfidencialių duomenų. Atsakymas apdorojamas operatyviojoje atmintyje ir neišsaugomas.
Auditas ir atitiktis
Gauk išsaugotus atsakymus, kad sukurtum audito žurnalus. Ištrink juos, kai jie tampa nereikalingi, kad atitiktum duomenų saugojimo politiką.
Saugojimo laikotarpis
Išsaugoti atsakymai automatiškai ištrinami po 30 dienų. Šio laikotarpio pratęsti per API negalima. Jei tau reikia ilgesnės istorijos, išsaugok atsakymus savo duomenų bazėje.
Svarbiausi punktai
store: trueišsaugo atsakymą 30 dienų –store: falsenieko nesaugoGET /v1/responses/{id}gauna išsaugotą atsakymąDELETE /v1/responses/{id}negrįžtamai ištrina atsakymą- Grandininis susiejimas per
previous_response_idreikalauja, kad atsakymas būtų išsaugotas - Atsakymai automatiškai išvalomi po 30 dienų
- Naudok
store: falsejautriems duomenims