设置 Agent Registry

如需在 Agent Registry 中注册和发现 AI 智能体、Model Context Protocol (MCP) 服务器和端点，您必须在 Google Cloud 项目中启用 Agent Registry API。代理注册表在项目级层运行，可让您发现和管理在启用该 API 的特定项目中部署的代理。

本文档介绍了如何设置代理注册表并启用所需的 API。

准备工作

如需设置代理注册表，请使用现有项目或创建新项目。

所需的角色

如需获得设置代理注册表所需的权限，请让您的管理员为您授予 Google Cloud 项目的以下 IAM 角色：

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

设置 gcloud CLI 环境

如果您计划使用 Google Cloud CLI 进行代理注册，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

  2. 确保已安装最新版本的 gcloud CLI：

    gcloud components update

启用 Agent Registry API

控制台

启用 API 所需的角色

如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已经通过 Owner 角色 (roles/owner) 获得了此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

启用 API

gcloud

在项目中启用 Agent Registry API：

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

将 PROJECT_ID 替换为您的项目 ID。

启用 Agent Registry API 后，您就可以开始在此项目中注册和发现代理了。

授予权限

如需查看和管理代理注册表中的资源，您必须向用户授予适当的 Identity and Access Management (IAM) 权限。

为用户授予以下一个或多个代理注册表角色：

  • Agent Registry API Viewer (roles/agentregistry.viewer)：查看代理、工具及其属性。
  • Agent Registry API Editor (roles/agentregistry.editor)：拥有对 Agent Registry 资源的编辑权限。
  • Agent Registry API Admin (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. 在项目选择器中，选择您设置代理注册表的 Google Cloud 项目。

  3. 点击停用 API。

  4. 在确认对话框中，点击停用。

gcloud

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

将 PROJECT_ID 替换为相应项目的 ID。

后续步骤