跳到主要内容

循环节点

用于按次数、无限或数组迭代方式重复执行循环体，并可在循环体内通过“继续 / 终止”节点控制流程走向。

一、应用场景​

  • 批量处理：遍历列表数据。
  • 定次执行：固定次数的重试、压测或重复生成任务。
  • 无限监听：在循环体中轮询接口或检查条件，结合“终止循环”节点退出。
  • 数据拆分：对分页/批量数据逐页迭代处理并汇总输出。

二、添加循环节点​

在画布中点击前一节点右侧的 ，选择循环节点完成添加。系统会自动在其下方生成一个不可单独删除的循环体分组，并用灰色连线固定关联。

三、节点配置详解​

1. 输入变量​

  • 左侧输入框填写循环内使用的变量名，右侧下拉选择来源，变量必须来自当前节点之前的节点输出，不能引用并行或后续节点。
  • 支持引用前置节点的变量，也可在循环变量区直接自定义常量；循环外不可见。

2. 循环类型​

  • 次数循环：设置循环次数（1～1000），达到次数后自动退出。
  • 无限循环：不设上限，但受强制上限 1000 次保护；需在循环体内放置终止循环节点以控制退出。

    无限循环未放终止节点时，将无法通过校验。

  • 迭代循环：选择数组类型变量作为迭代数组，支持 string[] / number[] / object[]。按元素顺序遍历，同样受 1000 次上限限制。

3. 循环变量​

  • 系统固定变量：
    • currentLoopTimes：当前已执行的循环次数（从 1 开始）。
    • currentLoopItem：仅在迭代循环时提供，表示当前迭代元素。
  • 自定义循环变量：在“循环变量”区选择前置变量或自定义值，循环体内可见；未加入“输出变量”则在循环结束后会被清理。
  • 循环体内节点可直接引用。

4. 输出变量​

  • 目前仅支持选择循环变量的字段；

5. 循环体与子节点​

  • 循环体不能单独删除；连接点：上方固定连线，左侧为循环入口，右侧为循环结束出口。
  • 循环体内可添加大部分常规节点，以及继续循环与终止循环节点，不可添加循环节点或结束节点。
  • 继续循环：立即进入下一轮循环。
  • 终止循环：立即跳出整个循环。

6. 配置示例​

  • 迭代循环：选择 订单列表 (object[]) 作为迭代数组，循环体内依次调用 HTTP 节点推送订单。
  • 次数循环：设置循环次数 3，在循环体内调用 LLM 生成回复，若回复不合法则继续循环重新生成，否则输出回复内容并结束循环。

四、注意事项​

  • 所有循环类型均受最大循环次数 1000 次保护，防止死循环。
  • 无限循环务必放置“终止循环”节点，否则无法通过校验。
  • 变量引用原则：循环体内的变量必须来自前序节点或循环变量区，不能引用并行/后续节点。
  • 需要在循环结束后使用的变量，记得加入“输出变量”，否则会被清理。
  • 循环体不可独立删除，删除任意循环节点会一并移除对应循环体。