Gestion de la mémoire
Vue d'ensemble
La page Gestion de la mémoire sert à consulter et à entretenir la mémoire au niveau du compte. La mémoire au niveau du compte est partagée entre les organisations et rattachée à l'utilisateur individuel : si vous vous connectez au même compte dans différentes organisations, la mémoire vous suit.
Lorsqu'un Agent crée une nouvelle conversation, il interroge automatiquement la mémoire du compte et l'injecte dans le system prompt sous la forme d'un « profil utilisateur ». Cela permet à l'Agent de véritablement « vous connaître ».
Deux vues
| Vue | Description |
|---|---|
| Liste | Parcours paginé de toutes les entrées de mémoire + recherche + édition / suppression / vidage |
| Graphe | Visualisation en graphe orienté par les forces, montrant le réseau d'associations entre les mémoires |
Changer de vue : un onglet Liste / Graphe figure en haut de la page.
Vue Liste
Entrées de mémoire
Chaque mémoire est présentée sous forme de carte :
| Champ | Description |
|---|---|
| Contenu texte | Information centrale de la mémoire (par ex. « l'utilisateur préfère TypeScript ») |
| Niveau de confiance | Score de confiance au moment de l'extraction (0 ~ 1) |
| Métadonnées | Informations complémentaires (ID de la session source, heure d'extraction, etc.) |
Actions
| Action | Description |
|---|---|
| Rechercher | Filtrer la liste des mémoires par mot-clé |
| Ajout manuel | Saisir une nouvelle entrée de mémoire |
| Éditer | Modifier le contenu d'une mémoire existante |
| Supprimer | Retirer une seule mémoire |
| Tout vider | Effacer en un clic toutes les mémoires au niveau du compte (⚠️ irréversible) |
Pagination
- 50 entrées par page par défaut
- Chargement initial de 50 entrées + données du graphe
- Le bouton
Charger plusen bas ajoute la page suivante
Vue Graphe
Passer en vue Graphe permet de visualiser le réseau de relations entre les mémoires :
Types de nœuds
| Type | Couleur | Description |
|---|---|---|
| Hub (centre) | Violet #6d28d9 |
Nœud central de l'utilisateur |
| Fact (fait) | Bleu #2563eb |
Une seule entrée de mémoire |
| Entity (entité) | Ambre #f59e0b |
Entité extraite de la mémoire |
Types de liens
| Type | Style | Description |
|---|---|---|
| Relation hiérarchique | Lien gris | Fact → Hub, Entity → Hub |
| Relation d'association | Lien ambre | Association croisée Entity ↔ Entity |
Interactions
- Cliquer sur un nœud : afficher les détails, avec possibilité d'éditer / supprimer
- Survoler un nœud : afficher le texte complet
- Glisser-déposer : ajuster la position d'un nœud
- Zoom : zoomer sur la vue avec la molette
- Mode replié : au-delà de 100 mémoires, le nœud central affiche une étiquette de comptage (par ex. « 128 mémoires ») plutôt que tous les nœuds de faits
Optimisation du rendu du graphe (mise à jour d'avril 2026) NEW
La nouvelle version du graphe introduit un mécanisme de double porte de densité afin d'éviter que le chevauchement des étiquettes ne rende l'affichage illisible lorsque les nœuds sont trop nombreux :
| Constante de seuil | Valeur | Signification |
|---|---|---|
PILL_READABILITY_MIN_SCALE |
1.5 | Aucune étiquette textuelle n'est rendue lorsque le facteur de zoom est inférieur à 1,5x |
PILL_MIN_SCREEN_AREA_PER_NODE |
3000 | Aucune étiquette textuelle n'est rendue lorsque la surface d'écran moyenne par nœud est inférieure à 3000 pixels |
Les étiquettes ne sont rendues que si les deux conditions sont remplies simultanément. Sinon, seuls des points sont affichés, pour préserver la clarté visuelle.
Stabilisation des couleurs par type d'entité : la couleur de tous les nœuds Entity est calculée via un hash djb2 : une entité d'un même type conserve la même couleur dans différentes vues et à différents moments, ce qui facilite la reconnaissance visuelle. Une palette de 10 couleurs permet une boucle sur un nombre illimité de types.
Correction du champ de type d'entité : les champs sourceTypes et targetTypes sont désormais correctement transmis au graphe côté frontend ; le bug qui, auparavant, faisait retomber tous les nœuds en gris à cause de leur perte a été corrigé.
Modes d'écriture de la mémoire
Ajout manuel
Dans la vue Liste, cliquez sur le bouton « Ajouter », saisissez le texte de la mémoire et enregistrez.
Extraction automatique depuis la conversation
L'Agent détecte automatiquement, au fil de la conversation, les informations méritant d'être mémorisées et les stocke :
| Mode de déclenchement | Exemple | Niveau de confiance |
|---|---|---|
| Commande explicite | « Retiens que je préfère utiliser TypeScript » | 0.99 |
| Détection implicite | « Je m'appelle Zhang San, je suis développeur frontend » | 0.93 |
Pour le détail du mécanisme d'extraction, reportez-vous à Système de mémoire tridimensionnelle.
Rôle de la mémoire dans la conversation
- Nouvelle conversation : le système interroge le profil de la mémoire au niveau du compte et l'injecte dans le system prompt sous la forme d'un « profil utilisateur »
- Question pendant la conversation : l'Agent interroge les mémoires pertinentes selon la sémantique de la question de l'utilisateur (outil memory_query)
- Mise à jour de la mémoire : de nouvelles informations issues de la conversation peuvent déclencher la mise à jour ou la fusion de mémoires existantes
Isolation Gateway inter-comptes NEW
Pour garantir la confidentialité, les sessions distribuées par un Gateway inter-comptes n'accèdent pas à votre mémoire de compte :
- Lorsque votre nœud est défini comme enterprise et appelé par d'autres comptes de la même organisation, le processus d'exécution ne peut pas lire votre mémoire de compte
- Seule la mémoire d'entreprise (au niveau de l'organisation) est accessible aux sessions inter-comptes
- Les sessions propres à votre machine ne sont pas affectées
Voir Architecture multi-nœuds — Isolation inter-comptes.
Guide pratique
Comment ajouter une mémoire manuellement
- Ouvrez l'APP → Paramètres → Mémoire
- Dans la vue Liste, cliquez sur le bouton Ajouter
- Saisissez l'information que vous souhaitez voir l'Agent retenir, par exemple : « Je préfère écrire du code en TypeScript »
- Enregistrez
Effet : lors de la prochaine nouvelle conversation, l'Agent saura que vous préférez TypeScript et l'utilisera automatiquement dans ses réponses relatives au code.
Comment consulter le graphe de mémoire
- Sur la page Gestion de la mémoire, passez à la vue Graphe
- Le grand cercle violet au centre est votre nœud central utilisateur
- Les nœuds bleus sont les entrées de mémoire (par ex. « aime TypeScript »), reliées au centre par des liens gris
- Les nœuds ambre sont les entités extraites (par ex. « TypeScript », « React ») ; les entités sont reliées entre elles par des liens ambre représentant leurs associations
- Actions :
- Cliquez sur n'importe quel nœud pour afficher les détails, l'éditer ou le supprimer
- Glissez un nœud pour ajuster sa position
- Zoomez sur la vue avec la molette
- Survolez un nœud pour afficher le texte complet
Comment vider la mémoire
- Sur la page Gestion de la mémoire, cliquez sur le bouton Tout vider
- Confirmez l'opération de vidage
Attention : l'opération de vidage est irréversible. Une fois la mémoire vidée, l'Agent ne connaîtra plus, dans les conversations futures, aucune de vos préférences, de votre contexte ni de votre historique. L'Agent échangera avec vous comme lors d'une première rencontre. N'utilisez cette fonction que si vous avez réellement besoin de « repartir de zéro ».
Impact de la mémoire sur la qualité des conversations
| État de la mémoire | Expérience de conversation |
|---|---|
| Mémoire riche et exacte | L'Agent connaît votre identité, vos préférences et le contexte de vos projets ; ses réponses sont personnalisées et précises |
| Mémoire vide | L'Agent agit comme lors d'une première rencontre ; vous devez à chaque fois réexpliquer votre contexte et vos préférences |
| Mémoire obsolète ou erronée | L'Agent peut donner des conseils inadaptés en se fondant sur des informations erronées |
| Mémoire trop volumineuse | Le profil de mémoire injecté dans la conversation s'allonge et peut occuper de l'espace de contexte |
Conseil : parcourez régulièrement (par ex. une fois par mois) la liste de vos mémoires et supprimez les entrées obsolètes ou devenues inexactes. Garder une mémoire concise et exacte est la clé d'une expérience de conversation optimale.
Extraction automatique vs ajout manuel
| Comparaison | Extraction automatique | Ajout manuel |
|---|---|---|
| Mode de déclenchement | L'Agent détecte automatiquement au fil de la conversation | Vous saisissez manuellement sur la page Gestion de la mémoire |
| Précision | Dépend du seuil de confiance ; peut manquer ou extraire par erreur | Entièrement sous votre contrôle, précision de 100 % |
| Cas d'usage | Accumulation naturelle au fil des conversations quotidiennes | Vous souhaitez que l'Agent retienne une information précise (par ex. une convention de projet) |
Astuce : les deux modes peuvent être combinés. Laissez l'extraction automatique gérer les informations courantes et, pour les conventions de projet et préférences de travail importantes, il est recommandé de les ajouter manuellement afin d'en garantir l'exactitude.
Questions fréquentes
Pourquoi l'Agent n'a-t-il pas retenu ce que j'ai dit ?
Causes possibles :
- Confiance insuffisante : l'information ne ressemble pas assez à « un fait à mémoriser ». Essayez de vous exprimer plus explicitement : « Retiens que j'aime le thème sombre. »
- Filtrage par les règles d'exclusion : les simples questions, les bavardages, le contenu des blocs de code et les informations éphémères (comme « la météo d'aujourd'hui ») ne sont pas extraits.
- Latence d'extraction de la mémoire : la mémoire n'est extraite qu'à la fin de chaque tour de conversation ; si la conversation est interrompue, l'extraction peut ne pas s'être achevée.
Pourquoi l'Agent répond-il en se fondant sur une mémoire erronée ?
Vous avez peut-être des entrées de mémoire obsolètes. Solution :
- Ouvrez la Gestion de la mémoire et recherchez la mémoire concernée
- Trouvez l'entrée erronée, cliquez sur Éditer pour la corriger ou sur Supprimer
- Vous pouvez aussi dire dans la conversation : « Oublie que j'avais dit préférer Python, j'utilise désormais TypeScript »
Quel espace de contexte la mémoire occupe-t-elle ?
Lors de la création d'une nouvelle conversation, le système injecte la mémoire sous forme de profil dans le system prompt, ce qui occupe généralement entre 200 et 1000 tokens (selon le nombre de mémoires). Rapporté à une fenêtre de contexte de 128K à 200K, ce ratio est très faible et n'affecte pas significativement l'espace disponible.
Documents associés
- Système de mémoire tridimensionnelle — présentation technique détaillée du système de mémoire (y compris les niveaux entreprise et session)
- Paramètres avancés — Mémoire d'entreprise — gestion de la mémoire au niveau de l'entreprise (administrateur)
- Architecture multi-nœuds — Isolation Gateway inter-comptes