开始节点

最近更新时间:2026-01-28 10:52:32

我的收藏

节点功能

开始节点属于基础节点,用于标识工作流的启动,是整个工作流的入口。该节点展示了可在工作流节点中引用的多种应用级变量,同时支持根据实际需求添加以下两类变量:
1. 工作流级变量:在当前工作流内赋值使用的变量。
2. 启动工作流的输入变量:主要用于工作流间传递的变量。




操作说明

应用级变量

包括系统变量、环境变量、API 参数和应用变量,各变量类型的详细说明请参见变量说明
1. 系统变量:腾讯云智能体开发平台默认提供的变量,在应用范围内的各模块均可读取,但不支持用户编辑(以 SYS.XXX 格式命名)。
2. 环境变量:用于保存 API 密钥、数据库密码等敏感数据,提供特殊的数据存储类型,在应用范围内的各模块均可读取,仅支持在“变量与记忆”中编辑(以 ENV.XXX 格式命名)。
3. API 参数:用户在调用腾讯云智能体开发平台 API 时,通过 custom_variables 字段传入系统的变量,在应用范围内的各模块均可读取,仅支持在“变量与记忆”中编辑(以 API.XXX 格式命名)。
4. 应用变量:在应用内各个模块中互相传递的变量,在应用范围内的各模块均可读可写,仅支持在“变量与记忆”中编辑(以 APP.XXX 格式命名)。

工作流级变量

在当前工作流中全局可用的变量,支持用户根据需求自定义添加。该类型变量主要用于在整个工作流的执行过程中被赋值或调用,以便在任意步骤中灵活传递和使用数据(以 WF.XXX 格式命名)。

使用示例

在“英文文献调研与撰写主工作流”中,调研主题(search_topic)和调研文献篇数(num_of_article)变量需要在当前工作流的各节点中都能被随时赋值和调用,此时可以在开始节点添加对应的工作流级变量



完成如上配置后,search_topic 和 num_of_article 变量即可在“英文文献调研与撰写主工作流”的各节点中被全局使用(即使节点间不存在直接连接关系)。




启动工作流的输入变量

在腾讯云智能体开发平台运行该工作流时所需要输入的变量,支持用户根据需求自定义添加。该变量主要用于不同工作流间的数据流转(例如:当主工作流中的变量需要传递到子工作流时,该变量需要在子工作流的开始节点通过添加启动工作流的输入变量接收)。

使用示例

在“英文文献调研与撰写主工作流”中,调研主题(search_topic)和调研结果(result)变量需要被传递到“文献检索”工作流时,首先需要在“文献检索”工作流的开始节点添加对应的启动工作流的输入变量:



完成如上配置后,即可回到“英文文献调研与撰写主工作流”中使用工作流节点将 result 和 search_topic 变量传递到对应的“文献检索”工作流中供其使用。



需要注意的是,当前工作流中的变量(此处以“文献检索”工作流的执行结果为例)需要传递到其他工作流时,需要在该工作流的结束节点进行输出变量的相关配置:



完成如上配置后,“文献检索”工作流中的变量即可被传递到其他工作流中(此处以“英文文献调研与撰写主工作流”为例)。




工作流级变量启动工作流的输入变量配置说明如下。
配置
说明
变量名称
变量的名称
默认值
变量的默认初始值
变量描述
变量的描述信息,帮助模型理解变量的含义
变量类型
变量的数据类型,支持 string、int、float、bool、object,array 类型的 array<string>、array<int>、array<float>、array<bool>、array<object>、array<file>、array<document>、array<image>、array<audio> 和 array<video>,文档格式支持通用格式 file、文本格式 document、图片格式 image、音频格式 audio 和视频格式 video。其中文档格式变量仅支持文档链接,非原文件
必填
变量是否必填,启动该流程时是否必须输入该变量

常见问题

API 参数和工作流级变量有什么区别?
API 参数是从“外部”系统传入到腾讯云智能体开发平台中的变量,而工作流级变量是腾讯云智能体开发平台“内部”流转的变量。