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

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

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

始める前に

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

必要なロール

Agent Registry の設定に必要な権限を取得するには、 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. 最新バージョンの gcloud CLI がインストールされていることを確認します。

    gcloud components update

Agent Registry API を有効にする

コンソール

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

API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（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（IAM）権限を付与する必要があります。

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

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

プロジェクトで 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 agentregistry.googleapis.com \
    --project=PROJECT_ID

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

次のステップ