AI エージェント、Model Context Protocol（MCP） サーバー、エンドポイントを Agent Registry に登録して検出するには、Agent Registry API をプロジェクトで有効にする必要があります。 Google Cloud Agent Registry はプロジェクト レベルで動作し、API が有効になっている特定のプロジェクト内にデプロイされたエージェントを検出して管理できます。
このドキュメントでは、Agent Registry を設定して必要な API を有効にする方法について説明します。
始める前に
Agent Registry を設定するには、既存のプロジェクトを使用するか、 新しいプロジェクトを作成します。
必要なロール
Agent Registry の設定に必要な権限を取得するには、 プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。 Google Cloud
-
Agent Registry API を有効にする:
Service Usage 管理者 （
roles/serviceusage.serviceUsageAdmin） -
Agent Registry API を使用するロールを付与する:
プロジェクト IAM 管理者 （
roles/resourcemanager.projectIamAdmin） -
Agent Registry API リソースへのフルアクセス権を取得する:
Agent Registry API 管理者 (
roles/agentregistry.admin)
ロールの付与の詳細については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。
必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。
gcloud CLI 環境を設定する
Agent Registry に Google Cloud CLI を使用する場合は、次の手順を行います。
-
コンソールで Cloud Shell をアクティブにします。 Google Cloud
コンソールの下部にある Google Cloud Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です 。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています 。セッションが初期化されるまで数秒かかることがあります。
最新バージョンの gcloud CLI がインストールされていることを確認します。
gcloud components update
Agent Registry API を有効にする
コンソール
API を有効にするために必要なロール
API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を通じてこの権限が付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を通じてこの権限を取得できます。ロールを付与する方法をご覧ください。
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）: エージェントの手動登録やメタデータの更新など、すべてのアクションを実行します。
プロジェクトに IAM ロールを付与する方法については、 プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。
Agent Registry プロジェクトを変更する
Agent Registry を使用するプロジェクトを変更し、古いプロジェクトから 依存関係を削除する場合は、そのプロジェクトでAgent Registry API を無効にします。その後、別のプロジェクトで Agent Registry API を有効にできます。データは移行されないため、この新しいプロジェクトでリソースを再作成する必要があります。
Agent Registry API を無効にする
Agent Registry が不要になった場合は、プロジェクトで Agent Registry API を無効にします。
コンソール
コンソールで、Agent Registry API 管理ページに移動します。 Google Cloud
プロジェクト選択ツールから、Agent Registry を設定した プロジェクトを選択します。 Google Cloud
[API を無効にする] をクリックします。
確認ダイアログで [無効にする] をクリックします。
gcloud
gcloud services disable agentregistry.googleapis.com \
--project=PROJECT_ID
PROJECT_ID を
実際のプロジェクト ID に置き換えます。