Configurar o Agent Registry

Para registrar e descobrir seus agentes de IA e servidores do Protocolo de Contexto de Modelo (MCP) no Agent Registry, ative a API Agent Registry no seu Google Cloud projeto. O Agent Registry opera no nível do projeto, permitindo que você descubra e gerencie agentes implantados no projeto específico em que a API está ativada.

Este documento explica como configurar o Agent Registry e ativar a API necessária.

Antes de começar

Para configurar o Agent Registry, use um projeto atual ou crie um novo.

Funções exigidas

Para receber as permissões necessárias para configurar o Agent Registry, peça ao administrador para conceder a você os seguintes papéis do IAM no seu Google Cloud projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Configurar o ambiente da CLI gcloud

Se você planeja usar a Google Cloud CLI para o Agent Registry, siga estas etapas:

  1. No Google Cloud console, ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte de baixo do Google Cloud console, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a Google Cloud CLI já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

  2. Instale o componente alpha:

    gcloud components install alpha

  3. Verifique se a versão mais recente da Google Cloud CLI está instalada:

    gcloud components update

Ativar a API Agent Registry

Console

Funções necessárias para ativar APIs

Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

Ativar a API

gcloud

Ative a API Agent Registry no projeto:

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

Substitua PROJECT_ID por o ID do seu projeto.

Depois de ativar a API Agent Registry, você pode começar a registrar e descobrir agentes nesse projeto.

Conceder permissões

Para visualizar e gerenciar serviços no Agent Registry, você deve conceder aos usuários as permissões adequadas do Identity and Access Management.

Conceda aos usuários um ou mais dos seguintes papéis do Agent Registry:

  • Leitor da API Agent Registry (roles/agentregistry.viewer): visualizar agentes, ferramentas e atributos.
  • Editor da API Agent Registry (roles/agentregistry.editor): acesso de edição aos recursos do Agent Registry.
  • Administrador da API Agent Registry (roles/agentregistry.admin): realizar todas as ações, incluindo o registro manual de agentes e a atualização de metadados.

Para saber como conceder papéis do IAM em um projeto, consulte Gerenciar o acesso a projetos, pastas e organizações.

Mudar o projeto do Agent Registry

Se você quiser mudar o projeto em que usa o Agent Registry e remover dependências do projeto antigo, desative a API Agent Registry em esse projeto. Em seguida, ative a API Agent Registry em outro projeto. Os dados não são migrados, e você precisa recriar os recursos nesse novo projeto.

Desativar a API Agent Registry

Se você não precisar mais do Agent Registry, desative a API Agent Registry no projeto:

Console

  1. No Google Cloud console, acesse a página de gerenciamento da API Agent Registry:

    Acessar a API Agent Registry

  2. No seletor de projetos, selecione o Google Cloud projeto em que você configurou o Agent Registry.

  3. Clique em Desativar API.

  4. Na caixa de diálogo de confirmação, clique em Desativar.

gcloud 

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

Substitua PROJECT_ID por o ID do projeto.

A seguir