循环节点

最近更新时间:2025-09-09 16:17:42

我的收藏

节点功能

循环支持重复执行一系列任务,直到满足条件为止。循环节点属于基础节点,支持用户通过配置输入变量、循环体(工作流)和循环方式,循环执行特定的工作流。




操作说明

输入变量

输入变量仅在该节点内部生效,不能跨节点使用。支持最多添加50个输入变量,满足多输入变量场景需要。点击添加,进行如下配置添加输入变量。
配置
说明
变量名称
该变量的名称,只能包含字母、数字或下划线,并且以字母或下划线开头,必填
变量描述
该变量的说明信息,非必填
数据来源
该变量的数据来源,支持“引用”“输入”两种选项。“引用”可选择前序所有节点的输出变量,“输入”可手动填入固定值,必填
变量类型
该变量的数据类型,不可选择,默认为“引用”的变量类型或“输入”的 string 类型
说明:
循环节点的输入变量中支持用户自行指定循环数组。循环节点运行时会对循环数组的元素进行循环,Input.Item 表示当前循环数组 Input 中元素内容。

循环体

表示用于循环执行的工作流,支持选择“待发布”和“已发布”两种状态的工作流。选择好工作流后,页面会自动展示该工作流的输入变量,支持用户通过变量引入方式设置每次循环时传入的变量。
方式1. 引入 循环数组 Input.Item 作为工作流的输入变量
每次运行时,会将循环数组中的新元素作为工作流的输入变量。
方式2. 引入其他变量(例如输入变量)作为工作流的输入变量
每次运行都会将相同的变量作为工作流的输入变量。

循环方式

循环节点支持“遍历全部元素”和“按条件循环”两种循环方式,您可以根据业务场景选择循环方式,其中:
遍历全部元素:表示遍历循环数组变量中的全部元素执行循环体。例如:循环数组变量中包含10篇文章,循环体工作流用于对文章进行摘要总结,那么在“遍历全部元素”模式下,循环节点会对每一篇文章进行摘要总结,最终生成10篇摘要结果。
按条件循环:表示正常运行循环体并在特定情况下退出。例如:循环数组变量包含10篇文章,循环体工作流用于对文章进行摘要总结,在循环次数为5次时或者在循环报错时退出循环体,配置示例如下图。



说明:
循环节点的 Loop 变量是该节点特有的内置变量,包含:
Loop.Index:表示当前执行循环体的次数;
Loop.Output:表示当前执行循环体后输出的结果;
Loop.ErrorCode:表示当前执行循环体的报错情况,0表示无异常,1表示异常;
Loop.Log:表示当前执行循环体的 log 日志。

输出变量

经该节点处理后的输出变量。包含循环体运行后汇总的结果 Results(数据类型为 array<object>),循环体的执行次数 LoopCount,以及运行时报错信息 Error(数据类型为 object,正常运行时该字段为空)。不支持用户手动新增。




异常处理

可手动开启异常处理,支持异常重试和异常情况的输出内容配置。配置内容如下:
配置
说明
最大重试次数
节点运行异常时重新运行的最大次数。重试超过设定次数,认为该节点调用失败,返回“异常情况的输出变量”内容,默认为3次
重试时间间隔
每次重新运行的时间间隔,默认为1秒
异常处理方式
支持“输出特定内容”和“执行异常流程”两种
异常情况的输出变量
选择异常处理方式为“输出特定内容”时,超过最大重试次数后节点返回的输出变量



选择异常处理方式为“执行异常流程”时,则节点异常重试后执行用户自定义的异常处理流程。




应用示例

根据用户输入的文章主题与风格撰写每一章节大纲,依照大纲循环调用文章生成工作流进行段落撰写。



其中循环撰写文章循环体配置如下:




常见问题

1. 如何将文本内容作为循环数组输入?
循环体节点仅支持 [obj] 类型的数组作为循环数组输入,可利用代码节点将文本内容转换为 [obj] 类型数组后引入循环体。
2. 如何设置无限循环,按条件终止?
循环体节点不支持无限循环。