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 Google Cloud . O Agent Registry opera no nível do projeto, permitindo descobrir e gerenciar agentes, servidores, habilidades e endpoints 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 projeto 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 CLI gcloud

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

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

    Ativar o Cloud Shell

    Na parte de baixo do console 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. Verifique se a versão mais recente da CLI gcloud está instalada:

    gcloud components update

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 receber 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 seu projeto:

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 uma ou mais das seguintes funções do Agent Registry:

  • Leitor da API Agent Registry (roles/agentregistry.viewer): veja e pesquise agentes, servidores MCP, ferramentas, habilidades independentes, revisões de habilidades, editores, endpoints e vinculações.
  • Editor da API Agent Registry (roles/agentregistry.editor): veja e edite recursos do Agent Registry, incluindo registro, atualização e 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): pode ver 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 dependências do projeto antigo, desative a API Agent Registry nesse projeto. Em seguida, ative a API Agent Registry em outro projeto. Seus dados não serão migrados, e você precisará 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 console Google Cloud , acesse a página de gerenciamento da API Agent Registry:

    Acessar a API Agent Registry

  2. No seletor de projetos, escolha 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 

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

Substitua PROJECT_ID pelo ID do projeto.

A seguir