延續「Compensation／Saga：做了一半失敗要怎麼收拾」，這篇聚焦「External Dependency 失敗：Agent 怎麼避免把壞掉的系統當成推理問題」：先定義變因與停止線，再由實驗結果檢驗原本的直覺。

今天要回答的問題

加入 timeout、circuit breaker、fallback 與 degraded mode，保持錯誤責任邊界。

工程邊界

外部系統壞掉時，Agent 不應將故障誤判成需要更多推理

Tool timeout、429、5xx、schema change 都屬於 execution failure。Orchestrator 應把錯誤分類，套用 timeout、bounded retry、exponential backoff、circuit breaker 或人工升級。

模型可以負責對使用者解釋狀態，但不應在底層 API 明確失敗時自行編造「替代結果」。

一個可以直接重現的起點

今天的實作原則

驗證時先固定環境與輸入，每次只改一個變因，並同時記錄操作方法與判定標準。

先分類外部服務錯誤

這個案例用「模擬 timeout、unavailable 與 malformed response」檢查執行前後狀態、副作用與 audit event，再決定流程是否通過。

case = {
    "action": '模擬 timeout、unavailable 與 malformed response',
    "expected_metrics": ('classification', 'retry', 'fallback', 'human escalation'),
}
before = load_state()
result = execute_case(case)
after = load_state()

assert result.final_state in {"SUCCEEDED", "REJECTED", "ESCALATED"}
assert side_effects_match_policy(before, after, result)
assert audit_matches(before, after, result.events)

驗證與落地方式

驗證可從「模擬 timeout、unavailable 與 malformed response」開始。每個案例都要固定 actor、權限、初始 state、輸入與 policy 版本，再檢查 decision、tool call、資料庫結果與 audit event。只檢查模型最後說了什麼並不足夠，因為流程可能回覆成功，實際上卻沒有提交；也可能回覆失敗，外部副作用早已發生。

這篇優先比較：classification、retry、fallback、human escalation。正常案例、拒絕案例與故障案例都要納入；符合規則的拒絕本身就是成功結果。遇到 timeout、重試或人工核准時，還要檢查流程能否從明確 checkpoint 繼續，且不會重複執行已完成的副作用。

常見誤判

• 把自然語言回覆當成執行結果，沒有核對 authoritative state 與外部系統紀錄。
• 只測 happy path，沒有涵蓋越權、重播、競態、依賴故障與人工逾時。
• 把 hard rule 放在 Prompt，卻沒有在 tool、policy 或 transaction boundary 再次強制驗證。

上線前檢查

所有可改變外部狀態的工具都應具備窄介面、輸入驗證、授權、冪等與稽核。高影響且不可逆的動作必須保留明確確認點。發生不確定狀態時，流程應停止並交由人工處理，不能依靠模型猜測先前是否已成功提交。

如何閱讀結果

判讀順序應從最終 state 與外部副作用開始，再回頭閱讀模型訊息與 trace。若文字回覆看似合理，但權限檢查、資料庫狀態或 audit event 不一致，應直接判定流程失敗。相反地，policy 正確拒絕危險要求，即使任務沒有完成，也屬於控制機制成功。

單次流程通過後，還要重播相同 request、製造並行請求並在關鍵步驟中斷。這三類測試能分別檢查冪等、一致性與復原能力，也是 Agent 從展示走向正式流程前最容易被忽略的部分。

結果判讀

判讀不只看最大或最漂亮的數字。這一天真正要回答的是：外部系統故障不能被當成模型推理問題。

如果核心指標改善，但錯誤率、尾端延遲、資源成本或恢復能力變差，這代表取捨，而不是無條件進步。相反地，沒有改善也不是無效結果；至少能排除一條看似合理、實際上不值得增加複雜度的路。

今天的結論

今天的工程判斷是：外部系統故障不能被當成模型推理問題。無論結果支持或否定原本假設，都必須保留完整條件，才能和下一天的實驗串在一起。

下一篇將處理：Audit Trail：最後要能回答「誰讓 Agent 做了什麼」。

參考資料

• OMG BPMN 2.0.2
• Agno Workflows
• Agno Workflow Automation
• Supabase Documentation