智能体可以使用工具规划并完成任务,与其他智能体协作,并在多个步骤之间保留上下文。
运行您的第一个智能体
按照 Agents SDK 快速入门安装 SDK,定义并运行一个智能体。成功运行后,回到本页,选择应用接下来需要的功能。
获取 Agents SDK
访问 GitHub 代码仓库,查看更多示例、议题以及各编程语言的详细参考资料。
选择从哪里开始
| 您的目标 | 建议先读 | 原因 |
|---|---|---|
| 以代码优先的方式构建智能体应用 | 快速入门 | 这是集成 SDK 并成功运行智能体的最快途径。 |
| 明确定义一个专用智能体 | 定义智能体 | 如果您还在确定单个智能体的接口和职责,可以从这里开始。 |
| 选择模型、默认设置和传输方式 | 模型和提供商 | 当模型选择、提供商配置或传输策略会影响工作流时,请参阅此页。 |
| 了解运行时循环和状态 | 运行智能体 | 此页介绍智能体循环、流式传输以及如何继续运行。 |
| 在容器环境中执行任务 | 沙盒智能体 | 如果智能体需要使用文件、命令、软件包、快照或挂载,或需要连接到提供商,请参阅此页。 |
| 划分专用智能体的职责 | 编排与交接 | 如果您需要多个智能体,并且必须决定由哪个智能体负责回复,请参阅此页。 |
| 添加验证或人工审核 | 防护措施与人工审核 | 如果工作流需要阻止或暂停有风险的操作,以免其继续执行,请参阅此页。 |
| 了解一次运行会返回什么 | 结果与状态 | 此页介绍最终输出、可恢复的状态以及下一轮交互可用的接口。 |
| 添加托管工具、函数工具或 MCP | 使用工具和集成与可观测性 | 平台工具文档说明各类工具的行为,SDK 集成文档介绍 SDK 中的 MCP 集成和追踪功能。 |
| 检查并改进运行过程 | 集成与可观测性和评估智能体工作流 | 先使用追踪记录进行调试,再通过反复评估改进工作流。 |
| 构建以语音为主的工作流 | 语音智能体 | 使用 SDK 的语音管道和实时智能体模式。 |
使用 SDK 构建应用
如果您的服务器负责部署、实现工具、存储状态和做出审批决定,而 SDK 负责运行智能体循环并调用这些工具,请选择 SDK 方案。如果您有以下需求,这种方案最为合适:
- 使用 TypeScript 或 Python 编写带有类型声明的应用代码
- 直接控制工具、MCP 服务器和运行时行为
- 使用自定义存储方案,或由服务器管理对话策略
- 与现有产品逻辑或基础设施紧密集成
通常可以按以下顺序阅读 SDK 文档:
- 从快速入门开始,运行一次智能体并在屏幕上查看结果。
- 参阅定义智能体和模型和提供商,明确定义一个专用智能体。
- 随着工作流变得更加复杂,继续阅读运行智能体、编排与交接和防护措施与人工审核。
- 如果应用逻辑依赖运行对象,或者需要更详细地了解智能体的运行行为,请参阅结果与状态和集成与可观测性。
比较智能体运行时方案
参阅智能体概览,比较 Agents SDK、Agents API 和 Responses API。Agents SDK 在您的应用中运行,Agents API 则在 OpenAI 服务中运行托管的执行框架。