循环

前提条件

已完成工作流搭建，如果未搭建工作流，请参考搭建工作流。

节点说明

循环是一种常见的控制机制，用于重复执行一系列任务，直到满足某个条件为止。工作流提供循环节点，当需要重复执行一些操作，或循环处理一组数据时，可以使用循环节点实现。

配置循环节点

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择进入所需空间。

   如果已选择团队空间，界面显示为实际的团队空间名称，而非“个人空间”。

   图1 选择团队空间
   

2. 在左侧导航栏选择“开发中心 > 应用管理 > 工作流应用”，单击您创建的工作流。
3. 单击“添加节点”并选择“代码”节点。
4. 拖动其他需要循环执行的节点到循环体画布内部并编排（循环内执行需从循环输入节点开始，输出连接到循环输出节点，暂不支持交互式节点）。
5. 参照表1，完成循环节点的配置。
   

   • 单击图标，可修改循环节点名称，修改完成后单击名称旁边的进行保存。
   • 单击图标，可重命名循环节点名称，复制一个循环节点或删除循环节点。

   表1 循环节点配置说明

   配置类型	参数名称	参数说明
   循环类型配置	使用数组循环	使用数组循环类似编程语言中的for语法结构。遍历循环用于遍历一个已知的序列，对序列中的每个元素执行一系列相同的步骤。 使用数组循环时，需要指定arr_loop_var的值，此参数仅支持引用上游节点的输出，且必须为数组格式。使用数组循环模式下执行循环节点时，循环的次数取决于循环数组引用的数组长度。 使用数组循环时，循环节点会遍历数组中的每个元素，每次循环都会将当前循环到的元素赋值给内置变量。内置变量仅限循环节点内部使用。目前支持的内置变量如下： item：数组元素，即当前循环到的数组元素。 index：数组索引，index+1 为当前循环的轮次。
   	指定循环次数	指定循环次数模式通常用于批量、顺序处理数据的场景，需要同时设置循环次数。 循环次数默认为 5 次，支持设置为 1~1000 次。 使用参考： 回合制游戏，3局2胜可将循环次数设置为3。 网络爬虫爬取前1000个商品信息，循环次数设置为1000。
   变量配置	循环数组	此参数只有在使用数组循环时支持配置，名称固定为arr_loop_var，仅支持引用上游节点输出。
   	中间变量	循环节点支持设置中间变量，此变量可作用于每一次循环。中间变量通常和循环体中的设置变量节点搭配使用，在每次循环结束后为中间变量设置一个新的值，并在下次循环中使用新值。 当单击图标时，可新增中间变量。 参数名称：只允许输入字母、数字、下划线，且不能以数字开头。 类型、值：支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点的输出变量值和全局配置中的记忆变量。 输入：支持用户自定义取值。
   	输出参数	循环节点的输出参数可设置为循环体的执行结果集合，表示当数组中所有元素运行完毕之后，将所有循环的运行结果打包输出给下游。也支持设置为中间变量的取值。 当单击图标时，可新增输出参数。
   终止条件	表达式	分支由[判断参数 比较条件 比较参数]组成一个条件表达式。 当单击图标时，可新增终止条件。 判断参数：条件表达式上半部分，需要选择来自前序节点的输出参数。 比较条件：条件表达式左侧，当前支持的比较条件有：长度大于、长度大于等于、长度小于、长度小于等于、等于、不等于、包含、不包含、为空、不为空。针对不同的判断参数类型，前端将展示不同的比较条件。 比较参数：条件表达式下半部分，支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点输出变量值及全局配置中的记忆变量。 输入：支持用户自定义取值。 添加条件：单击“+”，在当前条件分支中添加多个条件表达式，多个条件表达式之间通过“且”或“或”来连接。 单击“且”或“或”，可以切换该分支表达式的运算逻辑。

   图2 循环节点配置示例
   

6. 节点配置完成后，单击“确定”。
7. 连接循环节点和其他节点。