---
permalink: /coze-guide/getting-started/11-coze-ai-agent.html
---

# 11.Coze智能体-记忆

在与人工智能对话的过程中，随着对话轮数的增多，传统的上下文记忆往往难以支撑较长的对话场景。

因此，如何给智能体提供一种“长期记忆”机制，以便随时调用并让对话更加连续、个性化，成为新一代智能体的关键需求。

本文将为你介绍在扣子平台中，为智能体打造记忆的四大核心功能：变量、数据库、长期记忆和文件盒子。

通过结合这四大功能，你可以让智能体既能记住用户偏好，也能灵活存取和管理结构化数据，甚至可以像一个贴心朋友一样，通过长期记忆记录并响应用户的需求。

## 一、变量

**1. 变量的作用**

变量是存储用户偏好、使用习惯、个人信息等的关键手段。

当智能体识别到用户的信息后，会将这些信息赋值给事先配置好的变量。

在后续对话中，智能体就能随时调用这些变量，实现更加个性化的输出。

例如，你可以为用户设置一个名为 language_preference 的变量，用于记录用户喜欢使用的语言。

**2. 变量类型：系统变量与用户变量**

- **系统变量**：由系统默认创建，涵盖用户信息、飞书信息等。这些变量数据是只读的，无法由开发者或用户自行修改。默认情况下，这些系统变量是关闭的，只有在你明确开启后才会生效。
- **用户变量**：用于记录每个用户在对话中需要持久化的信息，比如昵称、习惯、历史查询记录等。开发者可以手动创建和配置用户变量，用户再次进入对话时即可沿用之前的数据，从而实现“跨会话”记忆。

**3. 创建与使用变量的关键步骤**

- 登录 扣子平台并进入“智能体”页面，找到“变量”功能。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122433Z-7f2bee8cfe1e44bf-eff87200.jpg)

- 点击 **+**，新增一个用户变量，设置名称、默认值和描述。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122440Z-4e359ef66cc97963-7ae4c06b.jpg)

- 在智能体的提示词或人设里调用这个变量。例如，将变量 name 用于问候：“你好，{{name}}！”

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122435Z-d3a33032817d6224-8a293340.jpg)

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122431Z-e15a9ac4790a9284-300a52a3.jpg)

- 在调试区域，可以实时查看和测试这些变量。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122434Z-745ef912541c95a8-b2fafe03.jpg)

- 当你善用变量功能后，智能体就能精准捕捉并存储用户提供的个性化信息，以便随时进行回复或分析。

## 二、数据库

**1. 为什么需要数据库功能？**

如果变量主要用来存储少量的用户信息，那么数据库功能就是专门应对更复杂的场景。

在真实业务中，你可能需要在智能体中管理大量结构化数据，例如客户信息、订单记录、产品库存等。

扣子的数据库功能为此提供了一种简单、高效的解决方案。

**2. 数据库的多用户模式**

数据库在扣子平台里可以设置为单用户模式或多用户模式。

单用户模式适合个人场景，用户可轻松插入、查询或修改自己的数据。

而多用户模式则更灵活，支持不同权限的读写控制，满足团队或企业环境下对数据安全的更高要求。

**3. 如何创建和使用数据表**

- 登录扣子平台后，进入“智能体”页面。
- 在编排页面点击“数据库”右侧的 **+**，创建数据表。你可选择“自定义表格”，或基于已有模版修改。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122431Z-04270ea11d355508-2f0c7b18.jpg)

- 在配置数据表时，依照实际需求设置字段信息。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122434Z-9815ec8a7917fec8-f14f10a8.jpg)

- 在 Prompt 中可以通过自然语言对数据库进行操作。例如，当用户输入“把今天的午餐开支记下来”时，智能体可将本次消费记录插入到数据库；若用户查询“本周我在餐饮上的支出是多少？”则会自动执行对应的 SQL 查询并返回结果。
- 可在调试区域查看表格中的数据，验证是否正确存储和读取。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122433Z-565fd4e2297a7f5b-f029329f.jpg)

借助数据库，你能处理和管理更复杂的结构化信息，让智能体在对话中轻松调用并分析海量数据。

## 三、长期记忆

**1. 长期记忆的意义**

在连续多轮对话中，单纯依靠上下文往往难以维持对于用户的深层认知，一旦超过模型最大对话轮数，早先的对话内容就会丢失。

针对这种情况，扣子平台的“长期记忆”功能可记录并挖掘用户的个性化信息，包括性格、喜好、经历等。

**2. 主要能力：记录与召回**

- **记录**：系统会自动识别对话中的关键信息，并将其提取到用户的记忆库中。
- **召回**：当用户发出与过往对话相关的请求时，智能体可检索记忆库，将之前记录的信息纳入当前的回复逻辑，让对话更加真实、生动。

**3. 典型场景**

如在“虚拟男友/女友”类场景中，智能体不但需要简单的聊天功能，更需随着对话的深入逐渐了解用户的人设，记住他们的个人喜好，甚至过去的情感经历。

长期记忆的加入，大幅提升了情感陪伴类对话的沉浸感和贴心度。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122432Z-1b1147171315a67a-d206c219.jpg)

## 四、文件盒子

**1. 文件盒子的功能**

在场景越来越丰富的今天，用户与智能体的交互也不仅限于文字。

用户可能需要上传图片、PDF、Word 或 Excel 文件来进行分析或存档。

扣子的“文件盒子”能够在合规的前提下统一管理和存储各种类型的文件，支持多种操作方式：

- 文件管理：增删改查等常规功能。
- 文件夹管理：对文件夹进行移动、批量修改等。
- 多模态数据的检索与调用：基于文件内容进行检索，灵活调用文件中的信息。

**2. 适用场景**

文件盒子功能适用于发布在豆包和智能体商店的智能体场景。

比如，你想做一个“云相册”或“记账本”，让用户上传照片或表格后，智能体能随时查询、显示或整理这些文件，文件盒子就能很好地满足这一需求。

![image.png](https://vtang.oss-cn-hangzhou.aliyuncs.com/images/2026/08/25/20260825T122440Z-26193725c5298033-a6dfe3a2.jpg)

## 小结

扣子平台提供的四大核心能力——变量、数据库、长期记忆和文件盒子，共同构成了智能体的记忆体系。

通过变量，智能体可以记住每位用户的偏好，输出个性化的回复。

借助数据库，庞大的结构化数据能够被灵活管理与查询。

有了长期记忆，智能体在多轮对话中可以不断完善对用户的认知，塑造更真实的互动体验。

最后，文件盒子让多模态文件也能被高效存储、检索和利用。

对开发者来说，这些功能的结合，使得智能体具备了从“认识用户”到“管理数据”再到“深度对话和多模态交互”的全方位能力。

更多干货内容，可以查看电子书。[点击跳转合集页面](https://xiaobot.net/post/8e3ae10c-5aca-43cd-af66-09a7fbe31eb0)