2025 最新 · 官方 SDK · 10 章精讲

OpenAI Agents SDK 实战

用 OpenAI 官方 SDK 构建生产级 AI Agent 系统。原生多 Agent 协作、内置工具调用、追踪与可观测性,Python 优先,生产就绪。

openai-agents 0.x Python 3.11+ GPT-4o / o3 FastAPI Pydantic v2
开始学习 →
📦 10 章节 🛠 实战代码 🔬 生产级示例

课程目录

从 SDK 设计哲学到完整生产项目,循序渐进掌握 OpenAI 官方 Agent 框架

Chapter 01
Agents SDK 简介与设计哲学
从 Swarm 到正式 SDK 的演进,核心概念 Agent/Tool/Handoff/Runner/Guardrails,第一个 Agent 完整示例。
设计哲学 核心概念 快速上手
Chapter 02
Agent 定义与配置
Agent 类详解、Instructions 最佳实践、模型选择、model_settings 调参、Dynamic Instructions 动态提示词。
Agent 配置 Instructions 模型选择
Chapter 03
Tools 工具集成
函数工具、@function_tool 装饰器、Pydantic 参数、工具错误处理、内置 WebSearch/File Search 工具。
Function Tools Pydantic 错误处理
Chapter 04
Runner 与 Run 生命周期
run/run_sync/run_streamed 三种模式,Stream 流式输出,Event 类型详解,多轮对话 Message 列表。
Runner 流式输出 生命周期
Chapter 05
多 Agent 协作(Handoff)
Handoff 机制、Orchestrator-Worker 模式、自定义 Handoff、on_handoff 回调,客服分诊系统实战。
Handoff 多 Agent 协作模式
Chapter 06
Context 与状态管理
RunContextWrapper 依赖注入、工具间状态传递、多轮对话历史维护、数据库集成与线程安全。
Context 状态管理 依赖注入
Chapter 07
Guardrails 安全护栏
Input/Output Guardrails、@guardrail 装饰器、Tripwire 绊线机制、并行护栏、内容安全实战。
Guardrails 安全护栏 Tripwire
Chapter 08
追踪与可观测性
内置追踪系统、OpenAI Traces UI、自定义 Span、第三方集成 LangSmith/Weave、敏感数据保护。
Tracing 可观测性 监控
Chapter 09
生产化与性能优化
异步并发、结构化输出、Token 优化、缓存策略、错误重试、批量处理与成本估算。
性能优化 结构化输出 成本控制
Chapter 10
实战项目——AI 研究助手
多 Agent 研究工作流、FastAPI WebSocket 流式输出、Tavily 搜索、PDF 解析、Ollama 本地模型集成。
综合实战 研究工作流 端到端