GET ir DELETE: atsakymų valdymas
Šiame puslapyje
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_idkartu 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_idnuorodas 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ą.