Lähe põhisisu juurde
Eesti— Vali keel
Menüü

GET ja DELETE: vastuste haldamine

Õppetund 7 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Loomisest kaugemale
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Parimad tavad
  5. Peamised punktid

Loomisest kaugemale

Responses API ei piirdu ainult vastuste loomisega. Kaks täiendavat lõpppunkti võimaldavad salvestatud vastuseid pärida ja kustutada. Need toimingud on hädavajalikud ajaloohaldusega robustsete rakenduste loomisel.

GET /v1/responses/{id}

Vastuse pärimine

curl https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

API tagastab täpselt sama JSON-objekti, mis loomise käigus:

{
  "id": "resp-abc123def456",
  "object": "response",
  "created_at": 1712000000,
  "status": "completed",
  "model": "grok-4.20-0309-reasoning",
  "output": [...],
  "usage": {...}
}

Praktilised kasutusjuhtumid

Vestluse jätkamine: Sinu rakendus salvestab viimase response_id kasutaja sessiooni. Uuesti ühenduse loomisel pärid vastuse, et kuvada eelnev kontekst.

# Kasutaja naaseb pärast pausi
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Kuva viimane vahetus
print(f"Last response: {previous.output[0].content[0].text[:200]}...")

# Jätka vestlust
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Where were we?",
    previous_response_id=last_response_id
)

Kulude audit: Itereeri oma salvestatud vastuseid, et analüüsida tarbimist kasutaja või funktsiooni lõikes.

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}")

Veakäsitlus

Kui vastust ei eksisteeri (kustutatud või aegunud), tagastab API vea 404:

{
  "error": {
    "message": "Response not found",
    "type": "not_found_error"
  }
}

Käsitle seda juhtumit oma koodis:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Response not found: {e}")
    # Alusta uut vestlust

DELETE /v1/responses/{id}

Vastuse kustutamine

curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

Õnnestumisel tagastab kustutamine oleku 200. Toiming on pööramatu.

Mõju aheldatud vestlustele

Kui kustutad vastuse, millele teised viitavad väljaga previous_response_id, kaob selle vastuse kontekst ahelast. Järgnevaid vastuseid ei kustutata, kuid need kaotavad juurdepääsu eelnevale kontekstile.

resp-1 → resp-2 → resp-3 → resp-4
         ↑ deleted

Kui kustutad resp-2, eksisteerivad resp-3 ja resp-4 edasi, kuid kontekst vastustest resp-1 ja resp-2 pole enam uute aheldatud päringute jaoks kättesaadav.

Automatiseeritud puhastus

Rakenda tootmiskeskkonnas perioodiline puhastus:

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  # Juba kustutatud või aegunud

Parimad tavad

  • Salvesta ID-d: hoia response_id-sid oma andmebaasis koos vestluse metaandmetega
  • Puhasta regulaarselt: ära oota tundlike andmete puhul automaatset 30-päevast aegumist
  • Käsitle 404-vigu: vastus võib päringute vahel kaduda (aegumine, manuaalne kustutamine)
  • Dokumenteeri oma ahelad: silumiseks jälgi vastuste vahelisi previous_response_id linke

Peamised punktid

  • GET /v1/responses/{id} pärib vastuse koos kogu selle sisu ja metaandmetega
  • DELETE /v1/responses/{id} kustutab vastuse jäädavalt – pööramatu toiming
  • Vahevastuse kustutamine katkestab vestluse ahela konteksti
  • Käsitle 404-vigu: vastused aeguvad automaatselt 30 päeva pärast
  • Hoia response_id-sid oma andmebaasis jälgitavuse tagamiseks