JeecgBoot低代码 AI工作流循环节点：批量处理与迭代控制的利器

JeecgBoot AI专题研究| JeecgBoot低代码循环节点配置与批量数据处理实战解析当工作流需要重复劳动时AI 工作流中有大量场景需要对一组数据逐条处理或者对某个操作重复执行多次。比如批量推送订单通知、逐页爬取分页接口数据、对 AI 生成结果不满意时自动重试——这些场景的共同特点是需要循环。如果没有循环能力你只能把相同的节点复制多份串联既不优雅也无法应对动态数量的数据。JeecgBoot低代码平台的循环节点正是为此而生它支持三种循环模式配合循环体内的继续和终止控制节点可以优雅地解决各类批量处理和迭代需求。循环节点能做什么在实际业务中循环节点的使用频率远比想象中高以下是四类典型场景批量数据处理拿到一个订单列表后逐条调用外部 API 完成推送、审核或转换操作固定次数重试让大模型生成内容如果结果不符合要求就重新生成最多重试 N 次轮询等待周期性检查某个异步任务是否完成完成则终止循环继续后续流程分页数据采集逐页请求分页接口将每页数据汇总后统一输出给下游节点如何添加循环节点在流程画布中点击前一节点的 图标选择循环节点即可。添加后系统会自动生成一个循环体分组——这是循环内部的工作区域你的业务逻辑节点就放在这里面。循环体与循环节点通过灰色连线固定关联不能单独删除。节点配置全解析选中循环节点后右侧面板展示全部配置项输入变量与其他节点类似循环节点的输入变量用于从上游节点接收数据。这些变量可以在循环体内被引用常见用途包括传入待遍历的数组、传入控制循环行为的参数等。变量来源同样遵循只能引用上游节点的原则。三种循环模式详解JeecgBoot低代码平台提供了三种循环类型覆盖从简单到复杂的各类迭代需求循环类型触发条件退出方式适用场景次数循环设定固定次数1~1000达到次数自动退出重试机制、固定轮次生成无限循环无上限受 1000 次保护必须通过「终止循环」节点退出轮询等待、条件触发退出迭代循环绑定数组变量遍历完所有元素后退出批量数据处理、列表遍历次数循环最为直观——设定一个循环次数到了就停。典型场景是 AI 内容生成的重试机制让大模型生成一段文案如果质量评分不达标就重新生成最多 3 次。无限循环则更加灵活但必须在循环体内放置「终止循环」节点否则流程校验不通过。它适合那些不知道要循环多少次满足条件才停的场景。所有循环类型都有 1000 次的硬性上限保护防止意外死循环拖垮系统。迭代循环是处理批量数据的首选——绑定一个数组类型变量支持string[]、number[]、object[]系统按元素顺序逐个遍历每轮循环将当前元素赋值给currentLoopItem变量循环体内的节点可以直接引用它。循环变量循环体内的数据桥梁循环节点提供两类内部变量系统固定变量自动生成无需配置currentLoopTimes当前循环次数从 1 开始计数可用于在循环体内判断已经第几轮了currentLoopItem仅在迭代循环模式下可用代表当前遍历到的数组元素自定义循环变量你可以将前置节点的输出或自定义常量加入循环变量区使其在循环体内可被引用。需要注意的是如果某个循环变量在循环结束后还需要被下游节点使用必须将其加入输出变量否则循环结束时会被自动清理。输出变量循环结束后通过输出变量可以将循环体内产生的数据传递给下游节点。目前支持选择循环变量的字段作为输出。循环体内的流程控制循环体是一个特殊的节点容器内部可以添加大部分常规节点如大模型节点、工具调用节点、条件判断节点等但不能嵌套循环节点也不能放置结束节点。此外循环体内有两个专属的流程控制节点继续循环跳过当前轮次剩余操作直接进入下一轮。类似编程中的continue终止循环立即跳出整个循环执行循环节点之后的下游节点。类似编程中的break这两个节点通常配合条件判断使用。比如在迭代循环中如果当前订单状态为已处理则跳过继续循环遇到异常数据则提前终止整个循环。配置示例示例一批量推送订单迭代循环模式——将上游查询到的订单列表object[]作为迭代数组循环体内通过 HTTP 节点逐条调用推送 APIcurrentLoopItem即为当前订单对象。示例二AI 生成内容重试次数循环模式——设置循环 3 次循环体内先调用大模型生成回复再用条件判断节点评估回复质量。如果合格则通过终止循环节点提前退出并输出结果如果不合格则继续循环让模型重新生成。实践中的避坑指南无限循环必须有出口忘记放「终止循环」节点是最常见的错误流程校验会直接拦截输出变量要提前规划循环体内产生的变量如果不加入输出变量循环结束后就会丢失。建议在设计循环前先想好循环结束后需要传递什么数据给下游注意 1000 次上限三种循环模式都有这个保护机制。如果你的数组可能超过 1000 个元素需要在上游先做分批处理循环体不可单独删除如果想删除循环体必须删除对应的循环节点两者是绑定关系性能考量循环体内如果有耗时操作如调用外部 API循环次数越多总耗时越长。建议对循环体内的操作做好超时控制总结JeecgBoot低代码平台的循环节点为 AI 工作流补全了重复执行这一关键能力。三种循环模式覆盖了固定次数、条件退出和数组遍历三大类场景配合循环体内的继续/终止控制节点开发者可以在可视化界面中实现堪比编程语言for/while循环的灵活控制力。无论是批量数据处理、AI 输出重试还是异步任务轮询循环节点都能让工作流的能力边界再上一个台阶。本文为 JeecgBoot AI 专题研究系列文章。