动态与公告

产品动态

产品公告

产品简介

产品概述

产品优势

应用场景

模型介绍

购买指南

套餐订阅

旧版计费

快速入门

智能体应用及其三种模式

基于“标准模式”创建“内容总结助手”

基于“单工作流模式”创建“网页内容抓取助手”

基于“Multi-Agent 模式”创建“脱口秀素材创作助手”

操作指南

应用开发

工作流

Multi-Agent

知识库

Widget

插件广场

模型列表

提示词模板

应用模板

平台管理

企业、工作空间与权限

API 文档

History

API Category

Making API Requests

Atomic Capability APIs

Operation Optimization APIs

Document Library APIs

Q&A Database APIs

Knowledge Tag APIs

Application Management APIs

Enterprise Management APIs

Billing APIs

Release Management APIs

Dialogue Endpoint APIs

Data Statistics APIs

Data Types

Error Codes

应用接口文档

对话接口总体概述

对话端接口文档（WebSocket）

对话端接口文档（HTTP SSE）

图片对话或文件对话（实时文档解析+对话）

离线文档上传

腾讯云智能体开发平台操作 cos 指南

ADP 文档解析协议

常见问题

产品常见问题

技术常见问题

变量说明

PDF

聚焦模式

字号

最后更新时间： 2026-01-28 10:21:30

智能体开发平台提供了丰富的变量类型供用户使用，以满足不同业务场景需求。
变量类型
从变量的使用范围角度，智能体开发平台的变量分为“应用级变量”和“工作流级变量”两类变量。
应用级变量
应用级变量表示应用全局范围内可见、可使用的变量，具体包括：
变量类型
变量描述
变量名称及描述
系统变量
智能体开发平台系统默认提供的变量，在应用范围内的各模块均可读取，但不支持用户编辑。
以 SYS.XXX 方式命名。
SYS.UserQuery：本轮对话内容；
SYS.RewriteQuery：多轮对话中本轮对话改写结果；
SYS.ChatHistory：对话历史（在工作流中使用时，支持配置对话历史轮数）；
SYS.CurrentTime：当前时间（格式为：YYYY年MM月DD日 HH:MM:SS，例如2025年08月10日 11:01:18）；
SYS.RequestId：对话请求 ID（API 调用请求参数中的 request_id）；
SYS.Memory：长期记忆内容（该字段在开启“长期记忆”功能后可用）。
环境变量
环境变量用于保存 API 密钥、数据库密码等敏感数据，提供特殊的 Secret数据类型，支持加密存储、传输、并在页面显示为*****。
在应用范围内的各模块可读取，仅支持在“变量与记忆”中编辑。
以 ENV.XXX 方式命名。
使用示例：ENV.LLMSecretKey，存储大语言模型调用时的 secretKey，在工作流中或者 Agent 的工具中使用。
API 参数
API 参数表示用户在调用智能体开发平台 API 时，通过 customer_variable 字段传入系统的变量。
在应用范围内的各模块可读取，仅支持在“变量与记忆”中编辑。
以 API.XXX 方式命名。
调用方法详见：对话端接口文档（HTTP SSE）、对话端接口文档（WebSocket）。
使用示例：API.UserName，通过 API 参数传入用户姓名，在对话时更亲切地称呼用户。
应用变量
表示在应用内各个模块中互相传递的变量。例如工作流A对应用变量进行赋值，工作流 B 进行读取。
在应用范围内的各模块均可读可写，仅支持在“变量与记忆”中编辑。
以 APP.XXX 方式命名。
使用示例：APP.Notes，工作流A中收集用户笔记内容并赋值给 APP.Notes，工作流 B 获取笔记内容并总结摘要。
工作流级变量
工作流级变量表示在工作流内部可见、可使用的变量，具体包括：
变量类型
变量描述
变量名称及描述
工作流变量
表示在工作流范围内传递的变量。例如在工作流分支A对变量赋值，在分支 B读取变量值。
在工作流的开始节点进行定义，在工作流内的各节点均可读取，并仅支持在“变量赋值节点”中赋值。
以 WF.XXX 方式命名。
使用示例：WF.OrderList，分支A中整理用户订单内容并赋值给 WF.OrderList，分支 B 中获取订单内容并下单。
节点输入变量
表示当前工作流节点的输入变量，仅在节点内部编辑和使用。
-
节点输出变量
表示当前工作流节点的输出变量，节点内实现该变量的写入，并在后续节点读取和使用。
-
适用范围
由于使用场景不同， 每种变量的使用范围也存在差异，具体如下：
变量名称
﻿
是否用户隔离
是否 Session 隔离
应用级变量
系统变量（除 SYS.Memory 外）
是
是
﻿
SYS.Memory
是
否
﻿
环境变量
否
否
﻿
API 参数
是
否
﻿
应用变量
是
否
工作流级变量
工作流变量
是
是
﻿
工作流节点输入变量
是
是
﻿
工作流节点输出变量
是
是
说明：
由于上述变量都存在于应用中，是应用下的概念，因此天然就是“应用隔离”，此处不再赘述。
“用户隔离”是指同一个变量对于不同终端用户的变量值不同，终端用户根据调用 API 时传入的 visitor_biz_id 字段进行区分（详情请参见 对话端接口文档（HTTP SSE）、对话端接口文档（WebSocket））。
例如：API 参数 userID（表示用户 ID），张三的 userID 是001，李四的 userID 是002，是“用户隔离”；而环境变量 APIKey（表示某插件的密钥）无论对于张三还是李四变量值都相同，不是“用户隔离”。
“Session 隔离”是指同一个变量在不同的 Session 下，该变量值不同。
例如：张三的长期记忆（SYS.Memory）可以跨 Session 使用，不是“Session隔离”；而工作流节点的输入变量，换 Session 后这些值也随即更换，是“Session 隔离”。
从隔离的范围上看，应用隔离 > 用户隔离 > Session 隔离。灵活使用 ADP 提供的各类变量可以满足复杂的业务场景需求。
生命周期
由于每一种变量的使用场景不同，因此生命周期也存在差异，具体如下：
变量名称
﻿
生命周期
应用级变量
系统变量（除 SYS.Memory 外）
Session 粒度
﻿
SYS.Memory
永久（具体保存时间取决于用户配置的记忆时效）
﻿
环境变量
永久
﻿
API 参数
永久
﻿
应用变量
Session 粒度
工作流级变量
工作流变量
Session 粒度
﻿
工作流节点输入变量
Session 粒度
﻿
工作流节点输出变量
Session 粒度
说明：
Session 粒度指的是同 Session 内生效，例如：应用变量 APP.UserName 的默认值为“张三”，在 Session1 中，工作流 A 将其改为“李四”，此后，Session1内的工作流B读取 APP.userName 时，值为“李四”。当开启新的 Session2后，工作流 A 再读取 APP.userName，该值仍为默认值“张三”，而不是 Session1中工作流 A 改成的“李四”。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

