KB Doctor
=========

KB Doctor est un contrôle qualité automatique du contenu de votre base de connaissances. Il utilise un LLM pour signaler les problèmes qui feraient mal répondre un agent — texte destiné à un rédacteur humain, contenus à compléter, contradictions, ou document rédigé dans la mauvaise langue — afin que vous puissiez les corriger avant que de vrais appelants ne les rencontrent.

KB Doctor ne modifie jamais votre contenu. Il se contente de rapporter des remarques ; c'est vous qui décidez quoi changer. Les remarques sont indicatives — examinez chacune d'elles, il peut occasionnellement s'agir de faux positifs.

Deux niveaux de contrôle
------------------------

Les vérifications s'effectuent à deux niveaux, car certains problèmes se trouvent dans un seul document et d'autres n'apparaissent qu'à l'échelle de toute la collection.

NiveauRechercheAffiché comme   **Par document**Problèmes à l'intérieur d'un seul document.Badges sur la ligne de ce document. **Collection**Problèmes visibles uniquement entre plusieurs documents.Une bannière sur la base de connaissances. Remarques par document
----------------------

TypeCe qu'elle détecte   **Notes humaines**Texte adressé à un rédacteur humain plutôt qu'à un appelant — « à vérifier », « à faire valider », « je n'ai pas trouvé le PDF officiel », avertissements éditoriaux ou citations de sources. L'agent risque de les lire à voix haute. **Contenu à compléter**Marqueurs TODO, sections vides, « à compléter », restes de brouillon ou de modèle à l'intérieur du document. (Un renvoi vers un autre document de la même base de connaissances n'est pas un contenu à compléter et n'est pas signalé.) **Contradiction**Un même fait énoncé avec deux valeurs différentes au sein du même document. **Langue incohérente**La langue principale du document diffère de la langue configurée pour la base de connaissances. Remarques au niveau de la collection
------------------------------------

TypeCe qu'elle détecte   **Informations essentielles manquantes**Pour une base de connaissances qui sert une entreprise physique, recevant du public (boutique, cabinet, restaurant, garage…), une information de contact essentielle — adresse postale, numéro de téléphone ou horaires d'ouverture — absente de toute la collection. Non signalé pour les logiciels, les SaaS, les services téléphoniques/vocaux, ou tout ce qui n'a pas de lieu physique que les clients visitent. **Contradiction entre documents**Deux documents énoncent le même fait avec des valeurs différentes (ex : horaires d'ouverture ou chiffres différents). Gravité
-------

Chaque remarque porte un niveau de gravité — **warning** (susceptible de nuire aux réponses, à corriger) ou **info** (à examiner). Une remarque comprend une brève explication du problème en langage clair et, le cas échéant, une courte citation textuelle du contenu montrant où il se produit.

Quand les vérifications s'exécutent
-----------------------------------

KB Doctor s'exécute automatiquement après l'ingestion, de sorte qu'une base de connaissances fraîchement téléversée ou re-crawlée est contrôlée sans aucune action de votre part. Vous pouvez aussi le relancer à la demande avec l'action **Lancer le contrôle qualité** sur la base de connaissances après avoir modifié le contenu. L'heure de la dernière exécution est enregistrée afin que vous sachiez à quel point les remarques sont à jour.

Agir sur les remarques
----------------------

1. Ouvrez le document signalé (ou la base de connaissances pour une remarque de collection).
2. Corrigez le contenu — supprimez les notes éditoriales et les contenus à compléter, résolvez les contradictions, ajoutez les informations de contact manquantes, ou déplacez un document rédigé dans la mauvaise langue vers une base de connaissances dans cette langue.
3. Re-téléversez ou relancez la vérification. Les remarques résolues disparaissent lors du prochain contrôle.

Comme l'agent récupère et peut lire à voix haute le texte de votre base de connaissances, les remarques « notes humaines » et « contenu à compléter » sont les plus importantes — ce sont les phrases qu'un appelant ne devrait jamais entendre. Voir [Téléverser des documents](/docs/knowledge-bases/upload) pour savoir ce qui rend un document prêt pour l'agent.