# Comment construire une base de connaissances personnelle qu’un agent peut utiliser?

Date: 2026-08-03 · Author: Robert Scales · https://guidetoartificialintelligence.com/fr/apprendre/base-de-connaissances-personnelle-pour-agent/

**Answer:** Gardez vos notes en fichiers texte dans un petit nombre de dossiers aux noms clairs, ajoutez un fichier d’index qui indique à l’agent ce qui se trouve où et comment se comporter, et donnez à l’agent accès à ce seul dossier au moyen d’un outil comme un serveur MCP de système de fichiers. L’agent ouvre alors les quelques fichiers dont il a besoin pour chaque question au lieu de tout lire.

Une **base de connaissances personnelle** est votre propre collection de notes, de références et de dossiers, organisée pour que vous puissiez retrouver les choses. Un **agent**, selon la définition simple d’Anthropic, est un modèle de langage qui utilise des outils en boucle : il peut lister des dossiers, ouvrir des fichiers, chercher et écrire. Réunissez les deux et vous pouvez demander « Qu’avais-je décidé pour la clôture du jardin le printemps dernier? » et obtenir une réponse tirée de vos propres notes, avec le fichier d’où elle vient.

Vous n’avez besoin ni d’une base de données ni d’un logiciel spécial pour cela. De simples fichiers texte dans des dossiers bien nommés fonctionnent très bien, parce que les agents savent déjà se déplacer dans un système de fichiers. Anthropic décrit cette approche comme **juste à temps** (*just-in-time*) : plutôt que de tout charger d’avance, l’agent garde des références légères, comme des chemins de fichiers, et n’ouvre que ce dont la question en cours a besoin. Les noms de dossiers, les noms de fichiers et les dates servent tous d’indices sur l’usage d’un fichier.

## Une arborescence concrète

Voici une arborescence pour les notes d’une personne. Chaque fichier est en Markdown, du texte brut avec une mise en forme légère, pour que vous et l’agent puissiez le lire.

```text
kb/
  INDEX.md              <- à lire en premier : carte des dossiers et règles
  projects/
    2026-garden-fence.md
    2026-kitchen-renovation.md
  people/
    contractors.md      <- noms, métiers, montants des soumissions, aucun identifiant personnel
  reference/
    car-maintenance.md
    recipes-tested.md
  journal/
    2026-07.md          <- un fichier par mois, entrées datées
  inbox/                <- le seul dossier où l’agent peut écrire
```

Trois habitudes font fonctionner le tout. Commencez chaque nom de fichier par une date ou un sujet clair, pour qu’une simple liste raconte l’histoire. Ouvrez chaque fichier par deux ou trois lignes qui disent ce qu’il contient et quand il a été mis à jour pour la dernière fois. Et gardez un sujet par fichier, pour que l’agent ouvre un fichier court et pertinent plutôt qu’un long fichier qui mélange tout.

## Le fichier d’index

L’index est la carte de l’agent. Les agents de programmation fonctionnent déjà ainsi : Claude Code charge automatiquement dans son contexte, au démarrage, un fichier appelé CLAUDE.md, et Anthropic suggère d’y mettre les règles et les instructions. Peu importe l’agent que vous utilisez, vous pouvez lui demander de lire INDEX.md en premier.

```prompt
# INDEX.md — lis ce fichier avant de répondre à toute question

## Ce qui se trouve où
- projects/ : un fichier par projet personnel ou professionnel, nommé AAAA-sujet.md
- people/ : entrepreneurs et services, avec ce qu’ils ont fait et le montant de leurs soumissions
- reference/ : notes pratiques stables (voiture, recettes, électroménagers)
- journal/ : fichiers de journal mensuels, entrées datées

## Comment répondre
- Cherche d’abord dans les noms de fichiers, puis ouvre au plus 5 fichiers.
- Cite le nom du fichier pour chaque fait que tu utilises.
- Si les notes ne le disent pas, réponds « pas dans mes notes ». Ne comble jamais les trous avec des connaissances générales sans le dire.

## Règles d’écriture
- Écris seulement dans inbox/. Ne modifie et ne supprime jamais les autres fichiers.
- Nomme les nouveaux fichiers AAAA-MM-JJ-sujet.md.
```

## Relier l’agent au dossier

Le *Model Context Protocol* (MCP) est une norme ouverte pour relier les applications d’IA à des outils et à des données. Son **serveur de système de fichiers** de référence permet à un assistant comme Claude Desktop de lire, d’écrire, de lister, de déplacer et de chercher des fichiers, et il n’autorise les opérations qu’à l’intérieur des dossiers que vous lui indiquez au démarrage. Une entrée de configuration ressemble à ceci :

```json
{
  "mcpServers": {
    "notes": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/kb"]
    }
  }
}
```

L’outil d’écriture du serveur peut créer de nouveaux fichiers ou écraser des fichiers existants, et sa documentation recommande de l’utiliser avec prudence. C’est pourquoi l’index limite l’écriture à `inbox/`, et pourquoi le dossier devrait être sauvegardé ou placé sous gestion de versions, pour que tout changement indésirable puisse être annulé. L’agent de programmation d’Anthropic demande aussi la permission avant les actions qui modifient quelque chose, à moins que vous désactiviez cette option; laissez-la activée pour vos notes.

> **À essayer :** créez le dossier `kb/` avec cinq vraies notes et un INDEX.md, connectez-le et posez trois questions dont vous connaissez les réponses. Vérifiez que chaque réponse nomme un fichier, et qu’une question sans réponse dans vos notes obtient « pas dans mes notes ».

## Comment garder vos notes privées à l’abri?

Servez-vous de la frontière du dossier, pas d’instructions. Une ligne dans INDEX.md qui dit « ne lis pas le dossier médical » est une demande que le modèle suivra ou non. Un dossier qui n’a jamais été indiqué au serveur de système de fichiers est hors de portée, parce que le serveur refuse les opérations hors des dossiers qu’on lui a donnés. Gardez donc un dossier distinct, comme `kb-private/`, à l’extérieur de `kb/`, et ne l’ajoutez jamais à la configuration de l’agent.

Rappelez-vous où va le texte. Chaque fichier que l’agent ouvre est envoyé au modèle d’IA dans le cadre de la conversation, ce qui veut habituellement dire aux serveurs du fournisseur. Vérifiez les réglages de données de votre fournisseur, et laissez hors du dossier partagé tout ce que vous ne partageriez pas avec cette entreprise : mots de passe, numéros de compte et d’identité, renseignements de santé, renseignements privés sur d’autres personnes.

Traitez aussi les documents extérieurs avec prudence. Une page Web ou un courriel enregistré dans vos notes peut contenir des instructions cachées destinées à l’agent, un risque appelé injection de prompt. Anthropic prévient que laisser un agent agir sans vérification des permissions ouvre la porte aux pertes de données et aux problèmes d’injection de prompt : gardez les confirmations activées, limitez l’accès en écriture de l’agent à un seul dossier et examinez ce qui arrive dans `inbox/` avant de le déplacer dans votre base de connaissances.

## Sources

- Filesystem MCP Server README: https://github.com/modelcontextprotocol/servers/blob/a54651477cf8849ba800336856f4f700bfef0e02/src/filesystem/README.md
- Effective context engineering for AI agents: https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents
- Claude Code: Best practices for agentic coding: https://www.anthropic.com/engineering/claude-code-best-practices
