AI平台说明文档

Appearance

任务循环节点 ​

定义 ​

任务循环节点对数组中的元素依次执行相同的操作步骤，直至处理完所有元素并输出结果。可以理解为工作流中的任务批处理器，通常配合数组变量使用。

任务循环1

功能简介 ​

任务循环节点接收一个数组作为输入，将数组中的每个元素逐一传入内部子流程执行，最终将所有执行结果汇总为新的数组输出给下游节点。

概念说明
循环输入需要遍历的数组变量，每次循环取出其中一个元素
循环变量当前循环轮次中的单个元素，可在子流程内的节点中引用
循环输出每轮子流程执行完毕后的返回值，所有轮次结果汇总为数组

子流程内可以嵌套任意节点（如模型节点、代码节点、HTTP 请求节点等），每轮循环均独立执行，互不影响。

典型场景 ​

场景一：长文批量翻译 ​

将长篇文章直接输入 LLM 节点，容易触达单次对话的 Token 上限。可先通过文档拆分节点将长文切割为多个片段数组，再由任务循环节点对每个片段逐一调用模型翻译，最终将所有译文片段汇总输出，从而绕过单次消息长度限制。

文档拆分节点 → 任务循环节点
                └─ 模型节点（翻译单个片段）
             → 整合输出节点

场景二：批量数据处理 ​

对从数据库或 API 获取的记录列表，逐条执行格式转换、字段提取或校验逻辑，将处理结果收集为新数组供后续节点使用。

场景三：多轮内容生成 ​

对一组关键词或主题列表，依次调用模型节点生成对应的摘要、标题或描述，批量产出结构化内容。

高级功能 ​

并行执行 ​

默认情况下，任务循环按顺序逐一处理数组元素。开启并行模式后，多个元素可同时进入子流程执行，显著提升批处理效率。

并行模式下的最高并行轮数为 10，这意味着单位时间内最多可以同时运行 10 个任务。如果需要处理超过 10 个任务，前 10 个元素将率先同时运行，前排任务处理完成后将继续处理剩余任务。

并行模式

并行模式适用于各轮循环之间无数据依赖的场景。若子流程内存在顺序依赖，请保持串行执行。

错误响应方法 ​

任务循环节点通常需要处理大量任务，有时会在处理某个元素时发生错误。为了避免某个元素异常而中断所有任务，你可以在错误响应方法中设置异常的应对方法：

  • 错误时终止：错误时终止。如果发现异常输出，终止循环节点，输出错误信息。
  • 忽略错误并继续：忽略异常信息，继续处理剩余元素。输出的信息中包含正确信息，异常信息为空值。
  • 移除错误输出：忽略异常信息，继续处理剩余元素。输出的信息中仅包含正确信息。

任务循环节点的输入变量与输出变量相对应。例如输入变量为 [1,2,3] ，则输出变量同样为 [result-1, result-2, result-3]。

如果选择了忽略错误并继续， 异常情况的输出值为 null 值，例如 [result-1, null, result-3]；

如果选择了移除错误输出， 将不会输出异常变量，例如 [result-1, result-3]。

错误响应方法