记忆库

扣子编程记忆库用于存储长期记忆信息。长期记忆功能模仿人类大脑形成对用户的个人记忆，基于这些记忆可以使低代码智能体能够提供个性化回复，提升用户体验。本文介绍记忆库升级及升级后的使用操作。

功能说明

在多轮对话中，低代码智能体会根据对话的上下文生成更符合当下场景的回复。但上下文是相对短期的记忆，超过模型指定的上下文轮数之后，对话效果通常会大打折扣。尤其在和情感陪伴类的智能体对话时，对话体验更依赖模型的长期记忆能力。在 AI 助手、虚拟男友/女友、心理咨询等类型的智能体中，智能体需要记录用户的个性化信息，通过不断的对话来理解、刷新和丰富信息、了解用户的个性，在用户对话时能召回相关的记忆，生成符合语境和用户画像的回复。例如虚拟男友类型的智能体，智能体需要长期记忆能力来记录每个用户的人设与偏好，使情感陪伴场景更加真实、个性化。

• 记录：自动识别并记录用户在对话中提供的个性化信息，例如用户画像、记忆点等信息。
• 召回：在用户要求提取相关的长期记忆，并总结个性化信息，在此基础上生成最终回复。

升级长期记忆功能

扣子编程长期记忆功能已完成全面升级，升级后：

• 系统会将长期记忆统一写入指定的新版记忆库，记忆召回服务的准确性与稳定性显著提升。
• 各记忆库间数据相互隔离，并且系统会通过用户 UID 与渠道 ID 组合生成编码，该编码将作为数据隔离的核心标识，保障同一记忆库中不同使用主体的记忆数据独立。
• 新版记忆库支持绑定多个低代码智能体、工作流，可实现记忆数据共享。

升级影响如下：

• 低代码智能体：新建智能体仅可选择新版记忆库；已开长期记忆功能的存量智能体，将提示手动升级至新版记忆库。
• 低代码工作流：新建的工作流仅能选择长期记忆新节点（包含写入、检索节点）；包含旧长期记忆节点的存量工作流，你可以将旧节点替换为新节点。

记忆库额度

不同订阅套餐可写入的记忆数量不同，具体说明如下表所示。当写入的记忆数据量超过套餐限额时，智能体或工作流将提示当前记忆条数触发上限，本次记忆写入失败，你可以选择删除部分记忆数据，或升级套餐至更高版本。

计费说明

在使用记忆库时，写入、存储、更新以及检索长期记忆均将按照实际用量进行计费。具体的计费项及单价，请参考记忆库费用。

创建记忆库

在使用智能体的长期记忆功能之前，你需要先创建记忆库。

1. 登录扣子编程。

2. 在页面顶部选择目标工作空间，然后在左侧导航栏中单击资源库。

3. 在页面右上角，选择 +资源 > 记忆库。

4. 在创建记忆库对话框中，设置记忆库名称和描述，然后单击创建。

在低代码智能体中添加记忆库

你可以在智能体的编排页面添加记忆库以开启长期记忆功能。功能开启后，智能体会自动收集对话中和用户相关的个性化信息，并将其记录在所指定的记忆库中。

1. 在智能体编排页面的长期记忆区域，单击➕，添加记忆库。
   
2. 单击设置图标，选择是否开启在 Prompt 中调用记忆库。
   • 开启支持在Prompt中调用：在对话中，模型将通过用户 Prompt 直接召回长期记忆，例如用户输入我喜欢西瓜，模型并会从记忆库中召回长期记忆并总结返回给用户。
   • 关闭支持在Prompt中调用：在对话中，模型不会直接召回长期记忆。如果绑定了包含长期记忆检索节点的工作流，模型将调用工作流召回长期记忆。

   说明

   支持在Prompt中调用仅影响长期记忆的召回方式，不影响长期记忆的记录方式，只要添加了记忆库，智能体就会记录用户的个性化信息。

   

记录长期记忆

在对话中写入长期记忆

开启长期记忆后，智能体用户可以通过多轮对话向智能体输入个性化信息，智能体会自动提取并记录以下信息：

• 用户画像信息：用户的个人信息和喜好。例如用户希望智能体如何称呼自己、用户的年龄、性别、个人喜好等个性化信息。
• 用户记忆点信息：某个日期发生的某些关键事件。例如用户昨天的期末考试得了 100 分、今天早上喝了豆浆等信息。

在与智能体对话时，智能体会主动识别并提取、记录用户个性化信息，例如在对话中和智能体强调“叫我小李”。对于一些非关键信息，可能智能体不会主动记录，你可以通过对话方式强制智能体记录长期记忆，例如对话时使用“记录到长期记忆”、“一定要记住”、“别忘了”等相似语义的关键词。

在工作流中写入长期记忆

你还可以通过工作流的长期记忆写入节点，将长期记忆数据写入记忆库。具体操作，请参考长期记忆写入节点。

召回长期记忆

开启长期记忆后，你可以通过 Prompt 或工作流召回长期记忆。

在 Prompt 中召回长期记忆

你可以在和智能体的对话中主动查询长期记忆，例如向智能体发送自己的早餐菜谱后，如果询问“今天早上我吃了什么”，智能体会从长期记忆中召回今日早餐相关的内容，总结后回复给你。
对于人设类的智能体，出于对用户关心，增强用户体验，在某些场景下，智能体也会主动提及长期记忆中存储的关键信息。例如用户表示自己摔了一跤，智能体可能会主动关心用户的康复情况。

在工作流中召回长期记忆

你可以在工作流中通过长期记忆检索节点来召回指定关键词相关的长期记忆，作为工作流下游节点的输入参数。关于工作流长期记忆节点的详细说明，可以参考长期记忆检索节点。

相关操作

查看长期记忆

在资源库的记忆库页签下，单击目标记忆库，然后在记忆库详情页面，单击目标 ID，并查看对应的长期记忆。
该 ID 是系统通过用户 UID 与渠道 ID 组合生成的编码，该编码将作为数据隔离的核心标识，保障同一记忆库中不同使用主体的记忆数据独立。

更新长期记忆

当你需要修改某条长期记忆时，可以在资源库的记忆库页签下，单击目标记忆库，然后在记忆库详情页面，将鼠标悬浮在目标长期记忆上，单击编辑，修改内容。

删除长期记忆

当你不再需要使用某条长期记忆时，可以删除指定的长期记忆。记忆库的存储数据是按小时统计的，删除指定的长期记忆后，系统将在下一个小时更新已存储的数据量。
在资源库的记忆库页签下，单击目标记忆库，然后在记忆库详情页面，将鼠标悬浮在目标长期记忆上，单击删除。

删除记忆库

当你不再需要使用所有的长期记忆时，可以删除整个记忆库。在资源库的记忆库页签下，找到目标记忆库，单击 ··· > 删除。