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