Bloques de memoria y cálculo del tiempo de sueño
Type: Build
Languages: Python (stdlib)
Prerequisites: Phase 14 · 07 (MemGPT)
Time: ~75 minutes
Objetivos de aprendizaje
- Nombre de los tres niveles de memoria que utiliza Letta (núcleo, recuerdo, archivo) y el papel de cada uno.
- Explica el patrón de bloqueo de memoria: bloque humano, bloque Persona y bloques definidos por el usuario como objetos de primera clase.
- Describa lo que es la computación del tiempo de sueño, por qué se encuentra fuera del camino crítico y por qué puede ejecutar un modelo más fuerte que el agente principal.
- Implemente un bucle de dos agentes scripted donde un agente principal sirve respuestas y un agente de tiempo de sueño consolida bloques entre turnos.
El problema
MemGPT (lección 07) resolvió el flujo de control de memoria virtual. Surgieron tres problemas de producción:
- Latency.Cada operación de memoria se encuentra en el camino crítico. Si el agente tiene que recortar, resumir o reconciliar mientras el usuario espera, la latencia de cola explotará.
- Memory rot.Los escritos se acumulan, los hechos contradictorios permanecen, la recuperación se ahoga en el contenido obsoleto.
- Structure loss.Una tienda de archivos plana no puede expresar "el bloque humano siempre está en el prompt; el bloque Persona siempre está en el prompt; el bloque de tareas cambia por sesión".
Letta (letta.com) es el nombre de la plataforma el proyecto MemGPT original adoptado en 2024 el patrón del papel mantiene el nombre MemGPT y la reescritura de 2026 Letta V1 es un paso posterior y separado.
El concepto
Tres niveles
| Tier | Scope | Where it lives | Written by |
|---|---|---|---|
| Core | Always visible | Inside the main prompt | Agent tool call + sleep-time rewrites |
| Recall | Conversation history | Retrievable | Automatic turn logging |
| Archival | Arbitrary facts | Vector + KV + graph | Agent tool call + sleep-time ingest |
El núcleo es el núcleo MemGPT. Recuerda es el amortiguador de conversación con su cola desalojada.
Bloques de memoria
Un bloque es una sección tipada, persistente y editable del nivel principal.
- Human block hechos sobre el usuario (nombre, función, preferencias, objetivos).
- Persona block el concepto de sí mismo del agente (identidad, tono, restricciones).
Letta generaliza a bloques definidos por el usuario: a Taskbloque para el objetivo actual, un Projectbloque de datos de base de código, una Safetybloque para restricciones duras. Cada bloque tiene unid¿ Qué ?label¿ Qué ?value¿ Qué ?limit(capítulo de carácter), description(para que el modelo sepa cuándo editarlo).
Los bloques se pueden editar a través de la superficie de la herramienta:
block_append(label, text)block_replace(label, old, new)block_read(label)block_summarize(label)condensa un bloque que está cerca de su límite.
Computación del tiempo de sueño
La adición 2025 Letta: ejecutar un segundo agente en el fondo, fuera de la ruta crítica.learned_contexten bloques compartidos, y consolidar o invalidar los registros de archivo.
Propiedades que se desprenden:
- No latency cost.Las respuestas primarias no esperan a las operaciones de memoria.
- Stronger model allowed.El agente de tiempo de sueño puede ser un modelo más caro y más lento porque no tiene limitaciones de latencia.
- Natural consolidation window.Dedup, resumir, invalidar hechos contradictorios cuando el usuario no está esperando.
La forma coincide con cómo trabajan los humanos: haces la tarea, duermes en ella, la memoria a largo plazo se calma durante la noche.
Razonamiento nativo
Letta V1 (letta_v1_agent, 2026) se desactiva send_message/bate del corazón y en línea Thought:Las aplicaciones de respuesta y mensajes (OpenAI) emiten el razonamiento en un canal separado, pasando por turnos (cifrados entre los proveedores en producción). El bucle de control es todavía ReAct.
Cuando este patrón va mal
- Block bloat.Infinito .
block_appendSi el bloque llega al límite, debe enviar un resumen de bloque antes de escribir. - Silent drift.El agente del sueño reescribe un bloque y el agente principal nunca se da cuenta.
- Poisoned consolidation.El agente del sueño procesa el contenido accesible al atacante en el núcleo.
Construye el mismo
code/main.pylos instrumentos:
Blockidentificación, etiqueta, valor, límite, descripción.BlockStoreCRUD +near_limit(label)¿Qué es eso?- Dos agentes con guión
PrimaryAgentsirve un turno,SleepTimeAgentse consolida entre los turnos. - Un rastro que muestra una conversación de tres vueltas con el bloque escribe, más un pase de tiempo de sueño que resume un bloque e invalida un hecho anticuado.
- ¿Qué quieres decir ?
python3 code/main.pyLa transcripción muestra la división: los giros primarios son rápidos y producen escritos crudos; el paso del sueño se compacta y limpia.
Usalo
- Letta(letta.com) para la implementación de referencia.
- Claude Agent SDK skillscomo conocimiento en forma de bloque una habilidad es un bloque de instrucciones nombrado, versionado y recuperable que el agente carga a pedido.
- Custom buildsPara los equipos que quieren controlar el backend de almacenamiento, utilice el contrato de Letta API para poder migrar más tarde.
Envío
outputs/skill-memory-blocks.mdgenera un sistema de bloque en forma de Letta con ganchos de hora de dormir para cualquier tiempo de ejecución, incluidas las reglas de seguridad y el cableado de citación.
Los ejercicios
- Añadir un
block_summarizeherramienta que sustituye el valor de bloque por un resumen generado por el modelo cuandonear_limit¿Cuál umbral de activación minimiza tanto las llamadas de resumen como el desbordamiento de bloque? - Implementar deducción del tiempo de sueño sobre el archivo: dos registros cuyo texto tiene un superposición simbólica de > 90% se derrumban a uno.
- Bloques de versiones. En cada registro de escritura el valor antiguo y una diferencia. Exponer
block_history(label)Así que los operadores pueden deshacerse de "por qué el agente olvidó X". - Trate a los agentes de horas de sueño como escritores no confiables. Cuando toquen el bloque Persona o Seguridad, requieren una revisión de segundo agente antes de comprometerse.
- Portar el ejemplo para utilizar la API Letta (
letta_v1_agent¿Qué cambios hay en el esquema de bloques, y cómo el razonamiento nativo altera la forma de las huellas?
Términos clave
| Term | What people say | What it actually means |
|---|---|---|
| Memory block | "Editable prompt section" | Typed, persistent, LLM-editable segment of core memory |
| Human block | "User memory" | Facts about the user, pinned in core |
| Persona block | "Agent identity" | Self-concept, tone, constraints, pinned in core |
| Sleep-time compute | "Async memory work" | Second agent doing consolidation off the critical path |
| Core / Recall / Archival | "Tiers" | Three-layer memory split: always-visible / conversation / external |
| Block limit | "Cap" | Character limit per block; forces summarization |
| Native reasoning | "Thinking channel" | Provider-level reasoning output, not prompt-level Thought: |
| Learned context | "Sleep output" | Facts the sleep-time agent writes into shared blocks |
Leer más
- Letta, Memory Blocks blog el patrón de bloque
- Letta, Sleep-time Compute blog Consolidación sin sincronizada
- Letta, Rearchitecting the Agent Loop Reescribir el razonamiento nativo
- Packer et al., MemGPT (arXiv:2310.08560) el origen
This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.
Browse the complete course catalog or open this lesson on GitHub.