Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

GET és DELETE: Válaszok kezelése

7. lecke 16 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Túl a létrehozáson
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Legjobb gyakorlatok
  5. Főbb megállapítások

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_id hivatkozá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.