前言

上篇文章《低代码Agent开发框架使用指南（五）—Coze消息卡片详解》中，笔者深入介绍了Coze平台中消息卡片的功能与配置方法，帮助开发者实现更具结构化和用户友好的交互体验。除了消息卡片，Coze还提供了多种核心技能，进一步赋予智能体更强的理解力与交互能力。今天笔者要重点介绍的，就是其中两项关键能力——变量 与 长期记忆。变量 让智能体能够动态存储和调用用户的个人信息，实现更加个性化的服务。长期记忆 则赋予智能体跨越对话的“记忆”能力，形成连贯的上下文理解与交互策略。即便你没有技术背景，掌握这两项功能，也能轻松打造出一个真正“懂你”、理解你需求的智能体。
接下来，笔者将手把手带你学习变量与长期记忆的具体使用方法，助力大家构建更智能、更贴近用户的智能体。

低代码Agent开发相关文章已全部收录于笔者专栏《AI应用工厂：低代码智能体开发使用指南》。本专栏致力于帮助零代码经验的朋友快速上手智能体搭建，学会该技能可以轻松实现如旅游助手、自动文档处理、自动视频生成等实用工具，让大模型技术真正赋能日常生活。

对于有编程基础、喜欢写代码的开发者也可以阅读笔者的LangChain/LangGraph系列教程专栏。该专栏融合了笔者在实战中积累的深度经验，系统讲解如何基于LangChain与LangGraph框架高效开发智能体，并通过众多实战项目助大家快速构建专业级应用。大家感兴趣可以关注笔者CSDN账号和系列专栏，更可关注笔者同名微信公众号: 大模型真好玩, 每期分享涉及的代码均可在公众号私信: LangChain智能体开发获得。

一、Coze变量

1.1 变量定义

在开发智能体时，变量常被用于记录用户信息并引导对话流程。来看一个具体场景：

假设开发者创建了一个对话型智能体，开发者创建一个名为 user_name 的变量。当用户第一次交互时，智能体可以主动询问：“你好，我是你的智能助手，请问怎么称呼你？”若用户回答“我叫小明”，智能体可将“小明”存储到user_name变量中。下次用户再次发起对话时，智能体就能直接问候：“小明，欢迎回来！很高兴再次见到你。”——是不是让交互更显贴心？

再进一步，开发者还可以使用变量记录更复杂的状态。例如开发者创建一个名为 user_visits 的变量用于统计用户访问次数：初次访问时设为 1，之后每次访问自动加 1。基于这个变量，开发者可以设计差异化的欢迎语，比如区分“欢迎第一次使用！”和“很高兴您再次光临！”，从而让智能体的回应更富个性，也更贴近真实交流。

理解了变量的基本作用后，接下来笔者将通过实际示例，带大家一步步掌握变量的使用方法。

1.2 变量实战

下面笔者通过一个完整的示例，演示如何在 Coze 平台中创建并使用变量，实现个性化的用户问候。

1.2.1 操作步骤

1. 首先进入 Coze 平台，创建一个新的智能体作为测试环境。

2. 在智能体编排界面，找到“变量”设置区域，点击右上角的 “+” 按钮新建变量。

3. 在编辑变量对话框内设置变量名称、默认值和描述；并单击保存完成变量创建。

4. 这里笔者额外提一下一些系统预设变量，比如 sys_uuid 可以获取用户的唯一标识，sys_longitude 和 sys_latitude 可以获取用户的地理位置信息。这些预设变量是只读的，可以让开发者快速利用。

5. 重复步骤再创建一个名为 visit_times 的变量，用于记录用户的访问次数。

1.2.2 实例演示

在与用户对话时，智能体会自动识别与变量匹配的内容，并将内容保存至变量内。开发者可以在智能体的人设与提示词中指定变量的具体使用场景。下面通过一个实例演示：

1. 在test智能体的提示词中加入以下逻辑:

