OpenAI Agents SDK教程：29.7k星官方多Agent框架，轻量强大支持100+LLM

📌 项目：openai/openai-agents-python | 星数：29.7k（2026-09-24） | 协议：MIT | 语言：Python | GitHub

一句话定位："OpenAI官方出品的轻量多Agent框架——provider-agnostic，支持100+LLM，从Agent到生产只需几行代码。" OpenAI Agents SDK提供Agent、Tool、Handoff、Guardrail等核心原语，支持OpenAI Responses和Chat Completions API以及100+其他LLM，是构建多Agent工作流的官方标准方案。

🧩 核心概念

OpenAI Agents SDK围绕9个核心概念构建：

• Agents：配置了指令、工具、Guardrail和Handoff的LLM实例
• Sandbox agents：预配置容器，在长时间范围内执行任务
• Realtime agents：基于gpt-realtime-2.1的语音Agent
• Voice agents：STT→Agent工作流→TTS的语音管道
• Agents as Tools / Handoffs：Agent作为工具被调用，或将控制权交接给另一个Agent
• Tools：函数工具、MCP工具、托管工具
• Guardrails：输入输出安全校验
• Human in the loop：内置人工介入机制
• Sessions：跨轮次会话管理

和 Agent技能工程化 的技能视角不同，OpenAI Agents SDK从Agent编排视角出发，强调Handoff和Guardrail。

🚀 快速开始

pip install openai-agents

from agents import Agent, Runner

# 定义Agent
agent = Agent(
    name="助手",
    instructions="你是一个有帮助的AI助手",
    tools=[my_function_tool]
)

# 运行
result = Runner.run_sync(agent, "帮我查一下天气")
print(result.final_output)

多Agent Handoff示例：

from agents import Agent, Runner

triage = Agent(name="分诊", instructions="根据问题类型交接给对应Agent")
router = Agent(name="路由", handoffs=[triage])

result = Runner.run_sync(router, "我要写代码")
# router会handoff给triage处理

🛡️ Guardrail与安全

Guardrail是OpenAI Agents SDK的特色——在Agent执行前后做安全校验：

from agents import Agent, GuardrailFunctionOutput, input_guardrail

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

agent = Agent(
    name="安全助手",
    instructions="...",
    input_guardrails=[check_toxicity]
)

当tripwire_triggered=True时，Agent执行立即中止。

⚖️ 优缺点