このドキュメントでは、エージェント レジストリに関連する重要な用語とコンセプトについて説明します。
エージェント
AI エコシステム内の自律型アクター。識別子と、そのアクターが持つ特定のスキルによって定義されます。
エージェント ID
エージェントのグローバルに一意で不変の名前。この論理識別子は、基盤となるインフラストラクチャの変更に関係なく、コンシューマーがエージェントを呼び出すための安定した参照を提供します。
エージェント ID は、取り込み時にエージェント レジストリによって自動的に生成され、Uniform Resource Name（URN）形式に従います。厳密な形式は、エージェントがデプロイされる場所によって異なります。次に例を示します。
- Gemini Enterprise Agent Platform のエージェント ランタイム:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Cloud Run サービス:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - GKE の Deployment:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace:
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - 手動で登録されたエージェント:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
エージェント プリンシパル
エージェントに割り当てられた一意の Identity and Access Management（IAM）識別子。これにより、エージェントは権限を保持し、監査を受けることができます。これは、エージェントまたはサーバーにバインドされた、検証可能な Google Cloudサービス アカウントまたはマネージド Workload Identity（SPIFFE ID など）の形式になります。
この ID はエージェントのランタイムのコンピューティング リソースに直接バインドされているため、プリンシパル文字列にはその基盤となるリソースへの正確なパスが組み込まれます。たとえば、Gemini Enterprise Agent Platform デプロイの Agent Runtime のエージェント プリンシパルは次のようになります。
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
この ID は、エージェントの詳細を表示すると、出力専用の属性として Agent Registry に表示されます。
エージェント コンポーネント
AI エコシステム内のモジュール型の機能エンティティ。Agent Registry を使用して登録、検出、管理できます。レジストリは、エージェント コンポーネントを 3 つの主なタイプ（エージェント、MCP サーバー、エンドポイント）に分類します。
エージェント ワークフロー
AI エージェントがタスクを完了するために、ツールの使用、推論、実行パスを独自に決定する一連の手順。
Auth provider（認証プロバイダ）
エージェント ID 認証マネージャー内の構成。エージェントを特定の外部ツールやアプリケーションに接続するための認証情報（API キーや OAuth トークンなど）を保存、取得、管理し、認証タイプを定義します。
バインディング
ソース エージェントとターゲット リソース（別のエージェント、MCP サーバー、エンドポイントなど）間の接続。バインディングを作成すると、オーケストレーター エージェントがダウンストリーム機能とやり取りできる明示的な関係が確立されます。バインディングは、委任された権限をサポートするために、エージェントを認証プロバイダに関連付けるためにも使用されます。
データリソース
MCP サーバーによって公開される特定のデータ コンテキストまたはデータセット。エージェントは、レスポンスの根拠やアクションの通知のためにこれにアクセスできます。
調査
レジストリにクエリを実行して、説明、タグ、スキルに基づいて既存のエージェント、MCP ツール、エンドポイントを検索するプロセス。
エージェント レジストリでの検出は、AI オーケストレーターが使用できる消費中心の機能に重点を置いています。登録済みの機能を検出して、AI システムを構築し、オーケストレートします。
Agent Registry のこのプロセスは、App Hub などのインフラストラクチャ検出とは異なります。インフラストラクチャ検出では、 Google Cloud プロジェクトで登録されていないコンピューティング リソースが特定されます。
エンドポイント
Agent Registry API の場合、エージェントがアクセスするターゲット URL（通常は REST API）を表すリソース。これらの宛先を管理可能なリソースに抽象化することで、エージェント レジストリを使用すると、エージェントがアクセスできる外部サービスを一元的に管理できます。
Model Context Protocol（MCP）
AI モデルをデータソースやツールに接続するために使用されるオープン スタンダードで、カスタム プラグインに取って代わります。
MCP サーバー（またはサーバー）
Model Context Protocol（MCP）を実装して、標準化されたツールとデータリソースを AI エージェントに提供するサービス。
MCP サーバー識別子
MCP サーバーのグローバルに一意で不変の Uniform Resource Name（URN）。エージェント識別子と同様に、この名前は特定のツールセットを検出するための安定した参照を提供します。
形式は、組み込みの Google サービスか、登録済みの外部サーバーかによって異なります。次に例を示します。
- Google Cloud リモート MCP サーバー:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - 手動で登録された MCP サーバー:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID
登録
エージェント、MCP サーバー、エンドポイントなどのエージェント コンポーネントをレジストリに追加するプロセス。Agent Registry には、次の登録メカニズムが用意されています。
- 自動登録: Agent Runtime などのサポートされている Google Cloud AI リソースの自動取り込み。
- 手動登録: カスタム エージェント コンポーネントまたは外部エージェント コンポーネントの手動オンボーディング。
リソースの URI
エージェントまたは MCP サーバーをホストする物理ランタイムの場所またはインフラストラクチャ。Uniform Resource Identifier（URI）は、このランタイム リソースを識別する一意の文字シーケンスです。たとえば、リソース URI は、エージェント ランタイム エンドポイント、Google Kubernetes Engine（GKE）デプロイ、Cloud Run サービスなどです。
リソース URI は、エージェント識別子または MCP サーバー識別子とは異なります。これらの値は、レジストリでエージェントと MCP サーバーを識別する URN 形式の一意の名前です。一方、リソース URI は、エージェントまたはサーバーが実行される実際のコンピューティング リソースを指します。
エージェントのリソース URI へのパスは、IAM ポリシーでそのリソースを一意に識別するために、エージェント プリンシパル文字列内に埋め込まれます。
この URI は、エージェントの詳細を表示するときに、出力専用の属性として Agent Registry に表示されます。
リソース URI を使用して、トポロジ グラフでクエリを作成し、特定のエージェントのトラフィック フローと関係を可視化できます。Agent Registry API では、この値は agentregistry.googleapis.com/system/RuntimeReference 属性で表されます。
サービス
Agent Registry API の場合、カスタムまたは外部のエージェント コンポーネントを手動でレジストリに登録するために使用される書き込み可能なリソース。Service は、レジストリに手動で追加されたエージェント、MCP サーバー、エンドポイントを表します。Service リソースを作成して管理し、Agent Registry が自動的に取り込まないエージェント コンポーネントのエンドポイントとメタデータを定義します。
指定した仕様に応じて、エージェント レジストリは、この Service を読み取り専用の Agent、McpServer、または Endpoint リソースとしてコンシューマー側に自動的に投影し、検出できるようにします。
レジストリ エントリの作成、編集、削除には、常に Service リソースを使用します。ただし、これらのエントリを取得、一覧表示、検索するには、読み取り専用の Agent、McpServer、Endpoint リソースをクエリします。
スキル
A2A エージェントが持つ高レベルの機能。スキルは A2A エージェント カードから抽出され、エージェントの検出の主要なデータポイントとして機能します。
ツール
エージェントが呼び出すことができる MCP サーバーによって提供される決定論的関数。