用途:本技能整理 TriggerFlow 中常见的业务流程编排模式,帮助把可复用的工作流形状落地,包括路由与先分类再路由、扇出与扇入、逐项 worker、带停止条件与循环预算的安全循环、评估-优化(maker-checker)循环、ReAct 式工具循环,以及人工审批门或轮次间暂停等业务级模式。
主要能力:提供 batch(...)、for_each(...)、collect(...)、side_branch(...) 等模式工具的用法思路;给出模式选择规则,例如单请求分类后走单一分支用 router,一个输入需并行分发再汇合用 fan-out/fan-in,列表逐项处理且需限制并发用 for_each(...),旁路观察或记录用 side_branch(...),重复轮次需明确停止条件用安全循环,草稿需反复评判修订用 evaluator-optimizer,推理-行动-观察交替用 ReAct 或工具循环,需在审批检查点停下用人工门模式。
使用方式:按工作流形态查阅对应参考文件——分支、分发或聚合先看 references/router-and-fanout.md;重复轮次、有界重试或防死循环看 references/loops-and-control.md;生成/评估交替或 think/act/observe 循环看 references/evaluator-optimizer-and-react.md;人工门、审批检查点或轮次间暂停看 references/human-gates.md;行为异常时看 references/troubleshooting.md。设计上保持 async-first,优先异步处理器与异步入口,使用显式事件、循环预算和有界并发,避免隐式递归或无界任务派生。
适用场景:需要把业务工作流组织成可重复形状并明确失败模式的场合。
限制:本技能不替代底层技能,不处理 chunk、to(...)、when(...)、if_condition(...)、match(...) 等独立 API 问题,不处理状态放置、子流边界、显式中断机制、模型请求实现、流配置或执行状态恢复;涉及具体中断处理应转向 agently-triggerflow-interrupts-and-stream,涉及模型请求转向 agently-triggerflow-model-integration,涉及状态放置转向 agently-triggerflow-state-and-resources。循环必须有停止条件与轮次预算,审批门应放在敏感副作用之前,长等待或审批应做状态检查点而非重放整个工作流,ReAct 或评估循环不应从原始模型输出派生无界新任务。前置条件为 Agently >= 4.0.8.5。