GET és DELETE: Válaszok kezelése
Ezen az oldalon
Túl a létrehozáson
A Responses API nem csupán válaszok létrehozására szolgál. Két kiegészítő végpont teszi lehetővé a tárolt válaszok lekérdezését és törlését. Ezek a műveletek elengedhetetlenek az előzménykezeléssel rendelkező robusztus alkalmazások felépítéséhez.
GET /v1/responses/{id}
Válasz lekérése
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Az API pontosan ugyanazt a JSON-objektumot adja vissza, mint a létrehozás során:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Gyakorlati alkalmazási esetek
Beszélgetés folytatása: Az alkalmazásod elmenti az utolsó response_id-t a felhasználói munkamenetben. Újracsatlakozáskor lekérdezed a választ, hogy megjelenítsd az előző kontextust.
# A felhasználó szünet után tér vissza
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Az utolsó váltás megjelenítése
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# A beszélgetés folytatása
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Költségellenőrzés: Iterálj végig a tárolt válaszaidon, hogy elemezd a felhasználó vagy funkció szerinti fogyasztást.
response = client.responses.retrieve("resp-abc123")
cost_usd = response.usage.cost_in_nano_usd / 1e9
input_tokens = response.usage.input_tokens
output_tokens = response.usage.output_tokens
print(f"Cost: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")
Hibakezelés
Ha a válasz nem létezik (törölték vagy lejárt), az API 404-es hibát ad vissza:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Kezeld ezt az esetet a kódodban:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Új beszélgetés indítása
DELETE /v1/responses/{id}
Válasz törlése
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Siker esetén a törlés 200-as státuszkódot ad vissza. A művelet visszavonhatatlan.
Hatás a láncolt beszélgetésekre
Amikor törölsz egy olyan választ, amelyre mások hivatkoznak a previous_response_id segítségével, annak a válasznak a kontextusa eltűnik a láncból. A későbbi válaszok nem törlődnek, de elveszítik a hozzáférést a korábbi kontextushoz.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Ha törlöd a resp-2-t, a resp-3 és a resp-4 továbbra is létezik, de a resp-1 és resp-2 kontextusa már nem elérhető az újabb láncolt kérések számára.
Automatikus tisztítás
Éles környezetben működő alkalmazásokhoz implementálj időszakos tisztítást:
import datetime
def cleanup_old_responses(response_ids, max_age_days=7):
for rid in response_ids:
try:
resp = client.responses.retrieve(rid)
age = datetime.datetime.now().timestamp() - resp.created_at
if age > max_age_days * 86400:
client.responses.delete(rid)
print(f"Deleted: {rid}")
except Exception:
pass # Már törölve vagy lejárt
Legjobb gyakorlatok
- ID-k tárolása: Tartsd meg a
response_id-kat az adatbázisodban a beszélgetés metaadataival együtt. - Rendszeres tisztítás: Ne várd meg az automatikus, 30 napos lejáratot az érzékeny adatok esetén.
- 404-es hibák kezelése: Egy válasz eltűnhet két kérés között (lejárat, kézi törlés).
- Láncok dokumentálása: Hibakereséshez kövesd nyomon a válaszaid közötti
previous_response_idhivatkozásokat.
Főbb megállapítások
- A
GET /v1/responses/{id}lekéri a választ annak teljes tartalmával és metaadataival együtt. - A
DELETE /v1/responses/{id}véglegesen törli a választ – ez egy visszavonhatatlan művelet. - Egy köztes válasz törlése megszakítja a beszélgetési lánc kontextusát.
- Kezeld a 404-es hibákat: a válaszok automatikusan lejárnak 30 nap után.
- Tartsd meg a
response_id-kat a saját adatbázisodban a nyomon követhetőség érdekében.