OpenAI Agents SDK 概览

2026-11-06 17:50 更新

智能体可以使用工具规划并完成任务,与其他智能体协作,并在多个步骤之间保留上下文。

运行第一个智能体

先按Agents SDK快速开始安装SDK、定义一个智能体并运行。成功后回到本页,为应用选择下一项能力。

获取Agents SDK

GitHub仓库提供更多示例、问题反馈和对应语言的参考细节:

选择起点

目标 起点 原因
以代码构建智能体应用 快速开始 获得可运行SDK集成的最短路径
清楚定义一个专项智能体 智能体定义 先确定单个智能体的约定
选择模型、默认值和传输 模型与提供商 模型、提供商或传输影响工作流时使用
理解运行循环与状态 运行智能体 循环、流式和继续策略
在容器环境中执行工作 沙箱智能体 需要文件、命令、软件包、快照、挂载或提供商集成
设计专项职责归属 编排与交接 多个智能体之间决定谁负责回复
添加验证或人工审查 护栏与人工审查 风险工作继续前阻断或暂停
理解运行返回值 结果与状态 最终输出、可恢复状态及下一轮接口
添加托管工具、函数工具或MCP 使用工具及集成与可观测性 通用工具语义与SDK特有MCP、追踪分别说明
检查和改进运行 集成与可观测性及评测智能体工作流 先用追踪调试,再进入评测循环
以语音为主要交互方式 语音智能体 SDK语音流水线与实时智能体模式

使用SDK构建

服务器负责部署、工具实现、状态存储和批准决策,而SDK运行智能体循环、调用工具时,选择SDK路径。它适合:有类型的TypeScript或Python应用代码;直接控制工具、MCP服务器与运行时行为;自定义存储或服务端对话策略;与现有产品逻辑和基础设施紧密集成。

通常按以下顺序阅读:先用快速开始完成一次运行;再用智能体定义及模型与提供商完善单个专项智能体;工作流复杂后,继续运行智能体、编排与交接、护栏与人工审查;应用依赖运行对象或更深入可见性时,再读结果与状态和集成与可观测性。

比较智能体运行时

智能体概览比较Agents SDK、Agents API和Responses API。Agents SDK在应用中运行,Agents API则在OpenAI服务中运行托管执行框架。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号