01 Memory 启动加载 | Knowledge Notes

学习目标

理解一句话：DeepAgent 的 long-term memory 是文件，memory=[...] 指定哪些文件会被加载进系统提示词。

它是什么

Memory 保存跨对话都应该保留的上下文，比如用户偏好、项目约定、组织政策。Deep Agents 的 memory 由 MemoryMiddleware 加载，默认格式是 Markdown 文件，常见文件名是 AGENTS.md。它解决的是“下一次对话还能记住稳定信息”，不是保存当前 thread 的临时草稿。

最小结构

memory_teach/workspace/
└── memories/
    └── AGENTS.md

Agent 接入时的核心形态：

graph = create_deep_agent(
    model=model,
    backend=backend,
    memory=["/memories/AGENTS.md"],
)

最小可运行例子

代码见 ../01_memory_loading.py。

这个例子读取固定目录里的 workspace/memories/AGENTS.md，再用 MemoryMiddleware 生成会注入系统提示词的 memory 片段。

运行

uv run python deepagent_src/memory_teach/01_memory_loading.py

预期输出：

memory loading ok

常见误区

最常见的坑是把 memory 当成 skills。memory 是启动时加载的长期上下文；skills 是按任务匹配后才读取的能力说明。

相关资源

查看示例代码：deepagent_src/memory_teach/01_memory_loading.py

from __future__ import annotations

from pathlib import Path

from deepagents import MemoryMiddleware
from deepagents.backends import FilesystemBackend


ROOT_DIR = Path(__file__).resolve().parent / "workspace"
MEMORY_PATH = "/memories/AGENTS.md"


def main() -> None:
    backend = FilesystemBackend(root_dir=ROOT_DIR, virtual_mode=True)
    middleware = MemoryMiddleware(backend=backend, sources=[MEMORY_PATH])
    response = backend.download_files([MEMORY_PATH])[0]

    assert response.error is None
    assert response.content is not None

    memory_prompt = middleware._format_agent_memory(
        {MEMORY_PATH: response.content.decode("utf-8")}
    )

    assert "<agent_memory>" in memory_prompt
    assert "Prefer concise Chinese explanations" in memory_prompt
    assert "INTERNAL_AUTHOR_NOTE" not in memory_prompt
    print("memory loading ok")


if __name__ == "__main__":
    main()