OpenAI Agents API vs Responses API vs Agents SDK vs AgentKit：该基于哪个来开发

这四个名字处于不同的层次，而一个问题就能把它们区分开：谁来运行 agent 循环？Responses API 是那次模型调用，循环由你的代码围绕它运行。Agents SDK 是一个 TypeScript 和 Python 库，它的 runner 在你的应用内部执行循环。Agents API 自 2026 年 9 月 10 日起公测，它替你运行 OpenAI 的 Codex harness，并保存 session（以及可选的 sandbox）。AgentKit 是 2025 年 10 月发布的打包产品，包含 Agent Builder、ChatKit、Connector Registry 和 Evals，而 Agent Builder 计划于 2026 年 11 月 30 日停用。

9 月 29 日的 DevDay 为 Agents API 加入了 computer use（见 DevDay 2026 汇总），这让命名上的困惑更难以忽视。下文依次给出：围绕循环、计算、状态、价格和成熟度的逐项对比，一张决策表，以及从手写 Responses 循环迁移的路径。想了解 session 与审批的实操演练，请阅读 OpenAI Agents API 指南。无论你选哪个，它的 HTTP 接口都可以在 Apifox 中测试。

OpenAI agent 方案逐项对比

	Agents API	Responses API	Agents SDK	AgentKit
它是什么	基于 Codex harness 的托管 agent 运行时	模型接口，`POST /v1/responses`	面向 TypeScript 和 Python 的库	打包产品：Agent Builder、ChatKit、Connector Registry、Evals
谁运行循环	OpenAI	你的代码	SDK runner，在你的应用内	Agent Builder workflow，导出为 SDK 代码或用 ChatKit 嵌入
计算在哪里运行	OpenAI 托管的 sandbox、你自己的 sandbox，或都不使用	你的环境，外加托管 tool	你的运行时和 sandbox 服务商	不适用
状态保存在哪里	OpenAI session：配置、turn、item	你的历史记录、`previous_response_id`，或 Conversations API	你的存储、SDK session，或 Responses 的状态	已发布、带版本的 workflow
你需要支付	token、tool 和托管容器；无额外费用	token 和 tool	token 和 tool，外加你自己的托管成本	底层 API 用量；无单独订阅费
集成成本（OpenAI 口径）	低	高	中	未评级
状态	公测（`OpenAI-Beta: agents=v1`）	所有新项目推荐使用	当前在用	Agent Builder 和 Evals 将于 2026 年 11 月 30 日停用；ChatKit 保留
数据管控	仅支持美国数据驻留；不符合 ZDR 要求；状态保留至被删除	符合 ZDR 要求（有限制）；支持区域端点	取决于它调用的 API	不适用

来源：OpenAI 的 agent 运行时对比、Agents API 概览，以及弃用页面。

谁运行循环

这一维度决定了表格中其他大多数行。

Responses API：由你运行。web search、file search、code interpreter 和远程 MCP 这类托管 tool 可以在一个请求内运行多次调用，但你自己的 function 会回到你这边。当模型调用某个 function 时，你会收到一个 function_call item，运行它，并在下一个请求中发送 function_call_output，带上相同的 call_id。何时停止、如何保存历史（响应默认会被保存；store: false 可将其关闭），以及何时用 context_management 和 compact_threshold 压缩过长的上下文，都由你决定。Responses API 指南和 function calling 指南覆盖了这个循环。

Agents SDK：由你的进程运行。OpenAI 的文档称 SDK 的 runner「负责 agent 循环和 handoff」，而你的 server 负责部署、tool 实现、状态存储和审批决策。使用 Sandbox Agents 时，harness 可以留在你的基础设施中，而命令在 Unix 本地、Docker 或托管服务商的 workspace 中运行，因此鉴权、审计日志和人工审核都保持在容器之外。

Agents API：由 OpenAI 运行。托管 harness 负责 session、编排、上下文压缩和恢复，并额外提供 subagent、tool search 和 programmatic tool calling。远程 MCP server 由 OpenAI 直接调用。你的代码仍需处理 function tool：当 session 报告 function_call 时（位于 required_actions 中），你返回一个 agent.session.input.tool_result 事件，带上 turn_id 和 call_id。

同一个任务，两种做法：

# Responses API: one model call; your code owns the loop
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "reasoning": {"effort": "low"},
    "tools": [{"type": "web_search"}],
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

# Agents API: a durable session; OpenAI owns the loop
curl https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {"model": "gpt-6-astra", "tools": [{"type": "web_search"}]},
    "environment": {"type": "none"},
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

Agents API 的文档示例使用 gpt-6-astra；文档没有说明是否接受其他模型，因此在替换为 gpt-6.1-sol 之前请先确认。

计算、状态与成本

计算。Agents API 可以为整个 session 提供并管理一个 sandbox：把 environment.type 设为 openai_hosted、self_hosted 或 none。使用 SDK 时，由你选择并支付 sandbox 服务商。使用 Responses 时，除了托管 tool，代码都在你自己运行它的地方执行。

状态。Agents API 的 session 把配置、turn 和 item 保存在 OpenAI 一侧，因此后续跟进只需在同一个 session ID 上发一个 event。使用 Responses 时，你串联 previous_response_id 或使用 Conversations。使用 SDK 时，状态保存在你的存储或 SDK session 中。

成本。由于各方案调用的是同一批模型，token 价格处处相同。Agents API「不收取额外费用」，但托管容器按每 20 分钟 session $0.03（1 GB）到 $0.48（16 GB）计费。SDK 的额外成本是你自己的托管开销。根据我们的 AgentKit 解读，AgentKit 没有单独订阅费。

