問題與邊界
客服團隊需要把新工單分成產品、帳單和安全類別,並給出優先級。系統不能自動修改客戶資料;證據不足時必須轉交人工。
方案
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。介面和安全邊界以連結中的官方資料為準;本文不虛構效能或費用結論。
