节点功能
开始节点属于基础节点,用于标识工作流的启动,是整个工作流的入口。该节点展示了可在工作流节点中引用的多种应用级变量,同时支持根据实际需求添加以下两类变量:
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变量即可在“文献调研与撰写主工作流”的各节点中被全局使用(即使节点间不存在直接连接关系)。
启动工作流的输入变量
在运行该工作流时所需要输入的变量,支持用户根据需求自定义添加。该变量主要用于不同工作流间的数据流转(例如:当主工作流中的变量需要传递到子工作流时,该变量需要在子工作流的开始节点通过添加启动工作流的输入变量接收)。
工作流级变量和启动工作流的输入变量配置说明如下。
|
变量名称 | 变量的名称 |
默认值 | 变量的默认初始值 |
变量描述 | 变量的描述信息,帮助模型理解变量的含义 |
变量类型 | 变量的数据类型,支持 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 参数是从“外部”系统传入到腾讯云智能体开发平台中的变量,而工作流级变量是腾讯云智能体开发平台“内部”流转的变量。