设置 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

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

  2. 安装 alpha 组件：

    gcloud components install alpha

  3. 确保安装了最新版本的 Google Cloud CLI：

    gcloud components update

启用 Agent Registry API

控制台

启用 API 所需的角色

如需启用 API，您需要拥有 Service Usage Admin 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 中查看和管理服务，您必须向用户授予适当的 Identity and Access Management 权限。

向用户授予以下一个或多个 Agent Registry 角色：

  • 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. 在项目选择器中，选择您在其中设置 Agent Registry 的 Google Cloud 项目。

  3. 点击停用 API 。

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

gcloud 

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

将 PROJECT_ID 替换为 项目 ID。

后续步骤