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 プロジェクト、オンプレミス環境、または外部クラウドでホストされているエージェント、MCP サーバー、エンドポイント)を管理するには、ガバナンス プロジェクトのレジストリに手動で登録します。
Agent Registry が Google または Google Cloudリモート MCP サーバーを自動的に登録すると、McpServer リソースは個々のリージョンではなく、global ロケーションにのみ作成されます。サポート対象の地域または global ロケーションで、エージェント、MCP サーバー、エンドポイントを手動で登録し、バインディングを作成できます。リージョン ゲートウェイは、リージョン リソースと global MCP サーバーの両方にトラフィックを管理してルーティングできます。
リージョン スコープのルールとポリシー要件の詳細については、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 サーバーによって提供される決定的関数。