問題與邊界
工單 Agent 在外部系統逾時時不能繼續猜測。本案例用記憶體事件列表模擬執行,驗證暫停、證據摘要和人工接管,不呼叫外部服務。
方案
每個事件只保存工具名稱、狀態、耗時和脫敏參數摘要。達到重試預算或出現權限錯誤時寫入 handoff 事件,介面展示下一步,而不是偽造完成。
最小實作
events = []
events.append({'type': 'tool', 'name': 'lookup_ticket', 'status': 'timeout', 'attempt': 2})
events.append({'type': 'handoff', 'reason': 'dependency_timeout', 'next': 'verify manually'})
assert events[-1]['type'] == 'handoff'
assert all('secret' not in event for event in events)
重現步驟
- 建立固定工單輸入和模擬逾時工具,最多允許兩次重試。
- 記錄工具事件和錯誤碼,確認不保存完整使用者正文或憑證。
- 寫入 handoff 事件,在人工介面展示工單 id、失敗原因和建議動作。
- 人工完成後追加 resolution 事件,保留原始失敗軌跡供回歸測試使用。
驗證清單
驗證重試上限、權限錯誤直接接管、證據脫敏,以及重複提交不會建立第二張工單。
常見問題
人工接管是否等於失敗? 它是受控的安全狀態,應和系統錯誤分開統計。
能自動把 handoff 重新交給模型嗎? 只能在人工授權和新預算下重新啟動。
延伸閱讀
官方參考
OpenAI Agents 指南;OWASP LLM Top 10。
最後核對日期:2026-11-17。介面和安全邊界以連結中的官方資料為準;本文不虛構效能或費用結論。
