OpenAI Agents SDK：多代理工作流开发框架

openai/openai-agents-python 在 GitHub 上已经拿到 26079 Star 了。
OpenAI 开源了这个 Python SDK，用于构建多代理工作流。它支持 OpenAI 官方 API，也兼容其他 100 多种大语言模型。

核心功能

这个 SDK 包含多个核心模块，覆盖多代理开发的主要场景。
Agents 模块支持配置大模型的指令、工具、护栏和任务交接。
Sandbox Agents 模块提供预配置的容器环境，支持代理在隔离环境中执行长时间任务，包括文件操作、命令执行、代码修改等操作。
工具模块支持函数调用、MCP 协议、托管工具等多种工具类型，代理可以通过工具完成实际操作。
护栏模块提供可配置的输入输出校验，确保代理执行符合安全规范。
人在回路模块内置人工介入机制，支持在代理执行过程中引入人工干预。
会话模块自动管理对话历史，跨代理执行过程保留上下文信息。
追踪模块内置执行记录功能，支持查看、调试和优化工作流。
实时代理模块支持基于 gpt-realtime-2 构建语音代理，保留完整的代理功能特性。

安装使用

使用这个 SDK 需要 Python 3.10 或更高版本。
venv 环境安装命令：

python -m venv .venv
source .venv/bin/activate  # Windows 环境执行 .venv\Scripts\activate
pip install openai-agents

需要语音支持可安装可选组件：pip install 'openai-agents[voice]'。需要 Redis 会话支持可安装对应组件：pip install 'openai-agents[redis]'。
使用 uv 安装更便捷：

uv init
uv add openai-agents

同样支持可选组件安装，按需选择即可。

快速上手

沙箱代理是 0.14.0 版本新增的功能，支持代理在可控的计算机环境中执行任务。示例代码如下：

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_config=RunConfig(sandbox=SandboxRunConfig(client=UnixLocalSandboxClient())),
)
print(result.final_output)

运行前需要设置 OPENAI_API_KEY 环境变量。示例执行后会输出项目的功能说明。
项目的 examples 目录包含更多使用示例，官方文档提供完整的功能说明。

适用场景

• 需要构建多代理协作系统的开发者
• 开发 AI 工作流、自动化处理任务的团队
• 搭建语音代理、实时交互系统的场景
• 需要代理执行代码、操作文件的应用开发

开源地址：https://github.com/openai/openai-agents-python

代理执行代码、操作文件的应用开发

开源地址：https://github.com/openai/openai-agents-python