這是我在重複預訂貼文 中承諾的診斷追蹤。相同的部署(牙科診所預訂代理、聊天和排程工作),相同的事件,這次的重點是如何記錄日誌,以便下次出現模糊故障時,能在幾分鐘內被發現,而不是由病患發現。
核心規則是:每個工具呼叫只記錄一個結果,且結果集為「成功 (ok) / 失敗 (failed) / 未知 (unknown)」,而不是「成功 / 錯誤 (error)」。逾時不是錯誤,它是呼叫者無法判斷發生了什麼事的唯一狀態;如果你的日誌沒有記錄這種狀態,無論你記錄多少資訊,事件都會保持隱形。
這篇文章探討了 AI 代理的日誌記錄策略,特別是針對「成功、失敗、未知」三種結果,並記錄呼叫者後續的決策。此方法能有效找出模糊的系統故障,例如因逾時導致的重複預訂,將系統回應與代理行為之間的落差轉化為可查詢的事件。透過記錄「未知」狀態與呼叫者的決策,能預防隱性問題並提升系統可靠性。

這是我在重複預訂貼文 中承諾的診斷追蹤。相同的部署(牙科診所預訂代理、聊天和排程工作),相同的事件,這次的重點是如何記錄日誌,以便下次出現模糊故障時,能在幾分鐘內被發現,而不是由病患發現。
核心規則是:每個工具呼叫只記錄一個結果,且結果集為「成功 (ok) / 失敗 (failed) / 未知 (unknown)」,而不是「成功 / 錯誤 (error)」。逾時不是錯誤,它是呼叫者無法判斷發生了什麼事的唯一狀態;如果你的日誌沒有記錄這種狀態,無論你記錄多少資訊,事件都會保持隱形。
對於每個寫入動作,日誌會記錄一行結構化資訊:嘗試 ID 和冪等鍵、結果(成功、失敗或未知),以及呼叫者接下來的動作(確認、升級或重試)。日誌中不包含對話內容或病患資料。你調查的是決策路徑,而不是對話紀錄。
為什麼「接下來的動作 (did next)」欄位很重要?重複預訂的問題並非隱藏在工具呼叫中,而是隱藏在「後端回報逾時」與「代理說你已預訂成功」之間的落差。記錄呼叫者的決策,能將這個落差轉化為可查詢的事件。
修復之後,這類事件只需一個篩選條件:結果 = 未知,決策 = 確認。這種組合不應該存在,如果再次出現,就表示系統發生了退化。
n8n 的實作(簡短版)是:狀態寫入位於子工作流程中,在寫入動作前一步。如果在重試節點內,它會隨著重試而重播,這正是上一篇貼文中的錯誤。未知 (unknown) 不是錯誤分支,它會路由到升級(人工任務),絕不會路由到「失敗時重試」。重試一個未知狀態,正是將一次預訂變成三次預訂的方式。
驗收工作流程會觸發相同的冪等鍵兩次,並斷言只有一次寫入。它會在每次變更時重新執行,到目前為止已捕獲了兩個不相關的退化問題,兩者都發生在其他工作流程中,它們以測試執行失敗的形式浮現,而不是使用者可見的錯誤。
結果是:沒有什麼戲劇性的報告,也沒有新增任何儀表板。每次嘗試一行日誌,三種可能的結果,以及一個應該保持為空的查詢。從那以後,沒有再發生重複預訂。
總結教訓:誠實地記錄你不知道發生了什麼事的狀態,並記錄呼叫者對這些狀態所做的決策。明顯的失敗會自行浮現,而模糊的失敗則需要書面記錄。我很樂意深入探討驗收工作流程,包括它斷言了什麼、刻意忽略了什麼,以及為什麼它能在三次重構後倖存下來。(內部協調保持私密;以上所有內容均可重複使用。)
覺得值得一看?分享給朋友。
以上為 AI 自動翻譯導讀。原文版權歸 n8n Community 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。
43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。