Comment créer une base de connaissances : articles, recherche, droits et réponses IA

Une base de connaissances est une bibliothèque de réponses consultable : comment faire quelque chose, comment résoudre un problème, quelle est la règle. Pour en créer une, il vous faut des articles regroupés en quelques catégories claires, un éditeur que vos rédacteurs utiliseront vraiment, une recherche qui trouve le bon article à partir des mots que les gens tapent réellement, et une décision sur qui peut lire quoi — le public, les clients connectés, ou le personnel seulement. Un créateur d'applications par IA peut produire la structure, l'éditeur et la recherche en une courte session. Ce qui rend une base de connaissances utile, ce sont la rédaction et la mise à jour ; concevez donc dès le premier jour pour faciliter la modification et repérer les articles périmés.

Décidez d'abord à qui elle s'adresse

Les mêmes fonctionnalités servent des sites très différents :

Centre d'aide public — pour les clients et les prospects. Doit être rapide, indexable par les moteurs de recherche et rédigé dans leur langue.
Documentation réservée aux clients — derrière une connexion, pour les clients payants ou les partenaires.
Base de connaissances interne — politiques, processus, procédures pour le personnel. Doit être privée ; la recherche et la fraîcheur comptent plus que le design.

Mélanger articles publics et internes dans un même site est la source de la plupart des fuites. Si vous avez besoin des deux, attribuez à chaque article un réglage de visibilité clair, ou gérez deux sites distincts.

Ce dont l'application a besoin

Données

Table	Champs clés
Articles	Titre, slug, résumé, contenu, catégorie, étiquettes, statut (brouillon, publié, archivé), visibilité, propriétaire, date de dernière relecture, date de mise à jour
Catégories	Nom, slug, description, ordre, parent (facultatif)
Révisions	Article, contenu, auteur, date de sauvegarde
Retours	Article, utile oui/non, commentaire, date de création
Journal de recherche	Requête, nombre de résultats, article cliqué, date de création

Deux champs font beaucoup de travail : propriétaire (qui veille à l'exactitude de l'article) et date de dernière relecture (quand quelqu'un a confirmé pour la dernière fois qu'il est toujours vrai). Ensemble, ils vous permettent de lister les articles que personne n'a vérifiés depuis six mois.

Droits d'accès

Les lecteurs voient les articles publiés qu'ils ont le droit de consulter. Les éditeurs créent et modifient des articles, éventuellement limités à certaines catégories. Les administrateurs publient, archivent et gèrent les utilisateurs. Pour une base interne, tout le monde doit se connecter ; pour un centre d'aide public, seuls les rédacteurs doivent le faire.

Décisions et compromis

Éditeur : Markdown ou texte enrichi

Markdown est rapide, portable et se prête bien à l'historique des versions, mais certains rédacteurs le trouvent déroutant. Un éditeur de texte enrichi avec titres, listes, images, encadrés et blocs de code paraît plus familier. Quel que soit votre choix, stockez le contenu dans un format que vous pourrez exporter plus tard.

Recherche

Une simple recherche textuelle en base suffit pour quelques centaines d'articles si vous cherchez dans les titres, résumés et contenus, en classant mieux les correspondances dans les titres. Au-delà, ou si les fautes de frappe et les synonymes comptent (« facture » ou « note »), utilisez une vraie recherche plein texte ou un service de recherche hébergé. Notre guide pour ajouter une recherche présente les options. Enregistrez chaque requête sans résultat : c'est une liste gratuite d'articles à rédiger.

Réponses IA

Une case « posez une question » qui répond à partir de vos articles est désormais courante. Elle fonctionne en récupérant les passages les plus pertinents et en demandant à un modèle de langage de répondre uniquement à partir de ces passages — voir ce qu'est le RAG. Affichez toujours les articles sources, autorisez la réponse « je ne sais pas », et gardez à l'esprit que l'outil répétera avec assurance tout ce qui est périmé dans vos articles. Construisez-la une fois que les articles sont en bon état, pas avant.

Versions et relecture

Conservez les révisions pour voir qui a modifié quoi et pouvoir revenir en arrière. Pour les contenus réglementés (politique RH, procédures de sécurité), ajoutez une étape d'approbation avant la publication d'une modification.

Un premier prompt qui fonctionne

Crée un centre d'aide public pour Parcelly, une application d'étiquettes d'expédition pour les petites boutiques en ligne. Page d'accueil avec une grande zone de recherche et six catégories (Premiers pas, Impression des étiquettes, Transporteurs, Facturation, Retours, Dépannage). Les articles ont un titre, un résumé, un contenu en Markdown avec images et encadrés, une catégorie, des étiquettes, un statut (brouillon, publié, archivé), un propriétaire et une date de dernière relecture. Les pages d'article affichent une table des matières, des articles associés et une question « Cela vous a-t-il été utile ? » oui/non avec un commentaire facultatif. La recherche porte sur les titres, résumés et contenus, avec les correspondances dans les titres classées en premier, et enregistre chaque requête et si elle a donné des résultats. Un espace éditeur (connexion obligatoire, rôles éditeur et administrateur) liste les brouillons, les articles non relus depuis 180 jours et les articles mal notés, et conserve l'historique des révisions. Chaque article a son propre titre de page et sa propre meta description pour les moteurs de recherche. Design propre, calme et lisible. Pensé d'abord pour mobile.

