Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。
发送反馈
角色与权限
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本页面列出了 Agent Registry 的 IAM 角色和权限。
向管理或查看注册表中代理、MCP 服务器、工具、独立技能、端点和绑定的用户或群组授予适当的 Agent Registry IAM 角色。如需授予角色，您可以使用 Google Cloud 控制台中的“IAM”页面或 Google Cloud CLI。如需查看详细说明，请参阅管理对项目、文件夹和组织的访问权限 。
Agent Registry 角色
下表介绍了 Agent Registry 的 IAM 角色及其典型职责：
注意 ： 请仅向需要权限来管理注册表的受信任管理员授予 Agent Registry API Admin (roles/agentregistry.admin) 或 Agent Registry API Editor (roles/agentregistry.editor) 角色，并避免直接向代理授予这些角色。这些角色包含创建、删除和更新服务的权限，包括修改关键代理元数据和工具注释 （例如 readOnlyHint 或 destructiveHint）。对元数据和注释的恶意更改可能会在编排器使用修改后的工具时造成意想不到的破坏性后果。此外，具有这些权限的代理可以明确将恶意外部代理注册到注册表中。
角色
说明
用途
Agent Registry API Admin
(roles/agentregistry.admin)
对所有 Agent Registry 资源（包括代理、MCP 服务器、工具、端点、独立技能、技能修订版本、绑定和技能 IAM 政策）的完整访问权限。
注册和管理代理、MCP 服务器、工具和端点。
创建、更新和删除独立技能和技能修订版本。
创建和管理绑定以及技能 IAM 政策。
Agent Registry API Editor
(roles/agentregistry.editor)
拥有对 Agent Registry 资源的编辑权限，包括智能体、MCP 服务器、工具、端点、独立技能和技能修订版本。
注册和管理代理和 MCP 服务器。
更新了工具定义和端点。
创建、更新和删除独立技能和技能修订版本。
Agent Registry API Viewer
(roles/agentregistry.viewer)
拥有只读权限，可查看和搜索代理、MCP 服务器、工具、独立技能、技能修订版本、发布者、端点和绑定。
发现可用的代理、MCP 服务器和工具。
查看 A2A 技能、独立技能、技能修订版本、发布者、端点和集成绑定。
Agent Registry User
(roles/agentregistry.user)
拥有对代理注册表资源的只读权限，以及创建、更新和删除独立技能和技能修订版本的权限。
创建、更新和删除独立技能和技能修订版本，而无需对代理、MCP 服务器或端点拥有编辑访问权限。
保留技能修订版本的版本控制，并集中管理技能的有效状态。
Agent Registry 权限
下表列出了每个 Agent Registry IAM 角色拥有的权限：
Agent Registry API Admin
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 Viewer
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 User
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 代理政策 。
发送反馈
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可，并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情，请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：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"]],["最后更新时间 (UTC)：2026-10-13。"],[],[]]
