> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

扣子编程记忆库用于存储长期记忆信息。长期记忆功能模仿人类大脑形成对用户的个人记忆，基于这些记忆可以使低代码智能体能够提供个性化回复，提升用户体验。本文介绍记忆库升级及升级后的使用操作。
:::notice 注意
为进一步优化服务体验，提供更强大、更灵活的长期记忆功能，扣子编程将于**2025年10月15日**对长期记忆功能进行升级。
:::
## 功能说明 {#ba9328fb}
在多轮对话中，低代码智能体会根据对话的上下文生成更符合当下场景的回复。但上下文是相对短期的记忆，超过模型指定的上下文轮数之后，对话效果通常会大打折扣。尤其在和情感陪伴类的智能体对话时，对话体验更依赖模型的长期记忆能力。在 AI 助手、虚拟男友/女友、心理咨询等类型的智能体中，智能体需要记录用户的个性化信息，通过不断的对话来理解、刷新和丰富信息、了解用户的个性，在用户对话时能召回相关的记忆，生成符合语境和用户画像的回复。例如虚拟男友类型的智能体，智能体需要长期记忆能力来记录每个用户的人设与偏好，使情感陪伴场景更加真实、个性化。

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

:::tip 说明
不支持在扣子编程的应用中使用记忆库功能。
:::
## 升级长期记忆功能 {#ff669b5d}
:::notice 注意
* 存量的低代码智能体、工作流可继续使用旧版记忆库。
* 升级到新版记忆库后，历史的长期记忆数据将被重置，无法找回。
:::
扣子编程长期记忆功能已完成全面升级，升级后：

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

升级影响如下：

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


::::cols
@col 50
**智能体**
![Image=826x243](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d95bbbc940f04573bf6137e0c983dbd6~tplv-goo7wpa0wc-image.image)


@col 50
**工作流**
![Image=705x263](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a550f093674b4e01a3ff8e43dea69112~tplv-goo7wpa0wc-image.image)

::::

## 记忆库额度 {#42e2a675}
不同订阅套餐可写入的记忆数量不同，具体说明如下表所示。当写入的记忆数据量超过套餐限额时，智能体或工作流将提示当前记忆条数触发上限，本次记忆写入失败，你可以选择删除部分记忆数据，或升级套餐至更高版本。
<!-- @cols-width: 173,264 -->
| | | \
|**订阅套餐** |**记忆库数量上限** |
|---|---|
| | | \
|个人免费版 |100 条 |
| | | \
|个人进阶版 |1000 条 |
| | | \
|个人高阶版 |2000 条 |
| | | \
|个人旗舰版 |1 万条 |
| | | \
|个人尊享版 |1 万条 |
| | | \
|企业标准版 |10 万条 |
| | | \
|企业旗舰版 |1000 万条 |

