Agent Registry は、標準化された用語を使用して、AI エコシステム全体のコンポーネント、リソース、ガバナンス メカニズムを記述します。これらの基本的なコンセプトを理解すると、Agent Registry でエージェント、MCP サーバー、エンドポイント、スキルを登録、検出、接続、管理できます。
A2A スキル
スキルと比較。
エージェントの agent-card.json
エージェント カード内にインラインで記述された機能の説明。A2A スキルは、エージェントが実行できるタスクとその通信インターフェースを記述します。これにより、他のエージェントは、いつどのように作業を委任するかを把握できます。
Agent Registry は、Agent2Agent(A2A)仕様のバージョン 0.3 と 1.0 をサポートしています。スタンドアロン スキルとの比較については、スタンドアロン スキルと A2A スキルの違いをご覧ください。
エージェント
AI エコシステム内の自律的なアクター。計画、推論、ツールの呼び出し、他のエージェントとの連携を行います。エージェントは、エージェント識別子と、それが持つ各 A2A スキルまたはスタンドアロン スキルによって定義されます。Agent Registry では、登録されたエージェントは読み取り専用の Agent 検出リソースとして表されます。
エージェント プリンシパル
エージェントに割り当てられた一意の Identity and Access Management(IAM)ID。これにより、エージェントは権限を保持し、ダウンストリーム リソースにアクセスして、監査ログを生成できます。これは、検証可能な Google Cloud サービス アカウントまたはマネージド Workload Identity(SPIFFE ID など)の形式で、エージェントのコンピューティング ランタイムに直接バインドされます。
プリンシパル文字列にはランタイム参照パスが組み込まれており、エンジン インスタンス、プロジェクト全体のプリンシパル セット、組織全体のプリンシパル セットの 3 つのスコープがサポートされています。
完全な構文とアクセス制御のガイダンスについては、エージェント プリンシパルをご覧ください。
エージェント コンポーネント
AI エコシステム内のモジュール化された機能エンティティ。Agent Registry を使用して登録、検出、管理できます。レジストリは、エージェント コンポーネントをエージェント、MCP サーバー、エンドポイント、スキルの 4 つの主なタイプに分類します。
詳細については、コンポーネントのライフサイクルと検出をご覧ください。
Agentic Workflows
AI エージェントがツールの使用、推論、実行パスを独自に決定してタスクを完了する一連のステップ。
Auth provider(認証プロバイダ)
エージェントを外部ツールやダウンストリーム サービスに接続するための認証情報(API キーや OAuth トークンなど)を保存、取得、管理するための Agent Identity Auth Manager 内の構成。
エージェントを認証プロバイダにバインドする方法については、コンポーネントの関係をご覧ください。
バインディング
ソースエージェントとターゲット リソース(別のエージェント、MCP サーバー、エンドポイントなど)間の有向接続。バインディングは、コンポーネント間の明示的な委任パスを確立し、委任された権限の認証プロバイダにエージェントを関連付けます。
詳細については、バインディングをご覧ください。
データリソース
エージェントがレスポンスのグラウンディングやアクションの通知のためにアクセスできる、MCP サーバーによって公開される特定のデータ コンテキストまたはデータセット。
現状把握
自然言語検索、タグ、レジストリ ID を使用して、登録済みのエージェント、MCP ツール、エンドポイント、スキルを検索するために Agent Registry にクエリを実行するプロセス。
Agent Registry での検出は、消費検出に重点を置いています。これにより、オーケストレーター エージェントが実行時に呼び出すことができる機能とコンポーネントを特定します。詳細については、検出タイプをご覧ください。
エンドポイント
エージェントがアクセスするターゲット URL(通常は REST API)。Agent Registry では、登録されたエンドポイントは読み取り専用の Endpoint 検出リソースとして表され、エージェントがアクセスできる外部サービスを一元的に管理できます。
ガバナンス プロジェクト
Google Cloud プロジェクト。エージェント コンポーネントを一元的にカタログ化、検出、管理するために Agent Registry API を有効にします。プロジェクトをまたぐ管理境界では、管理プロジェクトが境界の中央ガバナンス プロジェクトとして機能します。単一プロジェクトとクロスプロジェクトの構成の詳細については、中央レジストリのガバナンス プロジェクトを定義するをご覧ください。
ガバナンスのスコープ
Agent Registry リソースが登録され、管理される地理的およびアーキテクチャ上の境界。
Agent Registry は、一元化された Google Cloud ガバナンス プロジェクトを使用します。このプロジェクトで Agent Registry API を有効にして、エージェント コンポーネントをカタログ化して管理します。デフォルトでは、自動登録により、そのガバナンス プロジェクトにデプロイされているサポート対象のワークロードが検出されます。管理境界を構成すると、管理プロジェクトが中央ガバナンス プロジェクトとして機能し、境界内のメンバー プロジェクトで検出されたサポート対象のワークロードを自動的に集約します。ガバナンス プロジェクトまたは管理境界の外部(境界のない個別のGoogle Cloud プロジェクト、オンプレミス環境、外部クラウドなど)でホストされているリモート コンポーネントを管理するには、ガバナンス プロジェクトのレジストリに手動で登録します。
Agent Registry が Google または Google Cloudリモート MCP サーバーを自動的に登録すると、McpServer リソースは個々のリージョンではなく、global ロケーションにのみ作成されます。サポート対象の地域または global ロケーションで、エージェント、MCP サーバー、エンドポイントを手動で登録し、バインディングを作成できます。リージョン ゲートウェイは、リージョン リソースと global MCP サーバーの両方にトラフィックを管理してルーティングできます。
リージョン スコープのルールとポリシー要件の詳細については、Agent Registry のロケーションをご覧ください。
管理境界
AI エコシステムの管理境界を定義する 1 つ以上の Google Cloud プロジェクトのコレクション。Resource Manager では Boundary リソースで表されます。管理境界は、Resource Manager の組織またはフォルダで定義されます。そのフォルダまたは組織内のすべての子プロジェクトを含めることも、オプションのタグで子プロジェクトをフィルタすることもできます。管理境界を使用すると、複数のメンバー プロジェクトにわたってエージェント コンポーネントの一元的な検出とガバナンスを有効にできます。
Agent Registry は、Resource Manager の BoundaryConfig、Boundary、CapabilityConfig リソースを使用して、プロジェクト間のビューと一元化されたアクセス ポリシーをサポートします。これらの Resource Manager リソースの詳細については、管理の境界と機能の概要をご覧ください。
Agent Registry で管理境界を使用する方法については、プロジェクト間の境界をご覧ください。
管理プロジェクト
管理境界の中心的なガバナンス プロジェクトとして機能する Google Cloud プロジェクト。境界全体で管理タスク、API エンドポイント、メタデータを一元化します。管理プロジェクトを使用して、Agent Registry の設定、課金と割り当ての構成、メンバー プロジェクト全体の集約されたエージェントとツールのレジストリのクエリを行います。
詳細については、管理プロジェクトをご覧ください。
Model Context Protocol(MCP)
AI モデルをデータソースやツールに接続するために使用されるオープン スタンダード。カスタム プラグインに代わるものです。
MCP サーバー
Model Context Protocol(MCP)を実装して、標準化されたツールとデータリソースの機能を AI エージェントに公開するプログラム。Agent Registry では、登録済みの MCP サーバーは読み取り専用の McpServer 検出リソースとして表されます。
パブリッシャー
スキルを作成して登録するエンティティ。Agent Registry では Publisher リソースとして表されます。パブリッシャーは、スキルのオーナー権限とスキル識別子の構文を確立します。
Google が管理するスキルはサービス ドメインを使用します。手動で作成されたスキルは、private- 接頭辞が付いた private パブリッシャーに自動的にスコープされます。
詳細については、パブリッシャーをご覧ください。
登録
エージェント、MCP サーバー、エンドポイント、スキルなどのエージェント コンポーネントを Agent Registry に追加するプロセス。
Agent Registry は、次の 2 つの登録モデルをサポートしています。
- 自動登録: Agent Registry が有効になっているガバナンス プロジェクトにデプロイされた、サポートされている Google Cloud ランタイム(Gemini Enterprise Agent Platform の Agent Runtime など)からエージェント、MCP サーバー、Google が管理するスキルを自動的に取り込みます。また、管理境界を構成すると、メンバー プロジェクト全体で集計されます。
- 手動登録: リモートまたはカスタムのエージェント、MCP サーバー、エンドポイント、プライベート スタンドアロン スキルの明示的な登録。これには、管理境界のない別の Google Cloud プロジェクト、オンプレミス環境、外部クラウド、サポートされていないランタイムでホストされているコンポーネントも含まれます。これらは、ガバナンス プロジェクトのレジストリにリソースを作成することで登録されます。
アーキテクチャの詳細な比較については、登録モデルをご覧ください。
レジストリ ID
Agent Registry が登録済みのエージェント コンポーネントに割り当てる、グローバルに一意で不変の Uniform Resource Name(URN)。この識別子は、コンシューマとオーケストレーター エージェントが Agent Registry でコンポーネントを検出、フィルタリング、検索するための安定した参照を提供します。基盤となるインフラストラクチャの変更やコードの更新に関係なく、一定に保たれます。
URN 構文形式の詳細については、レジストリ ID をご覧ください。
ランタイム リファレンス
エージェント、MCP サーバー、またはエンドポイントをホストする物理的なランタイム ロケーションまたはコンピューティング インフラストラクチャ。Agent Registry では agentregistry.googleapis.com/system/RuntimeReference 属性で表されます。たとえば、ランタイム参照は、Agent Runtime 推論エンジン、Google Kubernetes Engine(GKE)デプロイ、Cloud Run サービスを指すことができます。
ランタイム参照パスは、IAM ポリシー評価のためにエージェント プリンシパルに埋め込まれます。詳細については、ランタイム リファレンスをご覧ください。
サービス リソース
Agent Registry 内の書き込み可能なリソース。独自のリソース名で識別され、エージェント、MCP サーバー、エンドポイントを手動で登録する際の管理オペレーションに使用されます。Service リソースには、エージェント コンポーネントのタイプや、インターフェース URL、説明、プロトコル バインディング、機能仕様などの構成の詳細を含む、コンポーネントのメタデータが保存されます。自動的に登録されたコンポーネントまたはスタンドアロンのスキルは、Service リソースを使用しません。
Service リソースを作成、更新、削除して、基盤となるデプロイを変更または削除することなく、Agent Registry で手動で登録されたコンポーネントを登録、メタデータの更新、登録解除します。Service リソースを作成または更新すると、Agent Registry はメタデータを読み取り、対応する Agent、McpServer、または Endpoint 検出リソースを自動的に作成または更新します。Agent Registry では、オーケストレーター エージェント、クライアント アプリケーション、デベロッパーなどのコンシューマーが、これらの読み取り専用の検出リソースを使用して、エージェント コンポーネントを一覧表示、検索、表示します。詳細については、Agent Registry でのエージェント コンポーネントの表現をご覧ください。
スキル
A2A スキルと比較してください。
Agent Registry に最上位の Skill リソースとして登録されたスタンドアロン パッケージ。タスクを完了するための特定の指示とオプションのスクリプトを提供することで、エージェントの機能を拡張します。スキルには、SKILL.md 命令ファイル、オプションのスクリプト、メタデータ アセットが含まれます。
スキルは、パブリッシャーと標準のリソース名によってスコープが設定されたスキル識別子によって識別されます。各スキルはデフォルトのリビジョン ポインタを保持し、1 つ以上のバージョニングされたスナップショットを持ちます。各スナップショットはスキル リビジョンとして表されます。
アーキテクチャ、パッケージング、ライフサイクルの詳細については、スキル アーキテクチャをご覧ください。
スキル リビジョン
スキル パッケージの不変のバージョニングされたスナップショット。Agent Registry の SkillRevision リソースとして表されます。スキル リビジョンを使用すると、親スキル ID を変更したり、既存のエージェントの依存関係を破棄したりすることなく、スキル指示やオプションのスクリプトを更新できます。
リビジョンのバージョニングと不変性の詳細については、スキルのリビジョンをご覧ください。
ツール
エージェントが呼び出すことができる、MCP サーバーによって提供される決定的関数。