Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。
提供意見
角色和權限
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
這個頁面列出 Agent Registry 的 IAM 角色和權限。
將適當的 Agent Registry IAM 角色授予使用者或群組，讓他們管理或查看登錄中的代理程式、MCP 伺服器、工具、獨立技能、端點和繫結。如要授予角色，可以使用 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 管理員
(roles/agentregistry.admin)
具備所有 Agent Registry 資源的完整存取權，包括代理、MCP 伺服器、工具、端點、獨立技能、技能修訂版本、繫結和技能 IAM 政策。
註冊及管理代理、MCP 伺服器、工具和端點。
可建立、更新及刪除獨立技能和技能修訂版本。
建立及管理繫結和技能 IAM 政策。
Agent Registry API 編輯者
(roles/agentregistry.editor)
具備 Agent Registry 資源的編輯權限，包括代理、MCP 伺服器、工具、端點、獨立技能和技能修訂版本。
註冊及管理代理和 MCP 伺服器。
更新工具定義和端點。
可建立、更新及刪除獨立技能和技能修訂版本。
Agent Registry API 檢視者
(roles/agentregistry.viewer)
具備唯讀存取權，可查看及搜尋代理、MCP 伺服器、工具、獨立技能、技能修訂版本、發布者、端點和繫結。
探索可用的代理、MCP 伺服器和工具。
查看 A2A 技能、獨立技能、技能修訂版本、發布者、端點和整合繫結。
Agent Registry 使用者
(roles/agentregistry.user)
具備 Agent Registry 資源的唯讀存取權，以及建立、更新和刪除獨立技能和技能修訂版本的權限。
建立、更新及刪除獨立技能和技能修訂版本，但無法編輯代理、MCP 伺服器或端點。
保留技能修訂版本的版本管控，並集中管理技能的啟用狀態。
Agent Registry 權限
下表列出各 Agent Registry IAM 角色擁有的權限：
Agent Registry API 管理員
Beta 版
(roles/)
具備 Agent Registry API 資源的完整存取權。
agentregistry.*
agentregistry.agents.getagentregistry.agents.listagentregistry.agents.searchagentregistry.bindings.createagentregistry.bindings.deleteagentregistry.agentregistry.bindings.getagentregistry.bindings.listagentregistry.bindings.updateagentregistry.endpoints.getagentregistry.endpoints.listagentregistry.locations.getagentregistry.locations.listagentregistry.mcpServers.getagentregistry.mcpServers.listagentregistry.agentregistry.agentregistry.agentregistry.operations.getagentregistry.operations.listagentregistry.publishers.getagentregistry.publishers.listagentregistry.services.createagentregistry.services.deleteagentregistry.services.getagentregistry.services.listagentregistry.services.updateagentregistry.agentregistry.agentregistry.agentregistry.agentregistry.skills.createagentregistry.skills.deleteagentregistry.skills.getagentregistry.agentregistry.skills.listagentregistry.skills.searchagentregistry.agentregistry.skills.update
Agent Registry API 編輯者
Beta 版
(roles/)
具備 Agent Registry API 資源的編輯權限。
agentregistry.agents.*
agentregistry.agents.getagentregistry.agents.listagentregistry.agents.search
agentregistry.
agentregistry.bindings.get
agentregistry.bindings.list
agentregistry.endpoints.*
agentregistry.endpoints.getagentregistry.endpoints.list
agentregistry.locations.*
agentregistry.locations.getagentregistry.locations.list
agentregistry.mcpServers.*
agentregistry.mcpServers.getagentregistry.mcpServers.listagentregistry.
agentregistry.operations.*
agentregistry.agentregistry.agentregistry.operations.getagentregistry.operations.list
agentregistry.publishers.*
agentregistry.publishers.getagentregistry.publishers.list
agentregistry.services.*
agentregistry.services.createagentregistry.services.deleteagentregistry.services.getagentregistry.services.listagentregistry.services.update
agentregistry.skillRevisions.*
agentregistry.agentregistry.agentregistry.agentregistry.
agentregistry.skills.create
agentregistry.skills.delete
agentregistry.skills.get
agentregistry.skills.list
agentregistry.skills.search
agentregistry.skills.update
Agent Registry API 檢視者
Beta 版
(roles/)
具備 Agent Registry API 資源的唯讀存取權。
agentregistry.agents.*
agentregistry.agents.getagentregistry.agents.listagentregistry.agents.search
agentregistry.
agentregistry.bindings.get
agentregistry.bindings.list
agentregistry.endpoints.*
agentregistry.endpoints.getagentregistry.endpoints.list
agentregistry.locations.*
agentregistry.locations.getagentregistry.locations.list
agentregistry.mcpServers.*
agentregistry.mcpServers.getagentregistry.mcpServers.listagentregistry.
agentregistry.operations.get
agentregistry.operations.list
agentregistry.publishers.*
agentregistry.publishers.getagentregistry.publishers.list
agentregistry.services.get
agentregistry.services.list
agentregistry.
agentregistry.
agentregistry.skills.get
agentregistry.skills.list
agentregistry.skills.search
Agent Registry 使用者
Beta 版
(roles/)
可建立、更新及刪除技能和技能修訂版本。
agentregistry.agents.*
agentregistry.agents.getagentregistry.agents.listagentregistry.agents.search
agentregistry.
agentregistry.bindings.get
agentregistry.bindings.list
agentregistry.endpoints.*
agentregistry.endpoints.getagentregistry.endpoints.list
agentregistry.locations.*
agentregistry.locations.getagentregistry.locations.list
agentregistry.mcpServers.*
agentregistry.mcpServers.getagentregistry.mcpServers.listagentregistry.
agentregistry.operations.get
agentregistry.operations.list
agentregistry.publishers.*
agentregistry.publishers.getagentregistry.publishers.list
agentregistry.services.get
agentregistry.services.list
agentregistry.skillRevisions.*
agentregistry.agentregistry.agentregistry.agentregistry.
agentregistry.skills.create
agentregistry.skills.delete
agentregistry.skills.get
agentregistry.skills.list
agentregistry.skills.search
agentregistry.skills.update
如要進一步瞭解 IAM 權限，請參閱「尋找合適的預先定義角色 」和「IAM 角色和權限索引 」。
已註冊資源的存取控管機制
Agent Registry 角色可控管哪些使用者能管理及探索登錄中的資源。如要控管哪些代理可透過 Agent Gateway 與已註冊的服務、端點和 MCP 伺服器通訊，請使用 Identity-Aware Proxy 輸出政策：
如需設定 IAP 輸出政策的詳細操作說明，請參閱「設定 IAM 代理程式政策 」。
提供意見
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ，程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2026-10-13 (世界標準時間)。
想進一步說明嗎？
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2026-10-13 (世界標準時間)。"],[],[]]
