Agent Registry は、エコシステムの Agentic コンポーネントを、管理および検出可能な 4 つの主なリソースタイプに分類します。
- エージェント: 特定の AI ワークフローを実行する自律型 AI アクター。エージェントは、特定のスキル を持つことで、ワークフローの機能を理解します。 Agent Registry では、エージェント スキルは宣言型メタデータ （A2A スキル）またはモジュール型の実行可能 パッケージ（スキル）として表されます。
- MCP サーバー: 標準化されたデータリソースとツールのプロバイダ。ツールは、MCP サーバーによって公開される決定論的関数であり、エージェントはこれを呼び出して特定のアクションを実行できます。
- エンドポイント: エージェントがアクセスするターゲット URL（通常は REST API）。これらの宛先を管理可能なリソースに抽象化することで、Agent Registry では、エージェントがアクセスできる外部 API を一元的に管理できます。
- スキル: Agent Registry 内で直接管理される、命令、コード、および メタデータのスタンドアロンの実行可能パッケージ。スタンドアロン スキルは A2A スキルとは異なります。A2A スキルは、エージェントの Agent Card 内でインラインで宣言される宣言型メタデータ ブロック マニフェストです。
Agent Registry で使用されるこれらのコンセプトの詳細については、 主なコンセプトをご覧ください。
API リソース
Agent Registry API は、エージェント、エンドポイント、MCP サーバーの読み取りオペレーションと書き込みオペレーションを分離します。
- 書き込み可能な API リソース: これらの Agentic コンポーネントは、レジストリで
Serviceリソースを手動で 作成、更新、削除することで管理します。 - 読み取り専用 API リソース: これらの Agentic コンポーネントのクエリ、一覧表示、検索を行うには、読み取り専用の
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 を設定します。Agent Registry API の詳細については、API リファレンス ドキュメントをご覧ください。
レジストリに Agentic コンポーネントを登録する
Agent Registry は、自動と手動の 2 つの登録メカニズムを使用して、エージェントと MCP サーバーのカタログを維持します。
Agent Registry は、サポートされている Google Cloud ランタイムにデプロイされたエージェント とサーバーを自動的に登録します。Agent Registry API を有効にして、エージェント、MCP サーバー、エンドポイントを登録して管理します。Google が作成したスキルも、Agent Registry を設定するとすぐに表示されます。
また、Service リソースを使用して、エントリを手動で作成、更新、削除することもできます。次に、読み取り専用の Agent、McpServer、Endpoint リソースに対してクエリを実行して、登録済みエージェント、サーバー、エンドポイントを取得、一覧表示、検索します。スキルの手動登録と検索には、Skill リソースを使用します。
| 登録メカニズム | 説明 | 登録済みコンポーネント | サポートされている Google Cloud プロダクト |
|---|---|---|---|
| 自動登録 | Agent Registry を構成して使用すると、サポートされている Google Cloud ランタイムにデプロイされた特定のリソースを自動的に検出して 取り込むことができます。 オープン Agent2Agent（A2A）プロトコルを実装するエージェントの場合、レジストリは Agent Card から A2A スキルと機能を自動的に抽出します。 | エージェント |
|
| MCP サーバー |
|
||
| スキル | Google の公開スキル は、すべての プロジェクトからグローバルに検出可能 | ||
| 手動登録 |
外部リソース、サポートされていないランタイムのカスタム Agentic コンポーネント、A2A プロトコルを実装していない標準 REST エージェントの場合は、レジストリに Service リソースを作成して手動で登録する必要があります。スタンドアロン スキルには、Skill リソースを使用します。
|
エージェント | リモート エージェント |
| MCP サーバー | サポートされていないランタイムのカスタム Agentic コンポーネントまたは外部 MCP サーバー | ||
| スキル | 独自のスタンドアロン スキル |
次のステップ
- 主なコンセプトを確認して、 Agent Registry で使用される重要な用語を理解する。
- Agent Registry を設定する。
- エージェントの 自動登録と手動登録の違いについて学習する。