Étapes de création

Listez vos 20 à 30 premiers articles à partir de vraies questions de support avant de construire quoi que ce soit. Cette liste façonne les catégories.
Générez le site et vérifiez la lecture sur téléphone — longueur des lignes, titres, images.
Éditeur et rôles. Les rédacteurs doivent pouvoir ajouter et corriger des articles sans demander à un développeur.
Recherche, puis testez-la avec les mots que les clients emploient réellement, y compris avec des fautes de frappe.
Retours et journalisation des recherches.
Rapport des articles périmés basé sur le propriétaire et la date de dernière relecture.
Bases du SEO pour un site public : titres et descriptions uniques, URL propres, plan du site. Voir le SEO pour les sites créés avec l'IA.
Liez-la depuis votre produit et vos réponses au support, puis suivez chaque semaine le journal des recherches sans résultat.
Réponses IA, une fois le contenu solide.

Erreurs courantes

Organiser par service au lieu de selon ce que le lecteur cherche à faire.
Des articles longs qui couvrent cinq tâches. Une tâche par article, avec un titre qui dit quel problème il résout.
Aucun propriétaire par article. Personne ne met rien à jour, et la confiance baisse après la première réponse erronée.
Des notes internes dans les articles publics. Utilisez une visibilité distincte et relisez avant de publier.
Une recherche qui ne porte que sur les titres. Les lecteurs tapent des symptômes, pas des noms d'articles.
Des captures d'écran sans texte alternatif ni contexte. Elles deviennent vite obsolètes ; décrivez aussi l'étape en mots.

Quand un produit prêt à l'emploi est le meilleur choix

Si votre équipe travaille déjà dans un outil de documentation ou de wiki, une base de connaissances interne s'y trouve généralement le chemin le moins coûteux — notre comparatif Notion vs Confluence couvre deux choix courants. Si vous utilisez un logiciel de helpdesk, son centre d'aide intégré relie les articles aux tickets et suggère des articles aux clients, ce qui est difficile à reproduire. Les générateurs de sites de documentation conviennent parfaitement à la documentation pour développeurs tenue à côté du code.

Créez la vôtre lorsque vous avez besoin de votre propre structure ou de vos propres droits (articles par client, par site, par rôle), que vous voulez la base de connaissances dans votre produit plutôt que sur un site séparé, que vous avez besoin d'étapes de relecture et d'approbation qu'un wiki n'impose pas, ou que vous voulez des réponses IA sur votre contenu sans un autre abonnement. Elle se combine naturellement avec un helpdesk sur mesure.

Le construire avec Mythex

Avec Mythex, vous décrivez la base de connaissances dans le chat et elle est construite dans un aperçu en direct ; les articles, révisions et retours sont stockés dans une base Postgres que l'agent ajoute au besoin, et les images vont dans le stockage de fichiers du projet. Les connexions des éditeurs utilisent une méthode d'authentification que vous choisissez, car Mythex n'a pas de connexion utilisateur intégrée. Pour les réponses IA, vous utilisez la clé API de votre propre fournisseur d'IA, stockée comme secret du projet, et la consommation est facturée sur votre compte fournisseur plutôt que sur les crédits Mythex (recette IA). Les nouvelles applications Mythex utilisent par défaut une application React rendue côté client, moins bien adaptée aux moteurs de recherche ; pour un centre d'aide public, demandez donc une configuration statique ou rendue côté serveur, comme Next.js (recette SEO).

Pour un prompt de départ, essayez les modèles hub de connaissances produit ou application de documentation d'équipe.

Questions

Quelle est la différence entre une base de connaissances et un wiki ?

Une base de connaissances est en général éditorialisée : une petite équipe rédige et maintient les réponses pour un public défini, souvent des clients. Un wiki permet à chacun de modifier le contenu et tend à grossir de façon plus large et plus désordonnée. Le même logiciel peut servir les deux ; la différence tient à qui écrit et qui relit.

Comment organiser une base de connaissances ?

Selon ce que les lecteurs cherchent à faire, et non selon votre organigramme. Quelques catégories principales, des articles courts centrés sur une tâche avec des titres clairs, et des liens entre les articles liés fonctionnent mieux que des arborescences de dossiers profondes.

Puis-je ajouter des réponses IA à une base de connaissances ?

Oui. L'approche habituelle, appelée génération augmentée par récupération (RAG), recherche dans vos articles les passages pertinents et demande à un modèle de langage de répondre uniquement à partir de ces passages, avec des liens vers les sources. Cela fonctionne mieux lorsque les articles eux-mêmes sont exacts et à jour.

Un centre d'aide public doit-il être indexé par les moteurs de recherche ?

En général, oui. Les gens cherchent comment résoudre un problème avant de contacter le support, donc chaque article doit avoir sa propre page, son titre et sa description. Gardez les articles internes sur un site séparé, protégé par un identifiant.