Claude Platform Docs
Managed Agents自行託管的 Managed Agents

自行託管的 Claude Managed Agents

在您自己的基礎架構上託管 Claude Managed Agents 服務及其沙箱。了解各部分由誰託管、何時該選擇此選項,以及從何處開始。

自行託管的 Claude Managed Agents 是在您自己的基礎架構上執行的 Managed Agents,該基礎架構可以是雲端帳戶或地端資料中心。您負責託管服務與沙箱。模型則在 Anthropic 或您所選擇的供應商上執行。

Managed Agents 有兩個您可以託管的部分:

  • 沙箱:代理工具執行指令與處理檔案的容器、VM 或其他隔離的工作空間。請參閱自行託管的沙箱。
  • 服務:API、代理迴圈,以及代理、工作階段與工作階段歷程記錄的儲存。

自行託管的沙箱會將第一個部分移交給您。自行託管的 Managed Agents 延伸了這一點:服務也由您託管。每個選項的名稱都說明了您託管的內容:

選項沙箱服務模型
雲端沙箱(預設)AnthropicAnthropicAnthropic
自行託管的沙箱您AnthropicAnthropic
自行託管的 Managed Agents您您Anthropic,或您所選擇的供應商

在這些頁面中,「託管服務」指的是由 Anthropic 執行的服務,而「您的伺服器」指的是由您執行、並具有自己資料庫的服務。兩者具有相同的 API,因此 SDK 和 ant CLI 都能與您的伺服器搭配使用,其餘的 Managed Agents 文件也同樣適用。與託管服務的差異列出了例外情況。

初次使用 Claude Managed Agents?

Claude Managed Agents 會將 Claude 作為自主代理執行:您定義一個代理、啟動一個工作階段,並在代理工作時與其交換事件。核心概念說明了代理、環境、工作階段與事件。您不需要先使用託管服務。

何時該選擇自行託管的 Managed Agents

當您需要下列其中一項時,請選擇自行託管的 Managed Agents:

  • 儲存在您的基礎架構上:您必須自行儲存代理、工作階段與工作階段歷程記錄。
  • 自行選擇推論供應商:模型呼叫必須傳送至 Amazon Bedrock、Claude Models on Google Cloud (Google managed)、Microsoft Foundry,或您自己的模型閘道。請參閱推論提供者。

如果您只需要在自己的基礎架構上執行工具,請使用自行託管的沙箱,此時服務由 Anthropic 執行。請參閱選擇代理環境。

使用自行託管的 Managed Agents 時,您需要執行並保護伺服器、其資料庫以及您的沙箱,而且每個版本都需由您自行安裝。部分功能僅存在於託管服務中,因此請在決定之前先查看與託管服務的差異。

各元件的執行位置

一或多個伺服器、其資料庫以及您的沙箱構成一個部署。

  • 伺服器(cma-server):提供 API、執行代理迴圈,並儲存代理、工作階段以及每個工作階段的歷程記錄。每當代理需要模型時,它會呼叫您的推論供應商。伺服器永遠不會執行代理的 shell 或檔案工具。
  • 資料庫:PostgreSQL 16 或更新版本。若沒有資料庫,伺服器會將資料保存在記憶體中,重新啟動後資料便會清除。
  • Worker:從伺服器取得工作,並在您的沙箱中執行代理的 shell 與檔案工具的程式。Worker 是一個 ant beta:worker 指令或一個 SDK worker。
  • 您的應用程式:您自己的程式碼與指令碼,透過 SDK 或 ant CLI 連線至伺服器。
  • 您伺服器上的主控台:位於伺服器位址的網頁,使用者透過您的身分識別提供者登入,即可建立代理並執行工作階段。請參閱在您的伺服器上使用主控台。
  • 管理 CLI(cma-server-admin):建立環境及其環境金鑰。它可在 Linux(x86-64 與 Arm)以及搭載 Apple silicon 的 macOS 上執行。

您的安全責任

自行託管沙箱的安全模型同樣適用於此處,但有兩項差異。該頁面指派給 Anthropic 的職責改由您負責,包括保護伺服器、託管記憶體儲存區,以及偵測異常使用。該頁面也建議為每個信任邊界使用個別的工作區與環境。在此處,每個信任層級都需要各自的部署,如多租戶所述。

三種憑證

憑證持有者驗證對象
伺服器 API 金鑰您的應用程式、ant CLI 與管理 CLI傳送至您伺服器的請求。設定過程會產生此金鑰。它扮演的角色等同於 Claude API 金鑰在託管服務中的角色。
推論憑證伺服器伺服器對您推論供應商發出的模型呼叫。例如,它可以是 Claude API 金鑰、您雲端供應商的憑證,或您模型閘道所接受的權杖。應用程式與 worker 不需要它。
環境金鑰您向伺服器輪詢工作的 worker單一環境的工作佇列以及該環境的工作階段。

哪些資料會離開您的網路

每次進行模型呼叫時,伺服器都會將目前為止的對話(包括工具輸入與工具結果)傳送至您的推論供應商。預設情況下,該供應商是 Claude API。對 Claude API 的呼叫也會帶有其工作階段的 ID,以及該工作階段的代理與環境的 ID。自行託管的 Claude Managed Agents 中的資料與存取列出了伺服器建立的每一個連線。該頁面也說明了記錄檔的去向,以及誰能連線至伺服器。

從何處開始

若要申請下載存取權,請聯絡您的 Anthropic 客戶團隊。接著依照開始使用自行託管的 Claude Managed Agents啟動伺服器並執行第一個工作階段。

每個版本的封存檔都包含該版本的操作人員指南 operator-guide.md。請讓 Claude 閱讀該檔案,如此 Claude 便能協助您設定並執行伺服器,以及撰寫連線至伺服器的程式碼。

這個頁面有幫助嗎?