設定 Agent Registry

如要在 Agent Registry 中註冊及探索 AI 代理、Model Context Protocol (MCP) 伺服器、獨立技能和端點，您必須在 Google Cloud 專案中啟用 Agent Registry API。Agent Registry 在專案層級運作，可讓您探索及管理已部署在特定專案中的代理、伺服器、技能和端點，並在該專案中啟用 API。

本文說明如何設定 Agent Registry，以及啟用必要的 API。

事前準備

如要設定 Agent Registry，請使用現有專案或建立新專案。

必要的角色

如要取得設定 Agent Registry 所需的權限，請要求管理員在 Google Cloud 專案中授予您下列 IAM 角色：

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

設定 gcloud CLI 環境

如果您打算使用 Google Cloud CLI 進行 Agent Registry，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中啟用 Cloud Shell。

    啟用 Cloud Shell

    Google Cloud 控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。

  2. 確認已安裝最新版 gcloud CLI：

    gcloud components update

啟用 Agent Registry API

控制台

啟用 API 時所需的角色

如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

啟用 API

gcloud

在專案中啟用 Agent Registry API：

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

將 PROJECT_ID 替換為專案 ID。

啟用 Agent Registry API 後，您就可以開始在這項專案中註冊及探索代理。

授予權限

如要查看及管理 Agent Registry 中的資源，必須授予使用者適當的 Identity and Access Management (IAM) 權限。

授予使用者下列一或多個 Agent Registry 角色：

  • Agent Registry API 檢視者 (roles/agentregistry.viewer)：查看及搜尋代理程式、MCP 伺服器、工具、獨立技能、技能修訂版本、發布者、端點和繫結。
  • Agent Registry API 編輯者 (roles/agentregistry.editor)：查看及編輯 Agent Registry 資源，包括註冊、更新及刪除代理、MCP 伺服器、工具、端點、獨立技能和技能修訂版本。
  • Agent Registry API 管理員 (roles/agentregistry.admin)：對 Agent Registry 資源執行所有動作，包括註冊及管理代理、MCP 伺服器、工具、端點、獨立技能、技能修訂版本、繫結和技能 IAM 政策。
  • Agent Registry 使用者 (roles/agentregistry.user)：查看所有 Agent Registry 資源，以及建立、更新及刪除獨立技能和技能修訂版本，但無法編輯代理、MCP 伺服器或端點。

如要瞭解如何在專案中授予 IAM 角色，請參閱「管理專案、資料夾和機構的存取權」。

變更 Agent Registry 專案

如要變更使用 Agent Registry 的專案，並從舊專案中移除依附元件，請在該專案中停用 Agent Registry API。然後在另一個專案中啟用 Agent Registry API。資料不會遷移，您必須在這個新專案中重新建立資源。

停用 Agent Registry API

如果不再需要 Agent Registry，請在專案中停用 Agent Registry API：

控制台

  1. 前往 Google Cloud 控制台的 Agent Registry API 管理頁面：

    前往 Agent Registry API

  2. 在專案挑選器中，選取您設定 Agent Registry 的 Google Cloud 專案。

  3. 點選「停用 API」。

  4. 在確認對話方塊中，點選「停用」。

gcloud

gcloud services disable agentregistry.googleapis.com \
    --project=PROJECT_ID

將 PROJECT_ID 替換為專案 ID。

後續步驟