Configurer le module Chatbot
Définir le slug d'organisation utilisé dans les adresses publiques, choisir les modèles disponibles et tout réindexer
À quoi ça sert
Deux réglages conditionnent le fonctionnement de tous les chatbots de l'organisation, et se règlent une fois pour toutes.
Le slug d'organisation est le morceau d'adresse qui identifie votre organisation dans les adresses publiques des chatbots. Il se règle dans « Chatbot » puis « Administration ».
Les modèles d'IA sont ce qui fait répondre les chatbots et ce qui indexe leurs sources. Sans eux, le module ne fonctionne pas du tout : la création de chatbot est bloquée et un avertissement « Configuration requise » s'affiche. Ils se règlent dans « Administration » puis « Modules », en ouvrant le module « Chatbot » et son onglet « Paramètres ».
Concepts clés
- Slug d'organisation — la portion d'adresse utilisée dans l'URL publique
des chatbots, de la forme
/chat/<slug>/<nom-du-chatbot>. - Modèle de réponse — un modèle de langage utilisable par les chatbots. La liste que vous constituez ici est celle que chaque chatbot pourra choisir.
- Modèle par défaut — celui proposé aux nouveaux chatbots, et celui vers lequel un chatbot bascule si son modèle est retiré de la liste.
- Modèle de génération de titre — celui qui rédige le titre d'une conversation au premier échange.
- Modèle d'embedding — celui qui indexe la base de connaissances et qui retrouve les passages pertinents. Il est obligatoire.
- Service d'extraction de documents — le service qui lit le texte des documents scannés lors de l'ingestion des sources.
- Transcription audio — le service qui transcrit les fichiers audio et vidéo ajoutés comme sources.
- Connexion IA — l'accès au fournisseur, défini une fois pour l'organisation et réutilisé par chaque emplacement de modèle. Voir Connexions IA.
Comment faire
Définir le slug d'organisation
- Ouvrez « Chatbot » puis « Administration ».
- Dans la carte « Slug d'organisation », renseignez le champ « Slug ».
- Cliquez sur « Sauvegarder ».
« Configuration sauvegardée » confirme l'enregistrement ; en cas d'échec,
« Erreur lors de la sauvegarde » s'affiche. Laissez le champ vide pour
utiliser le slug par défaut de l'organisation. La description de la carte
rappelle l'adresse obtenue : /chat/<slug>/nom-du-chatbot.
Ouvrir les réglages de modèles
- Ouvrez « Administration » puis « Modules ».
- Ouvrez le module « Chatbot ».
- Choisissez l'onglet « Paramètres ».
Le volet affiche, dans l'ordre : « Modèles de réponse », « Modèle par défaut » et « Modèle de génération de titre », « Modèle d'embedding », « Service d'extraction de documents » et « Transcription audio ». Un seul bouton « Enregistrer », en bas, valide l'ensemble.
Ajouter un modèle de réponse
- Dans « Modèles de réponse », cliquez sur « Ajouter un modèle ».
- Renseignez le « Nom affiché » : c'est ce que verront les utilisateurs dans les réglages de leurs chatbots.
- Choisissez la connexion IA à utiliser.
- Renseignez l'« Identifiant du modèle » tel que le fournisseur l'attend.
- Cliquez sur « Enregistrer ».
« Configuration des modèles du chatbot enregistrée » confirme la sauvegarde. Au moins un modèle est requis : le dernier de la liste ne peut pas être supprimé.
Choisir le modèle par défaut et le modèle de titre
- Dans les listes « Modèle par défaut » et « Modèle de génération de titre », choisissez un modèle parmi ceux de la liste.
- Cliquez sur « Enregistrer ».
Les deux listes ne proposent que les modèles déclarés au-dessus.
Configurer le modèle d'embedding
- Dans « Modèle d'embedding », choisissez la connexion IA.
- Renseignez l'« Identifiant du modèle » d'embedding.
- Cliquez sur « Enregistrer ».
- Si l'emplacement a changé, confirmez « Réindexer tous les chatbots ? ». La fenêtre annonce le nombre de chatbots et de fragments concernés.
La réindexation est lancée en arrière-plan. Pendant sa réindexation, un chatbot répond sans s'appuyer sur sa base de connaissances.
Configurer l'extraction de documents
- Dans « Service d'extraction de documents », choisissez la connexion IA dédiée.
- Cliquez sur « Enregistrer ».
Sans configuration, le texte des documents numérisés n'est pas extrait : une source scannée termine en erreur.
Configurer la transcription audio
- Dans « Transcription audio », choisissez la connexion IA.
- Renseignez l'« Identifiant du modèle » de transcription.
- Cliquez sur « Enregistrer ».
Sans configuration, les sources audio et vidéo sont refusées. Voir Alimenter le chatbot en sources de connaissance.
Consulter l'historique des modifications
- Ouvrez les réglages de modèles.
- Cliquez sur l'icône d'historique en haut du volet.
La liste datée des changements s'affiche : « Modèles mis à jour », « Modèle d'embedding configuré », « Modèle d'embedding réinitialisé », « Extraction de documents configurée », « Transcription audio configurée », « Transcription audio réinitialisée ». Sans modification enregistrée : « Aucune modification enregistrée. »
Réindexer toutes les sources d'un chatbot
- Ouvrez « Chatbot » puis « Administration », et ouvrez le chatbot.
- Dans l'onglet « Sources », cliquez sur « Réindexer ».
- Confirmez « Réindexer toutes les sources ».
« Réindexation démarrée : les sources sont retraitées en arrière-plan. » s'affiche. Utile après un changement de découpage : voir Régler la qualité des réponses.
Référence
Où se règle quoi
| Réglage | Emplacement | Portée |
|---|---|---|
| Slug d'organisation | « Chatbot » puis « Administration » | Toute l'organisation |
| Modèles de réponse, embedding, extraction, transcription | « Administration » puis « Modules », module « Chatbot », onglet « Paramètres » | Toute l'organisation |
| Modèle, température, longueur de réponse d'un chatbot | Onglet « Paramètres » du chatbot | Un chatbot |
| Découpage, recherche, évaluation | Onglet « Paramètres » du chatbot | Un chatbot |
Emplacements de modèle
| Emplacement | Obligatoire | Sans configuration |
|---|---|---|
| Modèles de réponse | Oui, au moins un | Le module est indisponible : « Configuration requise » |
| Modèle par défaut | Oui | L'enregistrement est refusé |
| Modèle de génération de titre | Oui | L'enregistrement est refusé |
| Modèle d'embedding | Oui | Le module est indisponible : les sources ne peuvent être ni indexées ni retrouvées |
| Service d'extraction de documents | Non | Le texte des documents numérisés n'est pas extrait |
| Transcription audio | Non | Les sources audio et vidéo sont refusées |
Comportements automatiques
- Retirer un modèle de la liste bascule automatiquement sur le modèle par défaut tous les chatbots qui l'utilisaient, y compris ceux qui sont archivés.
- Changer le modèle d'embedding ou sa connexion rend les index existants inutilisables : à l'enregistrement, tous les chatbots de l'organisation sont réindexés en arrière-plan. Le simple fait de faire passer le même modèle par une autre connexion équivalente ne déclenche pas de réindexation.
- Chaque modification des modèles est datée et conservée dans l'historique.
Quand le module est indisponible
Tant qu'aucun modèle de réponse ou aucun modèle d'embedding n'est configuré, la page « Chatbot » affiche « Configuration requise » et « Aucune connexion IA n'est configurée pour les chatbots. Demandez à un administrateur de l'organisation de configurer un modèle de réponse et un modèle d'embedding dans Administration > Modules. » Le bouton « Nouveau chatbot » est indisponible.
Messages
| Message | Situation |
|---|---|
| « Configuration sauvegardée » | Le slug d'organisation est enregistré |
| « Erreur lors de la sauvegarde » | Le slug d'organisation n'a pas pu être enregistré |
| « Configuration des modèles du chatbot enregistrée » | Les modèles sont enregistrés |
| « Au moins un modèle est requis » | La liste des modèles est vide |
| « Une connexion IA est requise » | Un emplacement n'a pas de connexion |
| « Le modèle par défaut doit faire partie de la liste » | Le modèle par défaut ne figure plus dans la liste |
| « Le modèle de titre doit faire partie de la liste » | Le modèle de titre ne figure plus dans la liste |
| « La configuration des modèles a été modifiée. Veuillez rafraîchir et réessayer. » | Un autre administrateur a enregistré entre-temps |
Questions fréquentes
Qui peut modifier ces réglages ? Le slug d'organisation se règle depuis l'administration du module Chatbot, réservée aux administrateurs de ce module. Les modèles se règlent depuis « Administration » puis « Modules », réservé aux administrateurs de l'organisation. Voir Modules.
Faut-il une clé d'accès par modèle ? Non. Les accès aux fournisseurs sont définis une seule fois comme connexions IA, puis réutilisés par chaque emplacement de modèle. Voir Connexions IA.
Puis-je changer le slug d'organisation après la publication d'un chatbot ? Oui, mais les adresses publiques déjà diffusées cesseront de fonctionner : elles contiennent l'ancien slug.
Combien de temps dure une réindexation ? Elle se déroule en arrière-plan et peut prendre plusieurs minutes selon le volume de sources. Aucune notification n'annonce sa fin : suivez l'avancement au statut des sources du chatbot.
Puis-je annuler une réindexation en cours ? Non, aucune interruption n'est proposée.