Премини към основното съдържание
Български— Изберете език
Меню

GET и DELETE: Управление на отговорите

Урок 7 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Отвъд създаването
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Най-добри практики
  5. Ключови изводи

Отвъд създаването

API за отговори (Responses API) не се ограничава само до създаване на отговори. Два допълващи крайни точки (endpoints) Ви позволяват да извличате и изтривате съхранени отговори. Тези операции са от съществено значение за изграждането на надеждни приложения с управление на историята.

GET /v1/responses/{id}

Извличане на отговор

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

API връща точно същия JSON обект, както по време на създаването:

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

Практически случаи на употреба

Възобновяване на разговор: Вашето приложение съхранява последния response_id в сесията на потребителя. При повторно свързване, извлечете отговора, за да покажете предишния контекст.

# Потребителят се връща след пауза
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Показване на последния обмен
print(f"Last response: {previous.output[0].content[0].text[:200]}...")

# Продължаване на разговора
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Where were we?",
    previous_response_id=last_response_id
)

Одит на разходите: Итерирайте през съхранените си отговори, за да анализирате потреблението по потребител или функция.

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

Обработка на грешки

Ако отговорът не съществува (изтрит или изтекъл), API връща грешка 404:

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

Обработете този случай във Вашия код:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Response not found: {e}")
    # Започване на нов разговор

DELETE /v1/responses/{id}

Изтриване на отговор

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

При успешно изтриване се връща статус 200. Операцията е необратима.

Въздействие върху верижните разговори

Когато изтриете отговор, към който други се позовават чрез previous_response_id, контекстът на този отговор изчезва от веригата. Последващите отговори не се изтриват, но губят достъп до предишния контекст.

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

Ако изтриете resp-2, resp-3 и resp-4 все още съществуват, но контекстът от resp-1 и resp-2 вече не е достъпен за нови верижни заявки.

Автоматизирано почистване

За производствени приложения внедрете периодично почистване:

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  # Вече изтрит или изтекъл

Най-добри практики

  • Съхранявайте ID: пазете response_id във Вашата база данни заедно с метаданните на разговора.
  • Почиствайте редовно: не чакайте автоматичното изтичане след 30 дни за чувствителни данни.
  • Обработвайте 404: отговор може да изчезне между заявките (изтичане, ръчно изтриване).
  • Документирайте веригите си: за отстраняване на грешки, проследявайте връзките previous_response_id между Вашите отговори.

Ключови изводи

  • GET /v1/responses/{id} извлича отговор с цялото му съдържание и метаданни.
  • DELETE /v1/responses/{id} окончателно изтрива отговор – необратима операция.
  • Изтриването на междинен отговор прекъсва контекста на веригата от разговори.
  • Обработвайте грешки 404: отговорите изтичат автоматично след 30 дни.
  • Съхранявайте response_id във Вашата собствена база данни за проследимост.