Claude Platform Docs
管理推論掛鉤

推論掛鉤

在推論進行之前,將每個受管控的提示傳送至您組織的 AI 安全伺服器,以取得允許或拒絕的裁決。

推論掛鉤讓 Claude Enterprise 組織能夠在推論執行之前,將每個受管控的提示路由經過一個「AI security server」(AI 安全伺服器)——由該組織或其安全廠商營運的 HTTPS 服務。當使用者提交提示時,Anthropic 會將對話逐字稿傳送至您的 AI 安全伺服器,並等待允許或拒絕的裁決;被拒絕的請求永遠不會到達模型。安全與合規團隊使用推論掛鉤來即時強制執行資料政策,而開發人員則負責建置評估每個請求的 AI 安全伺服器。

由於掛鉤在 Anthropic 的伺服器上執行——在請求離開用戶端之後、模型執行之前——它會一致地套用於每個受管控的請求,無需在使用者裝置上安裝或部署任何東西。

掛鉤事件有兩種。prompt 會在每個受管控的推論請求開始推論之前觸發一次。tool_call 會在 Claude 的回應包含工具呼叫時、任何工具呼叫執行之前觸發,適用於已開啟 Validate tool calls 的組織。


推論掛鉤的運作方式

  1. 使用者在受管控的介面上提交提示。
  2. Anthropic 向您組織所設定的 AI 安全伺服器端點傳送 HTTPS POST。請求主體包含對話逐字稿,且一旦您的組織產生其簽署密鑰後,每個請求都會依照 Standard Webhooks 規範進行簽署,讓您的伺服器能夠驗證該請求確實來自 Anthropic。
  3. 您的 AI 安全伺服器評估內容,並在您組織所設定的裁決逾時時間內(預設為 5 秒)回應裁決。
  4. 若為 allow,推論正常進行。若為 deny,請求會被拒絕,使用者會看到一則由兩部分組成的「已被政策封鎖」訊息:首先是您的 AI 安全伺服器在裁決的 deny_reason 欄位中提供的個別請求原因,接著是您的管理員所設定的常設訊息(例如應聯絡誰,或在何處申請例外)。若您的管理員尚未設定,內建的預設訊息會引導使用者聯絡管理員。每次拒絕也會記錄在您組織的活動摘要中。

下圖追蹤一個範例(一個 Cowork 請求,其中 Claude 也呼叫了 O365 工具),以說明流程中哪些部分會被掛鉤。被掛鉤的點是圖中的步驟 1、2 和 3,分別是提示抵達、Claude 呼叫工具,以及工具結果返回之處。在每個點上,您的 AI 安全伺服器都會在流程繼續之前回傳裁決。步驟 2 只有在開啟 Validate tool calls 時才會被掛鉤,且其單一裁決涵蓋回應中的所有工具呼叫。

被掛鉤的​流程(醒目標示)
醒目​標示的​流程​會在 Claude 推論​使用​它們​之前,先由您的​安全​伺服器​檢查。
醒目​標示:被掛鉤。傳送至 AI 伺服器​進行​驗證。
灰色:目前未被​掛鉤。
應用​程式 ⁠/ HarnessCowork
Claude 推論
由 Anthropic 託管
MCP 連接器
O365
1
提示
「找出我明天的行事曆」
2工具​呼叫
「查看行事曆」
新功能
需要​工具​呼叫​設定
3
工具​結果
「回傳會議」
4
回應
「明天的行程」

裁決是一個小型 JSON 物件:{"action": "allow"} 讓請求繼續進行,而拒絕則會附帶面向使用者的原因。完整的裁決結構描述請參閱回傳裁決。

您的 AI 安全伺服器看到的內容與使用者看到的相同:逐字稿文字、工具呼叫及其結果,以及從附件中擷取的文字。它永遠不會收到原始檔案或影像位元組、系統提示,或 Anthropic 內部的上下文。

推論掛鉤系統不會保留提示或回應內容的副本。它只會儲存您的掛鉤設定,以及有關掛鉤活動的中繼資料,例如裁決、時間戳記與請求識別碼。無論是否啟用掛鉤,您所使用的 Claude 產品都會依照其自身的資料保留規則儲存提示與回應。例如,在 claude.ai 上被掛鉤封鎖的訊息仍會保留在對話中。

如果您的 AI 安全伺服器無法連線、回傳錯誤,或未在逾時時間內回應,則由您組織的失敗處理設定決定結果:封鎖請求,或允許請求在未經檢查的情況下繼續進行。若持續發生可歸因於您伺服器的失敗,將會觸發「circuit breaker」(斷路器):Anthropic 會停止聯絡您的伺服器,並對每個請求套用您的失敗處理設定;一旦偵測到您的伺服器再次回傳判定,便會自動重設斷路器;請參閱斷路器。

強制執行可以依您的步調逐步推行,因此沒有人必須在第一天就被封鎖:「shadow mode」(影子模式)會觀察即時流量上的裁決而不封鎖任何內容,推行百分比會檢查所選比例的請求,而排除設定則可完全豁免所選角色的成員。請參閱設定推論掛鉤。

完整的請求與回應結構描述、簽章驗證及操作細節,請參閱開發整合。


在請求遭拒絕後繼續對話

每個請求都包含完整的對話,因此遭拒絕的訊息會隨著之後的每則訊息再次傳送。如果您的 AI 安全伺服器評估的是完整的對話逐字稿,它也會拒絕這些請求。若要繼續,使用者必須從應用程式接下來要傳送的內容中移除遭拒絕的內容,包括 Claude 會再次讀取的任何檔案。

