# Guide de la Memory Console Naviguez dans la console web personnelle sur /me pour inspecter, rechercher et corriger les mémoires, examiner l'attribution des agents, gérer les espaces, exporter des enregistrements et configurer les paramètres. - Canonical: https://docs.xmemo.dev/fr/docs/guides/memory-console - Locale: fr-FR - Content-Locale: fr-FR - Canonical-Content-Digest: 4aea951f5bf9f94fc8465b3b4089d9fe087baec4eab55f135bd33c84f878c7e8 - Edition-Digest: 4a0e999a1befef0e00326bb0a5ce0ed1063147fc4012f7d926107d19c1ee21ef - Source-Revision: sha256:ed359fa7ac7e89021568a98e14885eb4624796d3c8401d0c47d80a787520d3cf ## Objectif de l'utilisateur et aperçu de la console La Memory Console fournit une interface web visuelle sur /me (avec l'alias /memory-console) pour inspecter, rechercher et gérer les enregistrements de mémoire, les connexions d'agents, les projets et les paramètres de sécurité. Plutôt que d'interagir uniquement via des commandes CLI ou des outils MCP, les développeurs et les membres d'équipe utilisent la console pour auditer ce que les agents ont consigné, corriger les mémoires imprécises, inspecter l'attribution des agents, gérer les jetons d'API et contrôler l'exportation ainsi que la suppression des données. ## Disponibilité et prérequis La Memory Console est accessible dans tout navigateur moderne pour les utilisateurs authentifiés. La disposition de la console organise les fonctionnalités en sections d'espace de travail et d'accès distinctes, accessibles via la barre latérale et les ancres de hachage d'URL directes : - Exigence d'authentification : une session utilisateur active est requise. Les visites non authentifiées sont redirigées vers /login (la page de connexion). - Aperçu (#overview) : résumé rapide de l'espace de mémoire personnel, de l'activité récente, des agents connectés et des indicateurs de stockage. - Mémoires (#memory) : recherchez, filtrez, inspectez et modifiez les enregistrements de mémoire avec recherche en texte intégral, filtres de type et filtres de source. - Knowledge (#knowledge) : visualisez et gérez les documents de connaissances destinés à être consultés par les agents autorisés. - Projets (#projects) : parcourez les espaces de travail des projets, les notes contextuelles et les mémoires associées aux projets. - Cloud Skill (#skills) : créez, importez et gérez des compétences procédurales dans le cloud. Portant un badge Preview et disponible s'il est activé pour votre compte. - Dream (#dream) : examinez les modèles récurrents et les suggestions de synthèse avant qu'ils ne deviennent des mémoires durables. Portant un badge Preview et disponible s'il est activé pour votre compte. - Agents (#agents) : affichez les agents connectés à cet espace de travail, inspectez les horodatages de dernière activité et vérifiez les autorisations. - Équipes (#teams) : créez et gérez des équipes, invitez des membres et configurez les rôles d'espace de travail d'équipe. Portant un badge Preview et disponible s'il est activé pour votre compte. - Profil (#profile) : identité du compte, statut de vérification de l'adresse e-mail et préférences personnelles. - Sessions (#sessions) : examinez les sessions de connexion actives et les appareils connectés. - Clés API (#api-keys) : émettez, renouvelez et révoquez des jetons d'accès délimités pour le CLI, les agents et l'automatisation. - Paramètres (#memory-settings) : posture de confidentialité, modes de sécurité, demandes d'exportation de données et contrôles de suppression de mémoire. ## Une tâche complète : inspecter et corriger une mémoire synthétique Dans ce tutoriel guidé, vous localisez la mémoire de convention synthétique enregistrée lors du guide de démarrage rapide, inspectez son attribution d'agent, corrigez son texte dans la console, vérifiez la mise à jour et confirmez les limites de l'espace de travail personnel. ## 1. Localiser la mémoire synthétique dans le panneau Mémoires Accédez à /me et ouvrez le panneau Mémoires en cliquant sur Memories dans la barre latérale ou en naviguant vers #memory. Saisissez "demo project timestamp format" dans la barre de recherche ou filtrez par la catégorie Facts. La liste affiche les cartes de mémoire correspondantes avec résumé, heure de création et badges de visibilité. ```bash # Access personal workspace https://xmemo.dev/me#memory # Access team workspace with explicit team context https://xmemo.dev/me?space=#memory ``` ## 2. Inspecter l'attribution et les métadonnées de l'agent Cliquez sur la carte de mémoire pour déployer le panneau Explain. La console affiche les détails de provenance et d'attribution enregistrés lors de l'écriture : - Type de rédacteur et identité de l'agent : indique si la mémoire a été rédigée par un agent, un utilisateur humain ou un script importé, avec le nom et l'identifiant de l'agent. - Affichage de l'instance d'agent : présente l'identifiant distinct de l'instance d'agent (agent_instance_display) pour différencier les exécutions séparées d'un même agent. - Appareil et transport : affiche l'étiquette d'appareil (device_label) et le canal de transport par lequel l'écriture a été soumise. - Visibilité et portée : indique si l'enregistrement est personnel ou partagé en équipe (team_id), ainsi que les affectations de projet et de bucket. - Historique des versions : affiche le numéro de révision actuel et renvoie vers le tiroir de lignée de versions. ## 3. Corriger le contenu de la mémoire en ligne Cliquez sur le bouton Edit de la carte de mémoire pour ouvrir l'éditeur intégré. Mettez à jour le contenu pour refléter la convention de projet affinée, puis cliquez sur Save : - Contenu mis à jour : remplacez "demo project timestamp format" par "Demo project timestamps use UTC with ISO 8601 formatting.". - Action d'enregistrement : la console envoie une requête de mise à jour authentifiée avec protection CSRF, incrémentant le compteur de révision. - Protection contre les conflits : si un agent a mis à jour la mémoire simultanément, la console détecte l'écart de révision (HTTP 409) et vous invite par "CAS version conflict: Data has been updated elsewhere. Please refresh and try again." à vérifier le contenu le plus récent avant tout écrasement. ## 4. Vérifier la mise à jour dans la console et dans le rappel d'agent Après l'enregistrement, la console affiche une notification de succès et actualise la carte de mémoire. Le tiroir de lignée de versions montre la révision précédente remplacée par la nouvelle révision. Pour vérifier que les agents connectés constatent immédiatement la correction, exécutez recall dans votre terminal : ```bash node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" --limit 1 ``` ## Résultat observable Une correction réussie dans la console produit des changements visibles sur l'interface web et dans les interfaces d'agents : - Notification toast de console web : une notification de confirmation ("Memory updated") apparaît en bas de l'écran. - Présentation de la carte : la carte affiche immédiatement le texte mis à jour, l'horodatage actualisé et l'index de révision incrémenté. - Tiroir de lignée : le tiroir de lignée de versions affiche des diffs au niveau des mots comparant la révision précédente au texte mis à jour. - Sortie de rappel d'agent : une requête pour "demo project timestamp format" renvoie le texte mis à jour avec sa référence de révision la plus récente. ## Ce à quoi les agents peuvent accéder Les agents et les utilisateurs de la console opèrent selon des frontières distinctes d'authentification et d'autorisations : - Autorisations de console : les utilisateurs de la console accèdent aux données via des cookies de navigateur avec validation CSRF. Les actions dans la console reflètent le profil de l'utilisateur connecté. - Autorisations d'agent : les agents s'authentifient à l'aide de clés API délimitées émises dans le panneau Clés API (#api-keys) ou de jetons OAuth. Les portées de jeton autorisées incluent memory:read, memory:write, knowledge:read, ledger:read, ledger:write et read:audit. - Frontière de visibilité de l'agent : les agents ne peuvent pas consulter les mots de passe de compte, les sessions de navigateur actives ni les détails de facturation. Un agent doté d'un jeton personnel ne peut interroger que les mémoires personnelles et les connaissances publiques ; il ne peut pas inspecter les espaces de travail d'équipe à moins d'y être explicitement associé. ## Frontières de partage et de stockage La Memory Console applique une stricte séparation entre données personnelles et espaces de travail d'équipe : - Sélection d'espace : le sélecteur d'espace bascule entre la mémoire personnelle et les espaces de travail d'équipe via le paramètre de requête ?space= (géré par useSpaceContext). Omettre le paramètre ou définir ?space=personal restreint la vue à la mémoire personnelle. - Isolement des paramètres : le panneau Paramètres (#memory-settings) est automatiquement masqué lors de la navigation dans un espace d'équipe afin d'éviter toute dérive de configuration inter-locataires. Tenter d'ouvrir les Paramètres dans un espace d'équipe réinitialise l'espace actif sur Personal. - Frontières d'exportation de données : depuis les Paramètres (#memory-settings), les utilisateurs peuvent demander une archive d'exportation préservant les secrets (/api/v1/me/export-requests). L'exportation personnelle comprend les enregistrements de mémoire personnels, la lignée de versions, les transactions de grand livre personnelles et les documents personnels. La mémoire d'équipe est strictement exclue des exportations personnelles. - Autorisation de téléchargement de l'exportation : les archives d'exportation générées nécessitent une vérification sudo pour obtenir un jeton temporaire d'autorisation de téléchargement avant de récupérer xmemo-personal-export.zip. Les artefacts d'exportation peuvent être révoqués et supprimés à tout moment. - Contrôles de suppression de mémoire : les utilisateurs peuvent supprimer des mémoires individuelles après confirmation, effacer toutes les mémoires ou réinitialiser les mémoires en confirmant leur adresse e-mail de compte et en saisissant la phrase de confirmation "RESET MY XMEMO MEMORY". La fermeture de compte en libre-service nécessite le transfert préalable des équipes possédées avant la suppression (HTTP 409). - Points d'entrée TODO : la console présente les TODO sous forme de compteurs agrégés dans les cartes de projets sous Projets (#projects), affichant le nombre de tâches en attente associées à chaque espace de travail. - Points d'entrée du grand livre : les enregistrements du grand livre apparaissent comme une catégorie filtrable sous Mémoires (#memory), peuvent être délimités sur les jetons d'API (ledger:read, ledger:write) sous Clés API (#api-keys) et sont inclus dans les archives d'exportation de données personnelles. ## Dépannage Résolvez les erreurs courantes de console et les problèmes d'accès à l'aide des étapes suivantes : - Mémoire non trouvée dans la recherche : vérifiez si le sélecteur d'espace est configuré sur l'espace approprié (Personal vs Team ?space=). Réinitialisez les menus déroulants de filtrage actifs de la barre d'outils (comme Type ou Visibilité) pour élargir les résultats. - Erreur d'édition simultanée (HTTP 409) : si un agent ou un autre onglet a mis à jour la mémoire pendant que votre édition était ouverte, la console affiche "CAS version conflict: Data has been updated elsewhere. Please refresh and try again.". Actualisez la liste, inspectez la nouvelle révision et appliquez à nouveau vos modifications. - Option Paramètres non visible dans la barre latérale : Paramètres est masqué lors de l'affichage d'un espace d'équipe. Ouvrez le menu déroulant d'espace dans la barre latérale et revenez à l'espace personnel pour rétablir l'accès aux Paramètres (#memory-settings). - Autorisation de téléchargement d'exportation expirée : les jetons d'autorisation de téléchargement sudo ont une courte durée de vie. Ressaisissez les identifiants de votre compte dans l'invite de téléchargement pour générer une nouvelle autorisation. ## Références associées Consultez la documentation connexe sur les concepts et les outils pour approfondir les mécanismes sous-jacents et les contrats d'API : - Démarrage rapide : /docs/quickstart pour la configuration initiale et la création de mémoires synthétiques. - Correction de mémoire : /docs/concepts/memory-correction pour l'historique des révisions et la sémantique de remplacement. - Suppression de mémoire : /docs/concepts/memory-deletion pour la suppression réversible et le cycle de vie des tombstones. - Provenance et attribution : /docs/concepts/provenance-attribution pour les spécifications d'instance d'agent et de type d'auteur. - Projets : /docs/concepts/projects pour les limites d'espace de travail des projets et les portées de contexte. - Équipes : /docs/capabilities/teams pour la création d'espaces de travail d'équipe, les rôles et la collaboration. - Bases de connaissances : /docs/concepts/knowledge-bases pour les bases de documents et les règles de publication. - Cloud Skills : /docs/concepts/cloud-skills pour la rédaction de compétences procédurales dans le cloud. - Réflexion Dream : /docs/concepts/dream-reflection pour les concepts d'analyse de modèles récurrents. - Gouvernance et rétention : /docs/concepts/governance-retention pour les politiques de rétention et contrôles DSAR. - Frontière des données : /docs/security/data-boundary pour le chiffrement, la multi-tenance et le cloisonnement. - Outil TODO : /docs/tools/todos pour les paramètres de l'outil de suivi des tâches des agents. - Outil Ledger : /docs/tools/ledger pour les paramètres de l'outil de transactions financières. ## Utilisateur de ChatGPT Donnez à ChatGPT un accès durable à vos préférences XMemo, faits de projet, décisions et TODOs sans coller de jetons bearer dans un chat. Connectez le serveur MCP XMemo hébergé via le flux OAuth de l'application ChatGPT/OpenAI, puis approuvez les autorisations memory:read et memory:write pour votre compte XMemo. Enregistrez une préférence synthétique ou une note de projet, démarrez un nouveau chat, puis demandez à ChatGPT de la rappeler via XMemo avant de poursuivre le travail. Si OAuth échoue ou si les outils n'apparaissent pas, déconnectez-vous du serveur MCP dans l'application hôte, reconnectez l'URL du serveur XMemo et réessayez avant de créer des jetons directs. ## Développeur Copilot / Codex Transmettez les décisions du dépôt, les conventions de codage, les notes de correctifs et l'historique des tâches entre les agents IDE et CLI. Utilisez OAuth pour VS Code / GitHub Copilot et Gemini CLI lorsqu'il est disponible. Pour Copilot CLI, Codex, Cursor ou d'autres clients MCP directs, conservez XMEMO_KEY dans l'environnement local ou le gestionnaire de secrets et définissez un identifiant XMEMO_AGENT_INSTANCE_ID stable. Enregistrez une décision relative au code ou un correctif, puis demandez au prochain agent de l'IDE ou de la CLI de rappeler le contexte XMemo pertinent avant toute modification. Si les rappels sont vides, vérifiez le chemin de configuration MCP sélectionné, la variable d'environnement XMEMO_KEY pour les clients directs et tout identifiant OAuth obsolète dans l'application hôte. ## Responsable de projet pilote d'équipe / entreprise Évaluez la mémoire partagée avec les contrôles de compte, l'attribution des sources, les flux d'exportation/suppression et des preuves de configuration sécurisées pour les évaluateurs. Créez ou rejoignez l'espace de travail sécurisé XMemo, invitez les utilisateurs approuvés, puis connectez chaque client via OAuth ou un identifiant direct délimité selon les badges de disponibilité. Demandez à un membre du projet pilote d'enregistrer une mémoire d'équipe synthétique, confirmez l'attribution de la source dans XMemo, puis examinez les chemins de suppression/exportation et de support. Si un membre ne parvient pas à se connecter, vérifiez les permissions de rôle, l'approbation OAuth, l'état de disponibilité du client et les conseils du support avant d'émettre un nouveau jeton. ## Opérateur d'agents autonomes Permettez aux agents autonomes ou planifiés d'enregistrer leur progression, de récupérer les décisions antérieures et de conserver une identité d'instance stable et non secrète. Récupérez /api/v1/mcp/config/autonomous-agent. Privilégiez auth_modes.oauth lorsque l'exécuteur prend en charge OAuth + en-têtes personnalisés ; utilisez auth_modes.xmemo_key avec XMEMO_KEY issu d'un gestionnaire de secrets uniquement pour les exécuteurs entièrement autonomes. Exécutez une tâche synthétique qui consigne la progression dans XMemo, redémarrez l'exécuteur et confirmez qu'il rappelle cette progression à l'aide du même XMEMO_AGENT_INSTANCE_ID. Si l'attribution change ou si les rappels se scindent entre instances, conservez XMEMO_AGENT_INSTANCE_ID hors de git et vérifiez que l'exécuteur ne le régénère pas à chaque démarrage.