Papéis e permissões

O Agent Registry oferece os seguintes papéis do Identity and Access Management (IAM):

  • Administrador da API Agent Registry (roles/agentregistry.admin): realiza todas as ações, incluindo registrar agentes manualmente e atualizar metadados.
  • Editor da API Agent Registry (roles/agentregistry.editor): acesso de edição aos recursos do Agent Registry.
  • Leitor da API Agent Registry (roles/agentregistry.viewer): veja agentes, ferramentas e atributos deles.

Conceda os papéis apropriados do IAM do Agent Registry a usuários ou grupos que vão gerenciar ou visualizar agentes no registro. Para conceder papéis, use a página do IAM no console do Google Cloud ou a Google Cloud CLI. Para instruções detalhadas, consulte Gerenciar o acesso a projetos, pastas e organizações.

Papéis do Agent Registry

A tabela a seguir descreve os papéis do IAM do Agent Registry e as responsabilidades típicas deles:

Papel

Descrição

Purpose

Administrador da API Agent Registry

Realize todas as ações, incluindo o registro manual de agentes e a atualização de metadados.

  • Registre e gerencie agentes e servidores MCP.
  • Atualize as definições e os endpoints de ferramentas.

Editor da API Agent Registry

Acesso de edição aos recursos do Agent Registry.

  • Registre e gerencie agentes e servidores MCP.
  • Atualize as definições e os endpoints de ferramentas.

Leitor da API Agent Registry

Ver agentes, ferramentas e atributos.

  • Descubra os agentes e servidores MCP disponíveis.
  • Confira as habilidades e os endpoints para integração.

Permissões do Agent Registry

A tabela a seguir lista as permissões de cada papel do IAM do Agent Registry:

(roles/agentregistry.admin)

Acesso total aos recursos da API Agent Registry.

agentregistry.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search
  • agentregistry.bindings.create
  • agentregistry.bindings.delete
  • agentregistry.bindings.fetchAvailable
  • agentregistry.bindings.get
  • agentregistry.bindings.list
  • agentregistry.bindings.update
  • agentregistry.endpoints.get
  • agentregistry.endpoints.list
  • agentregistry.locations.get
  • agentregistry.locations.list
  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search
  • agentregistry.operations.cancel
  • agentregistry.operations.delete
  • agentregistry.operations.get
  • agentregistry.operations.list
  • agentregistry.services.create
  • agentregistry.services.delete
  • agentregistry.services.get
  • agentregistry.services.list
  • agentregistry.services.update

(roles/agentregistry.editor)

Acesso de edição aos recursos da API Agent Registry.

agentregistry.agents.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search

agentregistry.bindings.fetchAvailable

agentregistry.bindings.get

agentregistry.bindings.list

agentregistry.endpoints.*

  • agentregistry.endpoints.get
  • agentregistry.endpoints.list

agentregistry.locations.*

  • agentregistry.locations.get
  • agentregistry.locations.list

agentregistry.mcpServers.*

  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search

agentregistry.operations.*

  • agentregistry.operations.cancel
  • agentregistry.operations.delete
  • agentregistry.operations.get
  • agentregistry.operations.list

agentregistry.services.*

  • agentregistry.services.create
  • agentregistry.services.delete
  • agentregistry.services.get
  • agentregistry.services.list
  • agentregistry.services.update

(roles/agentregistry.viewer)

Acesso somente leitura aos recursos da API Agent Registry.

agentregistry.agents.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search

agentregistry.bindings.fetchAvailable

agentregistry.bindings.get

agentregistry.bindings.list

agentregistry.endpoints.*

  • agentregistry.endpoints.get
  • agentregistry.endpoints.list

agentregistry.locations.*

  • agentregistry.locations.get
  • agentregistry.locations.list

agentregistry.mcpServers.*

  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search

agentregistry.operations.get

agentregistry.operations.list

agentregistry.services.get

agentregistry.services.list

Para mais informações sobre as permissões do IAM, consulte Encontrar os papéis predefinidos certos e Índice de papéis e permissões do IAM.