具體步驟取決於應用程式:

  • claude.ai,包括 Claude Desktop 和行動應用程式。 使用者應編輯遭拒絕的訊息或更早的訊息,而不是將修正後的副本作為新訊息傳送。在網頁版和 Claude Desktop 中,除非使用者移除附件,否則編輯會重新傳送該訊息的附件。開啟新的聊天也可以。
  • Claude Code。 使用者執行 /rewind,並選取最初帶入該內容的提示。如果系統詢問,使用者應選取 Restore conversation,然後編輯或清除回到輸入欄位的提示。/clear 則會重新開始。請參閱檢查點。
  • Cowork。 如果遭拒絕的訊息是使用者最新的一則訊息,使用者可以編輯它。編輯會重新傳送附加的檔案,而 Restart from here 會原封不動地重新傳送整則訊息。如果該內容位於檔案或更早的訊息中,使用者應選取 New task。
  • Claude Tag。 在 Slack 中,使用者首先編輯遭拒絕的訊息;如果該訊息是回覆,則改為將其刪除。接著在 Claude 原本回答的位置單獨傳送 @Claude !restart:也就是在該討論串中,或在頻道的最上層。新的工作階段會重新讀取仍保留在 Slack 中的訊息,因此必須先完成編輯或刪除。請參閱 !restart 指令。

使用案例

  • 資料外洩防護(DLP)。 將逐字稿轉送至您的 DLP 掃描器,並拒絕含有受管制或機密資料的提示。這是最常見的部署方式。
  • 即時逐字稿封存。 在每份逐字稿到達時加以封存並一律回傳 allow,作為輪詢 Compliance API 的推送式替代方案。
  • 提示遙測。 在使用的當下衡量您的組織如何使用 Claude。
  • 政策引擎。 在推論之前強制執行您自己的規則:模型允許清單、專案範圍的限制,或工作時段控管。

目前的限制

  • 附件以中繼資料與擷取的文字表示。原始檔案與影像位元組永遠不會被傳送,因此純影像內容(例如文件的螢幕截圖)不會受到檢查。
  • 裁決僅有允許或拒絕。不支援重寫或遮蔽提示。
  • 平台組織(透過 Claude Platform 存取 API)不在適用範圍內。

可用性

推論掛鉤提供給 Claude Enterprise 組織使用。設定推論掛鉤需要 organization:manage 權限,而只有擁有者(Owner)和主要擁有者(Primary owner)角色具備此權限。

單一掛鉤即可管控您 Claude Enterprise 組織中 claude.ai、Cowork、Claude Code 和 Claude Tag 工作階段的對話,無論它們是在網頁、桌面或行動應用程式、CLI 還是 Slack 中執行。推論掛鉤不適用於 Amazon Bedrock 或 Google Cloud。

受管控的請求是指使用者對話背後的推論請求。輔助請求不會傳送至您的端點,這些請求包括對話標題產生,以及 Anthropic 在 Claude Tag 將 Claude 的回覆發布到 Slack 之後對該回覆執行的衡量。系統提示和工具定義永遠不會包含在傳送的內容中。在語音模式中,提示和工具呼叫也會傳送至您的端點,但有一小部分工具呼叫不會,因此請勿將推論掛鉤作為語音的唯一控管機制。如果您的端點在語音模式中拒絕請求,語音通話通常會以一般錯誤訊息結束,且不會顯示您的拒絕原因。

開啟 Validate tool calls 時,tool_call 事件可能會略過對 claude.ai 部分自有工具的呼叫,例如列出、搜尋或建議連接器、外掛程式或技能的工具,建議開始研究或開啟網頁搜尋的工具,搜尋其他工具、切換至更大模型、結束聊天、向 Claude 提供使用者的當地時間,或讀取使用者自己過去的聊天和已儲存記憶的工具。這些呼叫及其結果會保留在對話中,因此該對話的下一個 prompt 事件(如果有的話)會包含它們。

Anthropic 為您的組織執行的某些功能會自行進行模型呼叫。您的組織可以看到這些呼叫的結果,但看不到其逐字稿。這些呼叫不屬於受管控的請求,也不會傳送至您的端點。它們包括以下項目:

  • Claude Security 掃描(beta)。 Claude Security 會對您連結的儲存庫執行託管掃描。使用者為修正發現項目而開啟的工作階段,以及 Claude Code 中的 Claude Security 外掛程式,則屬於受管控範圍。
  • Code Review(研究預覽)。 Code Review 會對您的 GitHub pull request 執行審查。使用者在 Claude Code 中以 /code-review 在本機執行的審查則屬於受管控範圍。
  • 智慧報告(beta)。 Anthropic 會進行模型呼叫以建置您組織的智慧報告。

推論掛鉤與 Compliance API 的比較

這兩項功能皆服務於 Claude Enterprise 組織的安全、法務與合規團隊。

推論掛鉤Compliance API
作用時機即時,在推論執行之前事後
功能即時允許或拒絕每個受管控的請求擷取活動、聊天、檔案、專案、工作階段逐字稿與使用者,以供稽核與匯出
方向Anthropic 呼叫您的 AI 安全伺服器您呼叫 Anthropic 的 API

使用推論掛鉤在請求到達模型之前將其攔下,並使用 Compliance API 在事後稽核所發生的事情。


本節內容

為您的組織啟用推論掛鉤、設定並測試您的 AI 安全伺服器、選擇失敗處理方式,並強制執行裁決。

建置 AI 安全伺服器所需的請求與裁決結構描述、簽章驗證、操作語意及整合模式。

Was this page helpful?