Agent Registry のデータモデル

Agent Registry は、AI エコシステムを標準化されたリソースに整理します。これにより、単一のプロジェクトまたは管理境界全体でエージェント、MCP サーバー、エンドポイント、スキルを登録、検出、管理できます。Agent Registry が書き込み可能な Service リソースを読み取り専用の検出リソースから分離する方法、プロジェクト間でリソースをスコープする方法、自動登録と手動登録をサポートする方法を理解すると、レジストリの設計と管理に役立ちます。

まず、Agent Registry を設定するをご覧ください。Agent Registry API の詳細については、API リファレンス ドキュメントをご覧ください。

エージェント コンポーネント

Agent Registry を使用すると、次のタイプのエージェント コンポーネントを登録、検出、管理できます。

  • エージェント: 特定のタスクを実行し、ツールを呼び出し、他のエージェントと連携する自律型 AI アクター。
  • MCP サーバー: Model Context Protocol（MCP）を実装して、標準化されたデータリソースとツールを公開するプログラム。ツールは、エージェントが特定のアクションを実行するために呼び出すことができる、MCP サーバーによって公開される決定論的関数です。
  • エンドポイント: エージェントがアクセスするターゲット URL（通常は REST API）。これらの宛先を管理可能なリソースに抽象化することで、Agent Registry は、エージェントがアクセスできる外部 API を一元的に管理できます。
  • スキル: エージェントの機能を拡張するモジュラー機能。スタンドアロン スキルは、レジストリで直接管理される指示とオプションのスクリプトのパッケージです。A2A スキルは、エージェントのエージェント カードに記載されている機能の説明で、他のエージェントにいつどのように通信するかを伝えます。詳細については、スキル アーキテクチャをご覧ください。

サービス リソースとディスカバリ リソース

Agent Registry がコンポーネントを表す方法は、コンポーネント タイプと登録モデルによって異なります。コンポーネントのライフサイクルと検出の詳細については、コンポーネントのライフサイクルと検出をご覧ください。

エージェント、MCP サーバー、エンドポイント

エージェント、MCP サーバー、エンドポイントが自動または手動で登録されているかどうかにかかわらず、Agent Registry は、読み取り専用の Agent、McpServer、Endpoint の検出リソースとして表します。オーケストレーター エージェント、クライアント アプリケーション、デベロッパーなどのコンシューマーは、これらの検出リソースを使用して、登録済みのコンポーネントを一覧表示、検索、表示します。

自動登録されたコンポーネントの場合、Agent Registry はサポートされているランタイムからメタデータを直接取り込み、Service リソースなしで検出リソースを作成します。

エージェント、MCP サーバー、エンドポイントを手動で登録すると、Agent Registry は次の項目を作成して、管理オペレーションをコンポーネントの検出から分離します。

  • 書き込み可能な Service リソース: エージェント コンポーネントのタイプ、インターフェース URL、説明、プロトコル バインディング、機能仕様など、コンポーネントのメタデータを保存します。メタデータの更新やコンポーネントの登録解除などの管理オペレーションでは、基盤となるデプロイを変更または削除することなく、Service リソースを作成、更新、削除します。
  • 検出リソース: Service リソースを作成または更新すると、Agent Registry はメタデータを読み取り、レジストリ内のコンポーネントを表す Agent、McpServer、または Endpoint 検出リソースを自動的に作成または更新します。

Service リソースの作成時に使用する仕様フラグによって、結果の読み取り専用リソース コレクションが決まります。

フラグ リソースの収集 ユースケース 有効な値
--agent-spec-type
--agent-spec-content		 agents コレクション内の Agent リソース リモート A2A 準拠または標準の REST エージェント a2a-agent-card、no-spec
--endpoint-spec-type
--endpoint-spec-content		 endpoints コレクション内の Endpoint リソース 外部ターゲット REST API またはサービス URL no-spec
--mcp-server-spec-type
--mcp-server-spec-content		 mcp-servers コレクション内の McpServer リソース 外部 Model Context Protocol（MCP）サーバー tool-spec、no-spec

これらのフラグペアは相互に排他的です。複数のペアのフラグを指定すると、エラーが返されます。間違ったコンポーネント タイプのフラグペアを指定すると、Agent Registry は、指定したフラグに一致するコレクションに検出リソースを作成します。たとえば、エンドポイントの登録時に --agent-spec-type=no-spec を渡すと、Endpoint リソースではなく Agent リソースが作成されるため、タイプ固有のクエリとガバナンス ポリシーが想定どおりに適用されません。

スタンドアロン スキル

スタンドアロンのスキルでは、個別の Service リソースは使用されません。代わりに、最上位の Skill リソース、子 SkillRevision リソース、Publisher リソースを使用して、スキルを直接登録、バージョニング、クエリします。

