Papéis e permissões

Nesta página, listamos os papéis e as permissões do IAM para o Agent Registry.

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:

Atenção: conceda apenas os papéis Administrador da API Agent Registry (roles/agentregistry.admin) ou Editor da API Agent Registry (roles/agentregistry.editor) a administradores confiáveis que precisam de permissões para gerenciar o registro. Evite conceder esses papéis diretamente aos agentes. Esses papéis contêm permissões para criar, excluir e atualizar serviços, incluindo a modificação de metadados importantes do agente e anotações de ferramentas, como readOnlyHint ou destructiveHint. Mudanças maliciosas nos metadados e nas anotações podem causar consequências indesejadas e destrutivas quando um orquestrador usa a ferramenta modificada. Além disso, um agente com essas permissões pode registrar explicitamente um agente malicioso de terceiros no registro.

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.	Descobrir 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:

Administrador da API Agent Registry Editor da API Agent Registry Leitor da API Agent Registry Limpar tudo

Administrador da API Agent Registry ^Beta (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
Editor da API Agent Registry ^Beta (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
Leitor da API Agent Registry ^Beta (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.