Obiecte

ChatRequest

Câmpuri

• messagesarray of ChatMessageobligatoriu

  items ≥ 1

• collectionstring

  Implicit: "default"

• tagsarray of string | null
• exportstring | null
• card_idsarray of string | null

  items ≤ 50

• streamboolean

  Implicit: false

• conversation_idstring | null

  length ≤ 64

• originstring | null
• toolsboolean | null
• bypass_cacheboolean

  Nu se ia răspunsul din cache-ul răspunsurilor (butonul „Get a fresh answer” sub un răspuns din cache). Răspunsul nou înlocuiește intrarea din cache.

  Implicit: false

• languagestring | null

  Limba răspunsului: un cod ISO 639-1 (de, en, ru, …) pentru a răspunde în acea limbă. Cu auto sau fără câmp, limba se determină după întrebare. Interfața transmite explicit limba unei sugestii într-o altă limbă (Starter.language).

• scopeChatScope | null

  Aria întrebării: mai multe colecții, o sursă, etichete și o perioadă. Colecțiile din arie înlocuiesc collection. O sursă restrânge răspunsul la colecția ei (și la propriile ei fișe). Etichetele se adaugă la tags. Perioada limitează răspunsurile financiare la acea perioadă. Se poate selecta doar ce vede utilizatorul (colecții: collections.no_access/collections.not_found; sursă: sources.not_found). Cu conversation_id, aria se salvează în conversație. Fără câmp se aplică aria conversației; null sau o arie goală o șterge.

• request_idstring

  Cheia de idempotență a întrebării. Trimiteți aceeași cheie la fiecare reîncercare a fluxului pentru o întrebare (o reîncercare după o deconectare; aici Last-Event-ID nu continuă fluxul și este doar înregistrat în jurnal). O reîncercare cu cheia unui răspuns deja salvat nu creează o a doua întrebare: rezultatul salvat se trimite din nou ca un singur eveniment done (și un token cu textul), chiar dacă limita de întrebări sau de credite este epuizată. Dacă răspunsul anterior este încă în curs de generare pentru un client deconectat, acea generare se oprește și răspunsul se generează din nou.

  length ≤ 64

• version_ofinteger (int64)

  Creează o nouă versiune a schimbului acestei întrebări în conversație (question_id din istoric): o întrebare editată (text nou în messages), un răspuns regenerat (același text, de obicei cu bypass_cache) sau aceeași întrebare cu alt quality (de exemplu, precise după un răspuns fast). Perechea anterioară de întrebare și răspuns se păstrează. Schimburile de după ea rămân în ramura ei și sunt ascunse din istoric cât timp este selectată noua versiune (FeedItem.versions, POST /v1/conversations/{conv_id}/versions). Istoricul folosit pentru răspuns este ramura selectată până la acest schimb. Valoarea quality a unei versiuni nu modifică setările conversației. Necesită conversation_id; o întrebare din altă conversație returnează 404 questions.not_found.

• qualitystring

  Echilibrul dintre viteza și precizia căutării pe care se bazează rezultatul: fast este mai rapid, precise este mai precis. Implicit: precise.

  Valori permise: fastprecise

Folosit de

• POST/v1/chatTransmite în flux un răspuns al asistentului (SSE)