Обекти
ChatRequest
Заявка за отговор на асистента: последните реплики от разговора, колекцията, настройките на търсенето, режимът на отговора, експортът, ограничение до конкретни карти, разговорът, произходът на въпроса и инструментите.
Полета
items ≥ 1
collectionstringПо подразбиране: "default"
tagsarray of string | nullexportstring | nullcard_idsarray of string | nullitems ≤ 50
streambooleanПо подразбиране: false
conversation_idstring | nulllength ≤ 64
originstring | nulltoolsboolean | nullbypass_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