← 返回學習路線
案例 · 已發布

實戰:可稽核的工單分流 Agent

用唯讀查詢和結構化輸出完成工單分類,遇到證據不足時轉交人工。

來源: knowledge/p24-b/collection_8023a8d754046b6c2ae7220f/cases/agent-support-ticket-triage.mdAI Agent 工程實踐
本章閱讀進度 0%學習路線進度 0% · 0/10 已完成章節繼續學習路線 →

問題與邊界

客服團隊需要把新工單分成產品、帳單和安全類別,並給出優先級。系統不能自動修改客戶資料;證據不足時必須轉交人工。

方案

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)))

重現步驟

  1. 準備脫敏工單樣本和政策片段,標註預期類別與必須轉交人工的情況。
  2. 實作唯讀工具,並為每次執行設定具冪等性的 run_id。
  3. 先校驗結構化結果,再寫入待審核佇列。
  4. 用軌跡斷言沒有呼叫寫入工具,抽樣檢查引用的政策 id。

驗證清單

驗證空工單、未知類別、工具逾時、重複 run_id,以及安全類別轉交人工。記錄事件,但不要保存完整客戶正文。

常見問題

可以自動關閉工單嗎? 本案例不允許。關閉屬於副作用,需要獨立授權和人工確認。

如何回放失敗執行? 使用 run_id 讀取事件摘要,在隔離環境中回放。

官方參考

OpenAI Agents 指南;OpenAI Structured Outputs。

最後核對日期:2026-11-16。介面和安全邊界以連結中的官方資料為準;本文不虛構效能或費用結論。

前置知識與教學

知識Agent 可觀測性與成本控制知識Agent 生產發布:灰度、回滾與人工接管

延伸閱讀

知識AI 自動化工作流程設計與實踐知識AI Agent:從基礎概念到實際應用知識結構化輸出與工具契約:讓 Agent 動作可驗證
產品中心 Demo · V0.3