Objektai
ChatRequest
Užklausa asistento atsakymui gauti: paskutinės pokalbio replikos, rinkinys, paieškos nustatymai, atsakymo režimas, eksportas, apribojimas konkrečiomis kortelėmis, pokalbis, klausimo kilmė ir įrankiai.
Laukai
items ≥ 1
collectionstringNumatytoji reikšmė: "default"
tagsarray of string | nullexportstring | nullcard_idsarray of string | nullitems ≤ 50
streambooleanNumatytoji reikšmė: false
conversation_idstring | nulllength ≤ 64
originstring | nulltoolsboolean | nullbypass_cachebooleanNeimti atsakymo iš atsakymų podėlio (mygtukas „Get a fresh answer“ po atsakymu iš podėlio). Naujas atsakymas pakeičia įrašą podėlyje.
Numatytoji reikšmė: false
languagestring | nullAtsakymo kalba: ISO 639-1 kodas (
de,en,ru, …), kad atsakymas būtų ta kalba. Suautoarba be lauko kalba nustatoma pagal klausimą. Sąsaja kitos kalbos pasiūlymo kalbą perduoda aiškiai (Starter.language).scopeChatScope | nullKlausimo sritis: keli rinkiniai, šaltinis, žymos ir laikotarpis. Srities rinkiniai pakeičia
collection. Šaltinis susiaurina atsakymą iki savo rinkinio (ir savo kortelių). Žymos pridedamos prietags. Laikotarpis apriboja finansinius atsakymus tuo laikotarpiu. Galima pasirinkti tik tai, ką naudotojas mato (rinkiniai:collections.no_access/collections.not_found; šaltinis:sources.not_found). Suconversation_idsritis išsaugoma pokalbyje. Be lauko taikoma pokalbio sritis;nullarba tuščia sritis ją išvalo.request_idstringKlausimo idempotentiškumo raktas. Siųskite tą patį raktą kiekviename vieno klausimo srauto pakartojime (pakartojime po ryšio nutrūkimo; čia
Last-Event-IDsrauto netęsia ir tik įrašomas į žurnalą). Pakartojimas su jau išsaugoto atsakymo raktu nesukuria antro klausimo: išsaugotas rezultatas išsiunčiamas iš naujo kaip vienas įvykisdone(irtokensu tekstu), net jei klausimų ar kreditų limitas išnaudotas. Jei ankstesnis atsakymas atsijungusiam klientui dar generuojamas, šis generavimas sustabdomas ir atsakymas generuojamas iš naujo.length ≤ 64
version_ofinteger (int64)Sukuria naują šio klausimo replikos versiją pokalbyje (
question_idiš pokalbio juostos): redaguotą klausimą (naujas tekstasmessages), iš naujo sugeneruotą atsakymą (tas pats tekstas, paprastai subypass_cache) arba tą patį klausimą su kituquality(pavyzdžiui,precisepofastatsakymo). Ankstesnė klausimo ir atsakymo pora išsaugoma. Po jos einančios replikos lieka jos šakoje ir juostoje nerodomos, kol pasirinkta nauja versija (FeedItem.versions,POST /v1/conversations/{conv_id}/versions). Atsakymui naudojama istorija – pasirinkta šaka iki šios replikos. Versijosqualitypokalbio nustatymų nekeičia. Reikiaconversation_id; klausimas iš kito pokalbio grąžina404 questions.not_found.qualitystringPaieškos, iš kurios gautas rezultatas, greičio ir tikslumo pusiausvyra:
fast– greičiau,precise– tiksliau. Numatytoji reikšmė:precise.Leidžiamos reikšmės:
fastprecise