OpenAI Agents SDK

OpenAI Agents SDK 是一个轻量级但功能强大的框架，用于构建多智能体工作流。它不依赖于特定供应商，支持 OpenAI 的 Responses 和 Chat Completions API，以及 100 多种其他大语言模型。

[!NOTE]
正在寻找 JavaScript/TypeScript 版本？请查看 Agents SDK JS/TS。

核心概念：

1. 智能体：配置了指令、工具、防护栏和交接的 LLM。
2. 智能体即工具 / 交接：将特定任务委托给其他智能体。
3. 工具：多种工具让智能体能够执行操作（函数、MCP、托管工具）。
4. 防护栏：可配置的安全检查，用于输入和输出验证。
5. 人在回路：内置机制，可在智能体运行过程中引入人工参与。
6. 会话：跨智能体运行的自动对话历史管理。
7. 追踪：内置的智能体运行追踪功能，允许您查看、调试和优化工作流。
8. 实时智能体：构建功能齐全的强大语音智能体。

查看 examples 目录以了解 SDK 的实际应用，并阅读我们的 文档 获取更多详细信息。

开始使用

首先，设置您的 Python 环境（需要 Python 3.10 或更高版本），然后安装 OpenAI Agents SDK 包。

venv

python -m venv .venv
source .venv/bin/activate  # Windows 系统: .venv\Scripts\activate
pip install openai-agents

如需语音支持，请安装可选的 voice 组件：pip install 'openai-agents[voice]'。如需 Redis 会话支持，请安装可选的 redis 组件：pip install 'openai-agents[redis]'。

uv

如果您熟悉 uv，安装包会更简单：

uv init
uv add openai-agents

如需语音支持，请安装可选的 voice 组件：uv add 'openai-agents[voice]'。如需 Redis 会话支持，请安装可选的 redis 组件：uv add 'openai-agents[redis]'。

运行您的第一个智能体

from agents import Agent, Runner

agent = Agent(name="Assistant", instructions="You are a helpful assistant")

result = Runner.run_sync(agent, "Write a haiku about recursion in programming.")
print(result.final_output)

# Code within the code,
# Functions calling themselves,
# Infinite loop's dance.

（运行此代码前，请确保已设置 OPENAI_API_KEY 环境变量）

（Jupyter notebook 用户，请参阅 hello_world_jupyter.ipynb）

查看 examples 目录以了解 SDK 的实际应用，并阅读我们的 文档 获取更多详细信息。

致谢

我们要感谢开源社区的杰出工作，特别是：

• Pydantic（数据验证）和 PydanticAI（高级智能体框架）
• LiteLLM（为 100+ LLM 提供统一接口）
• MkDocs
• Griffe
• uv 和 ruff

我们致力于继续将 Agents SDK 构建为一个开源框架，以便社区中的其他人能够基于我们的方法进行扩展。