Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

GET un DELETE: pārvaldīt atbildes

Nodarbība 7 no 16 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Vairāk nekā tikai izveide
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Labākā prakse
  5. Galvenās atziņas

Vairāk nekā tikai izveide

Atbilžu API neaprobežojas tikai ar atbilžu ģenerēšanu. Divi papildu galapunkti ļauj iegūt un dzēst saglabātās atbildes. Šīs darbības ir būtiskas, lai izveidotu stabilas lietojumprogrammas ar vēstures pārvaldību.

GET /v1/responses/{id}

Atbildes iegūšana

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

API atgriež tieši tādu pašu JSON objektu kā izveides brīdī:

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

Praktiski lietojumi

Sarunas atsākšana: Tava lietojumprogramma saglabā pēdējo response_id lietotāja sesijā. Atkārtoti pieslēdzoties, iegūsti atbildi, lai parādītu iepriekšējo kontekstu.

# Lietotājs atgriežas pēc pārtraukuma
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Parādīt pēdējo apmaiņu
print(f"Last response: {previous.output[0].content[0].text[:200]}...")

# Turpināt sarunu
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Where were we?",
    previous_response_id=last_response_id
)

Izmaksu audits: Iterē cauri savām saglabātajām atbildēm, lai analizētu patēriņu pa lietotājiem vai funkcijām.

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

Kļūdu apstrāde

Ja atbilde nepastāv (ir dzēsta vai beidzies tās derīguma termiņš), API atgriež 404 kļūdu:

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

Apstrādā šo gadījumu savā kodā:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Response not found: {e}")
    # Sākt jaunu sarunu

DELETE /v1/responses/{id}

Atbildes dzēšana

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

Veiksmīgas dzēšanas gadījumā tiek atgriezts statusa kods 200. Darbība ir neatgriezeniska.

Ietekme uz saķēdētām sarunām

Dzēšot atbildi, uz kuru citas atbildes atsaucas, izmantojot previous_response_id, šīs atbildes konteksts pazūd no ķēdes. Turpmākās atbildes netiek dzēstas, taču tās zaudē piekļuvi iepriekšējam kontekstam.

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

Ja dzēsīsi resp-2, resp-3 un resp-4 joprojām pastāvēs, taču konteksts no resp-1 un resp-2 vairs nebūs pieejams jaunām saķēdētām pieprasījumiem.

Automatizēta tīrīšana

Ražošanas vidēm implementē periodisku tīrīšanu:

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  # Jau dzēsts vai beidzies derīguma termiņš

Labākā prakse

  • Saglabā ID: glabā response_id savā datubāzē kopā ar sarunu metadatiem
  • Regulāri tīri: negaidi automātisko 30 dienu termiņa beigšanos sensitīviem datiem
  • Apstrādā 404: atbilde var pazust starp pieprasījumiem (termiņa beigas, manuāla dzēšana)
  • Dokumentē savas ķēdes: atkļūdošanai izseko previous_response_id saites starp savām atbildēm

Galvenās atziņas

  • GET /v1/responses/{id} iegūst atbildi ar visu tās saturu un metadatiem
  • DELETE /v1/responses/{id} neatgriezeniski dzēš atbildi
  • Starpposma atbildes dzēšana pārtrauc sarunas ķēdes kontekstu
  • Apstrādā 404 kļūdas: atbildes automātiski beidzas pēc 30 dienām
  • Glabā response_id savā datubāzē izsekojamībai