Gérer la mémoire de l’espace de travail

Ce guide explique comment travailler avec le magasin de connaissances d’un espace de travail.

Ce qu’il faut savoir avant de commencer : l’interface de mémoire est une surface de révision, pas de rédaction. Les faits et les politiques sont écrits par les agents — au moyen de propose_fact et propose_policy, et de supersede_fact et supersede_policy pour les remplacer. remember écrit un élément de palier chaud limité à la session, que consolidate_memory pourra plus tard promouvoir en fait. Les décisions de réunion enregistrées sont recueillies dans le domaine decisions ; il n’y a pas de recueil sur les exécutions d’agents terminées. Ce que vous faites ici, c’est lire ce qu’ils ont écrit, le corriger, le désactiver ou le supprimer.

La mémoire se trouve dans Paramètres → Espace de travail → Mémoire (/workspaces/<id>/settings/memory). Ce n’est pas une destination de premier niveau dans la barre latérale.

Les trois onglets

La page comporte exactement trois onglets. Faits et Politiques affichent un décompte en direct ; le graphe, non :

Faits — chaque fait de l’espace de travail, avec un décompte de ceux qui ne sont pas remplacés
Politiques — les règles normatives regroupées par domaine, avec un décompte des politiques actives
Graphe de connaissances — une toile interactive de domaines, de sujets, de faits et de politiques

Les domaines ne sont pas quelque chose que vous créez. Un domaine voit le jour lorsqu’un agent y écrit le premier fait ou la première politique ; il n’existe aucune commande de création de domaine dans l’interface.

Examiner et corriger un fait

Ouvrez l’onglet Faits.
Utilisez le champ de recherche pour restreindre la liste. Il s’agit d’un simple filtre de sous-chaînes sur le domaine, le sujet et le contenu de chaque fait — aucun index de mots-clés, aucun classement.
Utilisez le filtre de portée pour afficher toutes les portées, seulement les faits à l’échelle de l’espace de travail, ou les faits d’un dépôt.
Utilisez la commande de tri pour classer par récence ou par confiance.
Cliquez sur la commande de modification d’un fait.

La boîte de dialogue de modification vous permet de changer :

Domaine — déplacer un fait d’un domaine à un autre
Sujet — sa courte étiquette
Contenu — le texte de la connaissance
Confiance — un curseur par pas de 5 %

Enregistrez pour consigner la modification. Il n’existe pas de bouton Nouveau fait ; la boîte de dialogue ne s’ouvre que sur une ligne existante.

Voir les faits remplacés

L’onglet Faits comporte un commutateur Afficher remplacés. Les faits remplacés sont masqués par défaut et révélés par ce commutateur, où réside la piste de vérification — la supplantation ne supprime jamais.

Supprimer un fait

Utilisez la commande de suppression d’un fait et confirmez. Il s’agit d’une véritable suppression, pas d’une supplantation : utilisez-la pour les faits qu’il était simplement erroné de consigner, et laissez les agents supplanter les faits dont le contenu a évolué.

Gérer les politiques

L’onglet Politiques regroupe les politiques actives par domaine et relègue les politiques inactives dans une section en fin de liste. Pour chaque politique, vous pouvez :

La modifier
La supprimer
La désactiver / l’activer — l’option réversible, et habituellement la bonne. Seules les politiques actives atteignent les prompts des agents.

Comme pour les faits, il n’existe aucune commande de création.

Explorer le graphe de connaissances

L’onglet Graphe de connaissances dispose les domaines, les sujets, les faits et les politiques sous forme de toile de nœuds navigable — déplacez la vue, zoomez, faites glisser les nœuds. Toucher un nœud ouvre sa fiche de détails, d’où les mêmes boîtes de dialogue de modification sont accessibles. C’est le moyen le plus rapide de voir quels domaines sont réellement peuplés.

Modifier la mémoire de travail d’un agent

La mémoire de travail est un bloc-notes privé par agent, injecté dans son prompt au moment du lancement. Les agents l’écrivent eux-mêmes avec record_observation et update_my_notes, mais vous pouvez la lire et la modifier directement :

Paramètres → Espace de travail → Agents → sélectionnez l’agent → l’onglet Mémoire.

Autorisations d’accès

Les autorisations d’accès à la mémoire font correspondre le rôle d’un agent à une permission (none, read, write) par domaine. Écrivez-les avec les opérations memory_access_grant.*.

Deux choses à comprendre sur la façon dont elles se résolvent :

Les lectures sont fail-open. Sans ligne d’autorisation pour un couple (rôle, domaine), la permission effective est read. La seule écriture qui lève une exception sans write est propose_policy. Les écritures de faits ne sont pas soumises à autorisation.
Les autorisations sont indexées sur le rôle de l’agent. Les outils de proposition attribuent par défaut general à un agent_role absent. Une autorisation écrite pour un autre rôle ne lie pas ces agents ; une autorisation general, oui.

La recherche n’est pas la même partout

Trois choses différentes portent le nom de « recherche de mémoire » et elles ne concordent pas :

Emplacement	Ce qu’elle fait
Le champ de recherche de l’onglet Faits	Filtre de sous-chaînes sur les faits déjà chargés dans le client
L’opération RPC `memory_fact.search`	Recherche par mots-clés FTS5 uniquement — un client léger ne peut pas livrer d’embedding de requête, donc la recherche hybride reste interne à l’hôte
L’outil `search_memory` côté agent	`keyword`, `semantic` ou `hybrid` (le mode par défaut). Hybride fusionne quatre voix : lexicale, sémantique, temporelle et de graphe

Ainsi, un agent et la page Mémoire ne classeront pas la même requête de la même façon. Quand vous vérifiez ce qu’un agent peut réellement rappeler, demandez-le à l’agent.

Embeddings

Les faits sont vectorisés au moment de l’écriture, et seulement lorsque le modèle d’embedding sur l’appareil est installé. Vérifiez son état dans Paramètres → Serveur → Diagnostics et confidentialité → Recherche sémantique. Installez le modèle avant que les agents commencent à écrire dans la mémoire si vous voulez le rappel sémantique.