变量
最新更新:2025-04-07

变量

变量是节点的核心组成部分,是工作流的节点之间进行数据传递的基本单元。而节点的本质就是接收变量、运行、输出变量。

变量类型

image.png

工作流支持主流的变量类型,如下:

String Integer Number Boolean Object Array<String> Array<Integer> Array<Number> Array<Boolean> Array<Object> File - Doc File - Excel File - Ppt File - Image File - Code File - Audio File - Video Array<File> - Array<Doc> Array<File> - Array<Excel> Array<File> - Array<Ppt> Array<File> - Array<Image> Array<File> - Array<Code> Array<File> - Array<Audio> Array<File> - Array<Video>
          String
Integer
Number
Boolean
Object

Array<String>
Array<Integer>
Array<Number>
Array<Boolean>
Array<Object>

File - Doc
File - Excel
File - Ppt
File - Image
File - Code
File - Audio
File - Video

Array<File> - Array<Doc>
Array<File> - Array<Excel>
Array<File> - Array<Ppt>
Array<File> - Array<Image>
Array<File> - Array<Code>
Array<File> - Array<Audio>
Array<File> - Array<Video>

        
此代码块在浮窗中显示

注意,当“文件类变量”被输入后,它将被转为 URL,以参与工作流流转。支持格式如下:

  • Doc:doc、docx、pdf、txt、md、html

  • Excel:xls、xlsx、csv

  • Ppt:ppt、pptx

  • Image:jpg、jpeg、png、gif、webp、svg

  • Code:py、java、c、cpp、js、css

  • Audio:mp3、wav、aac、flac、ogg、wma、alac、mid、midi、ac3、dsd

  • Video:mp4、avi、mov、wmv、flv、mkv

变量定义与赋值

每个节点,都可以按照当前节点所需,定义输入或输出变量。

对于定义输入变量,可以为其赋值,以便于在节点配置中引用。可用的值有以下几种:

  • 自定义值:在当前节点中手动输入的特定值。

  • 上游节点的输出:上游节点输出至当前节点的出参的值,可被赋值至当前节点的变量。

  • 全局变量:GPTBots 系统预置的一些变量,它们在所有工作流的任何节点中均可使用,如对话 ID、浏览器属性、三方平台属性(如 WhatsApp、Telegram 等)等。它们无法被修改。

  • 环境变量:开发者可在工作流内自定义环境变量,其作用域(Scope)仅限于当前的工作流内。环境变量可以在当前工作流的任何节点中使用。

变量使用

节点输入(变量定义)在节点的输入部分,可以定义变量,并对变量进行赋值。

image.png

节点配置:在节点的各个配置项,均可以通过选择、"{{"引用等方式,使用变量。

image.png

节点输出:在部分组件的节点输出部分,可以定义要输出的变量及其类型。每个组件的输出均有所差异。

image.png