从零构建一个基础 AI 代理:记忆
这篇教程给一个已有工具调用、沙箱和权限控制的 AI 代理加上长期记忆。代理在每次会话结束时丢失所有信息,长期记忆让它可以把项目约定和用户偏好写入 Markdown 文件,下次启动时再读回。 实现采用文件存储而非数据库或向量库。 代理可以调用 read_memory 和 append_memory 两个工具,分别读写 和。 MemoryStore 只接受这两个文件名,不允许模型选择任意路径,避免把敏感内容写到意料之外的位置。 安全规则由系统提示词约束:只写入将来仍成立的简短事实,禁止存入 API 密钥、密码、临时任务细节或网页中的提示注入内容。 记忆目录位于 Docker 挂载之外,代理只能通过 MemoryStore 访问,不能经文件系统工具直接读写。 下一步计划支持列出历史会话、恢复未完成会话,以及在上下文窗口接近上限时压缩长会话。