• 如果 visit_times = 1，说"你好，我是你的智能问候助手，请问怎么称呼你？"
• 如果 visit_times > 1：
  • 如果有 name，说"{{name}}，欢迎第{{visit_times}}次光临！很高兴再次见到你。"
  • 如果没有 name，说"欢迎第{{visit_times}}次光临！我是你的智能问候助手，请问怎么称呼你？"
• visit_times 自增 1。

# 角色

你是一个智能问候助手，根据用户的访问次数进行不同的问候。

## 技能

### 技能 1： 首次访问问候

1. 当 `visit_times` = 1 时，输出："你好，我是你的智能问候助手，请问怎么称呼你？"

### 技能 2： 非首次访问问候

1. 当 `visit_times` > 1 时，如果有 `name`，输出："{{name}}，欢迎第{{visit_times}}次光临!很高兴再次见到你。"
2. 当 `visit_times` > 1 时，如果没有 `name`，输出："欢迎第{{visit_times}}次光临!我是你的智能问候助手，请问怎么称呼你？"

## 限制

- 每次问候后，`visit_times` 自增 1。
- 严格按照给定的条件和输出格式进行问候，不得随意更改。

2. 当用户第一次访问时，智能体会询问用户的名字，并将访问次数visit_times加1；用户输入名字后，智能体会记住用户名字到name变量中，并欢迎用户第一次光临，visit_times继续加1。当用户第二次、第三次访问时，智能体会根据记住的名字和访问次数，给出不同的欢迎语，让用户倍感亲切~

3. 在对话界面，点击左上角的“记忆”按钮，可以实时查看所有变量的当前值，方便在开发过程中进行调试和验证。
   
   

二、长期记忆

2.1 长期记忆的定义

如果说变量是智能体的“短期记忆”，用于记录用户基本信息和当前对话的上下文，那么长期记忆就如同智能体的“大脑”，承载着与用户互动的完整历史。它帮助智能体建立起连贯的对话理解能力，并支撑其形成个性化的服务策略。

长期记忆能够自动记录用户与智能体之间的每一轮对话，并借助智能算法提炼关键信息，将其转化为结构化的记忆数据。当用户再次发起对话时，智能体不仅会参考当前输入的内容，还能够主动“回忆”起与用户过往交流相关的信息，从而生成更加连贯、贴切的回复。

2.2 实例演示

在 Coze 平台中，长期记忆功能的配置非常便捷。根据智能体创建时间的不同，配置方式略有差异：

对于旧版智能体（如2025年10月13日前创建） ：
在目标智能体的编排页面中，找到“长期记忆”选项，直接点击开启即可。

对于新版智能体：
开发者需要先创建一个记忆库，随后在智能体配置中将其绑定。

启用后，开发者可以在对话界面左上角的“记忆”模块中实时查看长期记忆的内容，便于调试和验证。

下面我们通过一个具体场景来演示长期记忆的实际效果：

场景：假设你是一家服装品牌的市场营销人员，使用 Coze 搭建了一个智能客服助手，负责导购咨询与售后服务。

• 初次交流：一位用户咨询夏季新款连衣裙，智能体根据她偏好的颜色、风格推荐了几款热销商品，并提供了详细的尺码建议。用户对服务很满意，表示会考虑购买。
• 一周后：该用户再次前来，表示在门店看中了之前推荐的连衣裙，但对尺码仍有疑虑。

此时，借助长期记忆，智能体能够准确回忆起上次的对话细节，并给出如下回复：

“欢迎再次光临！我记得上周我们讨论过夏季新款连衣裙，您对浅蓝色的法式印花裙十分感兴趣。考虑到您提到的身高体重，我当时推荐您选择 S 码。如果您喜欢修身一点的效果，也可以试试 XS 码。不过我想再次提醒您，由于面料的特性，这款裙子在洗涤时要注意避免长时间浸泡，以免变形。很高兴能再次为您服务，如果还有任何问题，欢迎随时告诉我。”

三、变量与长期记忆综合运用

