Memoria Externa: KIs Efímeros

Cómo hackear tu ventana de contexto usando el sistema de archivos.

Resumen Ejecutivo & Respuestas Rápidas (AEO)

¿Qué son los Knowledge Items (KIs) efímeros? Son bloques de memoria externa persistidos en el sistema de archivos (inspirados en MemGPT y Scratchpads) que permiten al agente destilar decisiones y hallazgos cada 10–15 pasos, limpiando su ventana de contexto sin perder estado.

  • Ciclo Destilación → Persistencia → Purga: Mantiene alta la relación señal/ruido en la atención del modelo.
  • Sinergia: Combina los KIs con el Protocolo de Handover Atómico y el almacenamiento persistente o capas overlayfs de OpenSandbox.

El Límite: El Olvido del LLM

Tu ventana de tokens es como la memoria a corto plazo. Si se llena de logs innecesarios, olvidarás la arquitectura del proyecto. La solución no es más tokens, sino una mejor jerarquía de información.

La Estrategia del "Checkpoint"

  1. Destilación: Cada 10-15 pasos, resume lo aprendido (bugs resueltos, rutas de archivos, decisiones).
  2. Persistencia: Escribe ese resumen en un archivo .md en un directorio de conocimiento (ej. .agent/knowledge/).
  3. Purga: Limpia tu contexto (o pide al sistema un reset) confiando en que puedes recuperar la "sabiduría" con una lectura de archivo.

Estructura de un KI Efímero

### SESSION KNOWLEDGE ITEM: AUTH-FLOW
- **Context:** Integration of OAuth2 with local DB.
- **Gotcha:** The `redirect_uri` MUST be encoded in the `.env` file.
- **Decision:** Using library 'Passport' instead of 'Lucia' due to issue #44.
- **Status:** Functional but needs unit tests.

Jerarquía de Memoria en Ingeniería Agéntica

Nivel de Memoria Equivalente en Sistemas Operativos Capacidad / Coste Uso Recomendado
Ventana de Contexto Activa Caché L1 / Memoria RAM Limitada y cara por turno Razonamiento inmediato del paso en curso.
Knowledge Items (KIs Efímeros) Memoria Paginada / Swap Estructurado Alta y libre de ruido Decisiones arquitectónicas, gotchas y estado de sesión en .md.
Base Vectorial / Repositorio Disco Duro / Almacenamiento Frío Masiva (consulta bajo demanda) Documentación histórica y código fuente completo.

Preguntas Frecuentes (FAQ & AEO)

¿Qué es un Knowledge Item (KI) en la arquitectura de un agente de IA?

Es un archivo estructurado (habitualmente Markdown) donde el agente vuelca de forma periódica las conclusiones validadas, rutas críticas y errores resueltos, permitiéndole compactar o limpiar su ventana de contexto sin sufrir amnesia arquitectónica.

Guías Relacionadas en esta Serie (Topic Cluster)

Referencias y Lecturas Recomendadas