EN
Uncategorized

Agent Builder 要停了:可视化工作流该怎么迁移

OpenAI 已公布 Agent Builder 的关闭日期。对已经依赖可视化工作流的团队来说,现在最重要的是把流程、数据和验收标准变成可审查的代码。

Jacky Wang 3 分钟阅读 103 阅读

我最近整理一套 Agent 工作流时,最怕的不是模型换代,而是一个看起来能跑的画布突然没有出口。OpenAI 文档现在写得很明确:Agent Builder 计划在 2026 年 11 月 30 日停止服务,现有用户可以在过渡期继续使用;ChatKit 仍然可用,官方建议需要继续运行的工作流改用 Agents SDK。

这不是“可视化工具不好”的结论。画布很适合把第一条链路搭出来:输入、几个工具调用、一个人工确认,再接到输出。问题在于,长期运行的系统需要知道每个节点的输入输出、失败后从哪里重试,以及谁有权批准副作用。拖拽出来的流程如果没有对应的版本文件,迁移时就会变成考古。

先把画布变成一张清单

我会先逐节点记录四件事:输入 schema、工具权限、可重试错误、人工介入点。别只截图。截图不能告诉我一个字段是字符串还是枚举,也不能告诉我重复执行会不会创建两张发票。

一个最小的迁移表可以长这样:

node: fetch_order
input: { order_id: string }
side_effect: none
retry: timeout, 429
approval: no

我还会为每个节点补一条失败路径:错误是否可以安全重试,重试前要不要重新读取状态,失败产物由谁查看。对有副作用的节点,表里再加上幂等键和回滚方式。例如发送通知前先写入发送意图,执行器看到同一个请求 ID 时只允许继续未完成的动作。这样迁移验收就不只是“新流程能跑”,而是能说明它在超时和重复提交时会做什么。

然后把每个节点改成有名字的函数或 agent。OpenAI 的 Agents API 文档把 agent 描述为指令、工具、状态和编排的组合,这个拆分对迁移很有用。它迫使团队把“模型自己应该知道”的隐含规则写出来。

把运行方式和产品界面分开

如果工作流最终嵌在网站里,ChatKit 可以继续承担交互层;执行逻辑则放在 SDK 或你自己的服务里。这样,换 UI 不会顺手改变权限。对我这种把服务放进 Kubernetes 的团队,执行器还应该有独立日志、请求 ID 和超时边界,而不是让一次网页请求一直挂着。

迁移时我会保留一组固定输入,逐个比较旧流程和新流程:正常请求、缺字段、上游 429、工具返回格式变化、用户拒绝授权。比较的不只是最终文字,还包括工具调用顺序和副作用次数。一个看起来更聪明的答案,如果多发了一次邮件,仍然是失败。

日期不是最后期限,而是测试期限

11 月 30 日之前真正要完成的不是“把节点重新拖一遍”,而是确认系统在没有原画布的情况下仍能部署、回滚和审计。官方迁移说明建议继续使用的场景转向 Agents SDK,我会把这件事当成一次依赖边界清理:工作流定义进 git,密钥进 secret,验收样例进测试。

我不认为可视化编排会消失。它会更像原型和沟通工具。生产系统最后还是要回到能 review 的文件、能复现的输入和明确的授权。对今天还在 Agent Builder 里的流程,我会从最有副作用的那个节点开始迁移,别等到倒计时最后一周。

发表评论