OpenAI Agents SDK 概览
2026-11-06 17:50 更新
智能体可以使用工具规划并完成任务,与其他智能体协作,并在多个步骤之间保留上下文。
运行第一个智能体
先按Agents SDK快速开始安装SDK、定义一个智能体并运行。成功后回到本页,为应用选择下一项能力。
获取Agents SDK
GitHub仓库提供更多示例、问题反馈和对应语言的参考细节:
- TypeScript SDK:打开TypeScript SDK仓库。
- Python SDK:打开Python SDK仓库。
选择起点
| 目标 | 起点 | 原因 |
|---|---|---|
| 以代码构建智能体应用 | 快速开始 | 获得可运行SDK集成的最短路径 |
| 清楚定义一个专项智能体 | 智能体定义 | 先确定单个智能体的约定 |
| 选择模型、默认值和传输 | 模型与提供商 | 模型、提供商或传输影响工作流时使用 |
| 理解运行循环与状态 | 运行智能体 | 循环、流式和继续策略 |
| 在容器环境中执行工作 | 沙箱智能体 | 需要文件、命令、软件包、快照、挂载或提供商集成 |
| 设计专项职责归属 | 编排与交接 | 多个智能体之间决定谁负责回复 |
| 添加验证或人工审查 | 护栏与人工审查 | 风险工作继续前阻断或暂停 |
| 理解运行返回值 | 结果与状态 | 最终输出、可恢复状态及下一轮接口 |
| 添加托管工具、函数工具或MCP | 使用工具及集成与可观测性 | 通用工具语义与SDK特有MCP、追踪分别说明 |
| 检查和改进运行 | 集成与可观测性及评测智能体工作流 | 先用追踪调试,再进入评测循环 |
| 以语音为主要交互方式 | 语音智能体 | SDK语音流水线与实时智能体模式 |
使用SDK构建
服务器负责部署、工具实现、状态存储和批准决策,而SDK运行智能体循环、调用工具时,选择SDK路径。它适合:有类型的TypeScript或Python应用代码;直接控制工具、MCP服务器与运行时行为;自定义存储或服务端对话策略;与现有产品逻辑和基础设施紧密集成。
通常按以下顺序阅读:先用快速开始完成一次运行;再用智能体定义及模型与提供商完善单个专项智能体;工作流复杂后,继续运行智能体、编排与交接、护栏与人工审查;应用依赖运行对象或更深入可见性时,再读结果与状态和集成与可观测性。
比较智能体运行时
智能体概览比较Agents SDK、Agents API和Responses API。Agents SDK在应用中运行,Agents API则在OpenAI服务中运行托管执行框架。
以上内容是否对您有帮助:

TRAE-AI编程


更多建议: