扣子应用全局变量配置指南：实现跨会话数据持久化的核心方法

扣子平台中，全局变量仅在当前会话生命周期内有效，无法自动在不同对话或用户间保持数据持久。要实现信息（如身份认证状态、个人偏好、历史查询参数）的跨会话留存，必须明确一条技术边界：唯一可靠的路径是通过数据库或第三方API完成数据持久化存储，随后利用赋值节点将其载入全局变量环境。

简言之，全局变量的职责是充当临时的数据中转站，而非永久仓库。长期数据保管必须依赖外部存储系统。以下是具体的实施策略。

明确全局变量不具备跨会话持久化能力

扣子的「全局变量」仅在单个智能体实例内共享，【不支持跨用户、不支持跨会话持久保存】——它随智能体发布而初始化，但其值不会自动存入磁盘或数据库。例如，即便你设置了 user_id: "1001" 的初始值，用户下次开启新对话时，看到的仍是这个预设值，而非上一轮会话结束时的最终状态。

关键在于理解：全局变量是运行时容器，不等于持久化存储层。忽略这一本质区别，后续所有配置都将失效。

开启会话记忆功能并定义全局变量

第一步：进入智能体编辑界面 → 点击左上角「设置」图标 → 切换至「对话设置」选项卡 → 开启「启用上下文记忆」功能。

第二步：在「全局变量」选项卡中点击「+ 添加变量」→ 变量名填写 【user_profile】（命名需以字母开头，仅允许字母、数字、下划线，长度≤20）→ 初始值可留空或设为 {} → 类型选择「文本」。

注意：此步骤仅为变量声明，并非赋值操作。变量名一旦创建即不可修改，拼写错误需删除后重建。这个细节常被忽视，却直接关系到后续数据流的正确性。

使用数据库节点取代变量节点实现真实持久化

方法一：通过「数据库」节点写入用户数据
拖入「数据库」节点 → 选择已创建的「users」数据表 → 操作类型选「更新或插入」→ 在「条件」字段填写 { "user_id": "{{input.user_id}}" } → 在「更新字段」中设置 { "last_city": "{{current_city}}", "budget": {{budget_range}} }。

方法二：通过「代码」节点调用外部API进行存取
拖入「代码」节点 → 编程语言选择 Python → 输入以下示例代码：
import requests
r = requests.post("https://api.yourservice.com/sa ve", json={ "uid": context.input.get("user_id"), "data": { "city": context.get("current_city", ""), "budget": context.get("budget_range", 0) } })
return { "status": r.status_code }

这是整个方案的核心转折点：所有需跨会话保留的关键数据，都必须最终落盘至数据库或其他具备持久化能力的服务。变量节点仅负责流程内的临时传递，不承担长期存储职责，这一设计原则必须贯彻始终。

在新会话中读取持久化数据并注入上下文

第一步：当用户发起新对话时，触发「数据库」查询节点 → 将查询条件设置为 { "user_id": "{{input.user_id}}" } → 输出路径填写 $.data（确保返回完整对象结构）。

第二步：连接一个「赋值节点」→ 将数据库返回结果中的 city 字段赋值给会话变量 【current_city】 → 值设定为 {{数据库节点.output.city}}。

第三步：继续连接一个「变量」节点 → 操作类型选择「设置」→ 变量名填写 user_profile → 输入参数绑定 {{赋值节点.output}} → 从而将查询到的持久化数据重新写入全局变量作用域，供后续所有工作流节点调用。

此刻，user_profile 的值已是动态加载的真实用户档案，而非初始的空值。从用户体验层面看，无论经历多少次对话轮次，其个性化偏好与历史交互数据都能实现无缝衔接，这正是跨会话数据持久化所要达成的核心效果。