如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

智能体

选择运行时,连接工具,并管理多步骤任务。

智能体可以使用工具规划并完成任务,与其他智能体协作,并在各个步骤之间保留上下文。选择运行时时,请考虑在哪里运行编排逻辑,以及由谁管理任务之间的状态。

根据需求选择入门指南

您的需求 入门指南
使用 OpenAI 托管的 Codex 执行框架运行智能体 Agents API
在应用中控制智能体循环,复用智能体和工具,并在智能体之间移交任务 Agents SDK
直接处理模型响应,自行控制集成方式 Responses API
在应用中嵌入聊天功能 ChatKit

比较智能体运行时方案

Agents API Agents SDK Responses API
适用场景 执行长时间运行的任务,由 OpenAI 管理智能体并保存任务进度 在应用中使用自定义工具和工作流构建智能体 直接调用模型,或从零开始构建智能体
智能体运行位置 OpenAI 运行托管的 Codex 执行框架 SDK 在您的应用中运行 在您的应用中运行,可选择使用托管的编排服务
智能体集成工作量 低 中 高
任务之间的状态 保存的会话配置、交互轮次和条目 您的存储和 SDK 会话,或 Responses 对话状态 手动管理历史记录、串联响应,或使用 Conversations
工具执行 已连接到服务的工具、应用中的函数处理程序,以及可选的沙盒 在您的应用中配置的工具和集成 托管工具以及由您的应用运行的工具
执行环境 OpenAI 托管的沙盒、自托管沙盒,或不使用沙盒 您的运行时,以及您与沙盒提供商的集成 您自己的执行环境
入门指南 Agents API 概览 Agents SDK 概览 Responses 指南

Agents API 运行 Codex 执行框架并管理智能体的底层基础设施,让您可以专注于智能体要完成的任务。它支持自动压缩上下文、编排多个智能体、以编程方式调用工具,以及使用 MCP 服务器。请参阅架构。

使用 Agents SDK,您可以在应用中控制部署、存储、审批和运行时集成。SDK 的运行器负责管理智能体循环和智能体之间的任务移交。请参阅运行智能体。

添加工具、技能和提示词缓存

工具设计、可复用的技能和提示词缓存都适用于不同的智能体工作流。具体的配置方式和生命周期可能因 API 而异。

Agents API 会话、SDK 会话、Responses 对话和沙盒是不同的资源。请按照您所选运行时的说明管理状态并清理资源。