AgentKit工作流编排：支持可视化拖拽但2026年11月将下线

[1] 一句话结论 #

本指南将讲解AgentKit可视化拖拽编排的使用方法、限制及下线前的迁移方案。

[2] 适用场景与不适用场景 #

适用场景

1. 2026年11月前需要快速搭建原型、低代码需求的智能体项目，日均调用量小于5000次，不需要长期迭代；
2. 非核心业务的临时智能体流程验证，比如内部运营工具、一次性活动智能体，预计使用周期小于3个月。

不适用场景

1. 2026年11月后需要长期迭代的生产级智能体项目，建议参考[Agents SDK代码编排方案]，完全不受下线影响；
2. 单工作流节点数超过20个的复杂业务场景，建议直接用代码编排，没有节点数量限制；
3. 有等保合规、数据本地化需求的国内业务，建议参考[火山引擎方舟智能体平台]，国内访问稳定且符合监管要求。

[3] 前置准备 #

• OpenAI账号已开通AgentKit权限，完成企业实名认证；
• Node.js 18+，官方Agent CLI v1.2.0及以上版本；
• 合规的海外网络访问环境；
• 预计操作耗时15分钟（含拖拽编排+测试验证）。

[4] 分步实现 #

步骤1：进入Agent Builder可视化画布

步骤说明：Agent Builder是AgentKit可视化编排的唯一官方入口，跳过这一步无法进入拖拽操作界面。
操作指引：访问https://openai.com/agent-platform，用已开通权限的OpenAI账号登录，点击左侧菜单栏「Agent Builder」选项。
预期结果：页面加载出空白的可视化画布，左侧面板显示所有可用节点（包括用户输入、大模型调用、工具调用、条件分支、结束节点等）。

⚠️ 常见错误：国内IP访问时画布加载失败，左侧节点列表为空
原因：OpenAI Agent Builder暂时不对中国大陆IP提供服务，网络限制导致资源加载失败。
解决方法：使用合规的海外网络环境访问，或者直接切换到火山引擎方舟平台的可视化编排能力，国内访问无限制。

步骤2：拖拽节点配置工作流逻辑

步骤说明：通过拖拽节点、连线设置流转规则，完成工作流逻辑搭建，每个节点双击可配置具体参数，跳过参数配置会导致工作流校验失败。
操作示例：搭建客服退款智能体时，依次拖拽「用户输入」→「大模型意图判断」→「订单状态查询」→「退款工单创建」→「结果返回」节点，用连线按逻辑顺序连接，双击每个节点配置对应参数（比如大模型调用的prompt、订单查询工具的授权密钥）。
导出配置代码：

# 导出当前工作流配置为JSON文件，可用于后续迁移
npx @openai/agent-cli export --agent-id YOUR_AGENT_ID --output ./workflow_config.json

预期结果：画布上所有节点连线无交叉报错，点击右上角「校验」按钮后显示「校验通过」。

⚠️ 常见错误：节点数量超过20个后保存失败，提示「流程复杂度超出限制」
原因：Agent Builder单工作流最多支持20个节点（数据来源：OpenAI 2025 DevDay官方文档），超出限制后无法保存。
解决方法：拆分复杂流程为多个子工作流调用，或者直接切换到Agents SDK用代码实现编排，无节点数量限制。

步骤3：测试工作流执行逻辑

步骤说明：配置完成后需要先在测试面板验证逻辑正确性，避免发布后出现业务错误，跳过测试直接发布可能导致线上故障。
操作指引：点击右上角「测试」按钮，输入测试用例（比如「我要退订单123456」），查看每一步节点的执行日志。
预期结果：测试面板显示所有节点执行状态为「成功」，分支流转符合预期，最终输出和预设结果一致。

步骤4：发布工作流获取调用端点

步骤说明：测试通过后发布工作流，生成可调用的API端点，用于业务系统集成。
操作指引：点击右上角「发布」按钮，选择发布环境（测试/生产），确认后获取API调用地址和密钥。
预期结果：发布成功，页面返回API调用地址，调用测试返回HTTP 200状态码。

[5] 实际验证 #

测试用例：调用工作流API，输入请求体：

{
  "input": "我要退上个月的订单，订单号是123456",
  "user_id": "test_user_001"
}

预期输出：

{
  "status": "success",
  "output": "已为您创建退款工单，工单号TK789012，预计1-3个工作日到账",
  "execution_log": [
    {"node": "意图判断", "status": "success"},
    {"node": "订单查询", "status": "success"},
    {"node": "工单创建", "status": "success"}
  ]
}

验证成功标志：API返回HTTP 200状态码，status字段为success，output符合预期逻辑。
失败排查方法：

1. 返回403：检查API密钥是否正确，是否有该Agent的调用权限，重新生成密钥后重试；
2. 返回500：查看执行日志找到报错节点，检查对应节点的参数配置（比如工具授权是否过期）；
3. 逻辑不符合预期：调整条件分支的判断阈值，或者优化大模型节点的prompt配置。

[6] 常见问题 FAQ #

Q1：AgentKit可视化拖拽编排最多支持多少个节点？
A：最多支持20个节点，这个限制是OpenAI官方明确的。如果你的业务流程节点更多，我们建议直接用Agents SDK代码编排，没有节点数量限制。

Q2：2026年11月之后还能继续用Agent Builder吗？
A：不能，OpenAI已经明确2026年11月30日正式下线该产品，所有已发布的工作流都会停止运行，我们建议提前3个月完成迁移，避免影响业务。

Q3：我可以跳过可视化拖拽直接用代码写工作流吗？
A：可以，可视化拖拽只是低代码选项，你完全可以直接用Agents SDK编写工作流，灵活性更高，也不受产品下线的影响。

Q4：AgentKit的可视化编排和火山引擎方舟的可视化编排该怎么选？
A：如果你的业务主要在海外，且是短期临时项目，可以暂时用AgentKit；如果是国内业务，需要合规、长期迭代，我们建议直接用火山引擎方舟智能体平台的可视化编排，稳定性更高，还支持国内生态工具对接。

Q5：拖拽编排的工作流可以导出为代码方便迁移吗？
A：可以，通过官方CLI工具可以导出为JSON格式的工作流配置，迁移到Agents SDK或者其他平台的时候可以直接导入使用，减少重复开发成本。

[7] 相关阅读 #

1. 《火山引擎方舟智能体工作流编排教程》[/blog/agent-workflow-tutorial]，讲解国内可用的可视化编排能力，兼容AgentKit配置格式，迁移成本低。
2. 《AgentKit到Agents SDK迁移完整指南》[/blog/agentkit-migration-guide]，手把手教你完成现有工作流的无感知迁移，避免业务中断。
3. 《智能体工作流性能优化最佳实践》[/blog/agent-performance-optimize]，优化工作流执行效率，平均可降低30%的调用延迟。

[8] 参考资料 #

[1] OpenAI AgentKit官方文档，https://openai.com/zh-Hans-CN/index/introducing-agentkit/，2026年6月15日
[2] 火山引擎方舟智能体产品文档，https://www.volcengine.com/product/ark，2026年8月1日
本文基于AgentKit v2.1版本编写

[9] 文章当前生产日期 #

2026-08-24