Configura Agent Registry

Para registrar y descubrir tus agentes de IA, servidores de Model Context Protocol (MCP), habilidades independientes y extremos en Agent Registry, debes habilitar la API de Agent Registry en tu proyecto de Google Cloud . El proyecto en el que habilitas Agent Registry funciona como tu proyecto de administración.

Puedes configurar el Registro de agentes en un solo proyecto de administración o en varios proyectos configurando un límite de administración en el que un proyecto de administración central sirva como tu proyecto de administración.

Antes de comenzar

Configura Agent Registry en un solo proyecto o en varios proyectos:

Roles obligatorios

Para obtener los permisos que necesitas para configurar el Registro de agentes, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto de Google Cloud :

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.

Configura tu entorno de Google Cloud CLI

Si planeas usar gcloud CLI para el registro de agentes, sigue estos pasos:

  1. En la consola de Google Cloud , activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  2. Actualiza gcloud CLI a la versión más reciente con el comando gcloud components update:

    gcloud components update

  3. Si planeas usar funciones de versión preliminar, instala el componente alpha con el comando gcloud components install:

    gcloud components install alpha

Habilita la API de Agent Registry

Usa el ID de tu proyecto para habilitar las APIs:

Console

Para un solo proyecto, habilita la API de Agent Registry en tu proyecto:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

Habilitar la API

En el caso de varios proyectos (límite de administración), habilita la API de Resource Manager en el proyecto que usas para la configuración:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

Habilitar la API

gcloud

  • Para un solo proyecto, habilita la API de Agent Registry en tu proyecto con el comando gcloud services enable:

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

  • En el caso de varios proyectos (límite de administración), habilita la API de Resource Manager en el proyecto que usas para la configuración:

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

Reemplaza PROJECT_ID por el ID del proyecto de tu proyecto de administración independiente o el proyecto que deseas usar como el proyecto de administración para tu límite de administración.

Configura un límite de administración para varios proyectos

Para usar Agent Registry en varios proyectos de Google Cloud , configura un límite de administración. Un límite de administración agrupa uno o más proyectos miembros de Google Cloud en un proyecto de administracióncentral que funciona como tu proyecto de administración para que puedas descubrir y administrar agentes de IA, servidores de MCP y herramientas en todos los proyectos.

Define un límite de administración en Resource Manager. Para obtener instrucciones paso a paso, consulta Configura límites de administración en la documentación de Resource Manager.

Para obtener una descripción general de la arquitectura de cómo funcionan juntos los recursos BoundaryConfig, Boundary y CapabilityConfig, consulta Límites entre proyectos.

Cuando creas un recurso CapabilityConfig con agent-management, Resource Manager habilita automáticamente agentregistry.googleapis.com en el proyecto de administración. Después de establecer tu límite de administración, haz lo siguiente:

  1. Si es necesario para las operaciones locales dentro de proyectos de miembros individuales, habilita la API de Agent Registry en esos proyectos de miembros.
  2. Otorga los roles y permisos necesarios a los usuarios y las cuentas de servicio en el proyecto de administración.

Cuando enumeras o buscas agentes o servidores de MCP en una ubicación del proyecto de administración, Agent Registry agrega y devuelve los recursos detectados automáticamente en esa ubicación de todos los proyectos miembros del límite, junto con los recursos de Service registrados que se crearon directamente en esa ubicación en el proyecto de administración. Cada nombre de recurso que se devuelve conserva el ID del componente y usa el proyecto especificado en la solicitud.

Otorga permisos

Para ver y administrar recursos en el Registro de agentes, debes otorgar a los usuarios los permisos de Identity and Access Management (IAM) adecuados.

Otorga a tus usuarios uno o más de los siguientes roles de Agent Registry:

  • Visualizador de la API de Agent Registry (roles/agentregistry.viewer): Permite ver y buscar agentes, servidores de MCP, herramientas, habilidades independientes, revisiones de habilidades, publicadores, endpoints y vinculaciones.
  • Editor de la API de Agent Registry (roles/agentregistry.editor): Permite ver y editar los recursos de Agent Registry, lo que incluye registrar, actualizar y borrar agentes, servidores de MCP, herramientas, endpoints, habilidades independientes y revisiones de habilidades.
  • Administrador de la API de Agent Registry (roles/agentregistry.admin): Realiza todas las acciones en los recursos de Agent Registry, incluidos el registro y la administración de agentes, servidores de MCP, herramientas, extremos, habilidades independientes, revisiones de habilidades, vinculaciones y políticas de IAM de habilidades.
  • Usuario de Agent Registry (roles/agentregistry.user): Permite ver todos los recursos de Agent Registry, y crear, actualizar y borrar habilidades independientes y revisiones de habilidades sin acceso de edición a los agentes, los servidores de MCP o los endpoints.

Para obtener información sobre cómo otorgar roles de IAM en un proyecto, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Cambia tu proyecto de Agent Registry

Si quieres cambiar el proyecto en el que usas Agent Registry y quitar las dependencias del proyecto anterior, inhabilita la API de Agent Registry en el proyecto anterior. Después de inhabilitar la API de Agent Registry en el proyecto anterior, puedes habilitarla en otro proyecto. Tus datos no se migran, y debes volver a crear tus recursos en este proyecto nuevo.

Inhabilita la API de Agent Registry

Si ya no quieres usar Agent Registry, inhabilita la API de Agent Registry en el proyecto:

Console

  1. En la consola de Google Cloud , ve a la página de gestión de API de Agent Registry:

    Ir a la API de Agent Registry

  2. En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste Agent Registry.

  3. Haz clic en Inhabilitar API.

  4. En el diálogo de confirmación, haz clic en Inhabilitar.

gcloud

Inhabilita la API de Agent Registry en tu proyecto con el comando gcloud services disable:

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

Reemplaza PROJECT_ID por el ID del proyecto.

¿Qué sigue?