角色和權限

本頁面列出 Agent Registry 的 IAM 角色和權限。

將適當的 Agent Registry IAM 角色授予使用者或群組，讓他們管理或查看登錄檔中的代理程式。如要授予角色，可以使用 Google Cloud 控制台中的「IAM」頁面，也可以使用 Google Cloud CLI。如需詳細操作說明，請參閱「管理專案、資料夾和機構的存取權」。

Agent Registry 角色

下表說明 Agent Registry IAM 角色及其典型職責：

注意： 請只將「Agent Registry API 管理員」(roles/agentregistry.admin) 或「Agent Registry API 編輯者」(roles/agentregistry.editor) 角色授予需要管理登錄檔權限的信任管理員，並避免直接將這些角色授予代理程式。這些角色包含建立、刪除及更新服務的權限，包括修改重要代理程式中繼資料和工具註解，例如 readOnlyHint 或 destructiveHint。如果惡意變更中繼資料和註解，當協調器使用修改過的工具時，可能會造成非預期的破壞性後果。此外，具備這些權限的代理程式可以明確將惡意第三方代理程式註冊到登錄檔。

角色	說明	Purpose
Agent Registry API 管理員	執行所有動作，包括手動註冊代理程式和更新中繼資料。	註冊及管理代理和 MCP 伺服器。 更新工具定義和端點。
Agent Registry API 編輯者	具備 Agent Registry 資源的編輯權限。	註冊及管理代理和 MCP 伺服器。 更新工具定義和端點。
Agent Registry API 檢視者	查看代理程式、工具及其屬性。	探索可用的代理和 MCP 伺服器。 查看整合項目的技能和端點。

Agent Registry 權限

下表列出各 Agent Registry IAM 角色擁有的權限：

Agent Registry API 管理員 Agent Registry API 編輯者 Agent Registry API 檢視者 全部清除

Agent Registry API 管理員 ^Beta 版 (roles/agentregistry.admin) 具備 Agent Registry API 資源的完整存取權。	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
Agent Registry API 編輯者 ^Beta 版 (roles/agentregistry.editor) 具備 Agent Registry API 資源的編輯權限。	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 檢視者 ^Beta 版 (roles/agentregistry.viewer) 具備 Agent Registry API 資源的唯讀存取權。	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

如要進一步瞭解 IAM 權限，請參閱「尋找合適的預先定義角色」和「IAM 角色和權限索引」。