Gestionar 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 que conviene 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 registradas se recogen en el dominio decisions; no hay ninguna recogida en las ejecuciones de agente completadas. Lo que haces aquí es leer lo que 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 de 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 se cree. Un dominio nace cuando un agente escribe en él el primer hecho o la primera política; no hay ningún control de creación de 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 simple filtro por subcadena sobre el dominio, el tema y el contenido de cada hecho: no hay í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 alternador de orden para ordenar por recencia o por confianza.
Haz clic en el control de edición de un hecho.

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

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

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

Ver los hechos sustituidos

La pestaña Hechos tiene un interruptor Mostrar sustituidos. Los hechos sustituidos están ocultos de forma predeterminada y ese interruptor los revela; ahí es donde vive el registro de auditoría: sustituir nunca elimina.

Eliminar un hecho

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

Gestionar las políticas

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

Editarla
Eliminarla
Desactivarla / Activarla — la opción reversible y normalmente la correcta. Solo las políticas activas llegan a los prompts de los agentes.

Al igual que con los hechos, no hay ningún control de creación.

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, amplía y arrastra nodos. Al tocar un nodo se abre su hoja de detalles, desde la que se puede acceder a los mismos diálogos de edición. Es la forma más rápida de ver qué dominios tienen realmente contenido.

Editar la memoria de trabajo de un agente

La memoria de trabajo es un bloc de notas privado de cada 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 asocian el rol de un agente con un permiso (none, read, write) por dominio. Escríbelos con las operaciones memory_access_grant.*.

Hay dos cosas que conviene entender sobre cómo se resuelven:

Las lecturas conceden acceso por defecto. Si no hay ninguna fila de permiso para un par (rol, dominio), el permiso efectivo es read. La única escritura que falla 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 asignan general cuando falta agent_role. Un permiso escrito para otro rol no vincula a esos agentes; uno general sí.

La búsqueda no es igual 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 valor 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 forma. Cuando compruebes qué recuerda 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.