Tes agents
Bases de connaissances
Range ton site, tes fichiers et tes réponses dans une base de connaissances, puis relie-la à tes agents pour qu'ils répondent avec tes vrais faits.
Une base de connaissances, c’est ce que ton agent lit avant de répondre à un lead : les pages de ton site, tes fichiers et les réponses que tu écris toi-même. Tu crées une base une fois, puis tu la relies à un ou plusieurs agents. Tout se trouve sous Connaissances dans le menu.
Ce qu’est une base de connaissances
Section intitulée « Ce qu’est une base de connaissances »Ouvre Connaissances dans le menu. Chaque ligne est une base : un classeur qui porte un nom. Une base contient trois sortes de sources.
| Source | Ce que c’est |
|---|---|
| Un site web | Ses pages. Elles sont lues quand tu ajoutes le site, puis relues environ une fois par semaine avec un forfait payant. Les autres pages du site ne sont lues que si tu les choisis. |
| Un fichier | Une brochure, une grille de tarifs, un règlement. |
| Tes réponses | Des questions et des réponses que tu écris à la main. |
Une base est reliée à un ou plusieurs agents, qui répondent à partir d’elle. Un agent répond à partir d’une seule base à la fois.
Si tu as connu l’ancien tableau de bord : la page s’appelait Base de connaissances et une base contenait des Documents, des Sites web et des listes de Questions & réponses. Les documents sont maintenant des fichiers. Les listes de questions et réponses sont devenues Tes réponses : une par base, sans rien à créer ni à nommer. « Resynchroniser » s’appelle maintenant Relire le site, et connecter un agent se dit maintenant le relier. Les campagnes s’appellent maintenant des agents.
Ce que montre la page Connaissances
Section intitulée « Ce que montre la page Connaissances »Ouvre Connaissances. Le haut de la page compte tes bases. Chaque ligne montre quatre choses :
- Base : son nom.
- Contient : ce qu’elle contient, par exemple « 1 site · 2 fichiers · 12 réponses », ou Vide.
- Agents : les agents qui répondent à partir d’elle.
- État : un mot, comme Prête ou Lecture.
Les bases sont regroupées. À vérifier vient en premier : les bases illisibles, vides ou pas à jour alors qu’un agent qui n’est pas un brouillon répond à partir d’elles. Viennent ensuite les bases reliées à un agent, celles dont l’agent est en service d’abord. Les bases qu’aucun agent n’utilise sont repliées sous Sans agent en bas de page : clique sur Afficher. Au-delà de 6 bases, un champ de recherche cherche dans les noms des bases, des sources et des agents.
Clique sur une ligne pour ouvrir la base : son Contenu à gauche, ses Agents reliés à droite.
Créer une base de connaissances
Section intitulée « Créer une base de connaissances »- Ouvre Connaissances et clique sur Nouvelle base. Si tu n’as encore aucune base, le bouton indique Créer une base.
- Saisis le Nom de la base, par exemple le nom de ton entreprise. Il peut contenir jusqu’à 120 caractères.
- Clique sur Créer la base.
Tu arrives dans la nouvelle base. Elle est vide tant que tu n’as pas ajouté de source.
Créer une base demande un forfait payant et la permission Modifier les agents et leurs prompts. Chaque forfait comprend un nombre de bases : 1 avec Starter, 3 avec Business, 10 avec Scale. Une fois ce nombre atteint, la fenêtre affiche un message comme Ton forfait comprend 1 base de connaissances. et un lien Voir les forfaits. Avec le forfait gratuit, le bouton porte un cadenas et ouvre Créer et remplir une base, qui mène aux forfaits.
La base créée avec ton agent
Section intitulée « La base créée avec ton agent »Ouvre Connaissances : si tu as créé un agent à partir de ton site, une base est déjà là. Les pages lues pendant la création de l’agent ont été rangées dans une base, et l’agent y a été relié. C’est pareil pour un agent créé à partir d’un document. Si ton équipe avait déjà une base qui contenait le même site, le nouvel agent a été relié à cette base : rien n’est lu deux fois.
La création de l’agent reste rapide : elle lit la page d’accueil et jusqu’à cinq pages principales, pas tout le site. Pour que ton agent en lise d’autres, vois Ajouter d’autres pages d’un site.
Cela se passe aussi avec le forfait gratuit. La page indique alors que la base de ton agent a été remplie à sa création. Tu peux l’ouvrir, voir ses pages et cliquer sur Relire le site. Pour créer une autre base, ou pour ajouter un site, un fichier ou tes réponses, il faut un forfait payant.
Vois Créer ton agent IA.
Ajouter un site web
Section intitulée « Ajouter un site web »- Ouvre Connaissances, ouvre ta base et clique sur Ajouter.
- Sous Que veux-tu ajouter ?, choisis Un site web.
- Saisis l’Adresse du site, avec ou sans
https://. - Clique sur Lire ce site.
Ce qui est lu :
- L’adresse que tu as donnée d’abord, puis les pages trouvées sur le même domaine.
- Jusqu’au nombre de pages par site de ton forfait : 50, 150 ou 200. La fenêtre affiche le tien.
- Le texte seulement. Les images, les PDF et les autres fichiers du site sont ignorés.
La ligne du site affiche Lecture avec le nombre de pages restantes, puis Prête. Garde une page Connaissances ouverte pendant la lecture. Si tu la quittes, la lecture reprend à ton retour.
Deux messages peuvent t’arrêter. Ce site est déjà dans tes connaissances. veut dire que la base contient déjà ce site. Ce site ne s’ouvre pas. Vérifie l’adresse. veut dire que le site n’a pas pu être joint.
Ajouter un fichier
Section intitulée « Ajouter un fichier »- Ouvre Connaissances, ouvre ta base et clique sur Ajouter.
- Choisis Un fichier.
- Dépose le fichier dans la zone, ou clique sur la zone pour le choisir.
- Clique sur Ajouter le fichier.
Formats acceptés : PDF, Word (.docx, .doc), texte (.txt, .md), HTML et CSV. Un fichier à la fois, 50 Mo au plus.
La ligne du fichier affiche Lecture pendant qu’il est lu, puis Prête. La page se met à jour toute seule. Un autre format est refusé avec Ce format n’est pas lu. Choisis un PDF, un fichier Word, texte, HTML ou CSV. Un fichier trop lourd est refusé avec Ce fichier dépasse 50 Mo.
Clique sur un fichier pour ouvrir son panneau. Ouvrir affiche un fichier PDF, HTML, texte ou CSV dans le navigateur. Télécharger enregistre n’importe quel fichier. Il n’y a pas de bouton pour le modifier : pour mettre un fichier à jour, retire-le et ajoute la nouvelle version.
Ajouter une réponse que tu écris
Section intitulée « Ajouter une réponse que tu écris »- Ouvre Connaissances, ouvre ta base et clique sur Ajouter.
- Choisis Une réponse que tu écris.
- Remplis La question, par exemple « Y a-t-il un parking ? », puis Ta réponse.
- Clique sur Enregistrer la réponse.
Sers-t’en pour une question qu’on te pose souvent. Toutes les réponses d’une base apparaissent comme une seule source appelée Tes réponses, avec leur nombre. Tes agents peuvent utiliser une réponse dès qu’elle est enregistrée.
Limites : une question contient jusqu’à 1 000 caractères, une réponse jusqu’à 4 000, et une base contient jusqu’à 200 réponses avec tous les forfaits payants. À ce moment-là, la fenêtre indique Tu as atteint 200 réponses, le maximum.
Modifier ou supprimer une réponse
Section intitulée « Modifier ou supprimer une réponse »Ouvre Connaissances, ouvre la base et clique sur Tes réponses. Le panneau Questions et réponses les liste, la plus récente en premier.
- Le crayon (Modifier) ouvre la question et la réponse. Change-les et clique sur Enregistrer. Tes agents utilisent le nouveau texte aussitôt.
- La corbeille (Supprimer) demande Supprimer cette réponse ?. Clique sur Supprimer pour confirmer, ou sur Garder.
- Nouvelle réponse en ajoute une sans quitter le panneau, tant que la base n’a pas atteint 200 réponses.
Quand tu supprimes la dernière réponse d’une base, Tes réponses disparaît de son contenu. La source revient avec la prochaine réponse que tu enregistres.
Relier une base à un agent
Section intitulée « Relier une base à un agent »Deux endroits font la même chose.
Depuis la base : ouvre Connaissances, ouvre la base et regarde Agents reliés à droite. Clique sur Relier un agent, coche un ou plusieurs agents, puis clique sur le bouton qui indique Relier 1 agent, avec ton propre nombre. Les agents sont regroupés sous Actifs et En pause. Les brouillons sont derrière un lien en bas de la liste.
Depuis l’agent : ouvre Agents, clique sur ton agent, puis sur l’onglet Réglages et la section Connaissances. Choisis une base dans la liste Base de connaissances et clique sur Enregistrer.
Un agent répond à partir d’une seule base à la fois. Si l’agent que tu choisis utilise déjà une autre base, la fenêtre te prévient : Cet agent quittera la base qu’il utilise aujourd’hui. Plusieurs agents peuvent partager la même base.
Délier une base d’un agent
Section intitulée « Délier une base d’un agent »Ouvre Connaissances, ouvre la base et, dans Agents reliés, clique sur l’icône Délier sur la ligne de l’agent. Ou ouvre Agents, clique sur ton agent, puis sur l’onglet Réglages et la section Connaissances, choisis Aucune dans la liste Base de connaissances et clique sur Enregistrer.
La base et son contenu ne bougent pas : seul le lien disparaît. L’agent n’a alors plus de connaissances. Il répond à partir de son prompt seul, et ses réglages indiquent qu’il n’est relié à aucune base. Tu peux le relier à une autre base quand tu veux.
Une base qu’aucun agent n’utilise passe dans le groupe Sans agent, en bas de la page Connaissances.
Comment ton agent utilise la base dans une conversation
Section intitulée « Comment ton agent utilise la base dans une conversation »Il n’y a rien à activer. Dès qu’une base est reliée (ouvre Agents, ton agent, Réglages, puis Connaissances pour vérifier), ton agent s’en sert chaque fois qu’il répond à un message d’un lead.
- Il cherche dans la base avec les derniers messages du lead et garde les passages qui correspondent le mieux, 4 au plus.
- Ces passages lui sont remis comme matière pour les faits, avec la page ou le fichier d’où ils viennent.
- Ton contenu peut être écrit dans une autre langue que la conversation : l’agent continue de répondre dans la langue du lead.
- Quand rien dans la base ne correspond, il répond à partir de son prompt seul.
- Si la base est injoignable un instant, la réponse part quand même.
Le premier message et les relances automatiques ne cherchent pas dans la base. Une page, un fichier ou une réponse sert dès qu’il a été lu. Tu peux vérifier ce que répond ton agent dans son onglet Tester : vois Tester ton agent.
Ce que veulent dire les états
Section intitulée « Ce que veulent dire les états »Sur la page Connaissances et dans une base, chaque ligne porte un état.
| État | Signification |
|---|---|
| Lecture | Un site ou un fichier est en cours de lecture. Pour un site, le nombre de pages restantes suit. |
| Prête | La source a été lue et tes agents peuvent s’en servir. |
| Illisible | La lecture a échoué. Ouvre la ligne pour voir pourquoi. |
| Vide | Rien n’a encore été lu. Une base sans source est vide aussi. |
| Pas à jour | Le site n’a pas été relu en entier depuis plus de 30 jours, alors qu’un agent qui n’est pas un brouillon répond à partir de la base. |
| Sans agent | Affiché sur une base : son contenu est prêt, mais aucun agent n’y est relié. |
Un site passe à Prête dès qu’une de ses pages a été lue, même si d’autres pages ont échoué. Une base prend l’état de ses sources : Lecture tant que l’une d’elles est lue, Illisible quand l’une d’elles a échoué.
Une source est marquée Illisible
Section intitulée « Une source est marquée Illisible »Ouvre Connaissances, ouvre la base et clique sur la ligne marquée Illisible. Le panneau donne la raison.
| Message | Que faire |
|---|---|
| Le site ne répond pas. Vérifie son adresse, puis relis-le. | Vérifie que le site est en ligne, puis clique sur Relire sur sa ligne. |
| Aucun texte lisible n’a été trouvé sur ces pages. | Les pages ne contiennent pas de texte, par exemple seulement des images. Ajoute ce contenu sous forme de fichier ou de réponses. |
| La lecture a échoué. Relis la source pour réessayer. | Pour un site, clique sur Relire. Pour un fichier, retire-le et ajoute-le de nouveau. |
Dans un site à l’état Prête, une page seule peut quand même indiquer Page illisible dans la liste des pages. Les autres pages servent normalement.
Mettre à jour un site web
Section intitulée « Mettre à jour un site web »Ouvre Connaissances, ouvre la base et clique sur le site. Son panneau indique quand a eu lieu la dernière lecture complète.
- Chaque semaine, un site est relu tout seul quand sa base est reliée à un agent actif ou en pause et que ton équipe a un forfait payant. Cette relecture couvre les pages déjà connues. Elle ne cherche pas de nouvelles pages.
- Relire le site, en bas du panneau, relit tout de suite les pages que ton agent a déjà. Il n’en ajoute pas : les nouvelles pages du site se choisissent avec Voir les autres pages du site.
- Une page dont le texte n’a pas changé garde ce qui en avait déjà été appris.
Avec le forfait gratuit, il n’y a pas de relecture hebdomadaire : clique toi-même sur Relire le site. Quand un site n’a pas été relu depuis plus de 30 jours alors qu’un agent l’utilise, sa ligne affiche Pas à jour avec un bouton Relire.
Ajouter d’autres pages d’un site
Section intitulée « Ajouter d’autres pages d’un site »Un site ne grandit jamais tout seul dans ta base : seules les pages que ton agent a déjà sont relues. Pour qu’il en lise d’autres, comme une page de services ou un nouvel article, c’est toi qui choisis. Il faut un forfait payant.
- Ouvre Connaissances, ouvre la base et clique sur le site. Le haut du panneau dit combien de pages ton agent a lues, par exemple « Ton agent a lu 1 page de ce site. »
- Clique sur Voir les autres pages du site. Les pages du site sont cherchées une fois, puis listées sous Autres pages du site.
- Coche les pages que ton agent doit lire. Les pages légales, de compte ou d’offres d’emploi sont décochées au départ, avec la mention Page légale, de compte ou d’emploi : tu peux quand même les cocher. Tout cocher et Tout décocher vont plus vite.
- Clique sur Lire ces pages en bas du panneau. Le bouton dit combien de pages tu as cochées.
Le panneau affiche « 14 pages ajoutées : ton agent les lit maintenant. » La ligne du site passe à Lecture, puis à Prête. Les pages ajoutées sont relues chaque semaine avec les autres.
- La liste reste en mémoire : la rouvrir ne recherche pas le site. Chercher à nouveau le recherche, par exemple après la mise en ligne de nouvelles pages.
- Ton forfait fixe le nombre de pages par site (50, 150 ou 200). Si tu en coches plus qu’il n’en reste, un message le dit et le bouton attend que tu en décoches.
- Aucune autre page trouvée : ton agent a déjà toutes les pages de ce site. veut dire qu’il n’y a rien à ajouter.
Ignorer une page d’un site
Section intitulée « Ignorer une page d’un site »Ouvre Connaissances, ouvre la base et clique sur le site. Le panneau liste les Pages que ton agent lit, chacune avec un interrupteur. Au-delà de 8 pages, un champ Chercher une page apparaît.
- Éteins l’interrupteur d’une page : tes agents cessent aussitôt de s’en servir, et la page indique Page ignorée.
- Rallume-le : la page indique En attente de lecture, puis sert de nouveau une fois lue.
- Une page ignorée le reste quand le site est relu, par toi ou par la relecture hebdomadaire.
Sers-t’en pour les pages que ton agent ne doit pas citer, comme une ancienne offre ou des mentions légales. Ouvrir le site ouvre le site dans un nouvel onglet.
Retirer un site ou un fichier
Section intitulée « Retirer un site ou un fichier »Ouvre Connaissances, ouvre la base et clique sur le site ou sur le fichier. En bas du panneau, clique sur Retirer ce site ou Retirer ce fichier, puis confirme avec Retirer. Garder annule.
Tes agents oublient aussitôt cette source : ses pages ou son contenu ne servent plus dans les réponses. Pour un fichier, la copie enregistrée est supprimée aussi.
Retirer une source libère une place dans le compte de sites ou de fichiers que ton forfait prévoit pour cette base.
Renommer ou supprimer une base
Section intitulée « Renommer ou supprimer une base »Ouvre Connaissances et ouvre la base.
- Renommer : clique sur le nom de la base en haut, saisis le nouveau et appuie sur Entrée. Tu peux aussi ouvrir Autres actions, le bouton à trois points, et choisir Renommer.
- Supprimer : ouvre Autres actions, choisis Supprimer la base et confirme.
Limites par forfait
Section intitulée « Limites par forfait »Ouvre Abonnement, puis Comparer en détail, pour retrouver ces chiffres dans l’application.
| Forfait | Bases de connaissances | Sites web par base | Pages lues par site | Fichiers par base | Réponses par base |
|---|---|---|---|---|---|
| Starter | 1 | 1 | 50 | 3 | 200 |
| Business | 3 | 3 | 150 | 5 | 200 |
| Scale | 10 | 10 | 200 | 10 | 200 |
Avec le forfait gratuit, tu ne peux ni créer une base ni ajouter une source : les boutons Nouvelle base et Ajouter portent un cadenas et mènent aux forfaits. Tu gardes la base remplie à la création de ton agent, et tu peux relire son site.
Quand une limite est atteinte, la fenêtre Ajouter le dit, par exemple Ton forfait comprend 1 site., avec un lien Voir les forfaits. Vois Abonnement & facturation.
Qui peut modifier les connaissances
Section intitulée « Qui peut modifier les connaissances »Toute personne qui a la permission Voir les agents peut ouvrir Connaissances et lire ce que contient une base. Créer une base, ajouter ou retirer une source, relire un site et relier des agents demandent la permission Modifier les agents et leurs prompts.
- Propriétaire, Admin et Éditeur peuvent tout modifier sur cette page.
- Un Lecteur consulte seulement : les boutons qui modifient quelque chose ne sont pas affichés.
- Un Répondant ne voit pas Connaissances dans le menu.
Un jeu de permissions sur mesure suit les deux mêmes règles. Vois Équipe & rôles.
Les connaissances dans l’API et avec un assistant IA
Section intitulée « Les connaissances dans l’API et avec un assistant IA »GET /knowledge-basesliste tes bases, leurs sources et les agents reliés à chacune.GET /knowledge-bases/{id}/searchrenvoie les passages qu’un agent reçoit pour un message, avec la même recherche que lorsqu’il répond.- Les réponses de Tes réponses s’ajoutent, se corrigent et se retirent avec
POST,PATCHetDELETEsur/knowledge-bases/{id}/answers. Les sites et les fichiers s’ajoutent ici, dans le dashboard.
Vois API : bases de connaissances.