Tutorial 20: Memoria Persistente — Memoria a Largo Plazo

Esto es parte de la serie oficial de tutoriales de Hermes Agent. Ver todos los tutoriales

Piensa en esta función como una nota adhesiva en tu escritorio: Hermes Agent anota cosas importantes sobre ti y tus proyectos para no olvidarlas entre conversaciones. Se acabó repetirte cada vez que inicias un chat nuevo.

¿Qué Hace la Memoria Persistente?

Normalmente, un agente de IA empieza de cero en cada sesión: olvida todo cuando termina la conversación. La Memoria Persistente cambia eso. Hermes Agent guarda dos archivos de texto pequeños en tu ordenador. Los lee al inicio de cada sesión, así que recuerda al instante tus preferencias, los detalles de tus proyectos y cualquier otra cosa que le hayas enseñado.

Paso 1: Conoce los Dos Archivos de Memoria

La memoria del agente vive en dos archivos, guardados en ~/.hermes/memories/:

Archivo	Qué Guarda	Límite de Tamaño
MEMORY.md	Notas personales del agente: hechos del entorno, convenciones, cosas que ha aprendido	2.200 caracteres (~800 tokens)
USER.md	Tu perfil: preferencias, estilo de comunicación, expectativas	1.375 caracteres (~500 tokens)

Los límites son intencionados. Obligan al agente a conservar solo lo importante, como una libreta bien organizada en lugar de un cajón desordenado.

Paso 2: Mira Cómo Aparece la Memoria en el Prompt

Al inicio de cada sesión, el agente carga ambos archivos y los muestra como una instantánea congelada en su prompt de sistema. Aquí tienes un ejemplo de lo que el agente “ve”:

══════════════════════════════════════════════
MEMORIA (tus notas personales) [67% — 1.474/2.200 caracteres]
══════════════════════════════════════════════
El proyecto del usuario es un servicio web en Rust en ~/code/myapi usando Axum + SQLx
§
Esta máquina ejecuta Ubuntu 22.04, tiene Docker y Podman instalados
§
El usuario prefiere respuestas concisas, no le gustan las explicaciones largas

Fíjate en los detalles:

Un encabezado que indica qué almacén es (MEMORIA o PERFIL DE USUARIO)
Porcentaje de uso y recuento de caracteres, para que el agente sepa cuánto espacio queda
Entradas separadas por § (signo de sección)
Las entradas pueden ser multilínea

Importante: Esta instantánea se captura una vez al inicio de la sesión y nunca cambia a mitad de sesión. Si el agente actualiza su memoria mientras chatea, los cambios se guardan en el disco inmediatamente, pero no aparecerán en el prompt hasta la próxima sesión. Esto mantiene las cosas rápidas al preservar la caché del modelo.

Paso 3: El Agente Gestiona Su Propia Memoria

El agente usa una herramienta llamada memory con tres acciones:

add — Añade una nueva entrada de memoria
replace — Reemplaza una entrada existente (usa coincidencia de subcadenas con old_text)
remove — Elimina una entrada que ya no es relevante (también usa old_text)

No hay acción read porque la memoria ya está inyectada en el prompt: el agente siempre la ve.

Aquí tienes un ejemplo sencillo de cómo podría usar el agente la herramienta:

memory action=add content="El usuario prefiere viñetas en lugar de párrafos"

O reemplazando una preferencia antigua:

memory action=replace old_text="El usuario prefiere respuestas concisas" new_text="El usuario prefiere respuestas de una línea con emojis"

Paso 4: ¿Qué Pasa Cuando la Memoria Está Llena?

La memoria no se compacta automáticamente. Cuando una escritura excedería el límite, la herramienta memory devuelve un error en lugar de descartar entradas silenciosamente. Entonces el agente hace espacio por sí mismo: consolida o elimina entradas en el mismo turno antes de reintentar.

Ten en cuenta también: replace está sujeto al límite. Intercambiar una entrada por otra más larga puede desbordar igualmente, así que el contenido nuevo debe acortarse (o eliminarse otra entrada) para que quepa.

Paso 5: Un Agente por Carpeta de Hermes (¡Importante!)

No apuntes dos procesos de agente al mismo directorio de Hermes. Las escrituras de memoria son automáticas y se cargan de nuevo en el prompt de sistema al inicio de la sesión, así que dos escritores compartiendo una misma carpeta acumularán las entradas del otro en un lío que ninguno de los dos ha creado. La memoria está limitada por perfil por diseño: dale a un segundo agente su propio perfil. Si necesitan memoria compartida, usa un proveedor de memoria externo.

Resumen

La Memoria Persistente le da a Hermes Agent una forma sencilla y acotada de recordarte entre sesiones. Dos archivos pequeños — MEMORY.md y USER.md — contienen notas seleccionadas, inyectadas como una instantánea congelada al inicio de la sesión. El agente gestiona estos archivos por sí mismo usando la herramienta memory, y los límites de caracteres mantienen el foco. Solo recuerda: un agente por carpeta de inicio, y la instantánea solo se actualiza al inicio de la sesión.