记忆库概述

记忆库用于保存与具体终端用户有关、需要跨会话继续使用的信息。它让智能体能够记住用户明确表达的偏好、长期事实、重要事件和阶段性结论，并在后续交互中按用户与渠道召回。

记忆不是不可更改的“事实档案”。每条记忆都应当能够定位、核验、修改和删除；当用户纠正信息或撤回授权时，维护者需要同步处理相关渠道中的记录。

本栏目导航

• 创建记忆库与查询用户：创建资源、理解详情页、按用户 ID 和渠道定位记录。
• 管理记忆记录：选择记忆类型，人工新增、编辑、纠错和删除。
• 在工作流和智能体中使用：挂载记忆库，配置长期记忆检索与写入节点。
• 隐私、质量与常见问题：处理隔离、授权、保留、冲突和上线验收。

当前能力

能力	当前页面或运行方式	说明
创建与维护资源	资源库的“记忆库”分类	可创建、编辑名称与描述、删除记忆库
按用户查看	详情页搜索终端用户 ID	未指定用户时可查看所选渠道下的全部记录
按渠道隔离	AIOS、API、Chat SDK、Web SDK	多选渠道用于合并查看；记录本身仍属于具体渠道
人工维护记忆	详情页“新增记忆”	支持五种类型、标签和 1–5 重要度
项目/智能体使用	项目资源中的长期记忆	可挂载资源，并控制是否支持在 Prompt 中调用
工作流使用	长期记忆检索、长期记忆写入节点	每个节点选择一个目标记忆库，通过运行上下文识别用户和渠道

一条记忆如何被定位

当前记忆不是仅凭内容或用户显示名称查找，而是由以下范围共同确定：

工作空间
└── 记忆库
    └── 终端用户 ID
        └── 渠道（AIOS / API / Chat SDK / Web SDK）
            └── 记忆记录

其中任何一层不一致，都可能出现“写入成功但查不到”或“同一个人出现多份记录”。因此：

• 终端用户 ID 必须来自登录身份、API 鉴权结果或 SDK 会话上下文，不应由模型生成。
• 显示名称、手机号后四位等可重复或会变化的信息，不能直接作为终端用户 ID。
• 渠道是访问边界，不是普通标签；不要假定不同渠道会自动合并或同步。
• 同名记忆库位于不同工作空间时，仍然是不同资源。

详情页总览

图 1：记忆库详情页。先确定终端用户 ID 和渠道，再查看或维护该范围内的长期记忆。

页面顶部显示资源名称、编辑入口和已存条数，并提供用户 ID 搜索、渠道多选、刷新与删除入口。右侧“新增记忆”只有在定位到具体用户后才可使用，避免生成无法归属的记录。

五类记忆

页面类型	内部类型	适合保存
用户画像	PROFILE	相对稳定、经用户确认的角色或背景
用户偏好	PREFERENCE	用户明确表达且可能持续生效的选择倾向
长期事实	FACT	后续服务仍有价值的客观事实
历史事件	EVENT	带时间意义的重要经历或业务节点
对话摘要	SUMMARY	多轮会话中的主题、决定和待办摘要

不要保存密码、令牌、支付凭据等高敏信息，也不要把模型推断的敏感身份写成用户画像。类型、标签和重要度只是管理元数据，不能替代身份授权和数据保护。

与知识库、数据库的区别

判断问题	记忆库	知识库	数据库
核心对象	具体终端用户的长期上下文	面向多人复用的文档知识	结构化业务记录
常见内容	偏好、画像、事件、摘要	制度、手册、产品资料	订单、库存、审批状态
主要访问方式	按用户和渠道召回	语义检索文档片段	按字段、条件或 SQL 精确读写
是否允许纠错	必须支持	通过文档更新	通过业务数据变更

稳定共享资料请放入知识库，需要确定性查询、统计和事务更新的数据请放入数据库。

推荐使用闭环

1. 明确哪些信息值得跨会话保留，以及用户如何知情和撤回。
2. 建立稳定的终端用户 ID 与渠道映射。
3. 创建记忆库并写清用途、允许范围和禁止内容。
4. 在项目中挂载记忆库，或在工作流中配置检索/写入节点。
5. 写入前筛选长期价值，召回后把记忆当作可纠错上下文使用。
6. 通过详情页定期检查重复、冲突、过期和无来源记录。
7. 为用户提供查看、更正、删除和注销后的清理流程。

旧文档中的旧版迁移日期、历史配额和“应用不支持记忆库”等说明不再作为当前功能依据。本栏目以当前资源库、项目编辑器和工作流节点实现为准。

进一步阅读

• 资源库总览
• 知识库
• 数据库
• 工作流与对话流
• 搭建和配置低代码智能体