設定 Agent Registry

如要在 Agent Registry 中註冊及探索 AI 代理和 Model Context Protocol (MCP) 伺服器，您必須在 Google Cloud專案中啟用 Agent Registry API。Agent Registry 運作於專案層級，可讓您探索及管理在啟用 API 的特定專案中部署的代理程式。

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

事前準備

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

必要的角色

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

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

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

設定 gcloud CLI 環境

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

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

    啟用 Cloud Shell

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

  2. 安裝 alpha 元件：

    gcloud components install alpha

  3. 確認已安裝最新版 Google Cloud CLI：

    gcloud components update

啟用 Agent Registry API

控制台

啟用 API 時所需的角色

如要啟用 API，您需要服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

啟用 API

gcloud

在專案中啟用 Agent Registry API：

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

將 PROJECT_ID 替換為專案 ID。

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

授予權限

如要查看及管理 Agent Registry 中的服務，您必須授予使用者適當的身分與存取權管理權限。

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

  • Agent Registry API 檢視者 (roles/agentregistry.viewer)：查看代理程式、工具及其屬性。
  • Agent Registry API 編輯者 (roles/agentregistry.editor)：具備 Agent Registry 資源的編輯權限。
  • Agent Registry API 管理員 (roles/agentregistry.admin)：執行所有動作，包括手動註冊代理程式和更新中繼資料。

如要瞭解如何在專案中授予 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。

後續步驟