Administrar la memoria del espacio de trabajo

Esta guía te muestra cómo trabajar con el almacén de conocimiento de un espacio de trabajo.

Lo más importante que debes saber antes de empezar: la interfaz de memoria es una superficie de revisión, no de creación. Los hechos y las políticas los escriben los agentes, mediante propose_fact y propose_policy, con supersede_fact y supersede_policy para reemplazarlos. remember escribe un elemento de la capa caliente acotado a la sesión que consolidate_memory puede ascender después a hecho. Las decisiones de reunión grabadas se recogen en el dominio decisions; no hay recolección a partir de ejecuciones de agente completadas. Lo que haces aquí es leer lo que ellos escribieron, corregirlo, desactivarlo o eliminarlo.

La memoria está en Ajustes → Espacio de trabajo → Memoria (/workspaces/<id>/settings/memory). No es un destino de nivel superior en la barra lateral.

Las tres pestañas

La página tiene exactamente tres pestañas. Hechos y Políticas muestran un recuento en vivo; el grafo no:

Hechos — todos los hechos del espacio de trabajo, con un recuento de los que no están sustituidos
Políticas — reglas normativas agrupadas por dominio, con un recuento de las activas
Grafo de conocimiento — un lienzo interactivo de dominios, temas, hechos y políticas

Los dominios no son algo que tú crees. Un dominio nace cuando un agente escribe en él el primer hecho o la primera política; no hay ningún control para crear dominios en la interfaz.

Revisar y corregir un hecho

Abre la pestaña Hechos.
Usa el cuadro de búsqueda para acotar la lista. Es un filtro simple por subcadena sobre el dominio, el tema y el contenido de cada hecho: sin índice de palabras clave ni clasificación.
Usa el filtro de ámbito para mostrar todos los ámbitos, solo los hechos de todo el espacio de trabajo o los hechos de un repositorio.
Usa el conmutador de orden para ordenar por recencia o por confianza.
Haz clic en el control de edición de un hecho.

El cuadro de diálogo de edición te permite cambiar:

Dominio — mover un hecho entre dominios
Tema — su etiqueta breve
Contenido — el texto del conocimiento
Confianza — un control deslizante en pasos del 5 %

Guarda para escribirlo de vuelta. No hay ningún botón Agregar hecho; el cuadro de diálogo solo se abre desde una fila existente.

Ver hechos sustituidos

La pestaña Hechos tiene un conmutador Mostrar sustituidos. Los hechos sustituidos están ocultos de forma predeterminada y se muestran con ese conmutador, que es donde vive el rastro de auditoría: sustituir nunca elimina.

Eliminar un hecho

Usa el control de eliminación de un hecho y confirma. Esta es una eliminación real, no una sustitución: úsala para hechos que simplemente no debieron registrarse y deja que los agentes sustituyan los hechos cuyo contenido ha evolucionado.

Administrar políticas

La pestaña Políticas agrupa las políticas activas por dominio y mueve las inactivas a una sección al final. Por cada política puedes:

Editarla
Eliminarla
Desactivarla / Activarla — la opción reversible y por lo general la correcta. Solo las políticas activas llegan al prompt de un agente.

Al igual que con los hechos, no hay ningún control para crear.

Explorar el grafo de conocimiento

La pestaña Grafo de conocimiento presenta los dominios, los temas, los hechos y las políticas como un lienzo de nodos navegable: desplaza, acerca y arrastra los nodos. Al tocar un nodo se abre su hoja de detalles, desde la cual se puede llegar a los mismos cuadros de diálogo de edición. Es la forma más rápida de ver qué dominios están realmente poblados.

Editar la memoria de trabajo de un agente

La memoria de trabajo es un bloc privado por agente, que se inyecta en su prompt en el momento del despacho. Los agentes la escriben ellos mismos con record_observation y update_my_notes, pero tú puedes leerla y editarla directamente:

Ajustes → Espacio de trabajo → Agentes → selecciona el agente → la pestaña Memoria.

Permisos de acceso

Los permisos de acceso a la memoria asignan a cada rol de agente un permiso (none, read, write) por dominio. Escríbelos con las operaciones memory_access_grant.*.

Dos cosas que debes entender sobre cómo se resuelven:

Las lecturas son fail-open. Cuando no hay ninguna fila de permiso para un par (role, domain), el permiso efectivo es read. La única escritura que lanza un error sin write es propose_policy. Las escrituras de hechos no están sujetas a permisos.
Los permisos se basan en el rol del agente. Las herramientas de propuesta usan general por defecto cuando falta agent_role. Un permiso escrito para otro rol no vincula a esos agentes; uno general sí lo hace.

La búsqueda no es la misma en todas partes

Hay tres cosas distintas que se llaman «búsqueda de memoria» y no coinciden:

Dónde	Qué hace
El cuadro de búsqueda de la pestaña Hechos	Filtro por subcadena sobre los hechos ya cargados en el cliente
La operación RPC `memory_fact.search`	Solo búsqueda por palabras clave FTS5: un cliente ligero no puede enviar el embedding de una consulta, así que la búsqueda híbrida se queda dentro del host
La herramienta `search_memory` del lado del agente	`keyword`, `semantic` o `hybrid` (el predeterminado). La híbrida fusiona cuatro voces: léxica, semántica, temporal y de grafo

Así que un agente y la página Memoria no clasificarán la misma consulta de la misma manera. Cuando quieras comprobar qué puede recordar realmente un agente, pregúntale al agente.

Embeddings

Los hechos se convierten en embeddings en el momento de la escritura y solo cuando está instalado el modelo de embeddings en el dispositivo. Consulta su estado en Ajustes → Servidor → Diagnóstico y privacidad → Búsqueda semántica. Instala el modelo antes de que los agentes empiecen a escribir memoria si quieres recuperación semántica.