エージェント レジストリは、エコシステムのエージェント コンポーネントを、管理および検出可能な 4 つのメイン リソースタイプに分類します。
- エージェント: 特定のタスクを実行し、ツールを呼び出し、他のエージェントと連携する自律型 AI アクター。
- MCP サーバー: 標準化されたデータリソースとツールのプロバイダ。ツールは、MCP サーバーによって公開される決定論的関数であり、エージェントが特定の操作を実行するために呼び出すことができます。
- エンドポイント: エージェントがアクセスするターゲット URL（通常は REST API）。これらの宛先を管理可能なリソースに抽象化することで、Agent Registry を使用して、エージェントがアクセスできる外部 API を一元的に管理できます。
- スキル: エージェントの機能を拡張するモジュール型の機能。エージェント レジストリは、レジストリで直接管理される指示とオプションのスクリプトのパッケージであるスタンドアロン スキルと、エージェントの Agent Card に記載されている機能の説明である A2A スキルを区別します。A2A スキルは、他のエージェントにいつどのように通信するかを伝えます。
エージェント レジストリで使用されるこれらのコンセプトやその他のコンセプトの詳細については、主なコンセプトをご覧ください。
API リソース
Agent Registry API は、エージェント、エンドポイント、MCP サーバーの読み取りオペレーションと書き込みオペレーションを分離します。
- 書き込み可能な API リソース: これらのエージェント コンポーネントは、レジストリで
Serviceリソースを手動で作成、更新、削除することで管理します。 - 読み取り専用 API リソース: これらのエージェント コンポーネントをクエリ、一覧表示、検索するには、読み取り専用の
Agent、McpServer、Endpointリソースを Agent Registry API にリクエストします。
Service の作成時に使用する仕様フラグによって、結果として得られる読み取り専用リソース コレクションが決まります。
| フラグ | リソースの収集 | ユースケース | 有効な値 |
|---|---|---|---|
--agent-spec-type--agent-spec-content |
Agent（agents） |
リモート エージェント（A2A 準拠または標準の REST エージェント） | a2a-agent-card、no-spec |
--endpoint-spec-type--endpoint-spec-content |
Endpoint（endpoints） |
外部ターゲット REST API またはサービス URL | no-spec |
--mcp-server-spec-type--mcp-server-spec-content |
McpServer（mcp-servers） |
外部 Model Context Protocol（MCP）サーバー | tool-spec |
これらのフラグのペアは相互排他的です。無効なフラグを指定すると、リソースが誤ったコレクションに作成され、タイプ固有のポリシーで機能しない可能性があります。
スタンドアロンのスキルは、Service 投影モデルを使用しません。代わりに、Skill、SkillRevision、Publisher の API リソースを使用して、スキルを直接管理、バージョン管理、一覧表示します。
開始するには、エージェント レジストリを設定するをご覧ください。Agent Registry API の詳細については、API リファレンス ドキュメントをご覧ください。
サポートされているプロダクトとコンポーネント
エージェント レジストリでは、サポートされているプロダクトとコンポーネントが、自動登録と手動登録のどちらで登録されたかに基づいて分類されます。
自動登録
エージェント レジストリは、プロジェクト内にデプロイされたサポート対象のGoogle Cloud ワークロードを自動的に検出し、取り込みます。オープンな Agent2Agent（A2A）プロトコルを実装するエージェントの場合、レジストリはエージェント カードから A2A のスキルと機能を自動的に抽出します。Google が作成したスタンドアロン スキルは、エージェント レジストリを設定するとグローバルに検出可能になります。
次の表に、エージェント レジストリが自動的に登録するプロダクトとコンポーネントを示します。
| コンポーネントのタイプ | サポート対象プロダクト |
|---|---|
| エージェント |
|
| MCP サーバー |
|
| スキル | Google の公開スキルは、すべてのプロジェクトからグローバルに検出可能 |
手動登録
カスタム ワークロード、外部クラウド ランタイム、オンプレミス インフラストラクチャ、または A2A プロトコルを実装していないエージェントの場合は、書き込み可能な Service リソースを使用してコンポーネントを手動で登録します。カスタム スタンドアロン スキルには、Skill リソースを使用します。
次の表に、手動で登録するプロダクトとコンポーネントを示します。
| コンポーネントのタイプ | サポートされているリソース |
|---|---|
| エージェント | Compute Engine、Google Kubernetes Engine、Cloud Run、オンプレミス システム、外部クラウドにデプロイされた リモート エージェント |
| MCP サーバー | サポートされていないランタイムまたは外部 MCP サーバー上のカスタム エージェント コンポーネント |
| Endpoints | エンドポイントとして管理される外部ターゲット REST API またはサービス URL |
| スキル | 組織が作成した独自のスタンドアロン スキル |
次のステップ
- 主なコンセプトを確認して、Agent Registry で使用される重要な用語を理解します。
- ID と識別子について学習する。
- エージェント レジストリを設定する。
- 自動登録と手動登録の違いについて説明します。