Configura Agent Registry

Para registrar y descubrir tus agentes de IA, los servidores del Protocolo de contexto del modelo (MCP) y los extremos 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 en el 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 mediante 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. Asegúrate de que esté instalada la versión más reciente de gcloud CLI:

    gcloud components update

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 Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol 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:

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 recursos en Agent Registry, debes otorgar a los usuarios los permisos adecuados de Identity and Access Management (IAM).

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 el acceso de edición 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?