产品动态
产品公告
循环节点
节点功能
循环支持重复执行一系列任务，直到满足条件为止。循环节点属于基础节点，支持用户通过配置输入变量、循环体（工作流）和循环方式，循环执行特定的工作流。
操作说明
输入变量
输入变量仅在该节点内部生效，不能跨节点使用。支持最多添加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 | 动态变量，内部字段名为被引用的子工作流的输出变量。Results 返回循环体的全部执行结果，类型为array<object> |
LoopCount | 循环体的执行次数，类型为int |
Error | 运行时的报错信息，正常运行时该字段为空，类型为 object |
可手动开启异常处理（异常处理默认关闭），支持异常重试和异常处理方式的配置。配置内容如下：
配置 | 说明 |
最大重试次数 | 节点运行异常时重新运行的最大次数。重试超过设定次数，认为该节点调用失败，执行下方的异常处理方式，默认为3次 |
重试时间间隔 | 每次重新运行的时间间隔，默认为1秒 |
异常处理方式 | 支持“输出特定内容”、“执行异常流程”和“中断流程”三种 |
异常情况的输出变量 | 选择异常处理方式为“输出特定内容”时，超过最大重试次数后节点返回的输出变量 |
选择异常处理方式为“输出特定内容”时，发生异常后工作流不会中断，节点异常重试后直接返回用户在输出内容中设置的输出变量及变量值；
选择异常处理方式为“执行异常流程”时，发生异常后工作流不会中断，节点异常重试后执行用户自定义的异常处理流程；
选择异常处理方式为“中断流程”时，没有更多设置项，发生异常后工作流执行中断。
使用场景建议
循环节点将在以下任务场景中发挥重要作用：
任务间存在依赖关系
前序任务的输出结果将直接影响后续任务的执行过程，例如：依照文章大纲的章节顺序逐段撰写内容。
依据结果控制循环流程
根据单次或多次任务的执行结果决定是否提前结束循环，例如：逐条处理用户反馈，并在达到特定条件时终止任务。
严格串行执行的任务流
适用于流程步骤必须按固定顺序执行的场景，例如：固定流程的流式数据处理。
应用示例
根据用户输入的文章主题与风格撰写每一章节大纲，依照大纲循环调用文章生成工作流进行段落撰写。
其中循环撰写文章循环体配置如下：
常见问题
1. 如何将文本内容作为循环数组输入？
循环体节点仅支持[obj]类型的数组作为循环数组输入，可利用代码节点将文本内容转换为[obj]类型数组后引入循环体。
2. 如何设置无限循环，按条件终止？
循环体节点不支持无限循环。
文档反馈