Објекти
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