Exposer

Exposer un assistant IA, c'est le rendre accessible en dehors de l'application QAnswer — sous forme de widget de discussion sur votre site web, de lien public que vous pouvez envoyer à n'importe qui, d'API REST pour votre propre code, ou via un outil que votre équipe utilise déjà comme Slack ou Confluence. Tout ce dont vous avez besoin se trouve dans l'onglet Exposer de l'assistant.

Ouvrir l'onglet Exposer

Ouvrez un assistant IA, puis sélectionnez Exposer dans la barre en haut de la page de l'assistant, à côté de Discussion et Analyses.

Les onglets Discussion, Analyses et Exposer sur la page d'un assistant IA
Note
L'onglet Exposer n'est disponible que pour les utilisateurs disposant d'un accès en écriture à l'assistant. Avec un accès en lecture seule, l'onglet est masqué.

La page Exposer

La page Exposer présente chaque canal disponible sous forme de carte. Sélectionner une carte ouvre un guide d'installation court et numéroté pour ce canal ; le lien « Retour » en haut vous ramène à cette liste.

La page Exposer montrant la carte Bibliothèque d'assistants IA et les canaux QAnswer intégrés
  • Bibliothèque d'assistants IA — publie l'assistant dans la bibliothèque publique QAnswer afin que chacun puisse le trouver et l'utiliser. Cette carte n'est visible que par les administrateurs de la plateforme.
  • Exposer avec QAnswer — les canaux intégrés, qui ne nécessitent aucun outil ni compte externe.
  • Intégrations tierces — des connecteurs prêts à l'emploi pour les plateformes sur lesquelles votre équipe travaille déjà.

Canaux intégrés

Les canaux de la section « Exposer avec QAnswer » sont hébergés par QAnswer :

  • Chatbot de site web — un widget de discussion que vous ajoutez à n'importe quel site web avec un extrait de script.
  • Interface de discussion — une discussion publique en pleine page, partagée sous forme de lien.
  • Interface de recherche — une recherche publique en pleine page sur les données de l'assistant, partagée sous forme de lien.
  • Générateur de rapports — une version publique de l'un de vos modèles de rapport que d'autres personnes peuvent remplir et exécuter.
  • API REST — un accès programmatique à l'assistant pour vos propres applications.
  • Interface SPARQL, interface de liaison d'entités et tableur IA — des interfaces publiques pour les types de tâches spécialisés correspondants.
Avertissement
Les cartes affichées dépendent du type de tâche de l'assistant. Un assistant Discussion propose le chatbot de site web, l'interface de discussion et l'API REST ; un assistant Recherche propose l'interface de recherche ; un assistant Générateur de rapports propose le générateur de rapports. Les intégrations tierces ne sont listées que pour les assistants Discussion. Modifiez le type de tâche sous « Type de tâche » dans l'onglet Général de l'éditeur d'assistant.

Intégrations tierces

Sous les canaux intégrés, la section Intégrations tierces relie l'assistant à une plateforme externe. La plupart de ces intégrations reprennent le même widget de chatbot de site web, selon la manière propre à chaque plateforme d'ajouter du code personnalisé.

La grille de cartes Intégrations tierces sur la page Exposer

Chaque carte ouvre des instructions pas à pas pour la plateforme concernée. Les pages dédiées de cette section de la documentation les détaillent.

L'accès se règle une seule fois, pour tout l'assistant

Chaque canal intégré contient la même étape « Choisir votre accès ». Il s'agit d'un réglage au niveau de l'assistant : votre choix s'applique à toutes ses interfaces à la fois, et pas seulement à celle que vous configurez. Elle propose ces options :

  • Public — tout le monde peut utiliser l'assistant, sans connexion ni clé API.
  • Utilisateurs connectés — toute personne ayant un compte sur cette plateforme QAnswer, une fois connectée. Le chatbot de site web ne la propose pas, car les visiteurs de votre site ne sont pas connectés à QAnswer.
  • Uniquement avec une clé API — l'assistant reste privé et l'intégration y accède avec une clé API : l'une des clés existantes de l'assistant, ou une nouvelle générée sur place.
Note
Sous les options, un message d'état indique si l'intégration est prête. Tant qu'elle ne l'est pas, les étapes suivantes de chaque guide — l'extrait d'export et le lien public — restent grisées. Le partage avec des utilisateurs, des équipes ou des organisations précis est distinct et se trouve dans la boîte de dialogue Partager , ouverte depuis le bouton Partager dans la barre supérieure de l'assistant.

L'option Expose

Rendre un assistant accessible en dehors de QAnswer nécessite l'option Expose sur l'organisation à laquelle il appartient. Sans elle :

  • la page Expose affiche l'avis « Option Expose requise », et chaque carte de canal porte un badge « Option Expose ». Les canaux s'ouvrent toujours, mais en lecture seule : chacun affiche le même avis au-dessus de son guide, et toutes les étapes sont grisées et ne peuvent pas être modifiées ;
  • les clés API de l'assistant sont refusées : chaque widget, lien, appel REST ou intégration tierce qui en utilise une reçoit un HTTP 403 et le message « Cette clé API appartient à un assistant dont l'organisation ne dispose pas de l'option Expose ; elle ne peut donc pas être utilisée en dehors de QAnswer. » Les clés ne sont pas supprimées et fonctionnent de nouveau dès que l'organisation dispose de l'option.
La page Expose d'un assistant dont l'organisation ne dispose pas de l'option Expose : l'avis « Option Expose requise » avec son bouton, au-dessus des cartes de canaux portant chacune un badge « Option Expose »Un guide de canal ouvert sans l'option Expose : l'avis « Option Expose requise » au-dessus du guide d'accès API, grisé, si bien qu'aucune clé ne peut être générée

Le partage de l'assistant avec des utilisateurs, des équipes et des organisations dans QAnswer n'est pas concerné, pas plus que les assistants qui n'appartiennent à aucune organisation.

Note
Le bouton Obtenir l’option de l'avis ouvre la page de facturation de l'organisation, où un administrateur de l'organisation peut ajouter Expose. Voir Plans & Billing.
Note
Pour créer d'abord un assistant IA, consultez la section Créer un assistant IA .