OpenAI Agents SDK 是一个轻量级且功能强大的Python多智能体工作流构建框架。这是OpenAI官方发布的生产级智能体开发工具,是对之前实验性项目Swarm的升级版本。该框架设计简洁但功能完备,专门用于构建复杂的多智能体AI应用。
# 创建Python虚拟环境
python -m venv env
source env/bin/activate
# 安装基础版本
pip install openai-agents
# 安装包含语音支持的版本
pip install 'openai-agents[voice]'
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)
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())
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="Weather Assistant",
instructions="You are a helpful weather 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())
output_type
,当LLM返回匹配类型的内容时结束output_type
,当智能体产生没有工具调用或交接的消息时结束OPENAI_API_KEY
环境变量# 安装uv包管理器
uv --version
# 安装依赖
make sync
# 运行测试
make tests
# 类型检查
make mypy
# 代码规范检查
make lint
OpenAI Agents Python是一个专业级的多智能体开发框架,它将复杂的AI协作变得简单易用。通过其核心的智能体、交接、防护和追踪机制,开发者可以快速构建出功能强大的AI应用系统。无论是简单的单智能体任务还是复杂的多智能体协作场景,这个框架都能提供优雅的解决方案。