问题与边界
客服团队需要把新工单分成产品、账单和安全类别,并给出优先级。系统不能自动修改客户数据,证据不足时必须转人工。
方案
Agent 只调用 lookup_ticket 和 search_policy 两个只读工具。服务端校验工单 id、角色和工具次数;最终结果写入待审核队列,不直接发送外部消息。
最小实现
from dataclasses import dataclass
@dataclass(frozen=True)
class Triage:
category: str
priority: str
needs_human: bool
def accept(result: dict) -> Triage:
allowed = {'product', 'billing', 'security'}
if result.get('category') not in allowed:
raise ValueError('unknown category')
return Triage(result['category'], result.get('priority', 'normal'), bool(result.get('needs_human', True)))
复现步骤
- 准备脱敏工单样本和政策片段,标注期望类别与必须转人工的情况。
- 实现只读工具并给每次运行设置幂等 run_id。
- 先校验结构化结果,再写入待审核队列。
- 用轨迹断言确保没有写操作工具,抽样检查引用政策 id。
验证清单
验证空工单、未知类别、工具超时、重复 run_id 和安全类别转人工。记录事件但不保存完整客户正文。
常见问题
可以自动关闭工单吗? 本案例不允许,关闭属于副作用,需要独立授权和人工确认。
如何回放失败运行? 使用 run_id 读取事件摘要,在隔离环境重放。
官方参考
OpenAI Agents 指南;OpenAI Structured Outputs。
最后核对日期:2026-11-16。版本、接口和安全边界以链接的官方资料为准;本文不虚构性能或费用结论。
