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

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

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

始める前に

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

必要なロール

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

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

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

gcloud CLI 環境を設定する

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

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

権限を付与する

Agent Registry でリソースを表示して管理するには、ユーザーに 適切な 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 ユーザー （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 に置き換えます。

次のステップ