Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

GET ir DELETE: atsakymų valdymas

Paskaita 7 iš 16 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Ne tik kūrimas
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Geriausios praktikos
  5. Svarbiausi punktai

Ne tik kūrimas

„Responses“ API skirtas ne tik atsakymams kurti. Du papildomi galiniai taškai leidžia gauti ir ištrinti saugomus atsakymus. Šios operacijos yra būtinos kuriant patikimas programas, turinčias istorijos valdymo funkcijas.

GET /v1/responses/{id}

Atsakymo gavimas

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

API grąžina tą patį JSON objektą, kuris buvo gautas kūrimo metu:

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

Praktiniai naudojimo atvejai

Pokalbio tęsimas: tavo programa saugo paskutinį response_id naudotojo sesijoje. Prisijungus iš naujo, gauk atsakymą, kad būtų rodomas ankstesnis kontekstas.

# Naudotojas grįžta po pertraukos
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Rodyti paskutinį mainų įrašą
print(f"Paskutinis atsakymas: {previous.output[0].content[0].text[:200]}...")

# Tęsti pokalbį
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Kur sustojome?",
    previous_response_id=last_response_id
)

Išlaidų auditas: peržiūrėk savo saugomus atsakymus, kad išanalizuotumėte suvartojimą pagal naudotoją ar funkciją.

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"Išlaidos: ${cost_usd:.6f} | Įvestis: {input_tokens} | Išvestis: {output_tokens}")

Klaidų apdorojimas

Jei atsakymo nėra (ištrintas arba galiojimas baigėsi), API grąžina 404 klaidą:

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

Apdorok šį atvejį savo kode:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Atsakymas nerastas: {e}")
    # Pradėti naują pokalbį

DELETE /v1/responses/{id}

Atsakymo ištrynimas

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

Sėkmingai ištrynus grąžinamas 200 būsenos kodas. Operacija yra negrįžtama.

Poveikis grandininiam pokalbiui

Kai ištrini atsakymą, į kurį kituose atsakymuose yra nuoroda per previous_response_id, to atsakymo kontekstas iš grandinės dingsta. Vėlesni atsakymai neištrinami, tačiau jie praranda prieigą prie ankstesnio konteksto.

resp-1 → resp-2 → resp-3 → resp-4
         ↑ ištrinta

Jei ištrini resp-2, resp-3 ir resp-4 vis dar egzistuoja, tačiau kontekstas iš resp-1 ir resp-2 naujiems grandininiams užklausoms tampa nepasiekiamas.

Automatizuotas valymas

Gamintojoms programoms įgyvendink periodinį valymą:

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"Ištrinta: {rid}")
        except Exception:
            pass  # Jau ištrinta arba baigėsi galiojimas

Geriausios praktikos

  • Saugok ID: savo duomenų bazėje saugok response_id kartu su pokalbio metaduomenimis.
  • Reguliariai valyk: nelauk automatinio 30 dienų galiojimo pabaigos, kai dirbi su jautriais duomenimis.
  • Apdorok 404 klaidas: atsakymas gali dingti tarp užklausų (dėl galiojimo pabaigos arba rankinio ištrynimo).
  • Dokumentuok savo grandines: derinimo tikslais stebėk previous_response_id nuorodas tarp savo atsakymų.

Svarbiausi punktai

  • GET /v1/responses/{id} gauna atsakymą su visu jo turiniu ir metaduomenimis.
  • DELETE /v1/responses/{id} visam laikui ištrina atsakymą – tai negrįžtama operacija.
  • Tarpinio atsakymo ištrynimas nutraukia pokalbio grandinės kontekstą.
  • Apdorok 404 klaidas: atsakymų galiojimas automatiškai baigiasi po 30 dienų.
  • Savo duomenų bazėje saugok response_id, kad užtikrintumėte atsekamumą.