循环数组节点

【循环数组】节点用于对数组变量中的每个元素依次执行相同的一组步骤，直到为所有元素都产出结果。
它本质上是一个“批处理器”：当上游输出为数组（如分段文本、文件列表、检索结果集等）时，可将每一项送入同一套子流程中逐个处理，最后统一输出结果数组。

何时使用

循环数组节点由三个核心单元组成：

输入变量
- 仅接受 Array 类型（如 Array[string]、Array[object]、Array[file]）。
- 若当前数据不是数组，请先使用“代码执行节点/参数提取节点/知识检索节点”等产出数组。
循环子流程
- 在节点内部编排一段“针对单个元素”的处理链路（可包含 LLM、模板转换、文档提取、HTTP 请求、代码执行等节点）。
- 系统会为数组中的每个元素按相同流程运行一遍。
输出变量
- 固定输出为一个数组，类型取决于子流程的产出（如 Array[string] / Array[object] 等）。
- 若需要得到字符串，请参见下文“将数组转换为文本”。

在循环数组节点内部，可直接使用以下内置变量（名称可能在可视化界面展示为更友好的别名）：

建议

典型用法：将 items 作为 LLM/模板输入，或用 index 为输出打标签/排序。

准备数组输入
- 在「开始」节点获取长文本；
- 使用「代码执行」节点将长文切片为 Array[string]。
添加循环数组节点
- 选择 sections 作为“输入变量”；
- 在循环子流程内放入 LLM 节点，对 items 执行翻译；
- 可选：在子流程末尾加“直接回复节点”做流式中间输出（顺序模式下更稳妥，见并行说明）。
产出结果
- 循环数组节点输出 Array[string]（每个元素是对应片段的翻译结果）。
- 如需合并，请见“将数组转换为文本”。

开启并行可显著提升整体处理速度：

注意

针对单个元素处理失败时的行为，可在“错误响应方法”中选择：

错误时终止：一旦其中一个元素出错，立刻终止并返回错误。
忽略错误并继续：错误元素在输出中以 null 占位，其他元素正常产出。
- 例如输入 [1,2,3] → 输出 [result-1, null, result-3]
移除错误输出：错误元素直接从结果中剔除，仅返回成功项。
- 例如输入 [1,2,3] → 输出 [result-1, result-3]

选择策略时请考虑下游对结果长度的假设：
需要与输入一一对应：选择“忽略错误并继续”；
允许条目数减少：选择“移除错误输出”。

循环数组的输出通常是 Array[string]，若需要合并为一个字符串，可选择以下方式：

def main(articleSections: list) -> dict:
    return {"result": "\n".join(articleSections)}

{{ articleSections | join("\n") }}

注意

若数组元素为对象，请先在模板/代码中选取并拼接需要的字段。

循环数组节点让你用“一套流程”批量处理“多条数据”。通过顺序/并行、错误策略与结构化输出的合理搭配。你可以在 AI Center 中构建高效、稳健、可扩展的批处理流水线：从长文分段翻译，到检索命中重写，再到批量文件解析与外部接口编排，都能优雅完成。