Comment faire citer leurs sources aux agents IA dans votre base de connaissances

Un agent peut écrire une phrase fluide, précise et fausse, qui ressemble trait pour trait à une phrase copiée d’une source. Une fois enregistrée dans vos notes, rien ne permet de les distinguer.

Dans une base de connaissances écrite par des agents, cette phrase ne reste pas à sa place. La session suivante la lit comme contexte et la répète. Un résumé la reprend. Un mois plus tard, elle figure dans quatre notes et semble acquise. Personne ne l’a inventée exprès, et personne ne sait d’où elle vient.

Une citation règle le problème au moment où c’est le moins coûteux. Quand l’agent écrit l’affirmation, il sait quel fichier ou quelle page il a lu. Le noter prend une ligne. Le retrouver plus tard oblige à relire toutes les sources. Et une règle qui exige une source pour chaque affirmation change ce que l’agent écrit : quand il n’y a pas de source, il doit le dire au lieu de combler le vide.

Ce guide met en place les citations à la main, dans un frontmatter simple que n’importe quel agent peut écrire. Après chaque étape, une courte note décrit la même étape dans Knowtarium, une base de connaissances chiffrée de bout en bout que nous concevons pour les notes écrites ensemble par des personnes et des agents.

Vous pouvez exiger des sources à deux niveaux. La plupart des bases de connaissances ont besoin des deux.

Un bon réglage par défaut : chaque document liste ses sources, et chaque phrase qui contient un chiffre, une date, un nom ou une citation cite l’une d’elles. Les opinions et votre propre raisonnement n’ont pas besoin de note, mais ils doivent se lire comme des opinions.

Dans Knowtarium

Les deux niveaux apparaissent dans Knowtarium. Les sources du document s’affichent sous Details dans ses propriétés, à côté de qui l’a écrit (et, dans les dossiers où la relecture est activée, de qui l’a vérifié), et chaque note de bas de page du texte est une citation qui montre sa source quand vous la survolez.

(s’ouvre en grand dans un nouvel onglet) (s’ouvre en grand dans un nouvel onglet)

Vous pourriez inventer votre propre format de citation, mais avec un format publié, chaque outil et chaque agent le lit de la même façon. L’Open Knowledge Format (OKF), une spécification ouverte publiée par Google Cloud, enregistre la provenance dans un champ sources et y rattache les affirmations par des notes de bas de page :

---
type: Metric
title: Churn
generated: { by: claude-code/2.1, at: 2026-09-26T08:10:00Z }
stale_after: 2026-12-31T00:00:00Z
sources:
  - id: billing-export
    resource: /references/billing-2026-09.csv
    title: Export de facturation, septembre 2026
    author: process:billing-sync
    last_modified: 2026-09-25T23:00:00Z
  - id: pricing-decision
    resource: /decisions/2026-07-01-annual-plans.md
    title: Passer la facturation aux offres annuelles
---
 
Le churn mensuel est tombé à 2,4 % en septembre.[^billing-export]
La baisse a suivi le passage aux offres annuelles.[^pricing-decision]
 
[^billing-export]: Export de facturation, septembre 2026
[^pricing-decision]: Passer la facturation aux offres annuelles

Chaque entrée de sources a besoin d’une resource : une URL, un chemin dans la base de connaissances ou un fichier d’un dossier references/. Les autres champs sont facultatifs :

• id : une clé stable. La spécification indique qu’elle doit être présente dès que le texte cite la source.
• title : un libellé lisible.
• author : qui ou quoi a produit la source, sous forme d’acteur comme human:maya ou process:billing-sync.
• last_modified : la date de la dernière modification de la source elle-même.
• usage_count : combien de fois la source a servi sur une période donnée dans un champ voisin usage_window.

Le libellé de la note est la clé de jointure. La spécification explique pourquoi c’est un id et non une position comme « source 2 » : les agents réécrivent ces documents sans cesse, et une référence numérotée renvoie à la mauvaise source dès que quelqu’un réordonne la liste. Un id nommé, lui, tient bon.

Quand une resource renvoie à un autre document de la base de connaissances, ce lien forme la filiation : on peut le suivre jusqu’aux propres sources de ce document. OKF enregistre ces signaux, pas un score de confiance. Les règles complètes sont dans la spécification OKF.

Les agents suivent le fichier d’instructions qu’ils lisent au début d’une session : AGENTS.md pour la plupart des outils, CLAUDE.md pour Claude Code. Ajoutez-y une section sur les sources :

## Sources
 
- Chaque chiffre, date, nom, citation et décision a besoin d’une source.
- Ajoute chaque source à `sources` avec un `id` court et stable et
  une `resource`.
- Cite-la juste après l’affirmation, avec une note : [^the-id].
- Ne cite qu’une source ouverte pendant cette session. N’invente
  jamais une URL ni un titre.
- Reprends les chiffres exactement comme la source les donne. N’arrondis pas.
- Enregistre dans references/ une copie des pages web et des exports cités.
- Si tu ne trouves pas de source, n’avance pas l’affirmation. Place-la
  sous « ## Open questions » avec ce qu’il faudrait pour la confirmer.
- Ne change jamais l’`id` d’une source une fois qu’un document la cite.

