最后核验：2026-10-23
先看结论
- OpenAI 在 2026-06-03 通知开发者，Agent Builder 已弃用，计划于 2026-11-30 关闭；同一公告说明 ChatKit 继续可用。
- 官方提供两条迁移路径：继续用 Agents SDK 写代码，或在 ChatGPT 里创建 Workspace Agent。两条路径都从“导出 Agents SDK 代码”开始。
- 导出不会转换工作流图，也不保证每个行为原样迁移，迁移后必须用代表性输入重新测试。
- 官方文档没有说明 2026-11-30 之后是否还能导出。稳妥做法是在关闭前完成导出并保存代码。
这份指南适用于已经在 Agent Builder 中搭建了工作流、需要在关闭前迁出的开发者与团队。文中“编者判断”与“编者建议”是本站的解读，其余事实均来自文末列出的官方页面。
关键日期
| 日期 | 事件 | 来源 |
|---|---|---|
| 2026-06-03 | 官方宣布 Agent Builder 弃用，ChatKit 保留 | Deprecations |
| 2026-10-31 | Evals 平台中现有 evals 变为只读（与 Agent Builder 同期弃用，需另行迁移） | Deprecations |
| 2026-11-30 | Agent Builder 计划关闭；Evals 控制台与 API、v1/prompts 同日计划关闭 | Deprecations |
先选路径：Agents SDK 还是 Workspace Agent
| 对比项 | 继续用 Agents SDK | 创建 ChatGPT Workspace Agent |
|---|---|---|
| 官方定位 | 适合用代码构建智能体 | 适合用自然语言构建智能体并在团队内共享 |
| 前提 | 你自己的应用、运行环境与部署流程 | ChatGPT Business、Enterprise 或 Edu 工作区，且有权访问 workspace agents 并有创建权限 |
| 迁移动作 | 把导出的 TypeScript 或 Python 代码放进应用，安装并配置对应的 Agents SDK，在你的运行时中测试 | 在 ChatGPT 创建 workspace agent，把导出代码与固定提示词粘贴进对话，让构建器转换 |
| 需要你自己验证 | 运行时配置、工具、认证、权限与部署 | 已连接的应用、认证、发布与权限配置，需在 ChatGPT 中单独审核 |
| 官方点名的风险 | 官方提示导出不保证行为不变 | 以强确定性为核心的工作流可能无法如实迁移 |
编者判断：如果你的工作流依赖明确的分支、重试与固定顺序（强确定性），官方已经提示它们迁到 workspace agent 时可能走样，优先考虑 Agents SDK；如果它更像“按说明办事、需要团队共享”的助手，且你已经有 Business、Enterprise 或 Edu 工作区，再评估 workspace agent。这只是依据官方限制条目做的取舍建议，不是官方结论。
第一步：导出工作流
官方给出的导出步骤：
- 在 Agent Builder 中打开要迁移的工作流（你需要有该工作流的访问权限）。
- 点击顶部导航里的 Code。
- 在代码弹窗中选择 Agents SDK。
- 选择 TypeScript 或 Python，复制完整导出内容。
编者建议：导出后立即把代码提交到你自己的版本库，并保留原工作流的截图或描述，作为之后对比行为的基准。
路径一：继续使用 Agents SDK
把导出的代码放进你的应用，安装并配置对应语言的 Agents SDK，再在自己的运行时中测试。官方文档入口：
部署之前要验证应用自己的配置与行为。如果界面里还嵌了聊天窗口，ChatKit 仍然可用。
路径二：用导出代码创建 Workspace Agent
在 ChatGPT 中创建 workspace agent，并把导出的代码与下面的提示词一起粘贴进对话（提示词取自官方迁移文档）：
Please help me convert this workflow into an agent:
<paste your exported code here>
构建器若指出某些行为需要调整，先处理再继续。创建之前，官方要求你：
- 检查生成的指令与已配置的能力。
- 配置所需的应用、工具、技能、认证与连接权限。
- 点击 Preview，用原工作流的代表性输入测试。
- 把预览行为与原工作流应有的行为对比。
- 验证通过后再点击 Create。
迁移前检查清单
下面前四项来自官方迁移文档，后三项是编者建议：
- 控制流：分支、循环、重试是否在新环境里仍然成立。
- 触发器：原工作流怎么被调用，新环境里由谁触发。
- 工具：每个工具是否已在新环境中配置并可用。
- 权限与认证：涉及私有数据或可执行动作的智能体，沿用原有的安全做法。
- （编者建议）准备 5～10 个覆盖主要路径与失败场景的测试输入，迁移前后各跑一遍并保存输出。
- （编者建议）列出依赖 Agent Builder 才有的能力，逐项确认在新环境中的替代方案。
- （编者建议）给迁移定一个早于 2026-11-30 的内部截止日期，为回退留出时间。
已知限制
官方在迁移文档中列出的限制：
- 以强确定性为核心的工作流，迁移为 workspace agent 后可能无法如实还原。
- 已连接的应用、认证、发布与权限配置，需要在 ChatGPT 中另行审核。
- 采用 Agents SDK 时，应用的运行时配置、工具、认证、权限与部署都需要你自己验证。
同期弃用的相关功能
Agent Builder 并不是唯一在 2026-11-30 前后收尾的功能：
- Evals 平台：2026-10-31 现有 evals 只读，2026-11-30 控制台与 API 计划关闭，官方给出的迁移参考是 Moving from OpenAI Evals to Promptfoo。
- 可复用提示词（
v1/prompts）：2026-11-30 计划关闭，迁移方法是把提示词内容移入应用代码，见 Migrate from prompt objects。
完整日期汇总见 OpenAI 产品与模型停用时间表；AgentKit 发布时的功能解析与现状更正见 AgentKit 解析。
常见问题
迁移后行为会和原来一致吗？ 不保证。官方明确说明导出不会转换工作流图，也不保证所有行为原样迁移，需要自行测试。
ChatKit 还能继续用吗？ 可以。官方在弃用公告中说明 ChatKit 保持可用。
2026-11-30 之后还能导出工作流吗？ 官方文档没有给出说明。建议在关闭日期前完成导出并自行保存。
我没有 Business、Enterprise 或 Edu 工作区，能用 Workspace Agent 吗？ 按官方迁移文档，路径二需要这些工作区之一，并且有权访问 workspace agents 与创建权限；否则请使用 Agents SDK 路径。
官方来源
以下页面均于 2026-10-23 核验：
- Migrate from Agent Builder：导出步骤、两条路径、限制
- Deprecations：Agent Builder、Evals、
v1/prompts的日期 - Agents SDK 文档
- ChatKit 文档
官方页面可能随时更新，执行迁移前请再次对照原文。
