OpenAI 从 Agent Builder 迁移

本指南说明如何将已有Agent Builder工作流导出为Agents SDK代码。可以在应用中继续使用Agents SDK，也可参考导出内容，在ChatGPT中重新创建工作区智能体。

这个过程不会直接转换工作流图，也不保证所有行为都能原样迁移。

选择迁移路径

• Agents SDK：适合通过代码构建智能体。
• ChatGPT工作区智能体（Workspace Agents）：适合用自然语言构建并与团队共享智能体。

迁移之前

你需要有权访问Agent Builder中的工作流。

导出工作流

1. 在Agent Builder中打开工作流。
2. 在顶部导航选择Code（代码）。
3. 在代码对话框选择Agents SDK。
4. 选择TypeScript或Python，复制完整导出内容。

方案一：继续使用Agents SDK

希望在自己构建和部署的应用中运行导出工作流时，采用此方案。

将TypeScript或Python导出内容复制到应用，安装并配置对应Agents SDK，在实际运行环境测试工作流。配置与运行方法见Agents SDK概述及快速开始。部署前验证应用配置和行为。

方案二：根据导出内容创建工作区智能体

你需要ChatGPT Business、Enterprise或Edu工作区，且具有工作区智能体访问资格和创建权限。

在ChatGPT中创建工作区智能体，将导出代码粘贴到对话，并使用以下提示词：

来源示例 1（text）：

中文译释：提示词完整译文：

请帮我将此工作流转换为智能体：

<在此粘贴导出的代码&

Please help me convert this workflow into an agent:

<paste your exported code here>

继续之前，检查构建器指出需要调整的行为。

检查并测试智能体

部分工作流行为可能需要手工重建。测试时检查控制流程、触发器、工具及权限。

创建智能体之前：

1. 检查生成的指令与已配置能力。
2. 配置所需应用、工具、技能、认证和连接权限。
3. 选择Preview（预览），用原工作流的代表性输入测试。
4. 将预览行为与原工作流的预期行为比较。
5. 验证完成后再选择Create（创建）。

沿用原工作流的安全实践，尤其是能够访问私有数据或通过连接工具执行操作的智能体。

限制

• 核心高度依赖确定性的工作流，可能无法完整迁移为工作区智能体。
• 连接应用、认证、发布和权限配置需要在ChatGPT中分别检查。
• Agents SDK实现仍需要你验证应用运行配置、工具、认证、权限和部署。

相关资料

• Agent Builder
• 构建智能体的安全实践
• Agents SDK概述
• Agents SDK快速开始
• 在ChatGPT中构建处理重复工作的工作区智能体