Objecten

ChatRequest

Velden

• messagesarray of ChatMessageverplicht

  items ≥ 1

• collectionstring

  Standaard: "default"

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

  items ≤ 50

• streamboolean

  Standaard: false

• conversation_idstring | null

  length ≤ 64

• originstring | null
• toolsboolean | null
• bypass_cacheboolean

  Het antwoord niet uit de antwoordcache halen (de knop “Get a fresh answer” – een nieuw antwoord – onder een antwoord uit de cache). Het nieuwe antwoord vervangt het item in de cache.

  Standaard: false

• languagestring | null

  Taal van het antwoord: een ISO 639-1-code (de, en, ru, …) om in die taal te antwoorden. Met auto of zonder het veld wordt de taal uit de vraag afgeleid. De interface geeft de taal van een suggestie in een andere taal expliciet mee (Starter.language).

• scopeChatScope | null

  Bereik van de vraag: meerdere collecties, een bron, tags en een periode. De collecties van het bereik vervangen collection. Een bron beperkt het antwoord tot haar collectie (en haar eigen kaarten). Tags worden aan tags toegevoegd. De periode beperkt financiële antwoorden tot die periode. Je kunt alleen kiezen wat de gebruiker kan zien (collecties: collections.no_access/collections.not_found; bron: sources.not_found). Met conversation_id wordt het bereik in het gesprek opgeslagen. Zonder het veld geldt het bereik van het gesprek; null of een leeg bereik wist het.

• request_idstring

  Idempotentiesleutel van de vraag. Stuur dezelfde sleutel bij elke nieuwe poging van de stream voor één vraag (een nieuwe poging na een verbroken verbinding; hier zet Last-Event-ID de stream niet voort en wordt het alleen gelogd). Een nieuwe poging met de sleutel van een antwoord dat al is opgeslagen, maakt geen tweede vraag aan: het opgeslagen resultaat wordt opnieuw verstuurd als één event done (en een token met de tekst), ook als de limiet voor vragen of credits op is. Wordt het vorige antwoord nog gegenereerd voor een client die de verbinding verloor, dan stopt die generatie en wordt het antwoord opnieuw gegenereerd.

  length ≤ 64

• version_ofinteger (int64)

  Maakt een nieuwe versie van de beurt van deze vraag in het gesprek (question_id uit het gespreksverloop): een bewerkte vraag (nieuwe tekst in messages), een opnieuw gegenereerd antwoord (dezelfde tekst, meestal met bypass_cache) of dezelfde vraag met een andere quality (bijvoorbeeld precise na een antwoord met fast). Het vorige paar van vraag en antwoord blijft bewaard. De beurten daarna blijven in de tak ervan en zijn verborgen in het gespreksverloop zolang de nieuwe versie is geselecteerd (FeedItem.versions, POST /v1/conversations/{conv_id}/versions). De geschiedenis voor het antwoord is de geselecteerde tak tot en met deze beurt. De quality van een versie verandert de instellingen van het gesprek niet. Vereist conversation_id; een vraag uit een ander gesprek geeft 404 questions.not_found.

• qualitystring

  Balans tussen snelheid en nauwkeurigheid van het zoeken achter het resultaat: fast is sneller, precise is nauwkeuriger. Standaard: precise.

  Toegestane waarden: fastprecise

Gebruikt door

• POST/v1/chatAntwoord van de assistent streamen (SSE)