文档

内置工具›代理编排

工作流

workflow
分组
代理编排
开启方式
对话设置「工具」页里它自己的开关。
审批
需审查:写入和无边界的操作要你批准,除非安全级别或之前的「总是允许」已经覆盖。
档案键
tool.workflow.description

运行一段由模型编写的脚本,按固定的结构把工作分给多个子代理,整体作为一个后台任务。

运行在任务面板里显示,每个步骤一块。脚本的写法见子代理与工作流。

什么时候询问你

在手动和允许编辑下,每次运行开始前都会询问一次,卡片提供总是允许。

限制

  • 一次运行限时 30 分钟,从它开始运行时算起,而不是从审批卡片出现时算起。步骤没有单步超时,Mework 也从不因为步骤长时间没有动静就结束它:私下推理的模型可能好几分钟什么都不发出。

值得知道

  • 设了 isolation: "worktree" 的步骤在工作区所在的机器上拿到自己的 Git 工作树。留有改动或提交的工作树会保留,由你合并。
  • 运行面板里的跳过 {label} 结束正在运行的步骤,agent() 得到 null;重试 {label} 让这一步从头重新开始,脚本拿到的是新一次的结果。只要运行还在进行,两者就一直可用。
  • Mework 在运行途中退出或崩溃时,下次启动后运行立即接着进行,不必等你打开这段对话,已完成的步骤直接沿用。

参数

参数类型说明
name 必填
名称
string必填。这次运行在会话代理命名空间里的地址,也是任务栏里这一行的标题;小写字母开头,可含数字、_ 和 -;整个对话分支树内不可重名,续跑也要换新名字
args
输入参数
any原样暴露给脚本的 JSON 值(全局 args);数组与对象直接传,不要编码成字符串
resume_run_id
续跑运行 ID
string上一次运行报出的运行 ID;提示词与选项没变的步骤即时重放,上次停下时还在跑的步骤单独重跑,从第一个改动或失败的步骤起其余全部重跑。可省略脚本与 args 沿用上次的;传入改过的脚本会重新审批
script
编排脚本
string以 export const meta = {…} 开头的 JS 编排脚本:用 agent()/parallel()/pipeline()/phase()/log() 派生并组织步骤子代理,正文的 return 值就是运行结果。给某一步加 { isolation: "worktree" } 会为它单开一棵从 HEAD 检出的 git 工作树(看不到未提交改动;留下改动就保留,没改动就自动拆除)
token_budget
token 预算
integer本次运行允许消耗的 token 硬顶,脚本经 budget 读到;耗尽后新的 agent() 调用抛错

在 GitHub 上编辑本页