このドキュメントでは、Agent Registry に関連する主な用語とコンセプトについて説明します。
A2A スキル
スキルと比較してください。
エージェントの
Agent Card
（agent-card.json）内にインラインで表される宣言型機能メタデータ ブロック。A2A スキルは、エージェント間の通信インターフェース
と、A2A 準拠のエージェントが持つ高レベルの機能を記述します。
Agent Registry は、Agent2Agent（A2A）仕様のバージョン 0.3 と 1.0 をサポートしています。
エージェント
AI エコシステムの自律アクター。 識別子と、所有する特定の A2A スキルまたは スキルによって定義されます。
エージェント ID
エージェントのグローバルに一意の不変の名前。この論理識別子は、基盤となるインフラストラクチャの変更に関係なく、コンシューマがエージェントを呼び出すための安定した参照を提供します。
エージェント ID は、取り込み時に Agent Registry によって自動的に生成され、Uniform Resource Name（URN）形式に従います。正確な形式は、エージェントのデプロイ先によって異なります。次に例を示します。
- Gemini Enterprise Agent Platform の Agent Runtime:
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 サービス アカウントまたはマネージド ワークロード ID（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
Agent Registry では、エージェントの詳細を 表示すると、この ID が出力専用属性として表示されます。
エージェント コンポーネント
AI エコシステム内のモジュール型の機能エンティティ。Agent Registry を使用して登録、検出、管理できます。レジストリは、エージェント コンポーネント を 4 つの主要なタイプに分類します。エージェント、MCP サーバー、 エンドポイント、およびスキルです。
エージェント ワークフロー
AI エージェントがタスクを完了するために、ツールの使用、推論、実行パスを独自に決定する一連のステップ。
Auth provider
エージェントを特定の外部ツールやアプリケーションに接続し、認証タイプを定義するための API キーや OAuth トークンなどの認証情報を保存、取得、管理する Agent Identity 認証マネージャー 内の構成。
バインディング
ソース エージェントとターゲット リソース（ 別のエージェント、MCP サーバー、エンドポイントなど）間の接続。バインディングを作成することで、オーケストレータ エージェントがダウンストリーム機能とやり取りできる明示的な関係を確立できます。バインディングは、委任された権限をサポートするために、エージェントを認証プロバイダに関連付けるためにも 使用されます。
データリソース
MCP サーバーによって公開される特定のデータ コンテキストまたはデータセット。エージェントはこれにアクセスして、レスポンスの根拠にしたり、アクションを通知したりできます。
現状把握
説明、タグ、 スキルに基づいて既存のエージェント、MCP ツール、またはエンドポイントを検索するためにレジストリにクエリを実行するプロセス。
Agent Registry での現状把握は、AI オーケストレータが使用できるコンシューマ中心の機能に重点を置いています。すでに登録されている機能を検出して、AI システムを構築し、オーケストレーションします。
Agent Registry のこのプロセスは、 App Hub などのインフラストラクチャの現状把握とは異なります。App Hub では、登録されていない コンピューティング リソースがプロジェクト Google Cloud に識別されます。
エンドポイント
Agent Registry API の場合、エージェントがアクセスするターゲット URL（通常は REST API）を表すリソース。これらの宛先を管理可能なリソースに抽象化することで、Agent Registry では、エージェントがアクセスできる外部サービスを一元的に管理できます。
Model Context Protocol（MCP）
AI モデルをデータソースやツールに接続するために使用されるオープン標準。カスタム プラグインに代わるものです。
MCP サーバー（またはサーバー）
Model Context Protocol（MCP） を実装して、標準化されたツールとデータリソースを AI エージェントに提供するサービス。
MCP サーバー ID
MCP サーバーのグローバルに一意の不変の Uniform Resource Name（URN）。エージェント ID と同様に、この 名前は特定のツールセットを検出するための安定した参照を提供します。
形式は、組み込みの 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 リソースの自動取り込み。自動登録は、単一プロジェクトのスコープ内で動作します。
- 手動登録: カスタムまたは外部のエージェント コンポーネントの手動オンボーディング、または一元的な検出と管理のために複数の Google Cloud プロジェクトにデプロイされたエージェント。
リソースの URI
エージェントまたは MCP サーバーをホストする物理ランタイム ロケーションまたはインフラストラクチャ。Uniform Resource Identifier（URI）は、このランタイム リソースを識別する一意の文字列です。たとえば、リソース URI は、Agent Runtime エンドポイント、Google Kubernetes Engine（GKE）Deployment、Cloud Run サービスなどです。
リソース URI は、エージェント ID または MCP サーバー ID とは異なります。これらの値は、レジストリ内のエージェントと MCP サーバーを識別する URN 形式の一意の名前です。 一方、リソース URI は、エージェントまたはサーバーが実行される実際のコンピューティング リソースを指します。
エージェントのリソース URI へのパスは、IAM ポリシーでそのリソースを一意に識別するために、 エージェント プリンシパル文字列に埋め込まれます。プロジェクト間の登録の場合、 リソース URI はコンピューティング リソースが存在するプロジェクトを参照します。
Agent Registry では、エージェントの詳細を 表示すると、この URI が出力専用属性として表示されます。
リソース URI を使用して、トポロジ
グラフでクエリを作成し、
特定のエージェントのトラフィック フローと関係を可視化できます。Agent Registry API では、この値は agentregistry.googleapis.com/system/RuntimeReference 属性で表されます。
サービス
Agent Registry API の場合、カスタムまたは
外部 エージェント コンポーネントをレジストリに手動で登録するために使用される書き込み可能なリソース。Service は、レジストリに手動で追加されたエージェント、MCP サーバー、またはエンドポイントを表します。Service リソースを作成して管理し、Agent Registry が自動的に取り込まないエージェント コンポーネントのエンドポイントとメタデータを定義します。
指定した仕様に応じて、Agent Registry はこの Service を読み取り専用の Agent、McpServer、または Endpoint リソースとしてコンシューマー側に自動的に投影し、検出します。
レジストリ エントリの作成、編集、削除には、常に Service リソースを使用します。ただし、これらのエントリを取得、一覧表示、検索するには、読み取り専用の Agent、McpServer、または Endpoint リソースにクエリを実行します。
スキル
A2A スキルと比較してください。
タスクを完了するための具体的な手順、自然言語、コードを提供することで、エージェントの機能を拡張する、
Agent Registry に最上位リソースとして登録されたスタンドアロンの実行可能パッケージ。
スキルには、手順ファイル（SKILL.md）、ランタイム実行スクリプト、メタデータ アセットが含まれます。
スキルは Uniform Resource Name（URN）で識別されます。正確な形式 はパブリッシャーによって異なります。次に例を示します。
- Google が作成したスキル:
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. 例:urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing - 手動で登録されたスキル:
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. 例:urn:skill:projects-123456789:locations:global:private-create-docs
Google が作成したスキルは、Agent Registry を設定するとすぐに表示されます。 独自のスキルを登録することもできます。スキルは、エージェントと MCP サーバーの兄弟リソースとして Agent Registry に登録します。各スキルにはデフォルトのリビジョンがあり、 複数のバージョン管理されたスキル リビジョンを含めることができます。
プラットフォーム管理者は、ライフサイクル状態を 管理し、ランタイム 解決のデフォルト バージョン ポインタを 設定することで、スキルを管理します。
スキル リビジョン
スキル パッケージの不変のバージョン管理されたスナップショット。リビジョンを使用すると、親スキルの識別子を変更せずにスキル手順やコードを更新できます。
スキル リビジョンを管理して、スキルのバージョン 管理を可能にできます。
パブリッシャー
Agent Registry でスキルを作成して登録するエンティティ。
事前入力されたパブリッシャーには、Google パブリッシャー（cloud.google.com、discoveryengine.googleapis.com など）と確認済みのパートナーが含まれます。これらのパブリッシャーから Google が作成したスキルは、Agent Registry を設定するとすぐに表示されます。
作成したスキルはデフォルトの private
パブリッシャーに自動的に割り当てられるため、特定のスキルの公開 ID には
private- という接頭辞が付きます。カスタム パブリッシャー リソースを登録することはできません。
登録した スキルのパブリッシャーの詳細を確認します。
ツール
エージェントが 呼び出すことができる MCP サーバーによって提供される決定論的関数。