Hook 執行紀錄

查看每一次 Hook 攔截或改寫的紀錄、控制是否記錄原始訊息內容，以及從對話中追查單筆訊息的 Hook 執行詳情。

Hook 每一次的攔截、改寫、放行都會留下紀錄。對受監管的產業（金融、醫療、政府）來說，「可追溯」本身就是合規要求——出了問題要查得到「哪一則訊息、被哪條規則、做了什麼處置、什麼時間」。

執行紀錄（Audit Log）完整記錄每次處置：命中規則、處置動作、處理結果與時間戳，支援關鍵字搜尋、依助理篩選與匯出報表

一、查看執行紀錄

從左側選單進入 AgentOps →〈Hook 執行紀錄〉。你可以看到每一筆執行的：

• 時間——何時發生

• 助理——哪個 AI 助理觸發的

• 命中規則——是哪一個 Hook 處理的

• 處置——做了什麼（遮罩改寫／攔截封鎖／放行）

• 狀態——處理結果

你可以用日期區間、助理、關鍵字篩選，也能匯出報表做進一步稽核分析。頁面上方也會顯示總執行次數、命中次數、命中率的統計。

執行紀錄列表：每筆顯示 AI 助理、Hook 名稱、觸發點、動作與結果。可看到個資遮罩把手機改成 [REDACTED_PHONE]、敏感詞與提示注入被封鎖等實際處置

查看單筆詳情

點開任一筆紀錄，會顯示這次處置的完整脈絡：基本資訊（Hook 名稱、類型、觸發點、動作、結果）、關聯資訊、訊息內容，讓你清楚知道系統做了什麼。

單筆詳情：以個資遮罩為例，可看到動作為 modify、訊息內容已遮罩為 [REDACTED_PHONE]

二、控制是否記錄原始訊息

執行紀錄預設只記錄「處置結果」，不保留原始的敏感內容——這是為了避免個資或敏感訊息又被留存在紀錄裡。

若你在除錯階段需要看到「原始內容長什麼樣」，可以在 Hook 的設定頁把 記錄遮罩前原始值 開關由 off 改成 on。開啟後，紀錄會額外保留遮罩前／攔截前的原始內容，方便追查。

在 Hook 設定頁的「記錄遮罩前原始值」欄位控制：預設 off（只記型別與次數，不留原始個資），需要除錯時才改成 on

隱私權衡： 開啟「記錄原始值」等於把原始的個資／訊息內容留存在執行紀錄中。基於資安考量，建議平時維持關閉，只在需要排查問題時暫時開啟。

三、從對話中查看 Hook 執行詳情

除了集中式的執行紀錄，你也可以從實際對話回頭追查：進入 客服對話 →〈所有對話〉，開啟任一則對話，就能看到該對話中哪些訊息被 Hook 處理過（遮罩或攔截），對應到當下的處置。

這讓你在檢視客戶對話時，能直接理解「為什麼這則訊息被遮罩／被擋下」，不必另外比對紀錄。

四、相關頁面

• Hook 訊息攔截總覽——Hook 是什麼、五種標準範本

• 新增與設定 Hook——如何建立、設定參數、關聯 AI 助理