变量类型	变量描述	变量名称及描述
系统变量	智能体开发平台系统默认提供的变量，在应用范围内的各模块均可读取，但不支持用户编辑。以 SYS.XXX 方式命名。	SYS.UserQuery：本轮对话内容； SYS.RewriteQuery：多轮对话中本轮对话改写结果； SYS.ChatHistory：对话历史（在工作流中使用时，支持配置对话历史轮数）； SYS.CurrentTime：当前时间（格式为：YYYY年MM月DD日 HH:MM:SS，例如2025年08月10日 11:01:18）； SYS.RequestId：对话请求 ID（API 调用请求参数中的 request_id）； SYS.Memory：长期记忆内容（该字段在开启“长期记忆”功能后可用）。
环境变量	环境变量用于保存 API 密钥、数据库密码等敏感数据，提供特殊的 Secret数据类型，支持加密存储、传输、并在页面显示为***。在应用范围内的各模块可读取，仅支持在“变量与记忆”中编辑。以 ENV.XXX** 方式命名。	使用示例：ENV.LLMSecretKey，存储大语言模型调用时的 secretKey，在工作流中或者 Agent 的工具中使用。
API 参数	API 参数表示用户在调用智能体开发平台 API 时，通过 customer_variable 字段传入系统的变量。在应用范围内的各模块可读取，仅支持在“变量与记忆”中编辑。以 API.XXX 方式命名。调用方法详见：对话端接口文档（HTTP SSE）、对话端接口文档（WebSocket）。	使用示例：API.UserName，通过 API 参数传入用户姓名，在对话时更亲切地称呼用户。
应用变量	表示在应用内各个模块中互相传递的变量。例如工作流A对应用变量进行赋值，工作流 B 进行读取。在应用范围内的各模块均可读可写，仅支持在“变量与记忆”中编辑。以 APP.XXX 方式命名。	使用示例：APP.Notes，工作流A中收集用户笔记内容并赋值给 APP.Notes，工作流 B 获取笔记内容并总结摘要。

变量名称			是否用户隔离	是否 Session 隔离
应用级变量	系统变量（除 SYS.Memory 外）	是	是
		SYS.Memory	是	否
		环境变量	否	否
		API 参数	是	否
		应用变量	是	否
工作流级变量	工作流变量	是	是
		工作流节点输入变量	是	是
		工作流节点输出变量	是	是

变量名称			生命周期
应用级变量	系统变量（除 SYS.Memory 外）	Session 粒度
		SYS.Memory	永久（具体保存时间取决于用户配置的记忆时效）
		环境变量	永久
		API 参数	永久
		应用变量	Session 粒度
工作流级变量	工作流变量	Session 粒度
		工作流节点输入变量	Session 粒度
		工作流节点输出变量	Session 粒度

tencent cloud

腾讯云智能体开发平台

变量说明

变量类型

应用级变量

工作流级变量

适用范围

生命周期

帮助和支持