Объекты

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

  Не брать ответ из кеша ответов (кнопка «Получить свежий ответ» под ответом из кеша). Свежий ответ заменяет запись в кеше.

  По умолчанию: 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)