Base de connaissances
Vérifié avec Cortex le 2 octobre 2026
La base de connaissances permet aux employés d’appuyer une réponse sur les documents internes de votre organisation. Le moteur IA extrait le texte, qui est découpé en fragments et vectorisé ; les fragments les plus proches de la question sont ajoutés au message. Chaque extrait passe par le filtrage DLP avant de quitter la passerelle. Elle se gère dans la console d’administration, sous « Base de connaissances », par les rôles « Administrateur » et « Gestionnaire de connaissances ».
Prérequis
Elle exige le moteur IA activé et un moteur d’embedding, c’est-à-dire un serveur compatible OpenAI qui sert /v1/embeddings (Ollama, vLLM…). Ces variables sont lues par le processus du moteur IA :
RAG_EMBEDDING_BACKEND_URL=http://ollama:11434/v1
RAG_EMBEDDING_MODEL=nom-exact-du-modele
L’URL inclut le préfixe /v1, et les deux variables vont ensemble. Le modèle doit avoir la largeur de vecteur de RAG_EMBEDDING_DIM (1024 par défaut), fixée pour chaque schéma à la migration. Ce moteur reçoit en clair le texte des documents et les questions : choisissez-en un que vous contrôlez.
La carte « Posture de la base de connaissances » indique l’état par « Active » ou « Inactive », avec la raison :
| Raison affichée | Effet |
|---|---|
| « Le nœud est désactivé dans la configuration du déploiement. » | Téléversements refusés |
| « Le nœud ne répond pas — les téléversements attendent dans la file. » | Téléversements en file |
| « Aucun modèle d'embedding n'est déclaré — les téléversements attendent dans la file. » | Téléversements en file |
| « Le modèle déclaré ne correspond pas à la largeur du schéma — les téléversements sont refusés. » | Téléversements refusés |
| « Le modèle déclaré ne correspond pas au modèle épinglé — les téléversements sont refusés. » | Téléversements refusés |
Quand les téléversements sont refusés, « Téléverser un document » est grisé. Tant que la posture n’est pas « Active », les employés n’ont pas le choix de la base de connaissances dans le chat. La carte affiche aussi les réglages en vigueur : « Extraits par réponse » (5), « Similarité minimale » (0.3), « Formats acceptés », « Taille maximale d'un document » (10 Mio) et « Documents » (1000 au plus). Ils se règlent par RAG_TOP_K, RAG_MIN_SIMILARITY, RAG_MAX_DOCUMENT_BYTES et RAG_MAX_DOCUMENTS, puis recréez le conteneur de la passerelle (docker compose up -d gateway).
Collections
Chaque document appartient à une collection, et l’accès se règle par collection. L’onglet « Collections » liste leur « Accès », leurs « Documents » et leur « État ». Une collection « General », ouverte à « Tous les services », existe dès l’installation.
Seul un « Administrateur » gère les collections. « Nouvelle collection » demande un « Nom » (unique sans égard à la casse), une « Description », « Activée » et l’« Accès » : « Tous les services » ou « Services choisis ». Un employé lit une collection si elle est activée et ouverte à tous les services ou à son service ; sans service, il ne voit que les collections ouvertes à tous. Une collection restreinte sans aucun service coché est « Lisible par personne ».
Le menu d’actions offre « Modifier », « Désactiver » (ou « Activer ») et « Supprimer ». Désactiver retire la collection de la recherche et des pages des employés, mais garde ses documents et accepte encore des téléversements. « Supprimer » n’est possible que si elle est vide (« Retirez d'abord ses documents »). Un « Gestionnaire de connaissances » voit les collections en lecture seule ; la console lui montre cette seule entrée.
Ajouter des documents
- En haut de la page, cliquez sur « Téléverser un document ».
- Choisissez la « Collection de destination ».
- Glissez un fichier sur la zone « Déposez un fichier ici ou parcourez », ou cliquez dessus pour en choisir un. La fenêtre rappelle les limites, par exemple « PDF, DOCX, XLSX, texte · 10 Mio maximum ».
- Cliquez sur « Téléverser ». Le document entre dans la liste.
- Suivez son « Statut » : « Téléversé », « En traitement », puis « Indexé » ou « Rejeté ». La liste se rafraîchit seule.
Les formats sont PDF, DOCX, XLSX et texte (le sélecteur propose .txt, .md et .csv). Le moteur IA reconnaît le type d’après le contenu, pas l’extension ; un texte doit être en UTF-8, et un PDF chiffré est rejeté. Au-delà de la taille permise, la console répond « Le fichier dépasse la taille permise par le déploiement. » ; au-delà du quota, « Le quota de documents est atteint — retirez des documents avant de téléverser. »
Pour un document « Rejeté », cliquez sur son statut : la raison s’affiche (type non pris en charge, texte introuvable ou non extractible, contenu qui ressemble à des données encodées, nœud sans réponse après trois tentatives…), avec « Retirer ». « Supprimer » retire n’importe quel document ; les réponses passées qui le citaient l’affichent comme indisponible.
Dans le chat
La page « Base de connaissances » du menu latéral des employés liste « Vos collections » (celles ouvertes à leur service ou à tous) et les « Documents que vous pouvez interroger », avec recherche et ouverture du texte indexé.
Dans la zone de saisie, le bouton « Base de connaissances » propose « Désactivée » (par défaut), « Toutes mes collections » ou une collection. Il n’apparaît que si la posture est « Active » et que la destination choisie est disponible, et il revient à « Désactivée » quand l’employé change de destination. Sans collection lisible, le bouton est inactif.
Sous la réponse, la carte « 2 sources de la base de connaissances » (le nombre varie) liste le fichier, la collection, le fragment et la pertinence. Cliquer une source ouvre le fragment cité dans un panneau ; il vient de l’index local et s’affiche sur le poste de l’employé. Sans passage assez proche, la réponse porte la mention « Base de connaissances consultée — aucun passage pertinent ». Si la base ne peut pas servir, par exemple parce que les extraits n’ont pas pu être vérifiés par le filtre DLP, elle indique « Base de connaissances non appliquée » avec la raison. Si l’employé désactive « Afficher les sources sous les réponses » dans « Paramètres » (actif par défaut), la carte et ces mentions disparaissent ; le panneau de transparence liste toujours les sources.