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. El proyecto de administración de Agent Registry te permite descubrir automáticamente las cargas de trabajo admitidas implementadas en ese proyecto y registrar de forma manual los componentes remotos alojados en proyectos de Google Cloud , entornos locales o nubes externas independientes.

Antes de comenzar

Para configurar Agent Registry, usa un proyecto existente o crea uno nuevo.

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

Console

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 información para otorgar roles.

Habilitar la API

gcloud

Habilita la API de Agent Registry en tu proyecto con el comando gcloud services enable:

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

Reemplaza PROJECT_ID por el ID de tu proyecto.

Después de habilitar la API de Agent Registry, puedes comenzar a registrar y descubrir agentes en este proyecto.

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?