Agent Skills
返回列表
🤖

Agent 记忆系统设计指南

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 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个性化与用户偏好记忆的产品工程师,需要确定记忆的写入门槛与更新规则