ロールと権限

このページでは、エージェント レジストリの IAM ロールと権限を示します。

レジストリ内のエージェントを管理または表示するユーザーまたはグループに、適切なエージェント レジストリ 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 などのツール アノテーションの変更も含まれます。メタデータとアノテーションが不正に変更されると、オーケストレーターが変更されたツールを使用するときに、意図しない破壊的な結果が生じる可能性があります。また、これらの権限を持つエージェントは、悪意のあるサードパーティ エージェントをレジストリに明示的に登録できます。

役割	説明	目的
Agent Registry API 管理者	エージェントの手動登録やメタデータの更新など、すべてのアクションを実行します。	エージェントと MCP サーバーを登録して管理します。 ツール定義とエンドポイントを更新します。
Agent Registry API 編集者	Agent Registry リソースに対する編集権限。	エージェントと MCP サーバーを登録して管理します。 ツール定義とエンドポイントを更新します。
Agent Registry API 閲覧者	エージェント、ツール、およびそれらの属性を表示します。	利用可能なエージェントと MCP サーバーを検出します。 統合のスキルとエンドポイントを表示します。

Agent Registry の権限

次の表に、各エージェント レジストリ IAM ロールが持つ権限を示します。

Agent Registry API 管理者 Agent Registry API 編集者 Agent Registry API 閲覧者 すべてクリア

Agent Registry API 管理者 ^ベータ版 （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 編集者 ^ベータ版 （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 閲覧者 ^ベータ版 （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 のロールと権限のインデックスをご覧ください。