Configurar o Agent Registry

Para registrar e descobrir seus agentes de IA e servidores do Protocolo de Contexto de Modelo (MCP) no Registro de agente, é 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 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 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 registro de agentes, 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. 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 pelo ID do seu projeto.

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

Conceder permissões

Para acessar e gerenciar recursos no Agent Registry, conceda 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): veja agentes, ferramentas e atributos deles.
  • 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): realiza 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 registro de agentes

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:

    Acesse a API Agent Registry

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