Guía de Memory Console

Objetivo del usuario y descripción general de la consola

Memory Console proporciona una interfaz web visual en /me (con alias /memory-console) para inspeccionar, buscar y gestionar registros de memoria, conexiones de agentes, proyectos y ajustes de seguridad. En lugar de interactuar exclusivamente mediante comandos de la CLI o herramientas MCP, desarrolladores y miembros de equipos emplean la consola para auditar lo que los agentes han registrado, corregir recuerdos inexactos, inspeccionar la atribución de agentes, gestionar tokens de API y controlar la exportación y eliminación de datos.

Disponibilidad y requisitos previos

Memory Console está disponible en cualquier navegador moderno para usuarios autenticados. El diseño de la consola organiza las funciones en secciones de acceso y espacios de trabajo diferenciadas, accesibles mediante la navegación de la barra lateral y anclajes directos hash de URL:

• Requisito de autenticación: se requiere una sesión de usuario activa. Las visitas no autenticadas se redirigen a /login (la página de inicio de sesión).
• Resumen (#overview): resumen rápido del espacio de memoria personal, actividad reciente, agentes conectados y señales de almacenamiento.
• Recuerdos (#memory): busca, filtra, inspecciona y edita registros de memoria con búsqueda de texto completo, filtros por tipo y filtros por origen.
• Knowledge (#knowledge): visualiza y mantén documentos de conocimiento para que los consulten los agentes autorizados.
• Proyectos (#projects): explora espacios de trabajo de proyectos, notas contextuales y recuerdos asociados a proyectos.
• Cloud Skill (#skills): crea, importa y gestiona habilidades de procedimiento en la nube. Marcado con la insignia Preview y disponible si está habilitado en tu cuenta.
• Dream (#dream): revisa patrones recurrentes y sugerencias de síntesis antes de que se conviertan en memoria duradera. Marcado con la insignia Preview y disponible si está habilitado en tu cuenta.
• Agentes (#agents): visualiza los agentes conectados a este espacio de trabajo, inspecciona marcas de tiempo de última actividad y revisa permisos.
• Equipos (#teams): crea y gestiona equipos, invita a miembros y configura roles de espacios de trabajo de equipo. Marcado con la insignia Preview y disponible si está habilitado en tu cuenta.
• Perfil (#profile): identidad de cuenta, estado de verificación de correo electrónico y preferencias personales.
• Sesiones (#sessions): revisa sesiones activas de inicio de sesión y dispositivos conectados.
• Claves de API (#api-keys): emite, rota y revoca tokens de acceso con alcance para la CLI, agentes y automatizaciones.
• Configuración (#memory-settings): postura de privacidad, modos de seguridad, solicitudes de exportación de datos y controles de eliminación de memoria.

Una tarea completa: inspeccionar y corregir memoria sintética

En este recorrido guiado, localizarás el recuerdo sintético de convención guardado durante la guía de inicio rápido, inspeccionarás su atribución de agente, corregirás su texto en la consola, verificarás la actualización y confirmarás los límites del espacio de trabajo personal.

1. Localizar memoria sintética en el panel de Recuerdos

Navega a /me y abre el panel de Recuerdos haciendo clic en Memories en la barra lateral o navegando a #memory. Escribe "demo project timestamp format" en la barra de búsqueda o filtra por la categoría Facts. La lista muestra tarjetas de memoria coincidentes con contenido resumido, hora de creación e insignias de visibilidad.

# Access personal workspace
https://xmemo.dev/me#memory

# Access team workspace with explicit team context
https://xmemo.dev/me?space=<team_id>#memory

2. Inspeccionar atribución y metadatos del agente

Haz clic en la tarjeta de memoria para desplegar el panel Explain. La consola muestra detalles de procedencia y atribución capturados en el momento de la escritura:

• Tipo de autor e identidad del agente: muestra si el recuerdo fue escrito por un agente, un usuario humano o un script importado, junto con el nombre y el ID del agente.
• Visualización de instancia de agente: muestra el identificador diferenciado de instancia del agente (agent_instance_display) para distinguir ejecuciones independientes del mismo agente.
• Dispositivo y transporte: muestra la etiqueta de dispositivo (device_label) y el canal de transporte a través del cual se envió la escritura.
• Visibilidad y alcance: indica si el registro es personal o compartido en equipo (team_id), junto con las asignaciones de proyecto y bucket.
• Historial de versiones: muestra el número de revisión actual y enlaza con el cajón de la línea temporal de versiones.

3. Corregir el contenido de la memoria directamente

Haz clic en el botón Edit de la tarjeta de memoria para abrir el editor integrado. Actualiza el contenido para reflejar la convención de proyecto refinada y haz clic en Save:

• Contenido actualizado: cambia "demo project timestamp format" a "Demo project timestamps use UTC with ISO 8601 formatting.".
• Acción de guardar: la consola envía una solicitud de actualización autenticada con protección CSRF, incrementando el contador de revisiones.
• Protección contra conflictos: si un agente actualizó la memoria al mismo tiempo, la consola detecta la discrepancia de revisión (HTTP 409) y solicita con "CAS version conflict: Data has been updated elsewhere. Please refresh and try again." revisar el contenido más reciente antes de sobrescribirlo.

4. Verificar la actualización en la consola y en la recuperación por agentes

Tras guardar, la consola muestra una notificación de éxito y actualiza la tarjeta de memoria. El cajón de línea temporal de versiones muestra la revisión anterior sustituida por la nueva revisión. Para verificar que los agentes conectados observen de inmediato la corrección, ejecuta recall en tu terminal:

node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" --limit 1

Resultado observable

Una corrección satisfactoria en la consola genera cambios observables en la interfaz web y en las interfaces de los agentes:

• Aviso emergente de la consola web: aparece un mensaje de confirmación ("Memory updated") en la parte inferior de la pantalla.
• Presentación de la tarjeta: la tarjeta muestra de inmediato el texto actualizado, la marca de tiempo actualizada y el índice de revisión incrementado.
• Cajón de versiones: el cajón de línea temporal de versiones muestra diferencias palabra por palabra comparando la revisión anterior con el texto actualizado.
• Salida de recuperación del agente: una consulta de "demo project timestamp format" devuelve el texto actualizado con su referencia de revisión más reciente.

A qué pueden acceder los agentes

Los agentes y los usuarios de la consola operan bajo límites diferenciados de autenticación y permisos:

• Permisos de consola: los usuarios de la consola acceden a los datos mediante cookies de navegador con validación CSRF. Las acciones en la consola reflejan el perfil del usuario conectado.
• Permisos de agentes: los agentes se autentican mediante claves de API con permisos asignados emitidas en el panel Claves de API (#api-keys) o tokens de OAuth. Los permisos de token permitidos incluyen memory:read, memory:write, knowledge:read, ledger:read, ledger:write y read:audit.
• Límite de visibilidad del agente: los agentes no pueden ver contraseñas de cuenta, sesiones de navegador activas ni detalles de facturación. Un agente con un token personal solo puede consultar recuerdos personales y conocimiento público; no puede inspeccionar espacios de trabajo de equipo a menos que esté expresamente vinculado a ese equipo.

Límites de uso compartido y almacenamiento

Memory Console impone una separación estricta entre datos personales y espacios de trabajo de equipo:

• Selección de espacio: el selector de espacio cambia entre memoria personal y espacios de trabajo de equipo mediante el parámetro de consulta ?space=<team_id> (gestionado por useSpaceContext). Omitir el parámetro o definir ?space=personal limita la vista a la memoria personal.
• Aislamiento de configuración: el panel de Configuración (#memory-settings) se oculta automáticamente al examinar un espacio de equipo para evitar divergencias de configuración entre inquilinos. Intentar abrir Configuración en un espacio de equipo restablece el espacio activo a Personal.
• Límites de exportación de datos: desde Configuración (#memory-settings), los usuarios pueden solicitar un archivo comprimido de exportación seguro para secretos (/api/v1/me/export-requests). La exportación personal incluye registros de memoria personales, historial de versiones, transacciones de registro contable personales y documentos personales. La memoria de equipo queda estrictamente excluida de las exportaciones personales.
• Autorización de descarga de exportación: los archivos de exportación generados requieren un desafío de confirmación sudo para obtener un token de autorización de descarga temporal antes de obtener xmemo-personal-export.zip. Los artefactos de exportación se pueden revocar y eliminar en cualquier momento.
• Controles de eliminación de memoria: los usuarios pueden eliminar recuerdos individuales previa confirmación, borrar todos los recuerdos o restablecer recuerdos confirmando el correo de su cuenta e introduciendo la frase de confirmación "RESET MY XMEMO MEMORY". El cierre autoservicio de cuenta exige transferir los equipos en propiedad antes de la eliminación (HTTP 409).
• Puntos de entrada de tareas TODO: la consola muestra las tareas TODO como contadores agregados dentro de las tarjetas de proyectos en Proyectos (#projects), indicando el número de elementos de acción pendientes asociados a cada espacio de trabajo.
• Puntos de entrada de libro contable: los registros de libro contable aparecen como una categoría de tipo filtrable en Recuerdos (#memory), se pueden delimitar en tokens de API (ledger:read, ledger:write) en Claves de API (#api-keys) y se incluyen en archivos de exportación de datos personales.

Recuperación ante fallos

Resuelve errores frecuentes de la consola y problemas de acceso siguiendo estos pasos:

• Recuerdo no encontrado en la búsqueda: comprueba si el selector de espacio apunta al espacio correcto (Personal frente a Team ?space=<team_id>). Borra los desplegables de filtro activos de la barra de herramientas (como Tipo o Visibilidad) para ampliar los resultados de búsqueda.
• Error de edición concurrente (HTTP 409): si un agente u otra pestaña actualizó el recuerdo mientras tu edición estaba abierta, la consola muestra "CAS version conflict: Data has been updated elsewhere. Please refresh and try again.". Actualiza la lista, inspecciona la nueva revisión y vuelve a aplicar los cambios.
• Opción de configuración no visible en la barra lateral: Configuración se oculta al visualizar un espacio de equipo. Abre el desplegable de espacios en la barra lateral y regresa al espacio personal para restablecer el acceso a Configuración (#memory-settings).
• Autorización de descarga de exportación caducada: los tokens de autorización de descarga con sudo son de corta duración. Vuelve a introducir las credenciales de tu cuenta en la solicitud de descarga para generar una nueva autorización.

Referencia relacionada

Consulta la documentación de herramientas y conceptos relacionados para conocer mecanismos subyacentes y acuerdos de API:

• Inicio rápido: /docs/quickstart para la configuración inicial y creación de recuerdos sintéticos.
• Corrección de memoria: /docs/concepts/memory-correction para historial de revisiones y semántica de sustitución.
• Eliminación de memoria: /docs/concepts/memory-deletion para eliminación suave y ciclo de vida de lápidas de borrado.
• Procedencia y atribución: /docs/concepts/provenance-attribution para especificaciones de instancia de agente y tipo de autor.
• Proyectos: /docs/concepts/projects para límites de espacios de trabajo de proyectos y alcances de contexto.
• Equipos: /docs/capabilities/teams para creación de espacios de trabajo de equipo, roles y colaboración.
• Bases de conocimiento: /docs/concepts/knowledge-bases para bases de documentos y reglas de publicación.
• Cloud Skills: /docs/concepts/cloud-skills para la creación de habilidades procedimentales en la nube.
• Reflexión Dream: /docs/concepts/dream-reflection para conceptos de análisis de patrones.
• Gobernanza y retención: /docs/concepts/governance-retention para políticas de retención y controles DSAR.
• Límite de datos: /docs/security/data-boundary para cifrado, tenencia múltiple y aislamiento.
• Herramienta TODO: /docs/tools/todos para parámetros de la herramienta de seguimiento de tareas del agente.
• Herramienta Ledger: /docs/tools/ledger para parámetros de la herramienta de transacciones financieras.