Válaszok tárolása és megőrzése
Ezen az oldalon
Az adataid élettartamának szabályozása
A Responses API beépített tárolási funkcióval rendelkezik: a store: true beállítással az xAI szerverei 30 napig megőrzik a válaszaidat. Ezeket dedikált végpontokon keresztül bármikor lekérheted, megtekintheted vagy törölheted.
store: true vs store: false
Tárolt mód (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
A válasz 30 napig megmarad. Lehetőséged van:
- Hivatkozni rá a
previous_response_idsegítségével a beszélgetés folytatásához - Később lekérni a
GET /v1/responses/{id}végponttal - Törölni a
DELETE /v1/responses/{id}végponttal
Privát mód (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
A rendszer a kérés után nem őrzi meg a választ. Bár az eredményt megkapod a HTTP-válaszban, azt követően elérhetetlenné válik. A previous_response_id segítségével történő láncolás ilyenkor nem lehetséges.
A store: false beállítást érzékeny adatok esetén alkalmazd, vagy amikor nincs szükséged a beszélgetés folytatására.
Tárolt válasz lekérése
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Az API a teljes válaszobjektumot adja vissza, amely megegyezik a létrehozáskor kapottal. Ez hasznos:
- A korábbi interakciók auditálásához
- Beszélgetési előzmények újjáépítéséhez
- Utólagos költségek ellenőrzéséhez
Pythonban
# Tárolt válasz lekérése
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")
Válasz törlése
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
A törlés végleges. Ha más, láncolt válaszok a previous_response_id segítségével hivatkoznak erre a válaszra, a hozzájuk tartozó kontextus többé nem lesz elérhető.
Pythonban
client.responses.delete("resp-abc123")
Tárolási felhasználási esetek
Előzményekkel rendelkező chatbot
Engedélyezd a store: true beállítást minden kéréshez. A felhasználó akkor is folytathatja a beszélgetést, ha bezárta a böngészőt, feltéve, hogy megtartod az utolsó response_id értéket.
Érzékeny adatok elemzése
Használd a store: false beállítást személyes vagy bizalmas adatokat tartalmazó kérésekhez. A válasz csak a memóriában kerül feldolgozásra, és nem kerül tartós tárolásra.
Auditálás és megfelelőség
Kérd le a tárolt válaszokat auditálási naplók összeállításához. Töröld őket, ha már nincs rájuk szükség, hogy megfelelj a megőrzési szabályzatoknak.
Megőrzési idő
A tárolt válaszokat a rendszer automatikusan törli 30 nap elteltével. Ezt az időszakot az API-n keresztül nem hosszabbíthatod meg. Ha hosszabb előzményre van szükséged, mentsd el a válaszokat a saját adatbázisodba.
Főbb megállapítások
- A
store: true30 napra megőrzi a választ – astore: falsesemmit nem tárol - A
GET /v1/responses/{id}lekéri a tárolt választ - A
DELETE /v1/responses/{id}véglegesen törli a választ - A
previous_response_idsegítségével történő láncoláshoz a válasznak tároltnak kell lennie - A válaszokat 30 nap után automatikusan törli a rendszer
- Használd a
store: falsebeállítást érzékeny adatok esetén