設定 Inference hooks

Inference hooks 會將您組織的提示傳送至您選擇的 AI 安全伺服器，並在 Claude 處理每個請求之前，等待允許或拒絕的裁決。本頁面將逐步說明如何開啟此功能、連接您的伺服器，以及控制強制執行。如需了解 Inference hooks 是什麼以及何時使用，請參閱 Inference hooks 概述。如需建置 AI 安全伺服器本身，請參閱開發 Inference hooks 整合。



開始之前

您需要：

• 在 claude.ai 中擁有 organization:manage 權限。內建的 Admin、Owner 和 Primary owner 角色擁有此權限，任何被授予此權限的自訂角色也同樣擁有。
• 一個接受裁決請求的 AI 安全伺服器 HTTPS 端點：一個位於連接埠 443 的 https:// URL，位於可公開路由的主機上，且無需重新導向即可存取。如需完整的託管需求，以及如何建置伺服器和驗證已簽署的請求，請參閱開發 Inference hooks 整合。



設定 Inference hooks

共有三種強制執行狀態：關閉（Enforce verdicts 關閉：永遠不會聯繫您的 AI 安全伺服器，且不會檢查提示）、影子模式（Enforce verdicts 開啟且 Mode 設為 Shadow mode：您的 AI 安全伺服器會接收提示並回傳裁決，但不會封鎖任何內容），以及強制執行（Enforce verdicts 開啟且 Mode 設為 Allow the request 或 Block the request：拒絕裁決會封鎖請求）。以下步驟將引導您將新設定從關閉狀態轉為強制執行狀態。



影子模式

「Shadow mode」（影子模式）會針對實際流量執行您的 hook，但不會封鎖任何內容。您的 AI 安全伺服器會接收受管控的提示並回傳裁決，與強制執行時完全相同，但不會封鎖任何內容：每個請求都會繼續傳送至模型，即使您的伺服器拒絕該請求或無法連線，終端使用者也不會察覺任何異狀。請使用此模式，在開始強制執行之前，針對您組織的實際流量調整您的政策。

若要使用影子模式，請在 Failure handling 下將 Mode 設為 Shadow mode，然後開啟 Enforce verdicts 以讓提示流向您的 AI 安全伺服器。當影子模式啟用時，設定頁面會顯示 Shadow mode — not blocking 標記。若要離開影子模式，請將 Mode 設回 Allow the request 或 Block the request；一旦強制執行開啟，裁決就會再次被強制執行。



排除項目

在 Exclusions 下，選擇其成員不受 Inference hooks 管控的角色：他們的提示永遠不會傳送至您的 AI 安全伺服器。只有您組織建立的自訂角色可以被排除；內建角色不會出現在選項中。請在角色選擇器中挑選（其預留文字顯示為 Select roles to exclude），並從角色管理頁面（Manage roles）管理每個角色的成員；變更排除項目需要身分管理權限。此清單預設為空，若未排除任何角色，則每個受管控的請求都會被檢查。

排除適用於使用者的互動式工作階段；透過機器憑證驗證的流量一律會被檢查。如果 Claude 無法解析請求者的角色成員資格，該請求會以可重試的錯誤失敗並封鎖，而非在未經檢查的情況下繼續進行。排除清單的變更會記錄在稽核軌跡中。



自訂封鎖提示訊息

在 Custom blocked prompt message 下，設定最多 500 個字元的自訂文字，當您的 AI 安全伺服器拒絕請求時，此文字會附加至終端使用者看到的錯誤訊息（通常是聯絡對象或申請例外的位置）。最終訊息會是您的 AI 安全伺服器針對該請求的 deny_reason（若有）、一個空白行，然後是此文字。若未設定自訂文字，內建的預設訊息會引導使用者聯絡其管理員；您也可以完全關閉附加訊息，讓使用者僅看到 deny_reason。



監控您的 AI 安全伺服器

Inference hooks 設定頁面的端點健康狀態區域會顯示：

• Endpoint status： Healthy、Tripped、Not enforcing，或在儲存端點之前顯示 Not configured。
• Failures per minute： 過去兩分鐘內的 webhook 失敗次數平均值。
• Block rate： 拒絕裁決佔您的 AI 安全伺服器裁決總數的比例，在推出百分比低於 100 時顯示。
• Circuit breaker tripped： 斷路器上次觸發的時間（若曾觸發）。
• Recent errors： 每個項目簡化為時間戳記、錯誤類型和一行原因。項目絕不包含請求內容或您的端點 URL。

此面板為盡力而為：如果 Anthropic 無法讀取計數器，它會顯示零失敗且無錯誤，而非顯示自身的錯誤，因此看起來健康的面板本身並不能證明您的 AI 安全伺服器是健康的。Failures per minute 會計算每次失敗，包括永遠不會觸發斷路器的網路和 DNS 錯誤，因此即使 Circuit breaker tripped 保持空白，此數值仍可能很高。



斷路器

可歸因於您的 AI 安全伺服器的持續 webhook 失敗會觸發「circuit breaker」（斷路器），進而停止強制執行：您的伺服器不再被聯繫，且您的 Failure handling 選擇會套用至每個受檢查的請求。若選擇 Block the request，您組織中的使用者會被封鎖，直到您採取行動。當斷路器觸發時，管理員也會在 claude.ai 通知中心收到通知。

若要恢復，請修復伺服器，然後重新開啟 Enforce verdicts 以重設斷路器。



輪替您的簽章密鑰

點擊 Request signing 下的 Rotate secret 以替換您的簽章密鑰。輪替是立即切換：新密鑰會產生並僅顯示一次，舊密鑰無法再取得，且沒有任何請求會同時以兩個密鑰簽署，因此沒有可依賴的重疊期間。

輪替後，以先前密鑰簽署的請求仍可能短暫地送達；驗證簽章說明了您的 AI 安全伺服器應如何處理此切換。



稽核軌跡

Inference hooks 活動會記錄在您組織的 Activity Feed 中：設定變更、拒絕裁決，以及在您的失敗處理設定下未經檢查而繼續進行的請求。拒絕記錄帶有識別碼，讓您可以將每個拒絕與您自己系統中的對應記錄進行比對。



關閉 Inference hooks

有兩個層級的關閉：

• 在 Inference hooks 設定頁面上關閉 Enforce verdicts：約一分鐘內，您組織的提示會停止傳送至您的 AI 安全伺服器；已在處理中的請求會依舊設定完成。設定頁面仍可使用，因此當您在處理 AI 安全伺服器時，可使用此方式暫停強制執行。
• 在 Data and privacy 設定中關閉 Allow for your organization：提示不再被檢查，且 Inference hooks 設定會變為無法使用，直到您重新開啟。無論哪種方式，您的端點設定、自訂標頭和簽章密鑰都會被保留；重新開啟會強制將 Enforce verdicts 設為關閉，因此當您準備好時，請再次開啟強制執行。



後續步驟