配置记忆抽取与存储策略-Agent 观测与优化 AgentLoop(AgentLoop)-阿里云帮助中心

抽取策略决定从输入中保留哪些事实，存储策略决定这些事实如何维护为长期记忆。您可以在创建向导中设置策略，也可以进入已有记忆库的策略页签调整配置、预览样本并查看版本历史。

配置抽取策略

例如，生活助手可以使用以下自定义指令：

提取用户明确表达的长期饮食偏好，保留喜欢和不喜欢的口味。
不要把助手提出但用户未确认的建议记为用户偏好。
不要把仅针对本次点餐的临时要求概括为长期习惯。

自定义指令最多 8000 个字符。指令用于描述抽取目标，不能替代业务身份、访问权限或范围配置。

分类：按需要填写如 preference、profile 等类别。配置非空分类列表后，只保留类别在列表内的事实，未提供类别的结果也会被过滤；建议同时通过预览检查分类是否符合预期。
排除规则：描述不希望提取的内容，例如临时验证码。处理输入前仍应由应用做好必要的数据筛选，不应仅依赖模型指令完成敏感信息保护。
抽取模型：使用控制台提供的模型选项；当前为 qwen3.8-flash。

每次抽取的事实作为新记忆追加，适合保留事件发生过程。开启去重后，可以跳过同一业务范围、同一来源与同一事实键的重复结果；不同来源的相似描述仍可能分别保存。

例如，同一客户在两次服务过程中提出的诉求可以分别保留，供后续追溯。

先查找同一业务范围中的已有记忆，再根据输入决定执行哪些动作，适合维护用户偏好、客户状态等会变化的信息。

配置项	说明
合并键	语义相似按内容相似度查找；factKey按事实键查找；factKey + 语义结合两种方式
相似度阈值	取值为 0～1，默认 0.4；用于寻找相关的已有记忆，不是应用检索的返回分数阈值
允许的动作	选择允许自动执行的 `ADD`、`UPDATE`、`MERGE`、`DELETE`，至少保留一种

factKey 用来标识一类事实，例如同一个用户的饮食偏好。动作的含义如下：

动作	含义
ADD	新增记忆
UPDATE	更新已有记忆
MERGE	合并相关记忆
DELETE	按新事实处理不再有效的旧记忆；具体存储处理以记录状态和审计为准

例如，新输入由“喜欢甜饮”变为“现在更喜欢无糖饮品”时，系统可能提出更新或新增；实际动作取决于范围、已有内容、策略和抽取结果。先用样本观察拟执行动作，再决定允许哪些自动变更。

人工编辑保护默认开启。自动抽取需要修改人工修订过的记忆时，系统保留当前内容，并记录待审核变更。记忆上的审核状态和相关审计可帮助判断为什么新内容未直接覆盖旧内容。

过期天数使用非负整数，0 表示不过期。设置正数时，为后续写入的记忆设置保留期限；修改配置不应被当作已对全部历史记录完成追溯清理。

配置项	说明
召回必需 scope	可选择 `userId`、`agentId`、`appId`、`runId`；请求必须至少携带所选维度中的一个，留空表示不额外施加该要求
审计保留天数	取值为 1～180 天，默认 30 天
query 记录方式	记录原文保存查询文本；仅记录 HMAC保存查询摘要，审计页面不展示查询原文
记录被丢弃候选	按需要记录未最终返回的候选，帮助分析过滤发生在哪个阶段

业务范围条件用于限定查询对象，API Key 用于访问鉴权；应用应从可信的业务上下文确定允许查询的标识。查询同时提供多个 ID 时，需要同时匹配。

审计设置的使用方式参见查看记忆审计与统计。

下面是可粘贴到预览输入框的样本。预览使用嵌套的 scope 表示业务范围；来源 Dataset 的平铺字段格式见记忆库使用指南。

[
  {
    "sourceId": "preview-001",
    "scope": {"userId": "user-001"},
    "messages": [{"role": "user", "content": "我喜欢清淡、少辣的家常菜"}]
  }
]

轨迹或 Dataset 来源允许留空，由系统从已配置的数据源抽样。手动写入来源需要粘贴样本。预览使用当前表单中的配置，不要求先保存；预览不写正式记忆，也不产生本次正式抽取、存储的审计记录。

检查完预览结果后，单击保存策略。保存成功后，核对当前版本和版本历史中的策略摘要、创建时间等信息。

页面中的重置用于放弃尚未保存的表单修改，恢复当前已保存配置。版本历史用于查看已有记录，保存策略不会自动重新抽取全部历史数据。