ChatKit 后端如何迁移？OpenAI AgentKit 停用时间与迁移清单

OpenAI AgentKit 曾是 OpenAI 用于构建、部署和评估智能体的一组工具，其中 Agent Builder 服务定于 2026 年 11 月 30 日关闭。Agents SDK 和 ChatKit 仍可继续使用，但依赖 Agent Builder 后端的 ChatKit 应用需要自行搭建替代后端。现有评测将于 10 月 31 日先转为只读；随后，Evals 控制台及 API，以及用于管理可复用提示词对象的 v1/prompts API，都定于 11 月 30 日关闭。

本文已于 2026 年 10 月 14 日对照 OpenAI 当时的在线文档核实。 迁移时真正要保住的，是工作流、提示词，以及证明它们仍能正常工作的测试。应将这三项分别列为迁移任务，并明确各自的负责人。OpenAI 停用时间表给出了日期，下文则将这些日期落实为可交付的项目节点。

OpenAI AgentKit 哪些要停用，哪些还能继续用？

即将关闭的是托管式构建服务，OpenAI 的智能体开发工具体系仍将延续。 AgentKit 集成了构建、部署和评估智能体的工具：OpenAI Agent Builder 提供可视化工作流编辑器，ChatKit 提供嵌入式聊天界面，Evals 提供测试环境。制定迁移方案时，需要分别处理这些组件。

可以把它想成一间配好设施的工作室：房间提供编辑和运行环境，工作流则规定要完成什么工作。房间不能用了，就要换个地方继续运行，但不意味着所有工具都要丢掉，也不意味着必须更换模型提供商。

上述停用日期来自 OpenAI 停用公告页；仍可使用的运行时选项见智能体概览。这些公告发布于 2026 年 6 月 3 日。10 月转为只读与 11 月正式关闭，是两个不同的节点。

这次公告并未宣布停用 Responses API。 但如果 Responses 应用的请求引用了可复用提示词对象，它仍可能受到影响。调用的接口与接口所依赖的已保存资源，需要分开看。

哪些团队现在就该开始迁移？

只要线上工作流依赖 Agent Builder、托管式 Evals 或已保存的提示词对象，就应立即行动。 迁往哪里，取决于工作流应该运行在哪里，而不是哪个产品的名字听起来最接近。

开发面向客户的应用： 导出工作流，并明确谁负责它的运行环境。如果客服聊天机器人必须嵌在你的产品里，那么托管工作流关闭后，就需要有一个可正常运行的应用服务接手。仅迁移可视化界面，解决不了关键依赖。

运营内部业务流程： 如果任务可以放在公司的 ChatGPT 工作空间里完成，可以考虑 ChatGPT Workspace Agents。定期生成客户简报、提供内部研究辅助，比接入公开网站更适合这条路径。输出质量由业务流程负责人判断，访问权限由工作空间管理员审核。

准备采购或立项： 现在就选择会继续提供的方案。如果供应商的方案基于 Agent Builder，应在批准实施前明确：关闭后使用什么运行环境、迁移交付物是什么、按什么标准验收。过渡期里能跑通的演示，回答不了这些问题。

已经使用 SDK 或直接调用 Responses 的团队： 可能根本不需要迁移 Builder。但在认定应用不受影响前，仍要检查评测流水线和已保存提示词的引用。如果这些依赖也不存在，就没有必要仅因这次公告而重写应用。

如何将 Agent Builder 工作流导出到 Agents SDK

OpenAI Agent Builder 可以导出工作流代码，作为搭建自有应用的起点。 当前迁移指南提供 Python 和 TypeScript 两种导出方式。修改前先保存完整导出文件，便于之后将改动与原始代码对照。具体步骤见迁移说明。

1. 1

   复制完整的工作流导出代码

   打开工作流，在顶部导航中选择 Code，再选择 Agents SDK，然后选择 Python 或 TypeScript。将全部导出代码复制到代码仓库，并记录它要替换的是哪个已部署工作流。

2. 2

   让应用真正运行起来

   按照对应 SDK 的当前快速入门文档完成安装和配置，接入工作流需要的工具与凭据。明确部署、存储和运行维护的负责人后，才能将这份导出代码视为替代服务。