Deux de ces règles font l’essentiel du travail. « Ne citez qu’une source ouverte » empêche l’agent de citer ce dont il se souvient qu’une page disait. « Si vous ne trouvez pas de source, n’avancez pas l’affirmation » lui donne un endroit où mettre une supposition, ailleurs que dans vos notes. Le modèle complet se trouve dans notre guide AGENTS.md pour une base de connaissances.

Gardez des copies de ce que vous citez. Les pages web changent et les exports sont écrasés. Avec une copie enregistrée dans references/, une citation peut encore être vérifiée l’année prochaine.

Les règles réduisent les mauvaises citations, elles ne les suppriment pas. Un agent peut citer une vraie source pour une affirmation que la source ne fait pas. Vérifiez donc les citations à part, en deux passes.

1. La passe mécanique

Chaque note de bas de page doit correspondre à un id de sources, et chaque id devrait être cité quelque part. Le terminal vous montre les deux listes :

# libellés de notes cités dans le texte
$ grep -o "\[\^[a-z0-9-]*\]" metrics/churn.md | sort -u
 
# ids déclarés dans le frontmatter
$ grep -E "^  - id:" metrics/churn.md

2. La passe de lecture

Faites ensuite lire chaque affirmation face à sa source par une autre session d’agent. Lancez-la à neuf, sans le contexte de la session qui a écrit, pour qu’elle lise le document comme le ferait un inconnu. Un tout autre agent, par exemple Codex qui vérifie le travail de Claude Code, fait encore mieux.

Vérifie les citations de metrics/churn.md. Ne modifie pas le document.
 
1. Pour chaque note de bas de page, trouve l’entrée de sources qui a
   le même id. Signale les notes sans entrée et les entrées que rien ne cite.
2. Ouvre chaque resource. Signale celles qui n’existent pas.
3. Pour chaque affirmation citée, reprends le passage de la source qui
   l’appuie, ou dis que tu n’en trouves pas.
4. Signale les affirmations avec des chiffres, des dates ou des noms
   qui ne citent rien.
 
Si chaque affirmation est confirmée, ajoute-toi à `verified` avec
l’heure UTC actuelle. Sinon, liste les problèmes et arrête-toi.

La dernière étape enregistre la vérification. Dans OKF, une entrée verified d’un agent rend le document machine-confirmed. Quand vous le lisez vous-même et ajoutez votre propre entrée human:, il devient human-reviewed :

verified:
  - { by: second-agent/1.0, at: 2026-09-26T09:02:00Z }  # l’agent qui vérifie
  - { by: human:maya, at: 2026-09-26T10:30:00Z }        # vous, après l’avoir lu

Une citation est vraie à la date où quelqu’un l’a vérifiée. Donnez une date stale_after aux documents qui contiennent des chiffres, et renseignez last_modified pour les sources dont vous savez qu’elles changent. Quand l’export de septembre est remplacé par celui d’octobre, la note sur le churn doit être revérifiée, pas acceptée sans un mot. Un document est périmé dès que l’heure actuelle dépasse son stale_after, quel que soit celui qui l’a vérifié.

Knowtarium lit le champ sources et les notes de bas de page qui y renvoient, et vous les montre pendant que vous lisez. Le format ne change en rien : les citations restent le même OKF simple que vos agents écrivent déjà, conservé chiffré de bout en bout dans votre espace de travail.

• Chaque affirmation, retracée. Survolez une citation pour voir la source qui la sous-tend, qui l’a produite et quand elle a changé pour la dernière fois ; suivez-la, et la source est mise en évidence dans les détails du document.
• Des propriétés, pas du YAML brut. Le frontmatter s’affiche en haut du document : qui l’a écrit (et, dans les dossiers où la relecture est activée, qui l’a vérifié), quand il expire et d’où il vient.
• Un graphe de vos liens. Il montre ce qui est périmé et, si la relecture est activée, il peut colorer les documents selon leur niveau de confiance, pour faire ressortir les notes non vérifiées. Les liens vers des documents que personne n’a encore écrits apparaissent comme des fantômes.
• Une recherche en texte intégral. Trouvez chaque document qui mentionne un chiffre ou une source au fil de la frappe, avec le passage correspondant affiché. La recherche s’exécute dans votre navigateur, parce que nous ne pouvons pas lire vos notes (les agents que vous connectez voient ce qu’ils lisent).

(s’ouvre en grand dans un nouvel onglet) (s’ouvre en grand dans un nouvel onglet)

Quand une source ou un chiffre change

C’est quand quelque chose change que les citations comptent le plus. Si un agent réécrit la note sur le churn, la modification est signée et signalée sur le document, avec son diff et un Undo ; dans un dossier où la relecture est activée, elle attend sous forme de diff que vous l’approuviez. Si vous corrigez vous-même un chiffre dans un tel dossier, la modification attend la vérification d’un agent : quand vous le demandez, votre agent lit le diff, suit les liens et les documents qui partagent une source, et corrige ou signale chaque endroit où l’ancienne valeur apparaît encore.

Knowtarium n’appelle aucune IA lui-même ; les agents que vous utilisez déjà se connectent via MCP et se chargent de l’écriture et de la vérification. Découvrez toutes les fonctionnalités.