Configura Agent Registry

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

En este documento, se explica cómo configurar el registro de agentes 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 proyecto 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 gcloud CLI

Si planeas usar Google Cloud 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 que muestra una ventana emergente con una 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 gcloud 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 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.

Otorgar permisos

Para ver y administrar recursos en Agent Registry, 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): Visualiza agentes, herramientas y sus atributos.
  • Editor de la API de Agent Registry (roles/agentregistry.editor): Tiene acceso de edición a los recursos de Agent Registry.
  • Administrador de la API de Agent Registry (roles/agentregistry.admin): Realiza 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.

Cómo cambiar 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 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 el registro de agentes, inhabilita la API de Agent Registry en el proyecto:

Console

  1. En la consola de Google Cloud , 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 proyecto 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 

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

Reemplaza PROJECT_ID por el ID del proyecto.

¿Qué sigue?