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

Agent Registry で AI エージェントと Model Context Protocol（MCP）サーバーを登録して検出するには、 Google Cloudプロジェクトで Agent Registry API を有効にする必要があります。エージェント レジストリはプロジェクト レベルで動作し、API が有効になっている特定のプロジェクト内にデプロイされたエージェントを検出して管理できます。

このドキュメントでは、エージェント レジストリを設定して必要な API を有効にする方法について説明します。

始める前に

エージェント レジストリを設定するには、既存のプロジェクトを使用するか、新しいプロジェクトを作成します。

必要なロール

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

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

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

gcloud CLI 環境を設定する

Google Cloud CLI を Agent Registry に使用する場合は、次の操作を行います。

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

    Cloud Shell をアクティブにする

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

  2. alpha コンポーネントをインストールします。

    gcloud components install alpha

  3. Google Cloud CLI の最新バージョンがインストールされていることを確認します。

    gcloud components update

Agent Registry API を有効にする

コンソール

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

API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。

API の有効化

gcloud

プロジェクトで Agent Registry API を有効にします。

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

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

Agent Registry API を有効にすると、このプロジェクトでエージェントの登録と検出を開始できます。

権限を付与する

エージェント レジストリでリソースを表示して管理するには、ユーザーに適切な Identity and Access Management 権限を付与する必要があります。

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

  • Agent Registry API 閲覧者（roles/agentregistry.viewer）: エージェント、ツール、それらの属性を表示します。
  • Agent Registry API 編集者（roles/agentregistry.editor）: Agent Registry リソースに対する編集権限。
  • Agent Registry API 管理者（roles/agentregistry.admin）: エージェントの手動登録やメタデータの更新など、すべてのアクションを実行します。

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

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

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

Agent Registry API を無効にする

エージェント レジストリが不要になった場合は、プロジェクトでエージェント レジストリ API を無効にします。

コンソール

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

    Agent Registry API に移動

  2. プロジェクト選択ツールから、エージェント レジストリを設定した Google Cloud プロジェクトを選択します。

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

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

gcloud

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

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

次のステップ