Documents de connaissances

La mémoire sert aux faits courts et isolés. Les documents de connaissances servent aux contenus plus longs dont ces faits sont tirés : procédures d'exploitation (runbooks), notes d'architecture, cartes d'infrastructure, comptes rendus de décision. Un document de connaissances conserve son texte intégral, et votre agent trouve le passage précis qui compte au lieu du fichier entier.

Ajouter un document

• Demandez à votre agent. Dites « enregistre ce runbook dans Neuronz.ai » ou « ajoute docs/deploy.md comme document de connaissances ». Votre agent enregistre le document, et enregistre aussi ses informations clés sous forme de faits distincts, reliés au document.
• Utilisez le tableau de bord. Ouvrez Knowledge dans le tableau de bord et cliquez sur New doc. Vous pouvez aussi y lire, modifier et supprimer chaque document.

Chaque document a une source, un nom unique comme un chemin de fichier. Enregistrer à nouveau un document avec la même source le met à jour au lieu d'en créer une copie.

Fonctionnement

Le texte intégral est conservé. Rien n'est perdu dans un résumé. Le document complet reste à la disposition de votre agent quand un passage ne suffit pas.

Il est découpé selon ses propres titres. En plus de la copie intégrale, le document est divisé en passages qui suivent ses titres, puis ses paragraphes. Les documents de connaissances sont consultés à chaque prompt dans le cadre du rappel automatique : votre agent est donc averti quand l'un d'eux correspond, et il peut lire uniquement la section qui répond à la question.

Votre agent peut parcourir avant de lire. Il peut demander le plan d'un document (chaque titre de section avec sa taille, sans le texte) pour voir ce que couvre un long runbook, puis lire seulement la section utile. Quand il lit un passage, il peut aussi récupérer jusqu'à dix passages voisins de chaque côté, pour qu'une section coupée en deux lui arrive en entier.

Les modifications s'appliquent immédiatement. Modifier un document le redécoupe : une recherche ne tombe donc jamais sur un texte qui n'existe plus.

Les faits suivent le document. Quand votre agent met à jour un document, il envoie aussi la liste actuelle des faits que le document étaye. Un fait que le document n'étaye plus en est détaché, puis retiré dès qu'aucun autre document ne l'étaye non plus. Les faits que vous avez ajoutés autrement ne sont jamais touchés.

Chaque document appartient à un profil. Il n'est trouvé que depuis le profil dans lequel il a été enregistré. Enregistrer un document dont la source existe déjà dans un autre profil est refusé ; pour déplacer un document, modifiez-le et changez son profil.

Outils MCP

add_knowledge, get_knowledge, list_knowledge, update_knowledge et delete_knowledge gèrent les documents. get_knowledge_outline affiche les sections d'un document, get_knowledge_chunk lit un passage (avec ses voisins), et list_knowledge_tags liste les étiquettes utilisées. Voir Outils MCP.

Exemple

Vous enregistrez runbooks/billing-deploy.md une fois. Des semaines plus tard, quand vous demandez à votre agent comment le service de facturation est déployé, il apprend qu'un document correspond et lit lui-même la section de ce runbook consacrée au déploiement.

Voir aussi

• Rappel automatique : comment le bon passage est trouvé.