Agent Registry のデータモデル

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

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

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 リソースを使用して、スキルを直接登録、バージョニング、クエリします。

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

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

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

自動登録

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

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

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

手動登録

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

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

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

次のステップ