OpenAI Agents SDK

# 伪代码：仅展示 Agent 与工具的定义结构
from agents import Agent, function_tool

@function_tool
def query_order(order_id: str) -> str:
    """根据订单号查询订单状态"""
    return f"订单 {order_id} 状态：已发货"

agent = Agent(
    name="客服助手",
    instructions="你是一个电商客服，帮用户查询订单。",
    tools=[query_order],
    model="gpt-4o",
)

# 伪代码：仅展示 Handoff 的声明关系
from agents import Agent

退款专员 = Agent(
    name="退款专员",
    instructions="你专门处理退款申请。核实订单信息后办理退款。",
)

客服前台 = Agent(
    name="客服前台",
    instructions="你是一线客服。简单问题自己回答，退款问题转给退款专员。",
    handoffs=[退款专员],  # 声明可以转交给谁
)

pip install openai-agents

export OPENAI_API_KEY="sk-你的密钥"

import asyncio
from agents import Agent, Runner, function_tool

# 1. 定义工具
@function_tool
def add(a: int, b: int) -> int:
    """将两个整数相加"""
    return a + b

# 2. 创建 Agent
math_agent = Agent(
    name="数学助手",
    instructions="你是一个数学助手，用工具帮用户做计算。",
    tools=[add],
    model="gpt-4o",
)

# 3. 用 Runner 驱动执行
async def main():
    result = await Runner.run(math_agent, "请计算 15 + 27")
    print(result.final_output)

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

应返回包含 42 的答案。

from agents import Agent, Runner

agent = Agent(name="助手", instructions="简洁回答问题。", model="gpt-4o")
result = Runner.run_sync(agent, "Python 之父是谁？")
print(result.final_output)

import asyncio
from agents import Agent, Runner

# 定义两个专业 Agent
billing_agent = Agent(
    name="账单专员",
    instructions="你专门处理账单和付款问题。",
)
tech_agent = Agent(
    name="技术支持",
    instructions="你专门处理技术故障和配置问题。",
)

# 路由 Agent：根据问题类型转交
triage_agent = Agent(
    name="前台客服",
    instructions=(
        "你是一线客服。根据用户问题类型分流：\n"
        "- 账单/付款问题 → 转给账单专员\n"
        "- 技术/故障问题 → 转给技术支持\n"
        "- 其他问题自己回答"
    ),
    handoffs=[billing_agent, tech_agent],
)

async def main():
    result = await Runner.run(triage_agent, "我的服务器报 502 错误怎么办？")
    print(result.final_output)
    print(f"回答来自：{result.last_agent.name}")

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