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

在您的伺服器上使用主控台

為自行託管的 Claude Managed Agents 伺服器上的主控台設定登入,然後在瀏覽器中建立代理並執行工作階段。

您伺服器上的主控台是一個網頁,由自行託管的 Claude Managed Agents 伺服器在與其 API 相同的位址上提供。您可以在其中建立代理、執行工作階段,以及管理環境、憑證保管庫、記憶體儲存區和技能,無需使用 SDK 或 CLI。

它並非位於 platform.claude.com 的 Claude Console。它只會顯示您伺服器上的內容。

設定登入

管理員只需設定一次登入。若要改為在單一機器上試用主控台,請依照在您的伺服器上試用主控台操作,該方式使用發行版本的模擬登入提供者。

  1. 設定單一登入和終端機登入

    請依照單一登入操作,包括讓開發人員從終端機登入。主控台會透過您為終端機登入註冊的應用程式讓使用者登入。它會根據簽發者項目中 audiences 的第一個項目檢查每個權杖,因此請將該應用程式的 audience 列在第一位。

  2. 透過 HTTPS 提供主控台

    在連接埠 8400 前方放置一個終止 TLS 的代理伺服器。在伺服器前方加上 TLS 列出了代理伺服器必須執行的工作。若使用純 HTTP,登入僅能在 localhost 或 127.0.0.1 上運作。

  3. 將主控台的位址新增至應用程式

    在您的身分識別提供者中,將您伺服器的 HTTPS 位址新增為該應用程式的第二個重新導向 URI,並加上結尾斜線:https://cma.example.com/。同時允許其來源 https://cma.example.com 進行跨來源(CORS)請求。

若要檢查設定,請開啟主控台並登入。

開啟主控台

如果您的應用程式呼叫 https://cma.example.com,請在瀏覽器中開啟 https://cma.example.com/,然後點選 Continue with SSO。

您會透過您的身分識別提供者登入。主控台不接受伺服器 API 金鑰。如果主控台顯示此伺服器尚未設定登入,則需要由管理員設定登入。

從主控台執行代理

空白代理的內建工具(例如 bash)會在 worker 上執行,因此請選取有 worker 正在輪詢的環境。各元件的執行位置說明了 worker 是什麼。若沒有 worker,第一個工具呼叫會等待直到有 worker 執行它。環境由管理員建立,管理員可以在環境的 Workers 分頁上查看其 worker。

  1. 建立代理

    在側邊欄中選取 Agents,然後點選 Create agent。選取一個起點,例如 Blank agent,然後輸入名稱。

    點選 Create agent。代理的頁面隨即開啟。

  2. 啟動工作階段

    在代理的頁面上,點選 Start session。選取一個環境,然後點選 Create session。工作階段的頁面隨即開啟。

  3. 傳送訊息

    在頁面底部的方塊中輸入訊息,然後傳送。頁面會隨著代理的運作而更新。如果工具呼叫等待您處理,其卡片會顯示 Approve 和 Deny。

當工具呼叫等待您處理時,工作階段的標記會顯示 Idle。

若要開啟任何其他工作階段,例如應用程式透過 API 啟動的工作階段,請在側邊欄中選取 Sessions,然後選取該工作階段。

誰可以看到什麼

您的角色決定主控台顯示的內容,與 API 中的情況相同:

  • 管理員可以查看並變更伺服器上的所有內容。
  • 具有 developer 或 user 角色的使用者可以看到所有環境。在代理、工作階段、保管庫、記憶體儲存區和技能中,他們只能看到以自己的登入身分建立的項目。

使用伺服器 API 金鑰建立的代理或工作階段(例如快速入門中的代理或工作階段)僅對管理員顯示。如需完整表格,請參閱各角色可執行的操作。

關閉主控台

伺服器預設會提供主控台。若要關閉,請在設定檔中設定 console.serve: false,然後重新啟動伺服器。伺服器隨後會停止提供主控台。代理和工作階段仍可透過 API 繼續運作。

後續步驟

這個頁面有幫助嗎?