Objektit

ChatRequest

Kentät

• messagesarray of ChatMessagepakollinen

  items ≥ 1

• collectionstring

  Oletus: "default"

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

  items ≤ 50

• streamboolean

  Oletus: false

• conversation_idstring | null

  length ≤ 64

• originstring | null
• toolsboolean | null
• bypass_cacheboolean

  Älä ota vastausta vastausvälimuistista (välimuistissa olevan vastauksen alla oleva ”Get a fresh answer” -painike). Uusi vastaus korvaa välimuistissa olevan merkinnän.

  Oletus: false

• languagestring | null

  Vastauksen kieli: ISO 639-1 -koodi (de, en, ru, …), jolla vastataan kyseisellä kielellä. Arvolla auto tai ilman kenttää kieli tunnistetaan kysymyksestä. Käyttöliittymä välittää toisenkielisen ehdotuksen kielen erikseen (Starter.language).

• scopeChatScope | null

  Kysymyksen rajaus: useita kokoelmia, lähde, tunnisteet ja jakso. Rajauksen kokoelmat korvaavat collection-kentän. Lähde rajaa vastauksen lähteen kokoelmaan (ja sen omiin kortteihin). Tunnisteet lisätään tags-kenttään. Jakso rajaa taloutta koskevat vastaukset kyseiseen jaksoon. Valita voi vain sitä, minkä käyttäjä näkee (kokoelmat: collections.no_access/collections.not_found; lähde: sources.not_found). Kun mukana on conversation_id, rajaus tallennetaan keskusteluun. Ilman kenttää käytetään keskustelun rajausta; null tai tyhjä rajaus tyhjentää sen.

• request_idstring

  Kysymyksen idempotenssiavain. Lähetä sama avain jokaisessa saman kysymyksen virran uusintayrityksessä (uusintayritys yhteyden katkettua; tässä Last-Event-ID ei jatka virtaa, vaan se vain kirjataan lokiin). Uusintayritys jo tallennetun vastauksen avaimella ei luo toista kysymystä: tallennettu tulos lähetetään uudelleen yhtenä done-tapahtumana (ja tekstin sisältävänä token-tapahtumana), vaikka kysymys- tai krediittiraja olisi käytetty loppuun. Jos edellistä vastausta muodostetaan vielä katkenneelle asiakkaalle, sen muodostaminen pysähtyy ja vastaus muodostetaan uudelleen.

  length ≤ 64

• version_ofinteger (int64)

  Luo keskusteluun uuden version tämän kysymyksen vuorosta (question_id syötteestä): muokattu kysymys (uusi teksti messages-kentässä), uudelleen muodostettu vastaus (sama teksti, yleensä bypass_cache-kentän kanssa) tai sama kysymys toisella quality-arvolla (esimerkiksi precise fast-vastauksen jälkeen). Edellinen kysymyksen ja vastauksen pari säilyy. Sen jälkeiset vuorot jäävät sen haaraan ja piilotetaan syötteestä, kun uusi versio on valittuna (FeedItem.versions, POST /v1/conversations/{conv_id}/versions). Vastauksessa käytetty historia on valittu haara tähän vuoroon asti. Version quality ei muuta keskustelun asetuksia. Edellyttää conversation_id-kenttää; toisen keskustelun kysymys palauttaa 404 questions.not_found.

• qualitystring

  Tuloksen taustalla olevan haun nopeuden ja tarkkuuden tasapaino: fast on nopeampi, precise tarkempi. Oletus: precise.

  Sallitut arvot: fastprecise

Käytössä

• POST/v1/chatVastaanota avustajan vastaus virtana (SSE)