---
title: 推論掛鉤
url: https://platform.claude.com/docs/zh-TW/manage-claude/inference-hooks
description: 在推論進行之前，將每個受管控的提示傳送至您組織的 AI 安全伺服器，以取得允許或拒絕的裁決。
---
「Inference hooks」（推論掛鉤）目前為 beta 版，僅提供給 Claude Enterprise 組織使用。設定推論掛鉤需要 claude.ai 中的 `organization:manage` 權限，而只有擁有者（Owner）和主要擁有者（Primary owner）角色具備此權限；請參閱[設定推論掛鉤](https://platform.claude.com/docs/zh-TW/manage-claude/inference-hooks-configuration)。
推論掛鉤讓 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](https://www.standardwebhooks.com/) 規範進行簽署，讓您的伺服器能夠驗證該請求確實來自 Anthropic。
3. 您的 AI 安全伺服器評估內容，並在您組織所設定的裁決逾時時間內（預設為 5 秒）回應裁決。
4. 若為 `allow`，推論正常進行。若為 `deny`，請求會被拒絕，使用者會看到一則由兩部分組成的「已被政策封鎖」訊息：首先是您的 AI 安全伺服器在裁決的 `deny_reason` 欄位中提供的個別請求原因，接著是您的管理員所設定的常設訊息（例如應聯絡誰，或在何處申請例外）。若您的管理員尚未設定，內建的預設訊息會引導使用者聯絡管理員。每次拒絕也會記錄在您組織的[活動摘要](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed)中。
下圖追蹤一個範例（一個 Cowork 請求，其中 Claude 也呼叫了 O365 工具），以說明流程中哪些部分會被掛鉤。被掛鉤的點是圖中的步驟 1、2 和 3，分別是提示抵達、Claude 呼叫工具，以及工具結果返回之處。在每個點上，您的 AI 安全伺服器都會在流程繼續之前回傳裁決。步驟 2 只有在開啟 **Validate tool calls** 時才會被掛鉤，且其單一裁決涵蓋回應中的所有工具呼叫。
裁決是一個小型 JSON 物件：`{"action": "allow"}` 讓請求繼續進行，而拒絕則會附帶面向使用者的原因。完整的裁決結構描述請參閱[回傳裁決](https://platform.claude.com/docs/zh-TW/manage-claude/inference-hooks-endpoint#return-a-verdict)。
您的 AI 安全伺服器看到的內容與使用者看到的相同：逐字稿文字、工具呼叫及其結果，以及從附件中擷取的文字。它永遠不會收到原始檔案或影像位元組、系統提示，或 Anthropic 內部的上下文。
推論掛鉤系統不會保留提示或回應內容的副本。它只會儲存您的掛鉤設定，以及有關掛鉤活動的中繼資料，例如裁決、時間戳記與請求識別碼。無論是否啟用掛鉤，您所使用的 Claude 產品都會依照其自身的資料保留規則儲存提示與回應。例如，在 claude.ai 上被掛鉤封鎖的訊息仍會保留在對話中。
如果您的 AI 安全伺服器無法連線、回傳錯誤，或未在逾時時間內回應，則由您組織的失敗處理設定決定結果：封鎖請求，或允許請求在未經檢查的情況下繼續進行。若持續發生可歸因於您伺服器的失敗，將會觸發「circuit breaker」（斷路器）：Anthropic 會停止聯絡您的伺服器，並對每個請求套用您的失敗處理設定；一旦偵測到您的伺服器再次回傳判定，便會自動重設斷路器；請參閱[斷路器](https://platform.claude.com/docs/zh-TW/manage-claude/inference-hooks-configuration#circuit-breaker)。
強制執行可以依您的步調逐步推行，因此沒有人必須在第一天就被封鎖：「shadow mode」（影子模式）會觀察即時流量上的裁決而不封鎖任何內容，推行百分比會檢查所選比例的請求，而排除設定則可完全豁免所選角色的成員。請參閱[設定推論掛鉤](https://platform.claude.com/docs/zh-TW/manage-claude/inference-hooks-configuration)。
完整的請求與回應結構描述、簽章驗證及操作細節，請參閱[開發整合](https://platform.claude.com/docs/zh-TW/manage-claude/inference-hooks-endpoint)。
***
## 在請求遭拒絕後繼續對話
每個請求都包含完整的對話，因此遭拒絕的訊息會隨著之後的每則訊息再次傳送。如果您的 AI 安全伺服器評估的是完整的對話逐字稿，它也會拒絕這些請求。若要繼續，使用者必須從應用程式接下來要傳送的內容中移除遭拒絕的內容，包括 Claude 會再次讀取的任何檔案。
具體步驟取決於應用程式：
* **claude.ai，包括 Claude Desktop 和行動應用程式。** 使用者應編輯遭拒絕的訊息或更早的訊息，而不是將修正後的副本作為新訊息傳送。在網頁版和 Claude Desktop 中，除非使用者移除附件，否則編輯會重新傳送該訊息的附件。開啟新的聊天也可以。
* **Claude Code。** 使用者執行 `/rewind`，並選取最初帶入該內容的提示。如果系統詢問，使用者應選取 **Restore conversation**，然後編輯或清除回到輸入欄位的提示。`/clear` 則會重新開始。請參閱[檢查點](https://code.claude.com/docs/zh-TW/checkpointing)。
* **Cowork。** 如果遭拒絕的訊息是使用者最新的一則訊息，使用者可以編輯它。編輯會重新傳送附加的檔案，而 **Restart from here** 會原封不動地重新傳送整則訊息。如果該內容位於檔案或更早的訊息中，使用者應選取 **New task**。
* **Claude Tag。** 在 Slack 中，使用者首先編輯遭拒絕的訊息；如果該訊息是回覆，則改為將其刪除。接著在 Claude 原本回答的位置單獨傳送 `@Claude !restart`：也就是在該討論串中，或在頻道的最上層。新的工作階段會重新讀取仍保留在 Slack 中的訊息，因此必須先完成編輯或刪除。請參閱 [`!restart` 指令](https://claude.com/docs/claude-tag/users/commands#restart-a-stuck-or-wrong-context-session)。
***
## 使用案例
* **資料外洩防護（DLP）。** 將逐字稿轉送至您的 DLP 掃描器，並拒絕含有受管制或機密資料的提示。這是最常見的部署方式。
* **即時逐字稿封存。** 在每份逐字稿到達時加以封存並一律回傳 `allow`，作為輪詢 [Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/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](https://claude.com/product/claude-security) 會對您連結的儲存庫執行託管掃描。使用者為修正發現項目而開啟的工作階段，以及 Claude Code 中的 Claude Security 外掛程式，則屬於受管控範圍。
* **Code Review（研究預覽）。** [Code Review](https://code.claude.com/docs/en/code-review) 會對您的 GitHub pull request 執行審查。使用者在 Claude Code 中以 `/code-review` 在本機執行的審查則屬於受管控範圍。
* **智慧報告（beta）。** Anthropic 會進行模型呼叫以建置您組織的[智慧報告](https://support.claude.com/en/articles/16893491-get-started-with-smart-reports)。
***
## 推論掛鉤與 Compliance API 的比較
這兩項功能皆服務於 Claude Enterprise 組織的安全、法務與合規團隊。
| | 推論掛鉤 | Compliance API |
| ---- | ----------------------- | --------------------------------- |
| 作用時機 | 即時，在推論執行之前 | 事後 |
| 功能 | 即時允許或拒絕每個受管控的請求 | 擷取活動、聊天、檔案、專案、工作階段逐字稿與使用者，以供稽核與匯出 |
| 方向 | Anthropic 呼叫您的 AI 安全伺服器 | 您呼叫 Anthropic 的 API |
使用推論掛鉤在請求到達模型之前將其攔下，並使用 [Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api) 在事後稽核所發生的事情。
***
## 本節內容
為您的組織啟用推論掛鉤、設定並測試您的 AI 安全伺服器、選擇失敗處理方式，並強制執行裁決。
建置 AI 安全伺服器所需的請求與裁決結構描述、簽章驗證、操作語意及整合模式。