審查與監控代理工作階段
可選擇以離線作業審查每個工作階段的事件。監看需要注意之工作階段的 webhook,並了解 Managed Agents 會保留哪些資料以及保留多久。
可選擇以離線作業審查每個工作階段的事件。監看需要注意之工作階段的 webhook,並刪除您不再需要的工作階段。若要在代理執行前限制其可執行的操作,請參閱保護您的 Managed Agents 部署。
可選擇讓離線審查者閱讀每份對話紀錄
「Offline reviewer」(離線審查者)是您執行的一項作業,與其所審查的工作階段分開,會在每個工作階段的事件寫入後讀取這些事件。長時間的工作階段事件過多,無法由人工閱讀,因此該作業會讓 Claude 來閱讀。審查會標記超出代理所獲授權範圍的行為。如需審查提示、設定步驟和可運作的程式碼,請參閱 Claude Cookbook 中的安全審查範例。
監控工作階段並檢視保留政策
訂閱在工作階段需要注意時通知您的 webhook,並刪除您不再需要的工作階段。請驗證每次傳遞的簽章。請參閱驗證簽章。
| 要監看的項目 | 查看位置 |
|---|---|
| 進入閒置狀態的工作階段,例如等待核准 | session.status_idled webhook。每當工作階段因任何原因進入閒置狀態時都會觸發 |
| 達到預算或終止的工作階段 | session.budget_reached 和 session.status_terminated webhook |
| 無法啟動工作階段的排程執行 | deployment_run.failed 和 deployment.paused webhook |
| 無法重新整理的 MCP OAuth 憑證 | vault_credential.refresh_failed webhook |
| 伺服器拒絕或暫停的工具呼叫 | agent.tool_use 和 agent.mcp_tool_use 事件上的 evaluated_permission。在多代理工作階段中,也請列出每個執行緒的事件 |
| 代理在工作階段中做了什麼 | Claude Console 工作階段檢視器 |
| 超出代理被授予範圍的行為 | 您執行的選用離線審查作業,會讀取每個工作階段的事件。請參閱可選擇讓離線審查者閱讀每份對話紀錄 |
若要查看工作階段進入閒置狀態的原因,請列出其事件,並將 types 設為 session.status_idle、order 設為 desc、limit 設為 1。事件名稱為 session.status_idle,而 webhook 名稱為 session.status_idled。若 stop_reason.type 為 requires_action,表示工作階段正在等待您,而 stop_reason.event_ids 會列出它正在等待的事件。若要回應這些事件,請參閱回應使工作階段暫停的工具呼叫。在自行託管的沙箱中,agent.tool_use 事件可能正在等待您的沙箱傳回工具的結果。在工作流程執行開啟時,工具呼叫可能會在工作階段維持 running 狀態的同時等待您的回應。請在每個呼叫的事件抵達時回應。請參閱執行開啟期間。
webhook 傳遞可能會遺漏,因此也請依排程列出您的工作階段並檢查閒置的工作階段。
請參閱訂閱 webhook 和檢查工作階段並追蹤用量。
此清單顯示 Managed Agents 會保留哪些資料以及保留多久:
- 工作階段歷史記錄: 保留至您刪除該工作階段為止。封存工作階段會保留其歷史記錄。若要保留工作階段的事件,請在刪除之前使用事件 API 將其複製到您自己的日誌中。
running狀態的工作階段無法刪除。請參閱刪除工作階段。 - 沙箱狀態: 自沙箱建立後保留 30 天。
- 工作階段產生的檔案: 隨工作階段一併刪除。請先下載您想保留的檔案。
- 您上傳的檔案、記憶體儲存區和保管庫: 不會隨工作階段一併刪除。請另行刪除。
使用自行託管的沙箱時,您自己基礎架構上的工具輸入與輸出副本由您自行決定保留或刪除。
Managed Agents 目前不符合零資料保留(Zero Data Retention)或 HIPAA 商業夥伴協議(Business Associate Agreement,BAA)涵蓋的資格。請參閱 API 與資料保留。
這個頁面有幫助嗎?