Objets

ChatRequest

Champs

• messagesarray of ChatMessageobligatoire

  items ≥ 1

• collectionstring

  Par défaut : "default"

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

  items ≤ 50

• streamboolean

  Par défaut : false

• conversation_idstring | null

  length ≤ 64

• originstring | null
• toolsboolean | null
• bypass_cacheboolean

  Ne pas prendre la réponse dans le cache des réponses (le bouton « Get a fresh answer » sous une réponse en cache). La nouvelle réponse remplace l’entrée en cache.

  Par défaut : false

• languagestring | null

  Langue de la réponse : un code ISO 639-1 (de, en, ru, …) pour répondre dans cette langue. Avec auto ou sans le champ, la langue est déduite de la question. L’interface transmet explicitement la langue d’une suggestion rédigée dans une autre langue (Starter.language).

• scopeChatScope | null

  Périmètre de la question : plusieurs collections, une source, des étiquettes et une période. Les collections du périmètre remplacent collection. Une source restreint la réponse à sa collection (et à ses propres fiches). Les étiquettes s’ajoutent à tags. La période limite les réponses financières à cette période. Vous ne pouvez sélectionner que ce que l’utilisateur voit (collections : collections.no_access/collections.not_found ; source : sources.not_found). Avec conversation_id, le périmètre est enregistré dans la conversation. Sans le champ, le périmètre de la conversation s’applique ; null ou un périmètre vide l’efface.

• request_idstring

  Clé d’idempotence de la question. Envoyez la même clé à chaque nouvelle tentative du flux pour une même question (nouvelle tentative après une déconnexion ; ici, Last-Event-ID ne reprend pas le flux et est seulement journalisé). Une nouvelle tentative avec la clé d’une réponse déjà enregistrée ne crée pas de seconde question : le résultat enregistré est renvoyé sous la forme d’un seul événement done (et d’un token avec le texte), même si la limite de questions ou de crédits est épuisée. Si la réponse précédente est encore en cours de génération pour un client déconnecté, cette génération s’arrête et la réponse est générée à nouveau.

  length ≤ 64

• version_ofinteger (int64)

  Crée une nouvelle version de l’échange de cette question dans la conversation (question_id issu du fil) : une question modifiée (nouveau texte dans messages), une réponse régénérée (le même texte, généralement avec bypass_cache) ou la même question avec une autre quality (par exemple precise après une réponse fast). La paire question-réponse précédente est conservée. Les échanges qui la suivent restent dans sa branche et sont masqués du fil tant que la nouvelle version est sélectionnée (FeedItem.versions, POST /v1/conversations/{conv_id}/versions). L’historique utilisé pour la réponse est la branche sélectionnée jusqu’à cet échange. La quality d’une version ne modifie pas les paramètres de la conversation. Nécessite conversation_id ; une question d’une autre conversation renvoie 404 questions.not_found.

• qualitystring

  Équilibre entre la rapidité et la précision de la recherche qui produit le résultat : fast est plus rapide, precise plus précis. Par défaut : precise.

  Valeurs autorisées: fastprecise

Utilisé par

• POST/v1/chatRecevoir une réponse de l’assistant en flux (SSE)