エージェント レジストリを設定する

Agent Registry で AI エージェント、Model Context Protocol（MCP）サーバー、スタンドアロン スキル、エンドポイントを登録して検出するには、 Google Cloud プロジェクトで Agent Registry API を有効にする必要があります。Agent Registry を有効にするプロジェクトは、ガバナンス プロジェクトとして機能します。

Agent Registry は、単一のガバナンス プロジェクトで設定することも、複数のプロジェクトにまたがって設定することもできます。複数のプロジェクトにまたがって設定する場合は、中央の管理プロジェクトがガバナンス プロジェクトとして機能する管理境界を構成します。

始める前に

単一のプロジェクトまたは複数のプロジェクトで Agent Registry を構成します。

必要なロール

Agent Registry の設定に必要な権限を取得するには、 Google Cloud プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Google Cloud CLI 環境を設定する

Agent Registry に gcloud CLI を使用する場合は、次の手順に沿って操作します。

  1. Google Cloud コンソールで Cloud Shell をアクティブにします。

    Cloud Shell をアクティブにする

    Google Cloud コンソールの下部で Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。

  2. gcloud components update コマンドを使用して、gcloud CLI を最新バージョンに更新します。

    gcloud components update

  3. プレビュー機能を使用する場合は、gcloud components install コマンドを使用して alpha コンポーネントをインストールします。

    gcloud components install alpha

Agent Registry API を有効にする

  • 単一のプロジェクトの場合: ガバナンス プロジェクトで Agent Registry API を有効にします。API を有効にして権限を付与すると、そのプロジェクトでエージェントの登録と検出を開始できます。管理境界を構成する必要はありません。
  • 複数のプロジェクト（管理境界）の場合: 構成コマンドの実行に使用するプロジェクトで Resource Manager API を有効にします。複数のプロジェクトの管理境界を構成して機能構成を作成すると、Resource Manager は管理プロジェクトで Agent Registry API を自動的に有効にします。

プロジェクト ID を使用して API を有効にします。

コンソール

単一のプロジェクトの場合は、プロジェクトで Agent Registry API を有効にします。

API を有効にするために必要なロール

API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法を確認する。

API の有効化

複数のプロジェクト（管理境界）の場合は、構成に使用するプロジェクトで Resource Manager API を有効にします。

API を有効にするために必要なロール

API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法を確認する。

API の有効化

gcloud

  • 単一のプロジェクトの場合は、gcloud services enable コマンドを使用して、プロジェクトで Agent Registry API を有効にします。

    gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

  • 複数のプロジェクト（管理境界）の場合は、構成に使用するプロジェクトで Resource Manager API を有効にします。

    gcloud services enable cloudresourcemanager.googleapis.com \
    --project=PROJECT_ID

PROJECT_ID は、スタンドアロン ガバナンス プロジェクトのプロジェクト ID、または管理境界の管理プロジェクトとして使用するプロジェクトに置き換えます。

複数のプロジェクトの管理境界を構成する

複数の Google Cloud プロジェクトで Agent Registry を使用するには、管理境界を構成します。管理境界は、1 つ以上の Google Cloud メンバー プロジェクトを、ガバナンス プロジェクトとして機能する中央の管理プロジェクトにグループ化します。これにより、プロジェクト間で AI エージェント、MCP サーバー、ツールを検出して管理できます。

管理境界は Resource Manager で定義します。詳しい手順については、Resource Manager ドキュメントの管理境界を構成するをご覧ください。

BoundaryConfig、Boundary、CapabilityConfig リソースがどのように連携するかのアーキテクチャの概要については、プロジェクト間の境界をご覧ください。

agent-management を使用して CapabilityConfig リソースを作成すると、Resource Manager は管理プロジェクトで agentregistry.googleapis.com を自動的に有効にします。管理境界を確立したら、次の手順を行います。

  1. 個々のメンバー プロジェクト内のローカル オペレーションに必要な場合は、それらのメンバー プロジェクトで Agent Registry API を有効にします。
  2. 管理プロジェクトのユーザーとサービス アカウントに必要なロールと権限を付与します。

管理プロジェクトのロケーションでエージェントまたは MCP サーバーを一覧表示または検索すると、Agent Registry は、境界内のすべてのメンバー プロジェクトからそのロケーションで自動検出されたリソースを集計して返します。また、管理プロジェクトのそのロケーションで直接作成された登録済みの Service リソースも返します。返された各リソース名は、コンポーネントの ID を保持し、リクエストで指定されたプロジェクトを使用します。

権限を付与する

Agent Registry でリソースを表示して管理するには、ユーザーに適切な Identity and Access Management（IAM）権限を付与する必要があります。

ユーザーに次の Agent Registry ロールの 1 つ以上を付与します。

  • Agent Registry API 閲覧者（roles/agentregistry.viewer）: エージェント、MCP サーバー、ツール、スタンドアロン スキル、スキル リビジョン、パブリッシャー、エンドポイント、バインディングを表示して検索します。
  • Agent Registry API 編集者（roles/agentregistry.editor）: エージェント、MCP サーバー、ツール、エンドポイント、スタンドアロン スキル、スキル リビジョンの登録、更新、削除など、Agent Registry リソースを表示、編集します。
  • Agent Registry API 管理者（roles/agentregistry.admin）: エージェント、MCP サーバー、ツール、エンドポイント、スタンドアロン スキル、スキル リビジョン、バインディング、スキル IAM ポリシーの登録と管理など、Agent Registry リソースに対するすべてのアクションを実行します。
  • Agent Registry ユーザー（roles/agentregistry.user）: すべての Agent Registry リソースを表示し、エージェント、MCP サーバー、エンドポイントへの編集権限なしで、スタンドアロン スキルとスキル リビジョンを作成、更新、削除します。

プロジェクトに IAM ロールを付与する方法については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

Agent Registry プロジェクトを変更する

Agent Registry を使用するプロジェクトを変更し、古いプロジェクトから依存関係を削除する場合は、古いプロジェクトで Agent Registry API を無効にします。古いプロジェクトで Agent Registry API を無効にすると、別のプロジェクトで有効にできます。データは移行されません。この新しいプロジェクトでリソースを再作成する必要があります。

Agent Registry API を無効にする

Agent Registry を使用する必要がなくなった場合は、プロジェクトで Agent Registry API を無効にします。

コンソール

  1. Google Cloud コンソールで、Agent Registry API 管理ページに移動します。

    Agent Registry API に移動

  2. プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを選択します。

  3. [API を無効にする] をクリックします。

  4. 確認ダイアログで [無効にする] をクリックします。

gcloud

gcloud services disable コマンドを使用して、プロジェクトで Agent Registry API を無効にします。

gcloud services disable agentregistry.googleapis.com \
    --project=PROJECT_ID

PROJECT_ID は、プロジェクトの ID に置き換えます。

次のステップ