管理绑定

在 Agent Registry 中，绑定表示源代理与目标资源（例如另一个代理、MCP 服务器或端点）之间的连接。通过创建绑定，您可以建立明确的关系，让编排器代理与下游功能进行交互。

您可以使用绑定来处理以下两种情况：

  • 资源连接：您可以将源代理与目标资源（例如另一个代理、MCP 服务器或端点）相关联。在此场景中，您可以规划多智能体工作流，其中主编排器将任务委托给专门的子智能体或工具。
  • 委托权限：您可以将代理与身份验证提供方相关联，以便代理使用自己的凭据或代表个人用户连接到外部目标或自定义工具。如果您的代理需要使用 OAuth 令牌或 API 密钥对远程 MCP 服务器或工具进行身份验证，则此绑定是必需的。使用绑定后，您无需在代码中手动定义身份验证提供程序。如需查看详细说明，请参阅本文档中的创建 Auth 提供方绑定。

本文档介绍了如何在代理注册表中创建、查看、更新和删除绑定。

准备工作

在管理绑定之前，请完成以下操作：

  1. 设置代理注册表。
  2. 注册源组件和目标组件。如需了解详情，请参阅注册代理组件。
  3. 如果您想为委托权限配置绑定，请创建具有 Agent Identity 身份验证管理器的身份验证提供程序。如需了解详情，请参阅向工具和资源进行身份验证。
  4. 如需使用本文档中的 Google Cloud CLI 命令，请确保您已设置 gcloud CLI 环境。

所需的角色

如需获得在代理注册表中管理绑定的权限，请让管理员向您授予项目的以下 IAM 角色：

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

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

创建绑定

创建绑定以将来源代理连接到目标资源：

gcloud alpha agent-registry bindings create BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --source-identifier="SOURCE_ID" \
  --target-identifier="TARGET_ID"

替换以下内容：

  • BINDING_NAME：您要为绑定指定的名称，例如 my-custom-binding。
  • PROJECT_ID：项目 ID。
  • REGION：注册区域。
  • DISPLAY_NAME：您要为绑定提供的直观易记的名称，例如 My Custom Binding。
  • SOURCE_ID：来源代理的标识符，采用统一资源名称 (URN) 格式。
  • TARGET_ID：目标资源的标识符，采用 URN 格式，例如 MCP 服务器标识符。

创建身份验证提供方绑定

您可以将代理与身份验证提供方相关联，以实现委托权限。在创建此绑定之前，您必须先使用 Agent Identity 身份验证管理器创建身份验证提供程序。如需了解详情，请参阅向工具和资源进行身份验证。

指定 --auth-provider 资源名称时，您必须使用自己的项目 ID：

gcloud alpha agent-registry bindings create BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --source-identifier="SOURCE_ID" \
  --auth-provider="projects/PROJECT_ID/locations/REGION/connectors/AUTH_PROVIDER_ID"

将 AUTH_PROVIDER_ID 替换为您的身份验证提供方的 ID。

如需查看如何在智能体代码中使用这些绑定，请参阅在智能体开发套件 (ADK) 代码中解析绑定。

列出绑定

列出特定位置中的所有绑定：

gcloud alpha agent-registry bindings list \
  --project=PROJECT_ID \
  --location=REGION

查看绑定详情

检索单个绑定的详细信息：

gcloud alpha agent-registry bindings describe BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION

更新绑定

使用 gcloud CLI 标志更新现有绑定的参数，例如其显示名称或说明：

gcloud alpha agent-registry bindings update BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="NEW_DISPLAY_NAME"

删除绑定

如需移除资源之间的连接，请删除绑定记录：

gcloud alpha agent-registry bindings delete BINDING_NAME \
  --project=PROJECT_ID \
  --location=REGION

后续步骤