Objectes

ChatRequest

Camps

• messagesarray of ChatMessageobligatori

  items ≥ 1

• collectionstring

  Per defecte: "default"

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

  items ≤ 50

• streamboolean

  Per defecte: false

• conversation_idstring | null

  length ≤ 64

• originstring | null
• toolsboolean | null
• bypass_cacheboolean

  No pren la resposta de la memòria cau de respostes (el botó «Get a fresh answer» —obtenir una resposta nova— sota una resposta de la memòria cau). La resposta nova substitueix l’element de la memòria cau.

  Per defecte: false

• languagestring | null

  Llengua de la resposta: un codi ISO 639-1 (de, en, ru, …) per respondre en aquesta llengua. Amb auto o sense el camp, la llengua es detecta a partir de la pregunta. La interfície passa explícitament la llengua d’un suggeriment en una altra llengua (Starter.language).

• scopeChatScope | null

  Abast de la pregunta: diverses col·leccions, una font, etiquetes i un període. Les col·leccions de l’abast substitueixen collection. Una font restringeix la resposta a la seva col·lecció (i a les seves pròpies entrades). Les etiquetes s’afegeixen a tags. El període limita les respostes financeres a aquest període. Només es pot seleccionar el que l’usuari pot veure (col·leccions: collections.no_access/collections.not_found; font: sources.not_found). Amb conversation_id, l’abast es desa a la conversa. Sense el camp, s’aplica l’abast de la conversa; null o un abast buit l’esborra.

• request_idstring

  Clau d’idempotència de la pregunta. Envieu la mateixa clau en cada reintent del flux per a una mateixa pregunta (un reintent després d’una desconnexió; aquí Last-Event-ID no continua el flux i només es registra). Un reintent amb la clau d’una resposta que ja s’ha desat no crea una segona pregunta: el resultat desat es torna a enviar com un sol esdeveniment done (i un token amb el text), encara que s’hagi esgotat el límit de preguntes o de crèdits. Si la resposta anterior encara s’està generant per a un client desconnectat, aquesta generació s’atura i la resposta es torna a generar.

  length ≤ 64

• version_ofinteger (int64)

  Crea una versió nova del torn d’aquesta pregunta a la conversa (question_id de l’historial): una pregunta editada (text nou a messages), una resposta regenerada (el mateix text, normalment amb bypass_cache) o la mateixa pregunta amb un altre valor de quality (per exemple, precise després d’una resposta fast). Es conserva la parella anterior de pregunta i resposta. Els torns posteriors es queden a la seva branca i s’amaguen de l’historial mentre la versió nova està seleccionada (FeedItem.versions, POST /v1/conversations/{conv_id}/versions). L’historial que es fa servir per a la resposta és la branca seleccionada fins a aquest torn. El valor de quality d’una versió no canvia la configuració de la conversa. Requereix conversation_id; una pregunta d’una altra conversa retorna 404 questions.not_found.

• qualitystring

  Equilibri entre la velocitat i la precisió de la cerca en què es basa el resultat: fast és més ràpida, precise és més precisa. Per defecte: precise.

  Valors permesos: fastprecise

S’usa a

• POST/v1/chatTransmetre en temps real una resposta de l’assistent (SSE)