Ruoli e autorizzazioni

Questa pagina elenca i ruoli e le autorizzazioni IAM per Agent Registry.

Concedi i ruoli IAM appropriati del registro degli agenti agli utenti o ai gruppi che gestiranno o visualizzeranno gli agenti nel registro. Per concedere i ruoli, puoi utilizzare la pagina IAM della console Google Cloud o Google Cloud CLI. Per istruzioni dettagliate, vedi Gestire l'accesso a progetti, cartelle e organizzazioni.

Ruoli di Agent Registry

La tabella seguente descrive i ruoli IAM del registro degli agenti e le relative responsabilità tipiche:

Attenzione :concedi i ruoli Agent Registry API Admin (roles/agentregistry.admin) o Agent Registry API Editor (roles/agentregistry.editor) solo agli amministratori attendibili che richiedono autorizzazioni per gestire il registro ed evita di concedere questi ruoli direttamente agli agenti. Questi ruoli contengono le autorizzazioni per creare, eliminare e aggiornare i servizi, inclusa la modifica dei metadati degli agenti critici e delle annotazioni degli strumenti come readOnlyHint o destructiveHint. Le modifiche dannose ai metadati e alle annotazioni possono causare conseguenze indesiderate e distruttive quando un orchestratore utilizza lo strumento modificato. Inoltre, un agente con queste autorizzazioni può registrare esplicitamente un agente di terze parti dannoso nel registro.

Role	Descrizione	Purpose
Agent Registry API Admin	Esegui tutte le azioni, inclusa la registrazione manuale degli agenti e l'aggiornamento dei metadati.	Registra e gestisci agenti e server MCP. Aggiorna le definizioni e gli endpoint degli strumenti.
Agent Registry API Editor	Accesso in modifica alle risorse del registro degli agenti.	Registra e gestisci agenti e server MCP. Aggiorna le definizioni e gli endpoint degli strumenti.
Agent Registry API Viewer	Visualizza gli agenti, gli strumenti e i relativi attributi.	Scopri gli agenti e i server MCP disponibili. Visualizza le competenze e gli endpoint per l'integrazione.

Autorizzazioni di Agent Registry

La tabella seguente elenca le autorizzazioni di ciascun ruolo IAM di Agent Registry:

Agent Registry API Admin Agent Registry API Editor Agent Registry API Viewer Cancella tutto

Agent Registry API Admin ^beta (roles/agentregistry.admin) Accesso completo alle risorse dell'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 API Agent Registry ^Beta (roles/agentregistry.editor) Accesso in modifica alle risorse dell'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
Agent Registry API Viewer ^Beta (roles/agentregistry.viewer) Accesso di sola lettura alle risorse dell'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

Per saperne di più sulle autorizzazioni IAM, consulta Trovare i ruoli predefiniti giusti e Indice di ruoli e autorizzazioni IAM.