[智能体-457]：Coze（扣子）循环节点完整详解

一、核心定位对应架构图里「传统的串行循环CPU 循环」是串行单线程遍历组件用于逐条处理数组 / 列表变量和「批处理并行并发」形成互补二者底层执行模型完全不同。二、底层运行逻辑输入数据源接收上游输出的数组 / 列表变量如知识库检索多条结果、数据库批量查询数据、批量上传文件列表串行执行严格按数组顺序逐条执行循环内部子流程上一条执行完成才会启动下一条变量透传循环内部可单独读取当前遍历项、下标、原始数组、循环累计输出结果收集循环结束后自动汇总每一轮子流程输出生成新数组传递给下游「变量聚合 / 输出」节点。三、核心特性串行专属优势强顺序保障数据处理有序有前后依赖的业务必须用循环不能用批处理 例逐条生成文案后按顺序拼接、按表单顺序逐条写入数据库、按对话时序处理历史消息。资源占用可控单线程执行不会瞬间并发大量 API 请求规避第三方接口限流、额度超限。支持轮内中断 / 分支循环内部可嵌套 IF 选择器满足条件跳过 / 终止循环。短板大批量数据效率低100 条数据串行执行会依次排队总耗时 单条耗时 × 条数无法并发提速没有多线程并行能力海量数据处理性能远弱于批处理。四、与批处理并行并发核心对比表格维度循环串行批处理并行并发执行方式单条依次执行串行阻塞多任务同时并发多线程执行顺序严格遵循数组下标顺序执行完成顺序随机不保证入参顺序适用场景数据有前后依赖、有序输出、接口限流严格无依赖大批量任务、批量生成图片 / 视频、批量入库耗时表现条数越多耗时线性叠加并发控制后总耗时接近单条任务耗时限流风险极低请求间隔可控高并发数过高易触发第三方 API 限流五、典型落地场景有序文本拼接知识库检索多条参考片段循环逐条润色后按检索顺序拼接成完整上下文送入大模型。有序数据入库读取 Excel 多行表单数据按行顺序逐条新增至数据库保证数据表记录顺序和原文件一致。多轮对话逐条处理读取上行文历史对话数组逐条提取关键信息做摘要维持对话时序逻辑。带依赖的多级生成先循环生成文案再基于本条文案生成配套图片单条未完成不能进入下一条。六、配套联动节点结合架构图流程上游数据源数据库查询、知识库检索、代码节点生成数组、输入节点传入列表循环内部可嵌套大模型、插件、IF 选择器、代码、数据库单条操作下游汇总循环输出数组 → 变量聚合节点统一封装再传递给输出 / 大模型异步搭配超长循环可外层嵌套「异步任务」后台执行不阻塞用户主流程。七、使用注意事项上万条海量数据不要使用循环优先批处理并行加速若业务无顺序要求一律选用批处理提升效率循环内部尽量减少高耗时插件视频生成、联网搜索避免整体流程超时可在循环内搭配 IF 选择器做过滤过滤无效条目减少无意义执行。八、和传统代码映射关系Coze 循环节点 编程语言中for / while串行循环python运行# 对应Coze循环执行逻辑 data_list [item1, item2, item3] result [] for item in data_list: # 逐条串行执行 res run_sub_flow(item) # 循环内子流程 result.append(res) # 循环结束输出result数组而批处理对应ThreadPoolExecutor线程池并发执行。