Skip to content

Mémoire persistante ​

La mémoire persistante est le cœur de Neuronz.ai : une réserve durable de faits, un fait clair par entrée, que vos agents conservent d'une session à l'autre au sein d'un même profil.

La vue Facts du tableau de bord Neuronz.ai, un tableau de faits atomiques avec leur type et leur statut

La vue Facts : chaque fait appris par vos agents, avec son type et son statut. Vous pouvez les rechercher, les filtrer et les modifier.

Fonctionnement ​

Un fait par entrée. Chaque entrée contient un seul fait, compréhensible à lui seul, classé par type : un fait simple (fact), une entité (entity : une personne, un service ou un système), un terme de glossaire (glossary), une instruction (instruction), un trait de persona (persona) ou autre (other). Les faits appartiennent à un profil et les autres profils ne les voient jamais. Des entrées courtes permettent au rappel de renvoyer exactement le fait dont un prompt a besoin, plutôt qu'un document entier. Une affirmation que l'agent n'a pas encore confirmée est enregistrée comme non vérifiée (unverified) jusqu'à ce que quelque chose la tranche : la mémoire ne se remplit pas de suppositions présentées comme des faits.

Pas de doublons. Chaque nouveau fait est comparé à ce qui existe déjà. S'il existe des faits similaires, votre agent les voit (voir Faits similaires) et conserve l'entrée existante, la remplace ou signale une contradiction ; si le fait est nouveau, il est simplement ajouté.

L'historique est conservé. Corriger un fait n'efface pas l'ancien : la version précédente est marquée comme remplacée et la nouvelle devient active, ce qui vous permet de voir comment un fait a évolué. Supprimer un fait le retire au lieu de détruire l'enregistrement.

Les contradictions sont repérées. Quand votre agent constate qu'un nouveau fait contredit un fait existant et que la conversation ne montre pas lequel est juste, les deux sont marqués contestés (disputed) et sortent du rappel jusqu'à ce que vous tranchiez.

Trancher une contradiction ​

Chaque contradiction est une paire : les deux faits en désaccord. Si un troisième fait contredit plus tard l'un des deux, il ouvre sa propre paire ; trancher une paire ne règle donc que ces deux faits. Consultez la liste pour voir s'il en reste d'autres plutôt que de considérer le sujet comme réglé.

Les contradictions ouvertes sont listées dans l'onglet Conflicts de la page Facts du tableau de bord, et une icône d'avertissement à côté de Facts indique combien sont ouvertes. Les contradictions entre deux traits de persona apparaissent plutôt sur la page Persona. Une seule réponse suffit pour en trancher une :

  • L'un des deux est vrai. Ce fait repasse à verified et revient dans le rappel ; l'autre est retiré (son historique est conservé).
  • Aucun n'est vrai. Les deux sont retirés et rien ne les remplace.
  • Aucun n'est vrai, voici ce qui l'est. Les deux sont retirés et votre correction est enregistrée comme un nouveau fait vérifié.
  • Pas maintenant. La question est reportée, pas résolue, et reviendra plus tard.

Votre agent peut faire de même depuis la conversation avec list_conflicts et resolve_conflict.

Faits similaires ​

Quand votre agent enregistre un fait alors que le profil contient déjà des faits actifs qui disent presque la même chose, la réponse à l'enregistrement les liste. L'agent lit ceux qui comptent et tranche chacun avec fact_resolve : c'est un doublon (le nouveau fait est abandonné), il remplace l'ancien, ou les deux se contredisent (ils sont tenus hors du rappel jusqu'à ce que la contradiction soit tranchée, voir plus haut). Rien n'est décidé à la place de l'agent, et la recherche de faits similaires ne coûte aucun reclassement. Le seuil de similarité est le réglage fact_neighbor_floor (0,80 par défaut) dans les Settings du tableau de bord.

Utilisation ​

La mémoire se constitue automatiquement pendant que vous travaillez, grâce à la consolidation en cours de session et, dans Claude Code, à la capture en fin de session. Vous pouvez aussi enregistrer un fait directement en demandant à votre agent de le retenir (« retiens que les nouvelles tentatives sont limitées à 3, avec un délai exponentiel et une part d'aléatoire ») ; il l'enregistre avec fact_add.

Votre agent accède à la mémoire avec ces outils MCP : fact_add, fact_resolve, fact_search, fact_get, fact_list, fact_update, fact_delete, ainsi que list_conflicts et resolve_conflict. Vous pouvez aussi lire, modifier et organiser les faits sur la page Facts du tableau de bord.