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 de MCP o un extremo. Cuando creas vinculaciones, estableces relaciones explícitas que permiten que tus agentes de orquestación interactúen con las capacidades de nivel inferior.

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 de MCP o un extremo. Este caso de uso te permite diseñar flujos de trabajo multiagente en los que un organizador principal delega tareas a subagentes o herramientas especializados.
  • Permisos delegados: Puedes asociar un agente con un proveedor de autenticación para permitir que 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 de 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 del 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 administrar las vinculaciones, completa los siguientes pasos:

  1. Configura el Registro de agentes.
  2. Registra los componentes de origen y destino. Para obtener más información, consulta Cómo registrar componentes de agentes.
  3. Si deseas configurar vinculaciones para permisos delegados, crea un proveedor de Auth con el administrador de autorización de identidad del agente. Para obtener más información, consulta Cómo autenticarse en herramientas y recursos.
  4. Para usar los comandos de Google Cloud CLI en este documento, asegúrate de configurar tu entorno de gcloud CLI.

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: Es la región del registro.
  • DISPLAY_NAME: Es el nombre legible por humanos que deseas asignarle a tu vinculación, por ejemplo, My Custom Binding.
  • SOURCE_ID: Es el identificador del agente fuente en formato de nombre de recurso uniforme (URN).
  • TARGET_ID: Es el identificador del recurso de destino en formato URN, como un identificador de servidor de MCP.

Crea una vinculación del proveedor de autenticación

Puedes asociar un agente con un proveedor de autenticación para obtener permisos delegados. Antes de crear esta vinculación, primero debes crear el proveedor de autenticación con el administrador de autenticación de identidad del agente. Para obtener más información, consulta Cómo autenticarse 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 Cómo resolver vinculaciones en el código del Kit de desarrollo de agentes (ADK).

Mostrar lista de vinculaciones

Enumera todas las vinculaciones en 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 las marcas de la 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?