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

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

このドキュメントでは、Agent Registry を設定して必要な API を有効にする方法について説明します。

始める前に

Agent Registry を設定するには、既存のプロジェクトを使用するか、 新しいプロジェクトを作成します。

必要なロール

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

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

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

gcloud CLI 環境を設定する

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

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

    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 を有効にすると、このプロジェクトでエージェントの登録と検出を開始できます。

権限を付与する

Agent Registry でサービスを表示して管理するには、ユーザーに 適切な Cloud 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 を無効にする

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

コンソール

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

    Agent Registry API に移動

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

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

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

gcloud 

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

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

次のステップ