Перейти до вмісту
Sursa Developers

Об’єкти

ChatEventError

Помилка після початку потоку. Потік завершується без done, а запитання не зберігається в журналі. Коли екземпляр сервера зупиняється для оновлення (code = server_restart, retry: true), відповідь позначається як скасована й не генерується повторно, тож той самий запит можна надіслати знову без змін.

Поля

  • type"error"обов’язково
  • codeChatErrorCodeобов’язково
  • messagestringобов’язково
  • retryboolean

    true означає, що відповідь не завершилася з вини сервера (екземпляр зупинився для оновлення, code = server_restart), і запит можна повторити без змін. Немає для інших кодів.

  • answer_idstring

    ID об’єкта відповіді, якщо відповідь уже створено.

  • detailsobject

    Подробиці. Для sources_inaccessible і out_of_scope: hidden (кількість недоступних джерел), can_request (можна запросити доступ через POST /v1/access-requests з answer_id), reason (те саме, що поле події), а для out_of_scope ще й collections (список CollectionRef, де відповідь існує). Для assistant.unavailable, коли асистент зайнятий (причина rate_limited): retry_after — пауза перед повтором у секундах, як у 429 answers.engine_busy до початку потоку. Попереднього коду помилки в details немає.

    Поля
    • hiddeninteger
    • can_requestboolean
    • reasonstring
    • collectionsarray of CollectionRef
    • retry_afterinteger
  • reasonstring

    Код причини для повідомлення мовою інтерфейсу (розширюваний, довільний рядок). Коди помилок асистента: timeout, rate_limited, upstream_unavailable, license_blocked, license_restricted, forbidden, canceled, internal, bad_request, conflict, not_found, too_large, unprocessable, not_implemented, server_restart. Коди Sursa: engine_unavailable (асистент недоступний), engine_closed (потік асистента закрився без результату), sources_inaccessible, server_restart (екземпляр Sursa зупинився для оновлення), sources_unavailable (приховано через видалені або архівовані джерела), out_of_scope (джерела є лише поза вибраною колекцією), superseded (разом із canceled: відповідь замінено повтором із тим самим request_id) і awaiting_classification (приховано, бо документ ще обробляється: його категорію доступу ще не визначено, відповідь стане доступною після класифікації, а запросити доступ не можна, тож can_request = false). Показуйте повідомлення за кодом. Для невідомого коду показуйте загальне повідомлення за code; message — лише резервний текст для клієнтів без перекладів, і його мова не гарантується.

Частина

ChatEvent