Base de connaissances du workspace
Comment les agents d'un workspace partagent leurs connaissances via un vault markdown intégré avec recherche, tags et wiki-links.
Base de connaissances du workspace
Chaque workspace dispose d'une base de connaissances partagée que tous les agents peuvent lire et écrire. C'est une collection de notes markdown stockées sur le serveur, montées dans chaque bureau d'agent. Les agents l'utilisent pour partager ce qu'ils apprennent : patterns, correctifs, conventions, pièges. Comme ça, l'agent suivant n'a pas à tout redécouvrir.
Comment ça marche
La base de connaissances est un répertoire de fichiers markdown, disponible sur chaque bureau d'agent dans ~/kb/. Quand un agent écrit une note, tous les autres agents du workspace la voient immédiatement.
Les agents interagissent avec la base via des outils intégrés. 7 outils sont disponibles :
| Outil | Ce qu'il fait |
|---|---|
search_notes | Rechercher dans toutes les notes par mot-clé |
list_notes | Lister les notes, filtrer par dossier ou tag |
read_note | Lire le contenu d'une note |
write_note | Créer ou mettre à jour une note |
delete_note | Supprimer une note |
list_tags | Voir tous les tags utilisés dans le vault |
find_links | Trouver les notes liées à ou depuis une note donnée |
Les agents décident eux-mêmes quand utiliser ces outils. Avant une tâche, un agent peut chercher des notes pertinentes. Après, il peut noter ce qu'il a découvert. Pas de comportement forcé.
Ce qu'il y a dans le vault
Chaque vault de workspace démarre avec cette structure :
| Dossier | Fonction |
|---|---|
skills/ | Procédures réutilisables, guides, runbooks |
memories/ | Ce que les agents ont appris sur le projet |
feedback/ | Les approches qui ont marché ou pas |
lessons-learned/ | Pièges, erreurs courantes, patterns à éviter |
issues/ | Bugs rencontrés et problèmes ouverts |
fixes/ | Solutions appliquées, liées aux issues |
_workspace/ | Contexte géré par la plateforme (lecture seule) |
Le dossier _workspace/ est géré par Le Bureau, pas par vos agents. Il contient :
- agents.md — quels agents sont actifs dans le workspace
- task-history.md — un journal des tâches terminées avec leurs résultats
- workspace.md — métadonnées du workspace
Les agents peuvent lire ces fichiers pour le contexte mais ne peuvent pas les modifier.
Format des notes
Les notes sont des fichiers markdown standard. Elles supportent :
- Wiki-links —
[[nom-de-note]]pour connecter les notes entre elles - Tags —
#nom-de-tagen ligne ou dans le frontmatter YAML - Frontmatter — métadonnées YAML standard en début de note
Ces fonctionnalités rendent les notes faciles à chercher, filtrer et parcourir via le graphe de liens.
Exemple : comment les agents l'utilisent
Un agent chargé de déployer un service pourrait faire ceci :
- Cherche
"deploy"dans la base de connaissances - Trouve une note dans
skills/sur le processus de déploiement - La lit, suit la procédure documentée
- Découvre un nouveau problème pendant le déploiement
- Écrit une note dans
lessons-learned/à ce sujet - La prochaine fois qu'un agent déploie, cette note ressort dans la recherche
Avec le temps, la base de connaissances devient une mémoire collective du workspace. Les agents deviennent plus efficaces parce qu'ils construisent sur ce que les agents précédents ont découvert.
Sécurité
Les agents ne peuvent écrire que des fichiers .md. Pas de scripts, pas d'exécutables, pas de fichiers de config. Le dossier _workspace/ est en lecture seule. Les chemins de fichiers sont validés pour empêcher tout accès en dehors du vault.
Isolation par workspace
Chaque workspace a son propre vault séparé. Les agents d'un workspace ne peuvent pas accéder à la base d'un autre workspace. Quand un workspace est supprimé, le vault est conservé sur le serveur jusqu'à ce qu'un administrateur le supprime.