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

Une base de connaissances est une bibliothèque consultable de réponses : comment faire quelque chose, comment régler un problème, quelle est la règle. Pour en créer une, il faut des articles regroupés dans 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 constructeur d'applications IA peut produire la structure, l'éditeur et la recherche en une courte session. Ce qui rend une base de connaissances utile, c'est la rédaction et l'entretien; 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 leurs mots.
Documentation réservée aux clients — derrière une connexion, pour les clients payants ou les partenaires.
Base de connaissances interne — politiques, processus, guides pratiques 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 un paramètre de visibilité clair à chaque article, ou exploitez deux sites distincts.

Ce dont l'application a besoin

Données

Table	Champs clés
Articles	Titre, segment d'URL, résumé, contenu, catégorie, étiquettes, statut (brouillon, publié, archivé), visibilité, responsable, dernière révision, date de mise à jour
Catégories	Nom, segment d'URL, description, ordre, parent (facultatif)
Révisions	Article, contenu, auteur, date de sauvegarde
Rétroactions	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 : responsable (qui maintient l'article exact) et dernière révision (quand quelqu'un a confirmé pour la dernière fois qu'il est toujours vrai). Ensemble, ils permettent de lister les articles que personne n'a vérifiés depuis six mois.

Permissions

Les lecteurs voient les articles publiés qu'ils sont autorisés à voir. Les éditeurs créent et modifient des articles, peut-être limités à certaines catégories. Les administrateurs publient, archivent et gèrent les utilisateurs. Pour une base de connaissances interne, tout le monde a besoin d'une connexion; pour un centre d'aide public, seuls les rédacteurs en ont besoin.

Décisions et compromis

Éditeur : Markdown ou texte enrichi

Markdown est rapide, portable et fonctionne bien avec 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 semble plus familier. Quel que soit votre choix, enregistrez le contenu dans un format que vous pourrez exporter plus tard.

Recherche

Une simple recherche textuelle dans la base de données suffit pour quelques centaines d'articles si vous cherchez dans les titres, les résumés et le contenu, en classant d'abord les correspondances dans les titres. Au-delà, ou si les fautes de frappe et les synonymes comptent (« facture » et « note »), utilisez une recherche plein texte complète ou un service de recherche hébergé. Notre guide pour ajouter une recherche présente les options. Consignez chaque requête qui ne donne aucun 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 maintenant 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 ceux-ci — voir ce qu'est le RAG. Affichez toujours les articles sources, permettez la réponse « je ne sais pas », et rappelez-vous qu'elle 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, et non avant.

Gestion des versions et révision

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

Une première consigne 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 boîte 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 responsable et une date de dernière révision. Les pages d'articles affichent une table des matières, des articles connexes et une question « Cet article vous a-t-il été utile? » oui/non avec un commentaire facultatif. La recherche couvre les titres, les résumés et le contenu, avec les correspondances dans les titres classées en premier, et consigne chaque requête et si elle a donné des résultats. Une zone d'édition (connexion requise, rôles éditeur et administrateur) liste les brouillons, les articles non révisés 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 méta-description pour les moteurs de recherche. Design épuré, calme et lisible. Pensé d'abord pour le mobile.

Étapes de construction

Listez vos 20 à 30 premiers articles à partir de vraies questions de soutien 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 un téléphone — longueur des lignes, titres, images.
Éditeur et rôles. Les rédacteurs doivent pouvoir ajouter et corriger des articles sans demander l'aide d'un développeur.
Recherche, puis testez-la avec les mots que les clients utilisent réellement, y compris les fautes d'orthographe.
Rétroactions et journal de recherche.
Rapport des articles périmés fondé sur le responsable et la date de dernière révision.
Bases du référencement pour un site public : titres uniques, descriptions, URL propres, plan du site. Voir référencement des sites créés avec l'IA.
Ajoutez un lien depuis votre produit et vos réponses au soutien, puis surveillez 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 essaie de faire.
Des articles longs qui couvrent cinq tâches. Une tâche par article, avec un titre qui indique le problème résolu.
Aucun responsable par article. Personne ne met rien à jour, et la confiance baisse après la première mauvaise réponse.
Des notes internes dans les articles publics. Utilisez une visibilité distincte et révisez avant de publier.
Une recherche qui ne couvre que les titres. Les lecteurs tapent des symptômes, pas des noms d'articles.
Des captures d'écran sans texte alternatif ni contexte. Elles vieillissent vite; décrivez aussi l'étape en mots.

Quand un produit clé en main 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 difficile — notre comparaison Notion et Confluence couvre deux choix courants. Si vous utilisez un logiciel de service d'assistance, son centre d'aide intégré relie les articles aux billets et suggère des articles aux clients, ce qui est difficile à reproduire. Les générateurs de sites de documentation conviennent bien à la documentation pour développeurs tenue à côté du code.

Construisez la vôtre si vous avez besoin de votre propre structure ou de vos propres permissions (articles par client, par emplacement ou par rôle), si vous voulez que la base de connaissances fasse partie de votre produit plutôt que d'un site distinct, si vous avez besoin d'étapes de révision et d'approbation qu'un wiki n'impose pas, ou si vous voulez des réponses IA sur votre contenu sans un autre abonnement. Elle se combine naturellement avec un système de billetterie d'assistance personnalisé.

Le construire avec Mythex

Avec Mythex, vous décrivez la base de connaissances dans le clavardage et elle est construite dans un aperçu en direct; les articles, les révisions et les rétroactions sont enregistrés dans une base de données Postgres que l'agent ajoute au besoin, et les images vont dans le stockage de fichiers du projet. La connexion des éditeurs passe par une approche d'authentification de votre choix, car Mythex n'offre pas de connexion intégrée pour les utilisateurs finaux. Pour les réponses IA, vous utilisez la clé API de votre propre fournisseur d'IA, conservée comme secret du projet, et l'utilisation est facturée à votre compte chez ce fournisseur plutôt qu'en crédits Mythex (recette IA). Les nouvelles applications Mythex sont par défaut des applications React à rendu côté client, moins bien adaptées 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 une consigne 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 généralement encadrée : une petite équipe rédige et maintient les réponses pour un public défini, souvent des clients. Un wiki permet à tout le monde de modifier le contenu et tend à devenir plus large et plus désordonné. Le même logiciel peut servir aux deux; la différence tient à qui rédige et qui révise.

Comment organiser une base de connaissances?

Selon ce que les lecteurs essaient de faire, et non selon votre organigramme. Quelques catégories principales, des articles courts axés sur une tâche avec des titres clairs, et des liens entre les articles connexes 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), consiste à chercher dans vos articles les passages pertinents et à demander à un modèle de langage de répondre uniquement à partir de ces passages, avec des liens vers les sources. Elle 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 soutien, donc chaque article devrait avoir sa propre page, son titre et sa description. Gardez les articles internes sur un site distinct protégé par connexion.