bb Workflows 实战：把任务扇出到多个 Agent 线程的并行编排指南

bb Workflows 实战把任务扇出到多个 Agent 线程的并行编排指南【免费下载链接】bbThe agent IDE that builds itself项目地址: https://gitcode.com/gh_mirrors/bb14/bbbb Workflows 是 bbThe agent IDE that builds itself内置的多 Agent 并行编排插件你用一段 JavaScript 脚本描述控制流它就能把任务扇出fan-out到多个并行的 Agent 线程worker threads自动汇总结构化结果。脚本在 QuickJS 沙箱中运行没有文件、网络、Shell 权限——真正的干活由普通 BB 线程完成。适合审查、研究、批量验证等一个 Agent 做不过来的场景。 Workflows 是什么一个插件、三个界面Workflows 是一个按需启用的内置插件builtin:workflows全新安装的 BB 中默认关闭。启用后你每次运行一个工作流都会得到一个持久化的 run IDwfr_…并在三个地方看到它的进度界面位置能看到什么实时运行卡片聊天流内运行状态、声明的阶段phases、活跃 worker、已用时间状态卡片线程输入框上方当前线程所有活跃 run、各阶段进度可就地停止Workflow run 面板线程右侧面板每个阶段、每次 agent 调用worker 可直接跳转对应线程运行结束后结果会以agent-only输入送回发起线程不打扰用户时间线。 五分钟上手最小工作流每个工作流脚本都是JavaScript不是 TypeScript且必须以一个纯字面量meta对象开头。下面是一个两阶段的最小示例——先审查、再验证export const meta { name: review-change, description: Review a change and verify the findings, phases: [{ title: Review }, { title: Verify }], }; const results await pipeline( args.items, (item) agent(Review item, { phase: Review }), (review, item) agent(Verify this review: review, { phase: Verify }), ); return results;三个要点meta必须是纯字面量name小写 kebab-case、description必填可选phases有序、标题唯一。args是入口参数以真实 JSON 值传入不要传 JSON 字符串用来参数化你的工作流。沙箱限制脚本内没有文件系统、Shell、网络、import、时钟、随机数这些会破坏断点续跑用args传入时间戳即可。官方文档README.md、PLUGIN_OVERVIEW.md 两大原语pipeline 与 parallelWorkflows 的编排能力来自两个核心函数定义见 src/types.ts 的WorkflowCapabilitiespipeline()—— 多阶段任务的默认选择每个 item独立地流过所有阶段阶段之间没有屏障item A 可以已经在第 3 阶段而 item B 还在第 1 阶段。总耗时 最慢的单条链路而不是每阶段最慢者之和。parallel()—— 需要全部结果时才用的屏障parallel()会等待所有任务返回是一个屏障barrier。只有在下一阶段确实需要上一阶段的全部结果时才使用例如跨全部结果去重/合并后再做昂贵的下游处理结果为空就提前退出0 个 bug → 跳过验证下一阶段提示词需要引用其他发现做对比。官方给了一个实用的异味测试如果你写的是parallel → 纯转换 → parallel中间转换不依赖跨 item 上下文就应该改写进 pipeline 的一个阶段里。拿不准时就用 pipeline。详见 orchestration.md。 扇出到多个 Agentagent() 的用法agent(prompt, opts?)是工作流向外部借算力的唯一方式——它启动一个普通 BB worker 线程保留其正常的工具与权限worker 线程对侧边栏隐藏不产生未读提醒。常用选项phase/label把调用归入进度分组、自定义显示名。在pipeline()/parallel()内部请显式传phase避免全局phase()状态的竞态。schemaJSON Schema。带上它worker 就必须通过bb_workflow_result工具提交校验过的结构化值agent()直接返回该值无需你自己解析最多两次纠正重试。provider/model/reasoningLevel覆盖模型选择三者必须同时提供部分覆盖会被拒绝且会被立即对照在线 provider 目录校验。结构化输出的完整写法见 authoring.md 第 125–165 行。✂️ 进阶编排子工作流与预算子工作流workflow(nameOrRef, args)可内联调用另一个工作流按.bb/workflows/name.js解析或内联脚本父/子共享同一 FIFO agent 调度器、调用预算、取消信号只允许一层嵌套子工作流里再调用会抛错。预算budget()返回本次 run 不可变的 agent 调用上限与并发上限可用于脚本内自我节制。并发旋钮插件设置maxActiveRuns全局同时运行的 run 数、maxConcurrentAgents单 run 内并行 agent 数、maxAgentCalls总调用预算、totalRunTimeoutMs、retentionDays。 断点续跑resume 机制这是 Workflows 对新手最友好的确定性卖点run 的每次 agent 调用都会持久化存于插件自己的 SQLite 库。中断、重启甚至修改脚本后用--resume run-id重新启动时已成功调用的最长不变前缀直接返回缓存结果第一个被修改/新增/失败的调用起其后全部实时重跑并行调用也按确定性顺序获得缓存身份所以并发不会破坏回放瞬态的 provider 故障限流、5xx、网络会自动重试两次带退避认证/配置/Schema 类确定性错误不重试。相关规则见 runs.md 与 runtime.ts 的实现。 命令行速查所有命令都在 BB 项目线程内执行输出统一为 JSONbb workflows validate --file .bb/workflows/review.js # 先校验 bb workflows run --file .bb/workflows/review.js --args {items:[]} bb workflows status run-id # 紧凑进度 bb workflows history run-id --cursor 0 --limit 100 # 分页明细 bb workflows list --limit 20 # 运行列表 bb workflows stop run-id # 停止小贴士history输出可能包含完整提示词与结果建议重定向到$BB_THREAD_STORAGE下的 JSONL 文件再查看而不是直接打进会话记录完整流程见 README.md 第 193–216 行。✅ 收尾清单在把脚本交给bb workflows run之前照这张清单自检一遍源自 SKILL.md 的 Quality check 小节用户确实需要多 Agent 编排普通任务不要用工作流bb workflows validate通过显式指定的 provider/model 三元组都存在于在线目录脚本里的phase()标题与meta.phases完全一致独立 item 用 pipeline没有多余的屏障有截断top-N、采样时log()说明了丢弃了什么下游消费方拿到的是 Schema 校验过的结构化结果。现在你就可以在.bb/workflows/下写下第一个脚本体验把一件大事拆给一队 Agent 并行干活的乐趣了。【免费下载链接】bbThe agent IDE that builds itself项目地址: https://gitcode.com/gh_mirrors/bb14/bb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考