记忆规则配置说明

概述

记忆规则用于定义 Agent 如何从对话中提取、存储和召回用户的关键信息，使 Agent 具备跨会话的长期记忆能力。通过合理配置记忆规则，可以让 Agent 更好地理解用户偏好、记住重要事实，从而提供更个性化的服务体验。

记忆规则包含两部分配置：

• 记忆抽取规则：定义从对话中提取哪些信息、如何分类和存储。
• 记忆查询规则：定义每轮对话时如何召回已有记忆，以及召回的数量和质量阈值。

记忆抽取规则

记忆抽取规则定义了系统如何从用户交互中提取和分类重要信息，包括抽取逻辑、标签体系和权重计算方式。

多 Agent 共享记忆

当您的应用涉及主 Agent 与多个子 Agent 协同工作时，可通过该开关控制记忆的共享范围。

状态	说明
开启	用户的事件型记忆数据以 用户 ID 为主键统一存储，主 Agent 与其子 Agent 共用同一份事件记忆进行读写。适用于需要多个 Agent 基于用户已发生事实进行理解与协同服务的场景，例如行为理解、长期偏好分析、一体化服务体验
关闭	事件记忆按 “Agent + 用户” 维度隔离，各 Agent 独立维护自身记录的事件，互不影响

抽取规则：自定义 Prompt

自定义 Prompt 用于告诉系统应当从对话中提取哪些维度的信息。您可以根据业务场景，自行定义需要关注的记忆类别和具体示例。

• 配置方式：在 自定义 Prompt 文本框中，按类别列出需要抽取的信息维度。字数上限为 2000 字。

• 示例（情感陪伴场景）：

  **关系与社交**：家人、朋友、老师、同学的姓名及其与用户的互动或评价。
  **习惯与偏好**：饮食忌口、作息规律（如 “我习惯 9 点睡觉”）、口头禅、特定的行为动作。
  **情绪与状态**：身体不适（生病、换牙）、心情起伏（开心、被老师表扬）、当前的成长阶段。
  **认知与观点**：对事物的看法（如 “觉得恐龙很酷”）、学习进度（如 “正在学跳绳”）、愿望与恐惧。
  **未来计划**：约定好的活动、旅行、生日预告、即将到来的小目标。
  

• 编写建议：

  • 每个类别配合具体示例，有助于提高抽取准确率。
  • 聚焦业务核心信息，避免定义过多无关类别导致抽取噪声。
  • 可随时修改并保存，调整后对后续新对话生效。

抽取规则：场景模版

如果您不确定如何编写自定义 Prompt，平台提供了多种预设场景模版，可一键应用。

模版名称	适用场景
情感陪伴	情感陪伴玩具、AI 音响等常规场景
办公场景	录音笔、办公机器人等办公场景
教育学习	学习机、AI 辅导、课后跟练等教育场景
智能家居	全屋智能、中控面板、智能音箱等家居控制场景
电商购物	导购助手、智能客服等电商消费场景

使用方式：单击 变更模版 并在左侧列表中选择目标场景，预览其 Prompt 内容后，单击 使用此模版 即可应用。应用模版后仍可在此基础上进行二次编辑。

每个模版还提供 “查看最佳实践” 入口，可了解该场景下的推荐配置方式和调优思路。

系统 Prompt

系统 Prompt 为平台内置的基础抽取逻辑，为只读状态，不支持修改。它与自定义 Prompt 协同工作，确保记忆抽取的基础能力稳定可靠。

记忆查询规则

记忆查询规则定义了每轮对话时，系统如何从已有记忆中检索相关内容并注入到 Prompt 上下文中，以增强 Agent 的回复质量。

派生记忆召回条数

• 含义：每轮对话时，从派生记忆中通过向量检索召回并注入 Prompt 的最大条数。
• 派生记忆说明：系统自动存储近 48 小时内的聊天内容切片，用于拓展用户聊天上下文，帮助 Agent 理解近期对话背景。
• 取值范围：最多可设置为 10 条。
• 建议：对话轮次较多、上下文依赖较强的场景建议设置较高值；简单问答类场景可适当调低以减少 Token 消耗。

长期记忆召回条数

• 含义：每轮对话时，从长期记忆中通过向量检索召回并注入 Prompt 的最大条数。
• 长期记忆说明：由记忆抽取规则从历史对话中提炼的结构化用户信息，长期保存，不受时间窗口限制。
• 取值范围：最多可设置为 10 条。
• 建议：需要深度个性化服务的场景（如情感陪伴、教育辅导）建议设置较高值，以充分利用用户画像信息。

召回评分阈值

控制召回记忆的相关性过滤强度，可选值为：

阈值	说明
低	召回条件宽松，返回更多记忆条目，覆盖面广但可能包含相关性较弱的内容
中	平衡召回数量与相关性，适用于大多数场景。（默认推荐）
高	召回条件严格，仅返回高度相关的记忆条目，精准度高但可能遗漏部分有用信息

建议：初次接入建议使用默认值 中，根据实际测试效果再进行调整。如果发现召回内容噪声较多，可上调为 高；如果发现关键信息被遗漏，可下调为 低。

配置流程总结

1. 进入 Agent 编辑页面，打开 编辑记忆规则。

   

2. 在 记忆抽取规则 页面，根据业务需要选择是否开启多 Agent 共享记忆。

   

3. 选择一个场景模版作为基础，或直接编写自定义 Prompt，定义需要抽取的信息维度。

   

4. 在 记忆查询规则 页面，配置派生记忆和长期记忆的召回条数及评分阈值。完成后，单击 保存 完成配置。

   

5. 配置完成后，Agent 将在后续对话中自动执行记忆抽取与召回。