Memoria para agentes de IA: de la complejidad a 300 líneas de código

La memoria es uno de los problemas más difíciles al crear sistemas autónomos con agentes de IA. El desarrollador Nikolay Gusev dedicó meses a buscar una solución viable y cuenta cómo llegó a una que es a la vez simple y escalable.

MemPalace y el primer error

Todo empezó con una idea ambiciosa: MemPalace, un sistema de memoria inspirado en la arquitectura de los palacios medievales. Sobre el papel parecía ingenioso, pero en la práctica generó 58 mil fragmentos duplicados y se convirtió en un laberinto impracticable. Demasiadas capas de abstracción, demasiada magia. El agente se perdía en su propia memoria.

El camino hacia la simplicidad

Tras MemPalace, el autor redujo la pila a cuatro componentes: MEMORY.md (la base principal), USER.md (contexto del usuario), SQLite state.db (estado), HippoRAG (búsqueda) y archivos wiki (datos estructurados). Pero incluso eso le parecía excesivo. La decisión acertada fue escribir `findings_to_wiki`, un sencillo script de Python de 300 líneas que guarda automáticamente los análisis estructurados (marcados con encabezados como `## Findings`) en archivos markdown y los convierte en páginas wiki. Sin frameworks, sin ORM: solo archivos y texto.

Escalar: ClickHouse

Cuando hay un solo agente, el almacenamiento en archivos funciona perfectamente. Pero para atender a más de 100 usuarios a la vez hace falta una base de datos de verdad. Aquí entra ClickHouse 24.x. Sus capacidades clave:

• Búsqueda vectorial mediante la función `cosineDistance()`: búsqueda rápida de recuerdos semánticamente similares
• Búsqueda de texto con el índice `tokenbf_v1`: búsqueda de texto completo en la memoria
• Particionado por user_id: el aislamiento de los datos de los usuarios está integrado en la base de datos
• TTL para eliminación automática: los registros antiguos se borran sin intervención manual

ClickHouse ejecuta analítica y búsqueda sobre millones de registros en milisegundos. Para la memoria de un agente, es más que suficiente.

Qué significa esto

La conclusión principal: no empieces por escalar. Resuelve el problema de forma simple (archivos, markdown, 300 líneas de código) y escala después solo si hace falta. Nikolay demostró que el mejor camino de ingeniería va de la complejidad a la simplicidad, y no al revés.