驾驭AI：OpenAI Agents SDK入门指南

June 04, 2025

实用开源项目

AI Tools Open Source LLMs Multi-Agent Systems

项目描述

OpenAI智能体（Agents）SDK是一个基于Python的框架，专为构建多智能体工作流设计。它不限于特定提供商，既支持OpenAI Responses和Chat Completions API，也支持超过100种其他大型语言模型（LLMs）。该SDK注重轻量化设计，并具备强大的能力来编排多个智能体之间的交互。

智能体追踪UI图片

核心概念： - 智能体（Agents）：配置了特定指令、工具、防护栏和交接（handoffs）能力的LLMs。 - 交接（Handoffs）：一种特殊的工具调用，用于在不同智能体之间转移控制权。 - 防护栏（Guardrails）：可配置的安全检查，用于验证输入和输出。 - 追踪（Tracing）：内置功能，用于跟踪、调试和优化智能体运行。

使用说明

1. 设置Python环境：

python -m venv env
source env/bin/activate

2. 安装智能体SDK：

pip install openai-agents

如需语音支持，请安装带可选语音组的版本：

pip install 'openai-agents[voice]'

3. Hello World示例： 运行一个基本的智能体：

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)

（请确保已设置OPENAI_API_KEY环境变量。）

4. 交接示例： 根据语言演示智能体交接：

from agents import Agent, Runner
import asyncio

spanish_agent = Agent(
    name="Spanish agent",
    instructions="You only speak Spanish.",
)

english_agent = Agent(
    name="English agent",
    instructions="You only speak English",
)

triage_agent = Agent(
    name="Triage agent",
    instructions="Handoff to the appropriate agent based on the language of the request.",
    handoffs=[spanish_agent, english_agent],
)

async def main():
    result = await Runner.run(triage_agent, input="Hola, ¿cómo estás?")
    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())

5. 函数示例： 将自定义函数集成为智能体的工具：

import asyncio
from agents import Agent, Runner, function_tool

@function_tool
def get_weather(city: str) -> str:
    return f"The weather in {city} is sunny."

agent = Agent(
    name="Hello world",
    instructions="You are a helpful agent.",
    tools=[get_weather],
)

async def main():
    result = await Runner.run(agent, input="What's the weather in Tokyo?")
    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())