ロケーション内のスキルのオプションの顧客管理の暗号鍵（CMEK）設定は、SkillEncryptionSpec リソースを使用して構成します。スキル スキャン中に検出されたセキュリティの問題は、読み取り専用の Finding リソースとして公開されます。詳細については、スキルに CMEK を構成するとスキルをスキャンしてセキュリティの問題を検出するをご覧ください。

クロスプロジェクト データモデル

管理境界を構成すると、Agent Registry は管理プロジェクトからすべてのメンバー プロジェクトの検出とガバナンスを一元化します。

管理プロジェクトからリソースをクエリ、一覧表示、検索すると、Agent Registry は次のスコープルールを適用して、リソースの重複やエンドポイントの競合を発生させることなく、統合カタログを提供します。

リソースのカテゴリ 管理境界内のスコープ 説明
自動検出されたリソース メンバー プロジェクトから集計 メンバー プロジェクトで自動的に検出されたエージェントと MCP サーバーは、管理プロジェクトのロケーションで一覧表示または検索すると、管理プロジェクト ビューに集約されます。エージェントまたは MCP サーバーを表示、一覧表示、検索する場合は、リクエストで管理プロジェクト ID またはメンバー プロジェクト ID を指定できます。リソース名は、Agent Registry がコンポーネントに割り当てる ID を保持し、リクエストで指定されたプロジェクトを使用します。
手動で登録されたリソース 作成されたプロジェクトにスコープ設定される Service リソースとして手動で登録されたカスタム エージェント、外部 MCP サーバー、エンドポイントは、作成されたプロジェクトにスコープされます。管理プロジェクトで作成して管理境界全体に表示するか、メンバー プロジェクトで作成してその単一のプロジェクト内でのみ表示します。
バインディング 作成されたプロジェクトにスコープ設定される Binding リソースは、作成されたプロジェクトにスコープされます。境界全体の可視性を確保するには管理プロジェクトで作成し、単一プロジェクトの可視性を確保するにはメンバー プロジェクトで作成します。
スタンドアロンのスキルとパブリッシャー 作成されたプロジェクトにスコープ設定される カスタムのスタンドアロン Skill、SkillRevision、Publisher、SkillEncryptionSpec、Finding リソースは、作成されたプロジェクトにスコープが設定され、メンバー プロジェクトから管理プロジェクトに集約されません。Google が管理するスタンドアロン スキルは、Agent Registry を設定すると、すべてのプロジェクトで自動的に検出可能になります。
AI アプリケーション 作成されたプロジェクトにスコープ設定される 読み取り専用の AiApplication リソースと、それらにリンクされたコンポーネント ビューは、アプリケーションが作成されたプロジェクトとロケーションにスコープされます。

サポートされているプロダクトとコンポーネント

Agent Registry は、サポートされているプロダクトとコンポーネントを、自動または手動の登録方法で分類します。

自動登録

Agent Registry は、プロジェクト内または管理境界内のメンバー プロジェクトにデプロイされた、サポートされているGoogle Cloud ワークロードを自動的に検出して取り込みます。オープンな Agent2Agent（A2A）プロトコルを実装するエージェントの場合、レジストリはエージェント カードから A2A スキルと機能を自動的に抽出します。Google が管理するスタンドアロン スキルは、Agent Registry を設定すると、すべてのプロジェクトで検出可能になります。

次の表に、Agent Registry が自動的に登録するプロダクトとコンポーネントを示します。

コンポーネントのタイプ サポート対象プロダクト
エージェント
MCP サーバー
スキル Google が管理するスキルは、すべてのプロジェクトから検出できます。

手動登録

リモート コンポーネントは、ガバナンス プロジェクトまたは管理境界の外部（境界のない別の Google Cloud プロジェクト、オンプレミス インフラストラクチャ、外部クラウドなど）でホストされているエージェント、MCP サーバー、エンドポイントです。これらのリモート コンポーネントは、Service リソースを使用してガバナンス プロジェクトに手動で登録します。また、Service リソースを使用して、サポートされていないランタイムのコンポーネントや、A2A プロトコルを実装していないエージェントのコンポーネントを手動で登録します。カスタムのスタンドアロン スキルの場合は、Skill リソースを使用します。

次の表に、手動で登録するプロダクトとコンポーネントを示します。

コンポーネントのタイプ サポートされているリソース
エージェント Compute Engine、GKE、Cloud Run、オンプレミス システム、外部クラウドにデプロイされたリモート エージェント
MCP サーバー サポートされていないランタイムまたは外部 MCP サーバー上のカスタム エージェント コンポーネント
Endpoints エンドポイントとして管理される外部ターゲット REST API またはサービス URL
スキル 組織が作成した独自のスタンドアロン スキル

次のステップ