数据。Agents API 仅支持美国数据驻留，且不支持零数据保留，即使使用自托管 sandbox 也一样。OpenAI 的数据管控页面把 /v1/agents 列为不符合 ZDR 要求，状态会保留至被删除；而 /v1/responses 在有限制的前提下符合 ZDR 要求，并可通过 eu.api.openai.com 这类区域端点使用。如果 ZDR 或欧盟驻留是硬性要求，那么 Agents API 目前就被排除了。

2026 年末的 AgentKit：还剩下什么

AgentKit 于 2025 年 10 月 6 日发布，包含四个组成部分。它们各自的现状如下：

Agent Builder：2026 年 6 月 3 日宣布弃用；计划于 2026 年 11 月 30 日停用。OpenAI 的迁移指南可把 workflow 导出为 Agents SDK 代码，或在 Business、Enterprise 或 Edu 套餐上重建为 ChatGPT Workspace Agent。
Evals：已有 eval 从 2026 年 10 月 31 日起变为只读，控制台和 API 计划于 11 月 30 日停用。
ChatKit：继续提供，用于嵌入式聊天。
Connector Registry：跨 OpenAI 各产品管理 connector 和 MCP server 的管理面板。

正如我们的 AgentKit 指南所说，要获得 AgentKit 中长久可用、代码优先的路径，就是 Agents SDK。

该基于哪一个来构建

选择	适用场景
Agents API	任务要运行数分钟，需要文件、命令或浏览器，而你又不想自己运维循环、sandbox 或 session 存储。能接受美国驻留和 beta header。
Responses API	你只做单次调用，希望每个 turn 都在自己掌控之下，需要 ZDR 或非美国的数据驻留，或者已经有可用的循环。
Agents SDK	需要有类型的应用代码来掌控 tool、存储、审批和 handoff，且循环必须运行在你的基础设施内。
ChatKit	你的产品里需要嵌入式的聊天 UI。
Agent Builder	不要从这里开始。请在 2026 年 11 月 30 日之前导出已有的 workflow。

在 AWS 上，由 OpenAI 提供支持的 Bedrock Managed Agents 把 Agents API 的核心能力带入 AWS，可原生运行。想在两种代码优先路径中接入 MCP，请参阅 MCP servers with OpenAI agents。

从你自己的 Responses 循环迁移到 Agents API

如果你已经在 Responses 上构建了循环，并希望改由 OpenAI 来运行：

对应各个组成部分。instructions、模型和 tools 移入 agent；你的容器变成 environment；你的对话存储变成一个 session ID。
把远程 MCP server 移入 agent.tools。把它们的 token 放进用 vault_ids 挂载的 vault 中，而不是写在 prompt 里。
重写 function 处理逻辑。把原来的 function_call_output 循环替换为处理 agent.session.requires_action（stream）或 agent.session.action_required（webhook）的 handler，并返回 agent.session.input.tool_result。subagent 不能调用 function tool，因此请把它们留在主 agent 上。
删掉你的压缩代码。harness 会自动压缩上下文。
切换到 event 方式。用 stream 获取 turn 结果（agent.session.turn.completed、agent.session.turn.failed、agent.session.turn.cancelled），或改用 webhooks。session 空闲并不意味着成功。
确认各项限制。仅美国驻留、不支持 ZDR，以及需要 beta header。

在一个 Apifox 项目中同时保留两者

在切换之前，让新旧两套并行运行。在同一个 Apifox 项目中，创建一个 Responses 目录和一个 Agents API 目录，让它们共用一个包含 {{OPENAI_API_KEY}} 和模型变量的环境。把相同的 prompt 分别发给两者，断言状态码和必需的输出字段，并把 Agents API 的 stream 作为 SSE 请求打开以观察 turn event。把这些运行保存为测试场景，并用 Apifox CLI 在 CI 中运行，这样 beta 阶段的变化就会以检查失败的形式显现出来。生产环境 AI agent 可靠性指南介绍了应当断言哪些内容，可以照着搭建。

FAQ

Agents API 会取代 Responses API 吗？没有宣布任何弃用。OpenAI 的 agents 概览把 Agents API、Agents SDK 和 Responses API 列为面向不同需求的现行选项。

OpenAI AgentKit 被弃用了吗？部分是。Agent Builder 和 Evals 计划于 2026 年 11 月 30 日停用；ChatKit 继续提供。

Agents SDK 会用到 Agents API 吗？不会。SDK 在你的应用中运行；Agents API 则在 OpenAI 的服务里运行托管 harness。

Assistants API 怎么样了？OpenAI 的弃用页面把它的移除时间定在 2026 年 8 月 26 日，并引导开发者转向 Responses 和 Conversations API。

哪个方案最便宜？它们的 token 价格都一样。差别在于 Agents API 上的托管容器，对比 SDK 或 Responses 下你自己的托管。

本周就选定一条路径

按「谁该运行循环」来做选择，然后在写应用之前用请求加以验证。如果你是从零开始，不妨先试一个 Agents API session，并在 Apifox 中把它的输出与你当前的 Responses 方案做对比。

HiFox：将 Agent 变成真正的队友

另外，我们也在思考，AI 如何从个人提效走进团队协作。

HiFox 是一个让人和 AI Agent 在同一个工作现场协作的平台：你可以像给同事分派任务一样指派 Agent，在任务看板中跟踪进度、查看结果，让 Agent 成为团队里的队友。

👉 立即体验 HiFox：https://hifox.com

OpenAI Agents API vs Responses API vs Agents SDK vs AgentKit：该基于哪个来开发