智能体可以使用工具规划并完成任务,与其他智能体协作,并在各个步骤之间保留上下文。选择运行时时,请考虑在哪里运行编排逻辑,以及由谁管理任务之间的状态。
根据需求选择入门指南
| 您的需求 | 入门指南 |
|---|---|
| 使用 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 而异。
- 请先阅读使用工具,了解函数调用、MCP 和托管功能。
- 请阅读以编程方式调用工具,了解如何使用 JavaScript 编排工具调用,以及如何为各个 API 进行配置。
- 请参阅技能,了解如何复用指令,以及支持哪些加载方式。
- 请阅读提示词缓存,了解各 API 共有的缓存行为,然后参阅 Agents API 可观测性与用量,了解如何按会话统计用量。
Agents API 会话、SDK 会话、Responses 对话和沙盒是不同的资源。请按照您所选运行时的说明管理状态并清理资源。