## 计费说明 {#7978fac6}
在使用记忆库时，写入、存储、更新以及检索长期记忆均将按照实际用量进行计费。具体的计费项及单价，请参考[记忆库费用](/coze_pro/memory_fee)。
## 创建记忆库 {#8a9b01de}
在使用智能体的长期记忆功能之前，你需要先创建记忆库。
1. 登录[扣子编程](https://code.coze.cn/home)。
2. 在页面顶部选择目标工作空间，然后在左侧导航栏中单击**资源库**。


3. 在页面右上角，选择 **+资源** > **记忆库**。
4. 在**创建记忆库**对话框中，设置记忆库名称和描述，然后单击**创建**。

## 在低代码智能体中添加记忆库 {#53378629}
:::tip 说明
一个智能体只能添加一个记忆库，一个记忆库可以被添加到多个智能体中。
:::
你可以在智能体的编排页面添加记忆库以开启长期记忆功能。功能开启后，智能体会自动收集对话中和用户相关的个性化信息，并将其记录在所指定的记忆库中。

1. 在智能体编排页面的**长期记忆**区域，单击➕，添加记忆库。
   ![Image=396x170](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e299a6d4269f4106908c6d53da1f4fcd~tplv-goo7wpa0wc-image.image)
2. 单击**设置**图标，选择是否开启在 Prompt 中调用记忆库。
   * 开启**支持在Prompt中调用**：在对话中，模型将通过用户 Prompt 直接召回长期记忆，例如用户输入`我喜欢西瓜`，模型并会从记忆库中召回长期记忆并总结返回给用户。
   * 关闭**支持在Prompt中调用**：在对话中，模型不会直接召回长期记忆。如果绑定了包含长期记忆检索节点的工作流，模型将调用工作流召回长期记忆。
   :::tip 说明
   **支持在Prompt中调用**仅影响长期记忆的召回方式，不影响长期记忆的记录方式，只要添加了记忆库，智能体就会记录用户的个性化信息。
   :::
   ![Image=609x110](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/31645888b9ba45eeb6cebb435d2562ec~tplv-goo7wpa0wc-image.image)

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

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

在与智能体对话时，智能体会主动识别并提取、记录用户个性化信息，例如在对话中和智能体强调“叫我小李”。对于一些非关键信息，可能智能体不会主动记录，你可以通过对话方式强制智能体记录长期记忆，例如对话时使用“记录到长期记忆”、“一定要记住”、“别忘了”等相似语义的关键词。
### 在工作流中写入长期记忆 {#a42b4d6a}
你还可以通过工作流的长期记忆写入节点，将长期记忆数据写入记忆库。具体操作，请参考[长期记忆写入节点](/guides/memory_write_node)。
## 召回长期记忆 {#6fc995b5}
开启长期记忆后，你可以通过 Prompt 或工作流召回长期记忆。
### 在 Prompt 中召回长期记忆 {#2fc54097}
你可以在和智能体的对话中主动查询长期记忆，例如向智能体发送自己的早餐菜谱后，如果询问“今天早上我吃了什么”，智能体会从长期记忆中召回今日早餐相关的内容，总结后回复给你。
对于人设类的智能体，出于对用户关心，增强用户体验，在某些场景下，智能体也会主动提及长期记忆中存储的关键信息。例如用户表示自己摔了一跤，智能体可能会主动关心用户的康复情况。
### 在工作流中召回长期记忆 {#d8aa4d5c}
你可以在工作流中通过**长期记忆检索节点**来召回指定关键词相关的长期记忆，作为工作流下游节点的输入参数。关于工作流长期记忆节点的详细说明，可以参考[长期记忆检索节点](/guides/memory_query_node)。
## 相关操作 {#f849c181}
### 查看长期记忆 {#df9f0242}
在资源库的**记忆库**页签下，单击目标记忆库，然后在记忆库详情页面，单击目标 ID，并查看对应的长期记忆。
该 ID 是系统通过用户 UID 与渠道 ID 组合生成的编码，该编码将作为数据隔离的核心标识，保障同一记忆库中不同使用主体的记忆数据独立。
![Image=505x89](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e40938ceedc34ea0a9cbba917c9bc6a7~tplv-goo7wpa0wc-image.image)
### 更新长期记忆 {#35492963}
当你需要修改某条长期记忆时，可以在资源库的**记忆库**页签下，单击目标记忆库，然后在记忆库详情页面，将鼠标悬浮在目标长期记忆上，单击**编辑**，修改内容。
![Image=490x86](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d9f599d2b89048499df7678b5be75231~tplv-goo7wpa0wc-image.image)
### 删除长期记忆 {#b267f5ec}
当你不再需要使用某条长期记忆时，可以删除指定的长期记忆。记忆库的存储数据是按小时统计的，删除指定的长期记忆后，系统将在下一个小时更新已存储的数据量。
在资源库的**记忆库**页签下，单击目标记忆库，然后在记忆库详情页面，将鼠标悬浮在目标长期记忆上，单击**删除**。
![Image=487x89](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/da6a3672931c44faaab5f16ce03d2daf~tplv-goo7wpa0wc-image.image)
### 删除记忆库 {#8efcd72d}
:::notice 注意
删除某个记忆库后，引用了该记忆库的智能体或工作流也将自动取消引用，且此操作不可撤回，请谨慎操作。
:::
当你不再需要使用所有的长期记忆时，可以删除整个记忆库。在资源库的**记忆库**页签下，找到目标记忆库，单击 **···** > **删除**。
![Image=573x103](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2232db5bc8de436285a7eada5a7fbbb9~tplv-goo7wpa0wc-image.image)