Memoria de agentes
La memoria de un agente es su capacidad de retener información relevante entre sesiones y dentro de una misma sesión según configuración. En Hermes, la memoria no es una sola cosa: es un sistema de capas que incluye Context Files, Context References, Session Search, Checkpoints / Rollback y SOUL.md (personalidad). Sin memoria, el agente te pregunta "¿y tú quién eras?" cada vez. Con memoria bien configurada, retiene el contexto que importa y lo usa cuando hace falta.
Definición
La memoria en Hermes funciona en varias capas. Context Files son archivos que cargas para enriquecer el contexto del agente: un PDF de tu empresa, un manual de procedimientos, una base de conocimiento.Context References permiten referenciar contexto externo sin cargarlo entero — el agente lo consulta bajo demanda. Session Search permite buscar en sesiones previas: el agente puede recordar qué pasó en conversaciones anteriores sin que se lo repitas. Checkpoints son puntos de control del estado del agente que permiten rollback — revertir a un punto anterior si algo salió mal. Y SOUL.md define la personalidad persistente del agente: cómo se comunica, qué tono usa, qué prioridades tiene. Todo esto se gestiona con aislamiento entre sesiones y entre perfiles, lo que significa que el contexto de un cliente no se mezcla con el de otro. La memoria persistente también incluye campaign state.db (v0.21.2): locks, WAL, FTS y aislamiento multi-perfil para que las sesiones no se pierdan y los secretos queden separados.
Cómo funciona
Context Files
Archivos que cargas para dar contexto al agente: documentos, manuales, bases de conocimiento. El agente los usa como referencia durante la sesión.
Context References
Referencias a contexto externo que el agente consulta bajo demanda, sin cargarlo todo de una vez. Optimiza tokens y mantiene el contexto relevante.
Session Search
El agente puede buscar en sesiones previas y recuperar información de conversaciones anteriores. No necesitas repetirle el contexto cada vez.
Checkpoints / Rollback
Puntos de control del estado del agente. Si algo sale mal, puedes revertir a un checkpoint anterior en lugar de empezar de cero.
SOUL.md (Personalidad)
Define la identidad persistente del agente: tono, prioridades, estilo de comunicación. El agente mantiene su personalidad entre sesiones.
state.db (v0.21.2+)
Campaign state.db con locks, WAL, FTS y aislamiento multi-perfil. Vault password-blind (1Password/Bitwarden). Las sesiones no se pierden; los secretos quedan aislados entre perfiles.
Ejemplo
Caso empresarial
Limitaciones
- La memoria no es infinita ni gratuita: más contexto cargado significa más tokens y más costo.
- El aislamiento entre perfiles/sesiones debe configurarse correctamente — si no, el contexto puede mezclarse.
- La memoria no es un reemplazo del criterio humano: el agente recuerda, pero no necesariamente entiende.
- Los secretos deben gestionarse con vault (password-blind) — no almacenarlos en texto plano en context files.
- Si el contexto cargado es ruido, el agente empeora en lugar de mejorar. Curar el contexto importa.
FAQ
¿La memoria del agente es automática?
Depende de la configuración. Session Search y la memoria persistente existen por defecto, pero qué contexto cargas (Context Files), qué referencias externas usas y qué personalidad defines (SOUL.md) requieren configuración consciente.
¿La memoria entre sesiones es segura?
Hermes incluye aislamiento entre sesiones y entre perfiles (state.db con locks y WAL desde v0.21.2). El vault password-blind (1Password/Bitwarden) protege secretos. La seguridad final depende de cómo configures el aislamiento y qué datos decidas persistir.
¿Puedo borrar la memoria del agente?
Sí. Checkpoints y rollback permiten revertir estados. También puedes limpiar Context Files, Session Search history y el estado del perfil. El control de qué se recuerda y qué no es tuyo.
¿Qué es SOUL.md?
SOUL.md es el archivo que define la personalidad persistente del agente: tono de comunicación, prioridades, estilo. Es lo que hace que tu agente se comporte de forma consistente entre sesiones, en lugar de parecer un asistente genérico cada vez.
¿Cuánto cuesta la memoria en términos de tokens?
Depende de cuánto contexto cargues. Context References y el índice de Skills están diseñados para minimizar el costo: el agente solo carga el cuerpo cuando lo necesita. La estrategia es curar el contexto relevante, no cargar todo.
¿La memoria puede mezclar información entre clientes?
No si configuras el aislamiento multi-perfil correctamente. state.db (v0.21.2+) incluye aislamiento explícito entre perfiles para que el contexto del cliente A no se mezcle con el del cliente B. Es responsabilidad tuya mantener perfiles separados.
Fuentes y verificación
De aprender a implementar: te ayudamos a dar el siguiente paso.
Hermes LATAM es tu comunidad de aprendizaje. Cuando estés listo para llevar agentes a producción empresarial, el ecosistema te acompaña: diagnóstico con Andrés, implementación con IAgil, y transformación con Habitolandia.