Objektumok
ChatRequest
Kérés az asszisztens válaszára: a beszélgetés legutóbbi körei, a gyűjtemény, a keresési beállítások, a válaszmód, az exportálás, adott kártyákra való szűkítés, a beszélgetés, a kérdés eredete és az eszközök.
Mezők
items ≥ 1
collectionstringAlapértelmezett: "default"
tagsarray of string | nullexportstring | nullcard_idsarray of string | nullitems ≤ 50
streambooleanAlapértelmezett: false
conversation_idstring | nulllength ≤ 64
originstring | nulltoolsboolean | nullbypass_cachebooleanNe a válaszok gyorsítótárából vegye a választ (a gyorsítótárazott válasz alatti „Get a fresh answer” gomb, friss válasz kérése). A friss válasz felváltja a gyorsítótárban lévő bejegyzést.
Alapértelmezett: false
languagestring | nullA válasz nyelve: ISO 639-1 kód (
de,en,ru, …), hogy a válasz ezen a nyelven készüljön.autoértékkel vagy a mező nélkül a rendszer a kérdésből állapítja meg a nyelvet. A felület a más nyelvű javaslat nyelvét kifejezetten átadja (Starter.language).scopeChatScope | nullA kérdés tartománya: több gyűjtemény, egy forrás, címkék és egy időszak. A tartomány gyűjteményei felváltják a
collectionértéket. A forrás a választ a gyűjteményére (és a saját kártyáira) szűkíti. A címkék hozzáadódnak atagsértékhez. Az időszak a pénzügyi válaszokat erre az időszakra korlátozza. Csak azt választhatod ki, amit a felhasználó lát (gyűjtemények:collections.no_access/collections.not_found; forrás:sources.not_found).conversation_idmegadásával a tartomány a beszélgetésben mentődik. A mező nélkül a beszélgetés tartománya érvényes; anullvagy az üres tartomány törli.request_idstringA kérdés idempotenciakulcsa. Egy kérdés adatfolyamának minden újrapróbálkozásában ugyanazt a kulcsot küldd (kapcsolatbontás utáni újrapróbálkozás; itt a
Last-Event-IDnem folytatja az adatfolyamot, csak naplózásra kerül). Egy már mentett válasz kulcsával érkező újrapróbálkozás nem hoz létre második kérdést: a rendszer a mentett eredményt újra elküldi egyetlendoneeseményként (és egytokeneseményként a szöveggel), akkor is, ha a kérdés- vagy a kreditkorlát elfogyott. Ha a megszakadt kapcsolatú kliens előző válasza még készül, annak elkészítése leáll, és a válasz újra elkészül.length ≤ 64
version_ofinteger (int64)Új verziót hoz létre a beszélgetésben ennek a kérdésnek a köréből (
question_ida beszélgetési előzményekből): szerkesztett kérdés (új szöveg amessagesmezőben), újragenerált válasz (ugyanaz a szöveg, általábanbypass_cacheértékkel) vagy ugyanaz a kérdés másqualityértékkel (példáulpreciseegyfastválasz után). Az előző kérdés–válasz pár megmarad. Az utána következő körök az ő ágában maradnak, és amíg az új verzió van kiválasztva, nem látszanak a beszélgetési előzményekben (FeedItem.versions,POST /v1/conversations/{conv_id}/versions). A válaszhoz figyelembe vett előzmények a kiválasztott ág körei eddig a körig. Egy verzióqualityértéke nem módosítja a beszélgetés beállításait. Aconversation_idmegadása kötelező; más beszélgetés kérdésére a válasz404 questions.not_found.qualitystringAz eredmény mögötti keresés sebessége és pontossága közötti egyensúly: a
fastgyorsabb, aprecisepontosabb. Alapértelmezett érték:precise.Megengedett értékek:
fastprecise