官方信息表
| 项目 | 内容 |
|---|---|
| 项目名称 | OpenAI Agents SDK |
| 仓库地址 | openai/openai-agents-python |
| 官方文档 | openai.github.io/openai-agents-python |
| 开源协议 | MIT |
| 最新更新 | 2026-10-27 |
| 定位 | 轻量多智能体工作流框架 |
项目背景
OpenAI Agents SDK 是 OpenAI 官方推出的轻量级多智能体框架，支持 Agent、Handoff（智能体交接）、Guardrails（输入输出护栏）、Sessions（会话历史）、Tracing（调用追踪）等核心概念。它不仅支持 OpenAI 模型，也通过兼容层支持 100+ 其他 LLM。还支持语音智能体和沙箱智能体。
核心特性
- Agents：带指令、工具、护栏的 LLM
- Sandbox agents：预配置容器，长时间执行任务
- Realtime agents：语音智能体，基于 gpt-realtime
- Handoffs：智能体间交接任务
- Guardrails：输入输出安全验证
- Human in the loop：内置人工介入机制
- Sessions：自动管理会话历史
- Tracing：内置追踪，可视化调试
环境要求
- Python 3.10+
- OpenAI API Key
部署步骤
python -m venv .venv
source .venv/bin/activate
pip install openai-agents
语音支持：
pip install 'openai-agents[voice]'
使用方法
from agents import Agent, Runner
agent = Agent(name="Assistant", instructions="你是一个 helpful assistant")
result = Runner.run_sync(agent, "你好")
print(result.final_output)
常见问题 FAQ
Q：只能用 OpenAI 模型吗？ A：不是，SDK 提供商无关，可通过 LiteLLM 接入其他模型。
Q：支持 JS/TS 吗？ A：支持，见 openai-agents-js。
Q：Tracing 在哪里看？ A：内置 OpenAI Dashboard 查看每次智能体运行轨迹。
安装要求
python -m venv .venv
source .venv/bin/activate
pip install openai-agents
# 语音支持
pip install 'openai-agents[voice]'
# Redis 会话
pip install 'openai-agents[redis]'
Python 3.10+。环境变量 OPENAI_API_KEY。
更多使用示例
from agents import Agent, Runner
agent = Agent(
name="Assistant",
instructions="你是一个 helpful assistant",
model="gpt-4o"
)
result = Runner.run_sync(agent, "你好")
print(result.final_output)