Skip to content

4.9 工作流 ​

本节目标

认识工作流把多步任务编排成脚本,可自动启动子代理,一次跑完整个流程。Workflow/ˈwɜːrkfloʊ/:把多步流程编排成脚本,自动启动子代理由主智能体委派出去执行子任务的子智能体,可并行工作、结果汇总回主会话。Subagent/sʌbˈeɪdʒənt/,一次跑完一条流水线。

什么是工作流 ​

子代理由主智能体委派出去执行子任务的子智能体,可并行工作、结果汇总回主会话。Subagent/sʌbˈeɪdʒənt/解决"拆分"问题,后台任务解决"等待"问题,但都还差一层:流程的编排。

比如你有一个固定套路:拉取数据、清洗、生成报告、发布。这套流程每次都要走一遍,如果靠手发指令,一遍遍重复太累。

工作流把多步任务编排成脚本,可自动启动子代理,一次跑完整个流程。Workflow/ˈwɜːrkfloʊ/就是把这类流程写成一段编排脚本:脚本按顺序定义每一步干什么、什么时候启动子代理、子代理之间怎么衔接。agent 写好脚本后,一条命令跑完整个流水线。

工作流和普通任务的区别 ​

对比普通任务工作流
流程临时决定,边想边干脚本固化,按步执行
子代理现场拆脚本里编排,自动启动
复用每次重新来一套脚本反复跑
适合一次性任务重复性流程

一句话:普通任务是"干一次",工作流是"定个流程,以后照跑"。

怎么用工作流 ​

工作流目前是偏进阶的能力,用法上记住两点:

  1. 让 agent 用工作流执行:对重复流程,告诉 agent"把这个流程写成工作流跑一遍"。agent 会编写编排脚本并执行,脚本里的每一步(包括启动子代理)都会按顺序推进
  2. 查看运行过程:工作流跑起来后,界面上会以嵌套展开的方式展示整个运行:这次运行、每个阶段、每个子代理(member)的身份和状态,可以逐层展开看执行到哪了

用户只需要做一件事

工作流没有按钮、也没有 / 命令(和后台任务一样,它是模型侧工具)。你要做的只有一件事:用对话描述流程,说"写成工作流跑一遍"。写脚本、编排子代理、按步执行,全是 agent 的事,不用你动手。

PTC 模式下工作流默认不可用

PTC 模式为了把多步操作统一交给 Code Mode SDK 处理,默认禁用了通用的工作流工具。如果你当前会话用的是 PTC 预设,说"写成工作流跑一遍"不会触发工作流卡片;想使用工作流,请切到标准模式或自定义一个启用工作流工具的预设。

动手演示:跑一个三步工作流 ​

拿一个确定能成功的例子试试:让工作流处理本地文档,产出清单报告。

text
用工作流跑一个三步骤任务:

第 1 步:子代理扫描 docs 目录,列出所有 Markdown 文件的文件名
第 2 步:子代理统计每个文件的字数
第 3 步:汇总成一份清单报告,包含文件名和字数,按字数从多到少排序

把它写成工作流脚本执行,跑完把结果给我。

你会看到:

  • 对话里出现工作流运行卡片,以嵌套展开的方式展示三个阶段
  • 每个阶段对应一个子代理(member),显示身份和运行状态
  • 三个子代理按脚本顺序启动,第 3 步等前两步结果汇总
  • 跑完后 agent 把清单报告汇报给你

这个例子验证了工作流的核心:脚本编排 + 多子代理协作 + 自动衔接。想复用到自己的流程,把三步换成你的固定套路即可。

什么时候值得用 ​

  • 固定流程反复跑:比如每周生成一次数据报告
  • 多步骤强依赖:第 1 步的产物是第 2 步的输入
  • 涉及多个子代理协作:脚本统一编排,避免现场临时拼

学习建议

工作流是这章里最进阶的功能。初学者先做到"认识它、能用它跑现成流程"即可。想深入编排和写脚本,等基础功能都熟了再看进阶篇。

常见问题 ​

问:工作流脚本是谁写的?

模型提供智能的大模型服务,dsh 负责调度它来思考与生成。Model/ˈmɒdl/写的。你描述流程,agent 负责把它变成编排脚本并执行,不用你自己写代码。

问:想让工作流跑一遍,需要我做什么准备吗?

不用。在对话里描述流程、说"写成工作流跑一遍"就行,脚本编排和子代理启动都是 agent 的活。想固定下来反复用,把流程描述保存好,下次再发一遍即可。

问:工作流跑一半失败了怎么办?

界面会显示失败在哪一步。告诉 agent"从失败那步继续"或让它调整脚本重跑。

小结 ​

  • 工作流把多步流程写成编排脚本,可自动启动子代理,一次跑完流水线
  • 适合固定、可复用的流程;界面以嵌套展开展示每步运行
  • 初学先会"跑现成流程",脚本编排是进阶玩法

流程自动化认识了,最后一节换一种视角看会话:轨迹视图。

发现错误?提交反馈 · 欢迎 提 PR 改进本书