在实际开发中，我们可以将变量作为智能体的“静态档案” ，用于存储用户的基础属性；而长期记忆则承担“动态历程” ，记录用户在对话中不断变化的偏好、状态与历史需求。当用户再次与智能体交互时，变量帮助系统快速识别用户身份，长期记忆则让智能体理解用户的近期动态与上下文。两者结合，使智能体能够提供既个性又连贯的服务体验。

下面通过一个“个性化健康管理助手”的案例，具体展示二者如何协同工作。

场景设定：假设你是一名健康管理师，使用 Coze 平台构建了一个智能健康助手，用于提供饮食、运动、睡眠等方面的指导。

1. 建立用户基础档案（变量）

创建以下变量，记录用户的基础信息：

• user_name：用户姓名
• user_age：用户年龄
• user_gender：用户性别
• user_height：用户身高
• user_weight：用户体重

这些信息帮助智能体对用户建立基础画像，为后续个性化建议提供依据。

2. 记录动态健康数据（长期记忆）

开启长期记忆功能后，智能体会自动提取用户对话中的关键信息并加以存储，例如用户曾提到：

• “最近食欲不振，没胃口，该怎么调理？”
• “每天睡眠不足6小时，白天昏昏欲睡，如何改善？”
• “我饮食习惯偏甜和高脂，很难控制体重，能否帮我制定减脂食谱？”

这些内容将被结构化为记忆点，逐步形成对用户整体健康状况的持续认知。

3. 综合调用信息，生成个性化回复

几天后，用户再次提问：“最近熬夜加班，脸色蜡黄，皮肤暗沉，不知道怎么缓解疲劳、改善气色？”

智能体结合变量中的基础信息与长期记忆中的历史记录，生成以下回复：

{{user_name}}，根据您的年龄（{{user_age}}岁）和体重（{{user_weight}}kg），我建议从以下几个方面进行调整：

1.  **改善睡眠质量**  
    尽量在晚上11点前入睡，保证每晚睡眠不少于7小时。您之前提到过睡眠不足的问题，可以尝试睡前泡热水澡或进行呼吸放松练习。
2.  **优化饮食结构**  
    多吃富含维生素C和E的新鲜蔬果，减少高糖高脂摄入。关于之前讨论的减脂食谱，如果您在执行中遇到困难，我们可以进一步调整方案。
3.  **加入适度运动**  
    建议进行低强度有氧运动，如慢跑、游泳等，有助于促进新陈代谢、改善血液循环。
4.  **针对性补充营养**  
    可适当食用柑橘类水果，或考虑服用维生素C与E的补充剂，有助于改善皮肤状态。

如果您在执行过程中有任何不适或新的情况，欢迎随时告诉我，我将根据您的进展提供进一步建议。让我们一起稳步调整，提升整体健康状态。

四、总结与展望

本文介绍了Coze平台中变量与长期记忆两大核心功能。变量用于动态存储用户信息，实现个性化交互；长期记忆则记录对话历史，赋予智能体跨会话的连贯理解能力。通过实战示例，展示了如何配置和使用变量和长期记忆提升智能体的服务体验。除了变量和长期记忆这类非结构化记忆，Coze还可以集成结构化数据库，以增强数据管理能力。关于数据库的使用笔者下期内容分享，大家敬请期待~

大家阅读后感兴趣可关注笔者掘金账号和专栏。 低代码Agent开发相关文章已全部收录于笔者专栏《AI应用工厂：低代码智能体开发使用指南》。对于有经验喜欢写代码的开发者也可以阅读笔者的LangChain/LangGraph系列教程专栏，目前已经更完22节并还在持续更新中。该专栏融合了笔者在实战中积累的深度经验，系统讲解如何基于LangChain与LangGraph框架高效开发智能体，助你快速构建专业级应用。大家可关注笔者同名微信公众号: 大模型真好玩, 每期分享涉及的代码均可在公众号私信: LangChain智能体开发获得。