高级交接

高级交接

演示了包括回调、结构化输入和自定义工具命名在内的高级交接配置。

本演示所展示的内容

• 自定义交接配置：使用handoff()函数
• 回调函数：在交接触发时执行代码
• 结构化输入数据：在交接时传递特定数据
• 工具自定义：自定义工具名称和描述

快速入门

1. 安装 OpenAI Agents SDK：

   pip install openai-agents
   ​

2. 设置环境：

   cp ../env.example .env
   # Edit .env and add your OpenAI API key
   ​

3. 运行代理：

   import asyncio
   from agent import main
   
   # Test advanced handoffs
   asyncio.run(main())
   ​

关键概念

• handoff() 函数：自定义交接配置
• 回调执行：on_handoff 函数用于跟踪
• 结构化输入：用于交接数据的 Pydantic 模型
• 工具覆盖：自定义工具名称和描述

高级功能

带有结构化数据的升级

class EscalationData(BaseModel):
    reason: str
    priority: str
    customer_id: str

escalation_handoff = handoff(
    agent=escalation_agent,
    tool_name_override="escalate_to_manager",
    input_type=EscalationData
)
​

回调函数

async def on_escalation_handoff(ctx, input_data):
    print(f" ESCALATION: {input_data.reason}")
    # Log to monitoring system
    # Send notifications
    # Update tickets
​

自定义工具配置

• tool_name_override：自定义工具名称
• tool_description_override：自定义工具描述
• input_filter：控制哪些上下文会转移
• is_enabled：动态启用/禁用交接

高级模式

升级交接

• 生气的客户场景
• 高价值退款请求
• 复杂的技术问题

回调集成

• 日志记录与监控
• 通知系统
• 指标跟踪

输入过滤

• 上下文清理
• 敏感数据移除
• 对话内容净化

下一步

• 基础交接 - 交接基础知识
• 教程 9：多智能体编排 - 复杂工作流

免责声明：
本文档采用基于机器的 AI 翻译服务进行翻译。尽管我们力求准确，但请注意，自动翻译可能存在错误或不准确之处。应以原文语言版本的文档作为权威依据。如需获取关键信息，建议使用专业的人工翻译。对于因使用本翻译而产生的任何误解或误读，我们概不负责。