Claude Platform Docs
Managed Agents安全性

審查與監控代理工作階段

可選擇以離線作業審查每個工作階段的事件。監看需要注意之工作階段的 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 與資料保留。

這個頁面有幫助嗎?