Configura Agent Registry

Para registrar y descubrir tus agentes de IA y servidores del Protocolo de contexto del modelo (MCP) en Agent Registry, debes habilitar la API de Agent Registry en tu Google Cloud proyecto. Agent Registry opera a nivel del proyecto, lo que te permite descubrir y administrar agentes implementados dentro del proyecto específico en el que está habilitada la API.

En este documento, se explica cómo configurar Agent Registry y habilitar la API requerida.

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 Agent Registry, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu Google Cloud 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.

Configura tu entorno de gcloud CLI

Si planeas usar Google Cloud CLI para Agent Registry, sigue estos pasos:

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

    Activa Cloud Shell

    En la parte inferior de la Google Cloud consola, 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. Instala el componente alpha:

    gcloud components install alpha

  3. Asegúrate de que esté instalada la versión más reciente de Google Cloud CLI:

    gcloud components update

Habilita la API de Agent Registry

Console

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

Habilitar la API

gcloud

Habilita la API de Agent Registry en tu proyecto:

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

Reemplaza PROJECT_ID con el ID de tu proyecto.

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

Otorgar permisos

Para ver y administrar servicios en Agent Registry, debes otorgar a los usuarios los permisos adecuados de Identity and Access Management.

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 agentes, herramientas y sus atributos.
  • Editor de la API de Agent Registry (roles/agentregistry.editor): Permite editar el acceso a los recursos de Agent Registry.
  • Administrador de la API de Agent Registry (roles/agentregistry.admin): Permite realizar todas las acciones, incluido el registro manual de agentes y la actualización de metadatos.

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 deseas cambiar el proyecto en el que usas Agent Registry y quitar las dependencias del proyecto anterior, inhabilita la API de Agent Registry en ese proyecto. Luego, puedes habilitar la API de Agent Registry 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 necesitas Agent Registry, inhabilita la API de Agent Registry en el proyecto:

Console

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

    Ir a la API de Agent Registry

  2. En el selector de proyectos, selecciona el Google Cloud proyecto 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 

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

Reemplaza PROJECT_ID con el ID del proyecto.

¿Qué sigue?