Configurar o Agent Registry

Para registrar e descobrir seus agentes de IA, servidores do Protocolo de Contexto de Modelo (MCP), habilidades independentes e endpoints no Agent Registry, é necessário ativar a API Agent Registry no seu projeto do Google Cloud . O projeto em que você ativa o Agent Registry serve como seu projeto de governança. O projeto de governança do Agent Registry permite descobrir automaticamente cargas de trabalho compatíveis implantadas nesse projeto e registrar manualmente componentes remotos hospedados em projetos do Google Cloud separados, ambientes locais ou nuvens externas.

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 projeto do Google Cloud :

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 papéis personalizados ou outros papéis predefinidos.

Configurar o ambiente da Google Cloud CLI

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

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

    Ativar o Cloud Shell

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

  2. Atualize a CLI gcloud para a versão mais recente com o comando gcloud components update:

    gcloud components update

  3. Se você planeja usar os recursos de pré-lançamento, instale o componente alpha com o comando gcloud components install:

    gcloud components install alpha

Ativar a API Agent Registry

Console

Funções necessárias para ativar APIs

Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

Ativar a API

gcloud

Ative a API Agent Registry no projeto com o comando gcloud services enable:

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

Substitua PROJECT_ID pelo ID do projeto.

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

Conceder permissões

Para visualizar e gerenciar recursos no Agent Registry, é necessário conceder aos usuários as permissões apropriadas do Identity and Access Management (IAM).

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

  • Leitor da API Agent Registry (roles/agentregistry.viewer): visualizar e pesquisar agentes, servidores MCP, ferramentas, habilidades independentes, revisões de habilidades, editores, endpoints e vinculações.
  • Editor da API Agent Registry (roles/agentregistry.editor): visualizar e editar recursos do Agent Registry, incluindo o registro, a atualização e a exclusão de agentes, servidores MCP, ferramentas, endpoints, habilidades independentes e revisões de habilidades.
  • Administrador da API Agent Registry (roles/agentregistry.admin): realiza todas as ações em recursos do Agent Registry, incluindo o registro e o gerenciamento de agentes, servidores MCP, ferramentas, endpoints, habilidades independentes, revisões de habilidades, vinculações e políticas do IAM de habilidades.
  • Usuário do Agent Registry (roles/agentregistry.user): visualizar todos os recursos do Agent Registry e criar, atualizar e excluir habilidades independentes e revisões de habilidades sem acesso de edição a agentes, servidores MCP ou endpoints.

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 as dependências do projeto antigo, desative a API Agent Registry no projeto antigo. Depois de desativar a API Agent Registry no projeto antigo, é possível ativá-la em outro projeto. Seus dados não são migrados, e você precisa recriar os recursos nesse novo projeto.

Desativar a API Agent Registry

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

Console

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

    Acessar a API Agent Registry

  2. No seletor de projetos, selecione o projeto do Google Cloud 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

Desative a API Agent Registry no seu projeto com o comando gcloud services disable:

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

Substitua PROJECT_ID pelo ID do projeto.

A seguir