Construire une base de connaissances que votre IA sait lire
Une IA ne répond bien que si elle trouve la bonne information, écrite clairement, dans sa dernière version. Voici comment écrire et ranger vos documents pour que ce soit le cas.
Une base de connaissances pour IA, ce n’est pas un wiki de plus
Beaucoup d’équipes ont déjà essayé le wiki interne. On le remplit avec enthousiasme pendant un mois, puis plus personne ne l’ouvre, et il vieillit en silence.
Une base lue par des assistants IA échappe à ce destin pour une raison simple : elle sert tous les jours, sans que personne ait à l’ouvrir. Chaque fois que quelqu’un pose une question à son IA, la base est consultée. Un document utile produit un effet immédiat, et un document faux aussi. L’équipe a donc une raison concrète de la tenir à jour.
Mais le lecteur a changé, et cela modifie la façon d’écrire. Un collègue qui lit une page devine ce qui manque, sait qui appeler, reconnaît une version périmée. Un assistant IA lit ce qui est écrit, et seulement cela.
Comment un assistant lit vos documents
Pour écrire utilement, il faut savoir ce qui se passe quand votre IA consulte la base.
- Elle cherche. À partir de votre question, elle lance une recherche avec quelques mots. Le résultat dépend des mots présents dans vos documents et de leurs titres.
- Elle reçoit des extraits. Quelques passages courts, avec l’endroit d’où ils viennent. C’est sur cette base qu’elle décide quoi lire.
- Elle lit une partie. Elle ouvre le document le plus prometteur et en lit la section utile, pas forcément le reste.
- Elle répond, en s’appuyant sur ce qu’elle a lu.
Trois règles d’écriture en découlent directement.
- Les mots de la question doivent être dans le document. Si tout le monde dit « devis » et que votre document parle de « proposition tarifaire », la recherche passe à côté.
- Chaque section doit se comprendre seule. L’assistant peut lire la section 4 sans avoir lu la 1. Un « comme vu plus haut » ne lui dit rien.
- Un document doit dire s’il est valable. Entre deux versions qui se contredisent, l’IA ne peut pas deviner laquelle vous appliquez.
Quoi écrire en premier
Ne cherchez pas à tout couvrir. Commencez par ce que vous réexpliquez le plus souvent à votre IA. Dans la plupart des équipes, cela donne six documents.
| Document | Ce qu’il contient | À quoi il sert |
|---|---|---|
| Qui nous sommes | Activité, clients, offre, ce qu’on ne fait pas, vocabulaire | Évite les réponses génériques |
| Comment nous écrivons | Ton, tutoiement ou vouvoiement, formules à éviter, exemples | Donne des textes qui vous ressemblent |
| Nos méthodes | Une procédure par document : les étapes et leurs raisons | Fait appliquer votre façon de faire |
| Nos décisions | Ce qui a été tranché, quand, pourquoi, ce qui a été écarté | Évite de rouvrir les débats clos |
| Le dossier en cours | Cahier des charges, contraintes, interlocuteurs, état | Rend l’IA utile sur le projet du moment |
| Consignes pour l’IA | Ce qu’elle peut faire, ce qu’elle doit demander, où écrire | Encadre son comportement |
Vous trouverez des versions prêtes à adapter sur la page Modèles.
Écrire un document qu’une IA exploite bien
Un sujet par document
Un document qui traite de la facturation, des congés et de l’accueil des nouveaux ne sera bien trouvé pour aucun des trois. Séparez. Trois documents courts valent mieux qu’un long.
Un titre qui annonce le contenu
« Procédure » ne dit rien. « Procédure : traiter une réclamation client » se trouve et se choisit. Faites de même pour les intertitres : « Délais de réponse » plutôt que « Étape 2 ».
Le résumé en tête
Commencez par deux ou trois phrases qui disent de quoi parle le document, à qui il s’applique et depuis quand. C’est souvent ce passage qui remonte dans la recherche et qui décide l’assistant à lire la suite.
Des phrases complètes, avec les raisons
Comparez.
- « Remise : non la première année. »
- « Nous n’accordons pas de remise la première année, parce que le prix inclut déjà l’accompagnement au démarrage. À partir de la deuxième année, une remise de dix pour cent est possible pour un engagement de deux ans. »
La seconde version permet à l’IA de répondre à un client, de traiter un cas voisin, et d’expliquer la règle au lieu de la réciter.
Des termes constants
Si vous appelez la même chose « client », « compte » et « donneur d’ordre » selon les pages, un lecteur humain suit. Un assistant peut croire qu’il s’agit de trois choses. Choisissez un mot, et donnez les synonymes une fois dans le document « Qui nous sommes ».
Des exemples
Une règle de ton se comprend mieux avec deux exemples, un bon et un mauvais, qu’avec trois paragraphes d’explication. Pour une procédure, un cas réel traité de bout en bout vaut une page de théorie.
Les cas particuliers, écrits
« Sauf pour les marchés publics », « sauf si le client est en période d’essai » : les exceptions sont ce que les gens savent sans l’avoir jamais noté. C’est aussi là que l’IA se trompe. Écrivez-les sous la règle.
Ranger : projets, liens et statut
Rangez par projet
Regroupez ce qui se lit ensemble. Un projet pour ce qui est commun à tous, un projet par client, par mission ou par produit. Ce découpage sert trois fois : vous vous y retrouvez, l’assistant cherche dans un périmètre pertinent, et vous donnez les accès projet par projet.
Reliez les documents entre eux
Une décision renvoie au compte rendu où elle a été prise et à l’étude qui la justifie. Une procédure renvoie au modèle qu’elle utilise. Ces liens permettent à l’assistant, comme à un collègue, de remonter à la source quand il a besoin d’en savoir plus.
Dites ce qui fait foi
C’est la règle la plus rentable et la moins appliquée. Tout document devrait porter un statut clair.
- Fait foi : c’est la référence, à appliquer.
- Exploration : une piste, une réflexion en cours, pas une règle.
- Remplacé : ne s’applique plus, avec le lien vers le document qui le remplace.
Sans cela, la proposition abandonnée en mars a, pour une IA, la même valeur que la décision prise en juin.
Importer l’existant sans importer le désordre
Vous avez déjà des fichiers Word, des PDF, des tableaux. Inutile de tout réécrire, et inutile de tout importer.
- Triez d’abord. Écartez les brouillons, les doublons et tout ce qui a plus de deux versions. N’importez que ce qui est encore vrai.
- Importez ce qui sert. Les documents de référence, les modèles, les contrats types, les études. Le détail de ce qui est repris selon le format est dans Importer ses documents.
- Marquez le statut à l’import. Un vieux document utile comme archive doit être signalé comme tel.
- Réécrivez seulement l’essentiel. Les trois ou quatre documents les plus consultés méritent d’être repris selon les règles ci-dessus. Le reste peut rester tel quel.
Tenir la base à jour
Une base fausse fait plus de dégâts qu’une base vide, parce que l’IA applique ce qu’elle lit avec assurance. Quatre habitudes suffisent.
- Corriger à la source, tout de suite. Quand une règle change, on modifie le document le jour même, pas « à la prochaine mise à jour ».
- Un responsable par document. Pas pour tout écrire : pour dire oui ou non quand quelqu’un propose une modification.
- Laisser l’IA proposer. En fin de réunion ou de dossier, demandez à votre assistant de consigner la décision ou de proposer la mise à jour de la procédure. Vous relisez, vous validez.
- Relire ce qui sert le plus. Une fois par trimestre, repassez sur les dix documents les plus consultés. C’est là qu’une erreur coûte cher.
Vérifier que cela marche
Écrivez dix questions que l’équipe pose réellement à ses IA. Ouvrez une conversation neuve, sans rien coller, et posez-les une par une.
- La réponse est juste et cite le bon document : c’est gagné.
- La réponse est vague : le document manque, ou il n’emploie pas les mots de la question.
- La réponse est fausse avec assurance : un vieux document traîne et n’est pas marqué comme remplacé.
- L’assistant ne consulte pas la base : précisez dans vos consignes dans quels cas il doit y chercher.
Refaites le test après chaque série de corrections. Dix questions suffisent à repérer l’essentiel des défauts.
Les sept erreurs à éviter
- Importer tout le disque partagé d’un coup.
- Laisser coexister des documents contradictoires sans statut.
- Écrire des notes pour soi, en abrégé.
- Mettre dix sujets dans un seul document.
- Donner la règle sans la raison ni les exceptions.
- Oublier de noter les décisions.
- Écrire une fois, et ne plus jamais corriger.
Construire cette base avec Linkevio
Linkevio est fait pour cela. Vous écrivez dans un éditeur ou vous importez vos fichiers Word, PDF, Excel et Markdown. Vous rangez par projet, vous reliez les documents entre eux, et vous indiquez pour chacun s’il fait foi, s’il est exploratoire ou s’il est remplacé.
Vous branchez ensuite l’assistant que vous utilisez déjà. Il cherche dans les projets auxquels vous avez accès, reçoit de courts extraits avec leur emplacement, lit la partie utile, et peut écrire dans la base si vous le lui demandez. Chaque document garde ses versions, et chaque demande d’un assistant est notée dans un journal.
Pour démarrer, suivez le guide Bien démarrer, prenez un des modèles, et créez votre espace gratuit : il couvre deux personnes et un projet, de quoi écrire vos six premiers documents et faire le test des dix questions.
Questions fréquentes
Faut-il écrire différemment pour une IA et pour un humain ?
Très peu. Un document clair pour un nouveau collègue est clair pour une IA : un sujet, un titre précis, des phrases complètes, des raisons, des exemples. La seule exigence supplémentaire est que chaque section se comprenne seule.
Quel format de fichier est le mieux lu ?
Le texte structuré, avec des titres et des intertitres. Un document écrit dans un éditeur ou en Markdown est idéal. Les fichiers Word et PDF textuels se lisent bien. Un PDF fait d’images scannées, sans texte, ne se cherche pas.
Combien de documents faut-il pour que ce soit utile ?
Peu. Six documents bien écrits changent déjà les réponses de votre assistant. Mieux vaut vingt documents à jour que deux cents dont la moitié est périmée.
Quelle longueur pour un document ?
Celle qu’il faut pour traiter un sujet, rarement plus de deux ou trois pages. Si un document dépasse cette taille, il contient probablement deux sujets.
L’IA peut-elle rédiger la base à ma place ?
Elle peut vous aider à mettre en forme ce que vous savez : vous dictez, elle structure. Elle ne peut pas inventer vos méthodes ni vos décisions. La relecture par la personne qui sait reste indispensable.
Que faire des documents confidentiels ?
Rangez-les dans un projet à part, ouvert aux seules personnes concernées. Un assistant n’a accès qu’aux projets de son utilisateur. Pour la suite, voyez Partager le contexte entre les IA d’une équipe.