OpenAI Agents SDK 和 LangChain 哪个更适合构建多智能体工作流？

OpenAI Agents SDK 是一个专为构建复杂多智能体工作流而设计的轻量级且功能强大的框架。其突出特点是提供商无关性，原生支持 OpenAI Responses 和 Chat Completions API，同时兼容超过 100 种其他大型语言模型。

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

核心概念

1. 智能体 (Agents)

配置了指令、工具、护栏和交接机制的大型语言模型。

2. 沙盒智能体 (Sandbox Agents)

预配置为在容器环境中工作，以执行长时间任务的智能体。

3. 智能体即工具 / 任务交接 (Agents as Tools / Handoffs)

将特定任务委托给其他智能体。

4. 工具 (Tools)

多种工具使智能体能够执行操作（函数、MCP、托管工具）。

5. 护栏 (Guardrails)

用于输入和输出验证的可配置安全检查。

6. 人在回路 (Human in the loop)

在智能体运行过程中引入人工干预的内置机制。

7. 会话 (Sessions)

跨智能体运行的自动对话历史管理。

8. 追踪 (Tracing)

内置的智能体运行追踪功能，允许您查看、调试和优化工作流。

9. 实时智能体 (Realtime Agents)

使用 gpt-realtime-1.5 和完整的智能体功能构建强大的语音智能体。

快速开始

环境准备与安装

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

使用 venv (推荐)

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

使用 uv (更快的包管理器)

如果您熟悉 uv，安装过程会更加简便：

uv init
uv add openai-agents

可选功能安装

运行您的第一个沙盒智能体

沙盒智能体 是 0.14.0 版本的新功能。沙盒智能体是一种使用计算机环境在您配置和控制的文件系统中执行实际工作的智能体。当智能体需要检查文件、运行命令、应用补丁或在较长时间任务中保持工作区状态时，沙盒智能体非常有用。

以下是一个简单的示例，展示如何创建一个沙盒智能体来检查 Git 仓库：

from agents import Runner
from agents.run import RunConfig
from agents.sandbox import Manifest, SandboxAgent, SandboxRunConfig
from agents.sandbox.entries import GitRepo
from agents.sandbox.sandboxes import UnixLocalSandboxClient

agent = SandboxAgent(
    name="Workspace Assistant",
    instructions="Inspect the sandbox workspace before answering.",
    default_manifest=Manifest(
        entries={
            "repo": GitRepo(repo="openai/openai-agents-python", ref="main"),
        }
    ),
)

result = Runner.run_sync(
    agent,
    "Inspect the repo README and summarize what this project does.",
    # Run this agent on the local filesystem
    run_config=RunConfig(sandbox=SandboxRunConfig(client=UnixLocalSandboxClient())),
)
print(result.final_output)

# This project provides a Python SDK for building multi-agent workflows.

[!IMPORTANT]
运行此代码前，请确保已设置 OPENAI_API_KEY 环境变量。

[!TIP]
Jupyter notebook 用户可参考 hello_world_jupyter.ipynb 示例。

项目依赖与致谢

核心开源依赖

我们感谢开源社区的卓越贡献，特别是：

可选依赖

本库包含以下可选依赖：

开发与构建工具

我们还依赖以下工具来管理项目：

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

下一步

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

常见问题（FAQ）

OpenAI Agents SDK 主要能用来做什么？

它是一个轻量级、提供商无关的 Python 框架，专门用于构建具有沙盒代理、工具、护栏和实时语音支持等功能的多智能体工作流。

沙盒智能体有什么特别之处？

沙盒智能体是预配置在容器环境中工作的智能体，能够执行长时间任务，例如检查文件、运行命令或应用补丁，非常适合需要保持工作区状态的操作。

如何为我的智能体工作流添加安全检查？

框架内置了“护栏”功能，提供可配置的输入和输出验证安全检查，确保智能体交互符合预设的安全和合规要求。