Base de connaissances
La base de connaissances rassemble ce que vos agents doivent savoir : procédures, FAQ, conditions, fiches produit, documents de référence. Elle appartient à votre organisation ; un agent la consulte au moment où il en a besoin, par un tool, au lieu de tout porter dans sa mission.
Ce qu'elle contient
Trois types d'entrées :
| Type | Contenu |
|---|---|
| Fiche | Un texte Markdown, écrit directement dans l'admin |
| Document | Un fichier téléversé, dont le texte est extrait automatiquement pour les agents |
| Dossier | Un classeur pour organiser fiches et documents |
Formats de document acceptés : PDF, Word (.doc, .docx), Excel (.xls, .xlsx), PowerPoint (.ppt, .pptx), texte, Markdown, HTML, CSV et images — jusqu'à 50 Mo par fichier.
L'extraction lit le texte des formats bureautiques et des PDF. Pour une image ou un PDF scanné (quasi sans texte), elle passe par le modèle multimodal (vision) de votre organisation. Une extraction qui échoue peut être relancée depuis l'admin.
Toute écriture dans la base est journalisée. La modifier exige l'accès à la section Connaissance et indexation ; la lecture est ouverte aux membres de l'organisation.
Ce que vos agents en font
Deux tools, à attacher à un agent :
knowledge.search— recherche par mots-clés, pondérée (étiquettes, puis nom, description, contenu). Rend l'entrée la plus pertinente.knowledge.semantic_search— recherche sémantique (par le sens, pas par les mots exacts). Rend des extraits avec leur source et leur score.
Les résultats sont présentés à l'agent comme matériau source : il répond dans la langue de l'utilisateur et ne doit pas affirmer au-delà de ce que dit la source.
Recherche sémantique
Pour la recherche sémantique, les fiches et le texte extrait des documents sont découpés et indexés dans une base vectorielle (Qdrant). Les embeddings sont calculés par le modèle bge-m3, servi par Ollama à l'intérieur de notre infrastructure : le texte de votre base n'est pas envoyé à un fournisseur d'embeddings tiers.
La synchronisation est automatique : une fiche créée ou modifiée est réindexée, une entrée supprimée est retirée de l'index, et une indexation qui échoue est réessayée. La recherche sémantique dépend de son activation sur l'instance ; à défaut, le tool oriente l'agent vers knowledge.search.
Portée par modèle
Par défaut, un modèle cherche dans toute la base de son organisation. Vous pouvez restreindre ce qu'il voit, depuis l'onglet Base de connaissance du modèle :
- cocher un dossier donne accès à tout son contenu, y compris ce qui y sera ajouté plus tard ;
- cocher une fiche ou un document ne donne accès qu'à lui.
La même portée s'applique aux deux tools de recherche. C'est un outil de pertinence (un assistant RH n'a pas à lire la FAQ commerciale) ; le cloisonnement de sécurité, lui, est celui de l'organisation : la base d'une organisation n'est jamais lisible par une autre.
Partager un document par lien
Une fiche ou un document peut être publié par lien (/shared/…), pour un partenaire ou un client qui n'a pas de compte betool. Les dossiers ne se partagent pas.
- Mot de passe facultatif — demandé aussi pour le téléchargement du fichier.
- Expiration facultative, de 1 jour à 5 ans ; sans expiration, le lien vit jusqu'à sa révocation.
- Révocation à tout moment ; republier crée un nouveau lien et révoque l'ancien ; supprimer l'entrée révoque son lien. Un lien révoqué, expiré ou inconnu rend la même page introuvable.
- Rendu : un PDF ou une image s'affiche dans la page ; un document Markdown est rendu mis en forme ; une page HTML s'affiche dans un cadre isolé (sans script ni ressource distante). Les autres formats se téléchargent, avec le texte extrait affiché quand il existe.
- Les pages partagées ne sont pas indexables par les moteurs de recherche, et le nombre de consultations est suivi.
Mettre à jour sans changer le lien
Remplacer le fichier d'un document conserve son identifiant, donc le lien déjà distribué : il sert immédiatement la nouvelle version. Le texte lu par les agents est ré-extrait du nouveau fichier, si bien que ce que lisent vos agents et ce que voit votre partenaire ne peuvent pas diverger.
Mettre à jour par proposition
Un agent (ou une application branchée en MCP) peut proposer de faire évoluer la base, sous validation humaine :
knowledge_update— créer ou mettre à jour une fiche texte (remplacement complet, d'une section, ou ajout en fin).knowledge_document_replace— remplacer le fichier d'un document, en place, lien public conservé.
Rien ne s'applique sans un Accepter explicite.