管理记忆记录

长期记忆记录包含用户、渠道、类型、内容、标签、重要度和来源。人工新增前，先确认信息确实值得跨会话保存，并已定位到正确的终端用户。

新增长期记忆

1. 在详情页搜索并选中终端用户 ID。
2. 只保留需要写入的渠道。
3. 点击 新增记忆。
4. 选择类型，填写内容、标签和重要度。
5. 保存后回到记录列表核对用户、渠道和正文。

图 1：新增长期记忆。内容必填且最多 2000 个字符；重要度为 1–5，默认值为 3。

表单字段

字段	页面规则	编写建议
类型	必选，默认“长期事实”	按真实语义选择，不要把所有信息都归入长期事实
内容	必填，最多 2000 个字符	一条记录尽量只表达一个可独立理解的事实或偏好
标签	可选，多个标签用中文或英文逗号分隔	使用稳定分类；不要把敏感正文复制到标签
重要度	1–5，默认 3	表示后续使用价值，不代表敏感度或可信度

人工创建的记录会以人工来源保存。内容为空、没有选择渠道或没有定位到终端用户时，页面不会保存。

五种记忆类型

页面类型	内部值	合适示例	不合适示例
用户画像	PROFILE	“用户负责制造业售后运营”	模型猜测的健康、政治等敏感身份
用户偏好	PREFERENCE	“偏好先给结论，再给操作步骤”	只对本轮对话生效的临时要求
长期事实	FACT	“当前使用企业旗舰版”	未核实传闻或模型猜测
历史事件	EVENT	“2026 年 7 月完成管理员培训”	普通点击、无价值流水日志
对话摘要	SUMMARY	“上次确认先完成迁移，再切换生产渠道”	完整聊天原文或逐字转录

同一信息选择一个最符合语义的主类型。会变化的信息要写明时间或生效条件，避免同时存在无法区分的新旧记录。

内容写法

高质量记忆通常具备以下特征：

• 原子化：尽量只表达一个事实、偏好或事件。
• 主体明确：脱离原对话后仍知道描述的是谁。
• 时间清楚：会变化的信息包含确认日期或有效条件。
• 来源可追溯：能回到用户确认、业务事件或受控摘要。
• 可纠错：事实变化时能快速定位原记录。
• 必要且适度：只保留后续服务真正需要的信息。

不推荐：

用户什么都喜欢，最近聊了很多项目，可能比较忙。

推荐：

用户于 2026 年 8 月明确偏好：技术方案先给风险结论，再列实施步骤。

多渠道写入

人工新增时，系统会针对当前选中的每个渠道分别创建一条记录。例如同时选中 AIOS 和 API，保存一次会产生两条内容相同、渠道不同的记录。

保存前确认：

• 这条记忆是否确实需要在每个选中渠道使用。
• 各渠道的终端用户 ID 是否指向同一个真实用户。
• 跨渠道使用是否符合授权与隐私声明。
• 后续纠错和删除是否有逐渠道同步方案。

不要为了“以后可能用到”默认写入全部渠道。渠道副本不会自动保持一致。

记录列表

每条记录会展示：

• 记忆类型和重要度。
• 终端用户 ID 与所属渠道。
• 标签与正文。
• 来源类型和更新时间。
• 鼠标移入后出现的编辑、删除操作。

“全部用户”视图可用于维护者抽查和审计，但不能代替服务端的用户权限控制。终端用户实际召回时仍必须校验工作空间、身份和渠道。

编辑、纠错与删除

编辑单条记录

点击记录的编辑入口，可以修改类型、内容、标签和重要度。编辑只更新该记录原本所属的渠道，不会自动更新其他渠道中的内容副本。

事实变化时优先修改原记录，或在内容中写明新的生效时间。不要无限追加内容相反、但没有时间说明的新旧事实。

删除单条记录

删除前会二次确认。删除只针对当前终端用户、渠道和记录 ID；其他渠道中的相同内容不会随之删除。

处理用户纠错或删除请求时：

1. 验证请求者身份并取得真实终端用户 ID。
2. 检查 AIOS、API、Chat SDK 和 Web SDK 中的相关记录。
3. 修改或删除冲突、过期和不应保留的记录。
4. 重新执行检索，确认旧内容不再被召回。
5. 按要求保留不含敏感正文的操作审计信息。

页面没有明确恢复入口时，应按不可直接恢复处理。删除整个资源前还应检查引用关系，参见创建记忆库与查询用户。

人工维护验收

至少准备以下测试用户：无记忆用户、正常用户、同名但不同 ID 的两个用户、跨渠道用户、包含冲突记录的用户。依次验证新增、编辑、删除和重新检索，确保没有串用户、串渠道或残留旧内容。