Об’єкти

ChatRequest

Поля

• messagesarray of ChatMessageобов’язково

  items ≥ 1

• collectionstring

  Типове значення: "default"

• tagsarray of string | null
• exportstring | null
• card_idsarray of string | null

  items ≤ 50

• streamboolean

  Типове значення: false

• conversation_idstring | null

  length ≤ 64

• originstring | null
• toolsboolean | null
• bypass_cacheboolean

  Не брати відповідь із кешу відповідей (кнопка «Get a fresh answer» під відповіддю з кешу). Свіжа відповідь замінює запис у кеші.

  Типове значення: false

• languagestring | null

  Мова відповіді: код ISO 639-1 (de, en, ru, …), щоб відповісти цією мовою. З auto або без поля мова визначається за запитанням. Інтерфейс явно передає мову підказки іншою мовою (Starter.language).

• scopeChatScope | null

  Область запитання: кілька колекцій, джерело, теги й період. Колекції області замінюють collection. Джерело звужує відповідь до своєї колекції (і власних карток). Теги додаються до tags. Період обмежує фінансові відповіді цим періодом. Вибрати можна лише те, що бачить користувач (колекції: collections.no_access/collections.not_found; джерело: sources.not_found). З conversation_id область зберігається в розмові. Без поля діє область розмови; null або порожня область очищає її.

• request_idstring

  Ключ ідемпотентності запитання. Надсилайте той самий ключ у кожному повторі потоку для одного запитання (повтор після розриву з’єднання; тут Last-Event-ID не продовжує потік і лише записується в журнал). Повтор із ключем уже збереженої відповіді не створює другого запитання: збережений результат надсилається знову однією подією done (і token з текстом), навіть якщо ліміт запитань або кредитів вичерпано. Якщо попередня відповідь ще генерується для клієнта, що від’єднався, цю генерацію буде зупинено, а відповідь згенеровано заново.

  length ≤ 64

• version_ofinteger (int64)

  Створює нову версію репліки цього запитання в розмові (question_id зі стрічки розмови): змінене запитання (новий текст у messages), повторно згенеровану відповідь (той самий текст, зазвичай з bypass_cache) або те саме запитання з іншим quality (наприклад, precise після відповіді fast). Попередня пара запитання й відповіді зберігається. Репліки після неї лишаються в її гілці й приховані зі стрічки розмови, поки вибрано нову версію (FeedItem.versions, POST /v1/conversations/{conv_id}/versions). Історія для відповіді — вибрана гілка до цієї репліки. quality версії не змінює налаштувань розмови. Потрібен conversation_id; запитання з іншої розмови повертає 404 questions.not_found.

• qualitystring

  Баланс між швидкістю та точністю пошуку, на якому ґрунтується результат: fast — швидше, precise — точніше. Типово — precise.

  Допустимі значення: fastprecise

Використовується в

• POST/v1/chatОтримувати відповідь асистента потоком (SSE)