3. 3

   验证业务行为是否符合要求

   用有代表性的输入回放测试替代实现，检查分支选择、工具参数、审批行为和最终结果。只有满足原工作流的验收标准后，才能部署上线。

OpenAI Agents SDK负责运行智能体循环，同时让应用自行掌控部署、存储、工具和审批。 后续实现可继续参考 SDK 概览。

选择 SDK 的门槛在于，运维责任也随之落在自己身上。复制一个文件，并不会自动解决生产部署、重启行为或状态持久化。以客服工作流为例，需要明确订单查询超时、审批被拒绝、同一请求重复到达时分别如何处理。这些都是需要实现并验证的验收场景，导出按钮不会替你保证。

如果还在重新评估运行环境该由谁负责，可以参考 OpenAI Agents API 与 Agents SDK 对比。OpenAI 当前的 Builder 迁移指南列出的目标是 SDK 和 Workspace Agents；不能据此认定另行提供的托管式 Agents API 可以自动导入工作流。

将无代码内部流程迁至 ChatGPT Workspace Agents

对于团队内部共享、以自然语言定义的工作流，ChatGPT Workspace Agents 是文档列明的迁移路径。 根据 OpenAI 迁移指南，需使用已开放智能体访问的 Business、Enterprise 或 Edu 工作空间，并具备创建智能体的权限。导出 Builder 工作流，将代码粘贴到工作空间的智能体构建器中，再要求它重建该工作流。具体要求见工作空间迁移说明。

OpenAI 的工作空间智能体教程展示了这类流程的运行方式：连接应用、复用指令、定时执行任务，并在工作空间内共享。这适合生成内部客户简报的工作流，负责人可以直接检查成稿。

这条路径的关键限制，是能否忠实保留原有行为。OpenAI 提醒，如果工作流要求高度确定性，也就是相同条件下必须沿着同一条预定路径执行，迁移后未必能完整保持。应检查连接和权限，在 Preview 中用代表性输入测试，验证通过后再选择 Create。这是一项重建工作，并不保证每个节点和每条连接都能原样转换。

例如，内部研究助手只要最终简报符合要求，研究路径有所不同也可以接受。但如果工作流在修改客户记录前必须获得批准，就要明确验证这道审批边界。如果业务依赖精确的分支逻辑，我建议将这部分逻辑保留在应用代码中，优先验证 SDK 路径。

保留 ChatKit 界面，替换托管后端

ChatKit 可以继续作为聊天前端使用，但背后的替代服务端需要由应用自行提供。 OpenAI 指引新项目及现有依赖 Builder 的应用采用自定义服务端集成。现有托管工作流仅在过渡期内继续获得支持。详见 ChatKit 过渡指引。

变化发生在聊天框背后。在后续架构中，浏览器向你的 ChatKit 服务端发送请求，服务端运行智能体实现和工具，再将结果返回界面。界面体验保持不变，并不意味着原来的托管执行链路也得以保留。

高级集成指南列出了实现所需的部分：ChatKitServer、HTTP 端点、用于生产环境会话和消息的持久化存储、支持上传时所需的文件存储，以及承载身份和权限信息的服务端上下文。指南也提供了与 Agents SDK 对接的方法。

对客服应用来说，验收不能止于收到一条回复。还要确认已登录客户只能看到其应当访问的会话，必要的附件仍可使用，获准的工具能够执行，问题升级后仍能送达正确的处理方。现有会话历史如何处理，也需要提前规划，不能假定它会随工作流一起导出。

使用 ChatKit 构建聊天机器人的指南涵盖了更广泛的产品职责。就本次迁移而言，关键是：一段真实对话能否通过替代后端完整走通，并满足预期的访问控制和操作规则。

按截止日期推进迁移清单

先保存评测基线，再于关闭前完成执行逻辑和提示词的迁移。 基线是用来判断替代实现是否正常工作的一组示例及可接受结果。没有它，即使代码搬过去了，也可能丢掉用户赖以完成工作的行为。

2026 年 10 月 31 日前：导出并保存评测

现在就明确评测负责人。保存理解当前行为所需的测试输入、预期结果、评分器定义、提示词版本、模型设置，以及重要的既有结果。现有工作流支持导出什么，就先导出；无法导出的部分，应复制配置并在平台之外重建。

