OpenAI 官方的轻量多 agent Python SDK
openai-agents 是 OpenAI 官方 MIT Python SDK：Agent + Runner，带 tracing 与 handoff。它不是 ChatGPT，也不是终端 coding agent。
更新于 2026-09-04。数据来自官方仓库当日快照。
如何快速上手 OpenAI Agents SDK
3 步按官方 Quickstart 跑通一个 Agent
安装
官方文档：venv 之后 pip 或 uv。
pip install openai-agents设置 API key
当前终端会话导出 OPENAI_API_KEY。不要把密钥写进仓库。
export OPENAI_API_KEY=...跑一个 Agent
官方 Quickstart 用 Agent + Runner。完整异步示例见文档。
from agents import Agent, Runner避坑指南
别当成 ChatGPT 专区
ChatGPT 是对话产品，本专区是 Python SDK。模型品牌走导航 ai-brands，不在这里展开。
生产别省 tracing / guardrails
官方文档把 tracing、session、护栏写成一等能力。PoC 可以先 Runner.run；上线要能看见每一步。
包名和 import 不一致
pip 装的是 `openai-agents`，代码里是 `from agents import ...`。复制示例时别装成 `openai` 就以为 SDK 齐了。
和 LangChain、Claude Code 怎么选
基于官方公开文档与许可。本专区是 SDK，不是 ChatGPT，也不是终端 coding agent。
| 工具 | 许可 | 产品形态 | 核心定位 | 适合谁 |
|---|---|---|---|---|
| OpenAI Agents SDK | MIT | Python SDK | 轻量多 agent + tracing | 已在 OpenAI 生态写生产 agent |
| LangChain | MIT | Python / JS 框架 | 组件与大量集成 | 要混多家模型与工具 |
| Claude Code | 专有闭源 | 终端 agent 产品 | 在仓库里改代码 | 日常编码，而不是在应用里嵌 SDK |
官方资源导航
官方入口
- GitHub 仓库
官方 Python SDK。MIT。
文档与安装
- 官方文档
概念、Runner、handoff、session。
- Quickstart
venv、pip install、第一个 Agent。
- PyPI · openai-agents
`pip install openai-agents`。
相关
- OpenAI 平台
API key 与模型，不是本 SDK 文档。
最新动态
2026-09-04 · GitHub · openai/openai-agents-python
OpenAI Agents SDK：轻量多 agent 工作流官方 Python 包 openai-agents，MIT。文档强调 Agent + Runner，以及 tracing / handoff。Star 快照约 2.9 万。
老金精选推荐
常见问题
- OpenAI Agents SDK 是什么？
- OpenAI 官方的轻量 Python 框架，用来编排多 agent 工作流。包名 `openai-agents`，import 是 `from agents import Agent, Runner`。不是 ChatGPT 网页产品。
- 怎么安装？
- 官方 Quickstart：建 venv 后 `pip install openai-agents`（或 `uv add openai-agents`），并设置 `OPENAI_API_KEY`。
- 必须绑定 OpenAI 模型吗？
- 默认走 OpenAI API key。官方定位是 OpenAI 生态里的最短路径；跨供应商要自己接，不要假设它是 LangChain 那种集成目录。
- 和 LangChain、Claude Code 怎么选？
- 已有 OpenAI 账单、要代码里编排 agent，选这个 SDK。要很多供应商和检索组件，选 LangChain。要终端里改仓库，选 Claude Code / Gemini CLI，不是 SDK。
引用本专区内容 (Cite this Hub)
我们鼓励你将本页内容沉淀至你的知识库、研究报告或直接让 AI Agent 读取。本站保持 CC BY 4.0 开放版权。
本专区如何更新
版本与链接集中在 src/content/openai-agents-sdk.ts 维护，star 快照由 GitHub API 自动巡检。教程、导航、精选按 slug 挂载。