Agent 记忆系统设计指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/agent-memory-design-guide。
技能介绍
在构建 AI Agent 时,开发者常陷入一个误区:试图把所有历史对话塞进上下文窗口,以为这就是“记忆”。结果往往是 token 预算耗尽,且检索出大量无关的闲聊。这个技能将你视为「Agent 记忆架构师」,指导你将混乱的对话流转化为可检索的结构化资产。
核心机制:分层与生命周期
本指南将 Agent 记忆拆分为职责明确的四个层级,避免单一向量库的“大杂烩”式设计:
- 短期记忆:驻留在上下文窗口,会话结束即弃,用于维持当前对话连贯性。
- 事实记忆:存储用户偏好与身份属性(如
用户偏好中文回复),存于结构化 KV 或图库,支持更新覆盖。 - 情景记忆:记录带时间戳的历史事件(如
上周帮用户订过机票),存于向量库,需考虑时间衰减。 - 程序记忆:沉淀特定用户的做事规范(如
该用户的报告要先给结论),随反馈演化。
运作流程:从写入到遗忘
一个健壮的记忆系统不仅是“存”,更在于“管”:
- 抽取式写入:会话结束后,通过模型抽取关键事实以第三人称短句存储,而非保存原文。写入需满足跨会话有用、用户显式要求或纠正旧记忆这三个门槛之一。
- 分层召回:每轮对话中,事实记忆全量注入,情景记忆按语义相似度 × 时间衰减因子进行检索,并严格限制 Token 预算(通常占上下文的 10-15%)。
- 主动遗忘与整合:定期归档低频、低置信度记忆;将多条相似情景(如 10 次点奶茶)压缩为模式化事实(如
用户习惯周五下午点奶茶)。
适用边界与避坑
- 隐私红线:多用户环境必须实现物理隔离,用户要求删除的数据必须物理销毁,不可仅做逻辑标记。
- 方案迭代:本指南提供架构设计原则,具体的向量库或数据库选型请参考官方最新文档。
使用场景
- Agent每次对话失忆,开发者需要设计长期记忆,让Agent记住用户偏好与历史交互
- 长期记忆积累后检索变差,开发者需要优化检索,让相关历史更准确地进入当前回答
- 需要为Agent建立遗忘与整合机制,在保留有效记忆的同时清理过时信息,并满足隐私要求
- 要给Agent的记忆写入设门槛,区分值得记的事实、事件与程序记忆,避免把闲聊都存下来
适合人员
- 构建AI Agent的开发工程师,需要设计可检索的长期记忆而非全量存储对话
- 优化LLM应用上下文管理的技术工程师,需要降低无关记忆对token预算的占用
- 做Agent个性化与用户偏好记忆的产品工程师,需要确定记忆的写入门槛与更新规则