10 月 31 日是转为只读的节点，文档并未将其定义为最终导出截止日期。 本文建议将备份完成时间安排在该日期之前，以便迁移期间始终有可用的基线。

OpenAI 的 Evals 迁移指南推荐使用 Promptfoo，并介绍了如何手动重建提示词、提供商配置、测试用例和断言。这套流程不以 OpenAI Evals 提供导出功能为前提。依赖重建后的评分器分数之前，要先重新运行并验证，因为 OpenAI 提醒，不同系统的评分可能存在差异。

有用的交付物是一套可以运行的评测，以及对失败判定标准的说明。过去某次得分的截图只能补充历史记录，不能替代这套评测。

2026 年 11 月 30 日前：迁移工作流和提示词对象

在计划关闭日期前完成以下任务：

• 部署导出的 SDK 工作流，或验证并创建对应的 Workspace Agent 替代实现。
• 将所有依赖 Agent Builder 的 ChatKit 应用切换到替代服务端。
• 将可复用提示词内容迁出托管提示词对象。
• 运行替代评测流程，调查行为变化。
• 移除生产环境对即将退役服务的依赖，并明确新运行方案的负责人。

提示词对象需要在应用中单独排查。 某条工作流运行正常，并不代表其他功能没有继续依赖已保存的提示词 ID。OpenAI 的提示词迁移指南将提示词文本移入源代码，用函数参数替代变量，并通过 Responses API 的 input 传入生成的消息，取代托管的 prompt 对象。提示词应与应用一同进行版本管理；条件允许时，在动态值之前保留稳定的共享前缀。

以账单助手为例，需要交付完整指令集、变量替换逻辑，以及代表性用例的预期回复。只复制界面上可见的一段文字，却漏掉变量或选错已保存版本，都算不上迁移完成。

将内部切换日期设在供应商截止日期之前，留出排查测试失败的时间。在剩余过渡期内保留有文档说明的回退方案；如果回退仍依赖将被关闭的服务，正式关闭后它就无法提供保障。

哪些说法容易夸大或误导？

“AgentKit 要关闭了”过于笼统，无法直接指导工程决策。 公告明确点名的是具体产品和已保存资源。SDK、ChatKit、Responses API 及独立的 Agents API 仍有后续使用文档，需要迁移的是受影响的托管服务。

导出成功不等于行为一致。 生成的替代实现可能给出看似可信的答案，却跳过本应审批的分支。应将可观察的行为与原始需求对照，而不是只看新流程图或代码是否眼熟。

ChatKit 继续可用，不代表 Builder 托管也会保留。 界面可以继续用，真正执行任务的服务却要更换。应据此安排工程资源和责任归属，无须先假定一定要重做前端。

Evals 关闭，不会让评测需求消失。 变化的是谁来维护测试。同样，将提示词移入代码也不意味着 Responses API 停用，改变的只是应用向它提供指令的方式。

现在使用 AgentKit，有哪些常见疑问？

OpenAI AgentKit 免费吗？

制定迁移方案时，不要假定 AgentKit 是一款统一的免费产品。先选定会继续提供的运行时，再核查其当前的模型、工具和基础设施费用。停用公告没有给出适用于所有迁移的统一价格。

现在该如何使用 OpenAI 智能体？

现有 Agent Builder 工作流可以导出到 Agents SDK，或重建为 Workspace Agent。开发新应用时，应选择仍在提供的运行时，并测试任务所需的工具和权限。ChatKit 界面需要配套的服务端实现。

OpenAI 智能体能做什么？

智能体可以调用工具，完成多步骤任务。有效的迁移应从已经依赖的具体任务出发，例如准备内部简报，或回答经过身份验证的客服请求，并在新运行时中保留该任务所需的行为。

下一步：先跑通一条真实工作流

明确迁移负责人，选出一条有代表性的线上工作流。 保存它的导出代码、提示词内容和评测基线，再将替代实现从头到尾跑通。根据这次结果估算剩余迁移工作量。首项交付应是证据：一个必需任务能够在正确的权限约束下完成，并产出符合要求的结果。之后再为其余迁移任务制定带日期的计划。

想继续了解 AI 工作流构建和运维的实用进展，可以订阅邮件通讯。