Administra vinculaciones

En Agent Registry, una vinculación representa una conexión entre un agente de origen y un recurso de destino, como otro agente, un servidor MCP o un extremo. Cuando creas vinculaciones, estableces relaciones explícitas que permiten que tus agentes de orquestador interactúen con las capacidades descendentes.

Usas vinculaciones para controlar dos situaciones:

  • Conexiones de recursos: Puedes vincular un agente de origen a un recurso de destino, como otro agente, un servidor MCP o un extremo. Esta situación te permite trazar flujos de trabajo de múltiples agentes en los que un orquestador principal delega tareas a subagentes o herramientas especializados.
  • Permisos delegados: Puedes asociar un agente con un proveedor de autenticación para permitir que tu agente se conecte a destinos externos o herramientas personalizadas con sus propias credenciales o en nombre de un usuario individual. Esta vinculación es obligatoria si tu agente necesita autenticarse en servidores o herramientas MCP remotos con tokens de OAuth o claves de API. Con las vinculaciones, no tienes que definir manualmente los proveedores de autenticación en tu código. Para obtener instrucciones detalladas, consulta Crea una vinculación de proveedor de autenticación en este documento.

En este documento, se describe cómo crear, ver, actualizar y borrar vinculaciones en Agent Registry.

Antes de comenzar

Antes de que puedas administrar las vinculaciones, completa lo siguiente:

  1. Configura Agent Registry.
  2. Registra los recursos de origen y destino. Para obtener más información, consulta Registra servicios.
  3. Si deseas configurar vinculaciones para permisos delegados, crea un proveedor de autenticación con el administrador de autenticación de Agent Identity. Para obtener más información, consulta Autentícate en herramientas y recursos.
  4. Para usar los comandos de gcloud CLI en este documento, asegúrate de que tienes configurado tu Google Cloud CLI Cloud.

Roles obligatorios

Para obtener los permisos que necesitas para administrar vinculaciones en Agent Registry, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Crea una vinculación

Crea una vinculación para conectar un agente de origen a un recurso de destino:

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"

Reemplaza lo siguiente:

  • BINDING_NAME: El nombre que deseas asignarle a la vinculación, por ejemplo, my-custom-binding.
  • PROJECT_ID: El ID del proyecto
  • REGION: La región del registro
  • DISPLAY_NAME: El nombre legible que deseas asignarle a tu vinculación, por ejemplo, My Custom Binding.
  • SOURCE_ID: El identificador del agente de origen en formato de nombre de recurso uniforme (URN)
  • TARGET_ID: El identificador del recurso de destino en formato URN, como un identificador de servidor MCP.

Crea una vinculación de proveedor de autenticación

Puedes asociar un agente con un proveedor de autenticación para permisos delegados. Antes de crear esta vinculación, primero debes crear el proveedor de autenticación con el administrador de autenticación de Agent Identity. Para obtener más información, consulta Autentícate en herramientas y recursos.

Cuando especifiques el nombre del recurso --auth-provider, debes usar el ID de tu proyecto:

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"

Reemplaza AUTH_PROVIDER_ID por el ID de tu proveedor de autenticación.

Para ver ejemplos de cómo usar estas vinculaciones en el código de tu agente, consulta Resuelve vinculaciones en tu código ADK.

Mostrar lista de vinculaciones

Enumera todas las vinculaciones de una ubicación específica:

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

Ver detalles de vinculación

Recupera los detalles de una sola vinculación:

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

Actualiza una vinculación

Actualiza los parámetros de una vinculación existente, como su nombre visible o descripción, con marcas de gcloud CLI:

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

Borra una vinculación

Para quitar una conexión entre recursos, borra el registro de vinculación:

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

¿Qué sigue?