AI translation, not an official translation. Refer to the original for technical details.

完整文档索引请参阅 llms.txt。在页面 URL 后追加 .md 即可获取各文档页面的 Markdown 版本。

Agent 可以使用工具规划并完成任务、与其他 Agent 协作，并在多个步骤之间保持上下文。请根据您希望编排逻辑运行的位置以及由谁管理任务间状态来选择合适的运行时。

选择您的起点

您希望	从这里开始
使用由 OpenAI 托管的 Codex 运行环境运行 Agent	Agents API
在应用程序中通过可复用的 Agent、工具和交接控制 Agent 循环	Agents SDK
直接操作模型响应并控制集成方式	Responses API
添加嵌入式聊天体验	ChatKit

对比 Agent 运行时选项

	Agents API	Agents SDK	Responses API
适用场景	由 OpenAI 管理 Agent 并保存进度的长时任务	在您的应用程序中使用自定义工具和工作流构建 Agent	直接调用模型或从头构建 Agent
Agent 运行位置	OpenAI 运行托管的 Codex 运行环境	SDK 在您的应用程序内部运行	您的应用程序，可选择使用托管编排
Agent 集成工作量	低	中	高
任务间状态管理	保存会话配置、轮次和条目	您的存储与 SDK 会话，或 Responses 对话状态	手动维护历史记录、链式响应或使用 Conversations
工具执行方式	服务连接工具、应用程序函数处理器以及可选沙箱	在您的应用程序中配置的工具和集成	托管工具以及由您的应用程序运行的工具
执行环境	OpenAI 托管沙箱、自托管沙箱或无沙箱	您的运行时及沙箱提供商集成	您自己的执行环境
从这里开始	Agents API 概览	Agents SDK 概览	Responses 指南

Agents API 运行 Codex 运行环境并管理底层 Agent 基础设施，让您专注于 Agent 的具体功能。它包含自动上下文压缩、多 Agent 编排、程序化工具调用以及对 MCP 服务器的支持。请参阅架构。

Agents SDK 让您的应用程序可以控制部署、存储、审批和运行时集成。其运行器负责处理 Agent 循环和交接。请参阅运行 Agent。

工具设计、可复用技能和提示缓存适用于各类 Agent 工作流。它们的配置和生命周期可能因 API 而异。

Agents API 会话、SDK 会话、Responses 对话和沙箱是不同的资源。请遵循您所选运行时对应的状态管理和清理说明。