OpenAI Agents SDK

OpenAI 官方 Agent 开发框架——用 Python 构建生产级多 Agent 系统。

功能介绍

OpenAI Agents SDK 是 OpenAI 于 2026 年 3 月发布的官方 Agent 框架，替代了之前的 Assistants API。它采用轻量级、可组合的设计理念，让开发者用最少的代码构建复杂的多 Agent 协作系统。

核心概念：

• Agent：定义指令、模型、工具和交接行为的自治单元。每个 Agent 有独立的 system prompt 和工具集
• Handoff（交接）：Agent 之间的工作转移机制。当用户需求超出当前 Agent 能力时，自动交接给合适的 Agent
• Guardrails（安全护栏）：输入/输出验证层，在 Agent 处理前拦截恶意或越界请求。分为 Input Guardrail 和 Output Guardrail
• Tracing（追踪）：自动记录 Agent 执行的每一步，包括 LLM 调用、工具执行和 Handoff 决策。支持 OpenAI Dashboard 可视化和自定义导出
• Runner：编排 Agent 执行流程的核心引擎，支持同步和流式两种模式

与其他框架的区别：

• vs CrewAI：Agents SDK 更轻量，没有强制的角色/任务/流程抽象，自由度更高
• vs LangGraph：Agents SDK 是 OpenAI 官方出品，与 GPT 模型深度优化，但模型依赖性更强
• vs AutoGen：Agents SDK 的 Handoff 机制比 AutoGen 的对话模式更结构化

安装步骤

pip install openai-agents

# 设置 API Key
export OPENAI_API_KEY=your-key

使用示例

最简 Agent

from agents import Agent, Runner

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

result = await Runner.run(agent, "Hello!")
print(result.final_output)

多 Agent + Handoff

from agents import Agent, Runner, handoff

triage = Agent(
    name="Triage",
    instructions="Route to the right specialist.",
    handoffs=[
        handoff(research_agent, "For research questions"),
        handoff(coder_agent, "For coding tasks"),
    ]
)

result = await Runner.run(triage, "帮我写一个 Python 排序算法")
# Triage → 自动交接给 coder_agent

Guardrails

from agents import Agent, GuardrailFunctionOutput, input_guardrail

@input_guardrail
async def check_toxicity(ctx, agent, input_data):
    is_toxic = await toxicity_check(input_data)
    return GuardrailFunctionOutput(
        output_info={"toxic": is_toxic},
        tripwire_triggered=is_toxic
    )

agent = Agent(
    name="Safe Assistant",
    instructions="Be helpful.",
    input_guardrails=[check_toxicity]
)

Tracing

from agents import trace

with trace("Research Workflow") as t:
    result = await Runner.run(agent, "Analyze this paper")
    # 自动记录所有 LLM 调用和工具执行
    # 可在 OpenAI Dashboard 查看

提示：Agents SDK 的 Handoff 和 Guardrails 模式可以很好地与 MCP Server 集成——每个 Agent 连接不同的 MCP 工具集，Handoff 实现工具域的自动切换。

GitHub: https://github.com/openai/openai-agents-python (12k+ stars)