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

Съхранение и постоянство на отговорите

Урок 6 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Контрол върху жизнения цикъл на Вашите данни
  2. store: true срещу store: false
  3. Извличане на запазен отговор
  4. Изтриване на отговор
  5. Сценарии за използване на хранилището
  6. Срок на задържане
  7. Ключови изводи

Контрол върху жизнения цикъл на Вашите данни

API за отговори (Responses API) включва вградено хранилище: при задаване на store: true, сървърите на xAI запазват Вашите отговори за 30 дни. Можете да ги извличате, преглеждате и изтривате по всяко време, използвайки специализирани крайни точки (endpoints).

store: true срещу store: false

Режим на съхранение (store: true)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Write a summary of this project.",
  "store": true
}

Отговорът се запазва за 30 дни. Можете да:

  • Го използвате като референция чрез previous_response_id, за да продължите разговора
  • Да го извлечете по-късно с GET /v1/responses/{id}
  • Да го изтриете с DELETE /v1/responses/{id}

Частен режим (store: false)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this confidential data.",
  "store": false
}

Отговорът не се запазва след изпълнението на заявката. Вие все още получавате резултата в HTTP отговора, но той става недостъпен впоследствие. Верижното свързване чрез previous_response_id не е възможно.

Използвайте store: false за чувствителни данни или когато нямате нужда да продължавате разговора.

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

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

API връща пълния обект на отговора, идентичен с този, получен при създаването му. Това е полезно за:

  • Одитиране на минали взаимодействия
  • Възстановяване на историята на разговора
  • Проверка на разходите постфактум

На Python

# Retrieve a stored response
stored = client.responses.retrieve("resp-abc123")
print(stored.output[0].content[0].text)
print(f"Cost: {stored.usage.cost_in_nano_usd / 1e9:.6f} USD")

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

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

Изтриването е окончателно. Ако други верижни отговори се позовават на този отговор чрез previous_response_id, съответният контекст вече няма да бъде наличен.

На Python

client.responses.delete("resp-abc123")

Сценарии за използване на хранилището

Чатбот с история

Активирайте store: true за всички заявки. Потребителят може да възобнови разговора си дори след затваряне на браузъра, стига да запазите последния response_id.

Анализ на чувствителни данни

Използвайте store: false за заявки, съдържащи лични или поверителни данни. Отговорът се обработва в паметта и не се запазва трайно.

Одит и съответствие

Извличайте запазените отговори, за да изградите одиторски дневници. Изтривайте ги, когато вече не са необходими, за да спазвате политиките за задържане на данни.

Срок на задържане

Запазените отговори се изтриват автоматично след 30 дни. Не можете да удължите този период чрез API. Ако имате нужда от по-дълга история, запазете отговорите във Ваша собствена база данни.

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

  • store: true запазва отговора за 30 дни — store: false не запазва нищо
  • GET /v1/responses/{id} извлича запазен отговор
  • DELETE /v1/responses/{id} окончателно изтрива отговор
  • Верижното свързване чрез previous_response_id изисква отговорът да бъде запазен
  • Отговорите се изчистват автоматично след 30 дни
  • Използвайте store: false за чувствителни данни