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
投影モデルは使用されません。代わりに、スキルを直接管理、バージョン管理、一覧表示します
。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 の公式 MCP サーバーと Google Cloud リモート MCP サーバー | ||
| スキル | Google の公開スキル は、すべての プロジェクトからグローバルに検出可能 | ||
| 手動登録 |
外部リソース、サポートされていないランタイムのカスタム Agentic コンポーネント、A2A プロトコルを実装していない標準の REST エージェントの場合は、レジストリに Service リソースを作成して手動で登録する必要があります。スタンドアロン スキルの場合は、Skill リソースを使用します。
|
エージェント | リモート エージェント |
| MCP サーバー | サポートされていないランタイムまたは外部 MCP サーバーのカスタム Agentic コンポーネント | ||
| スキル | 独自のスタンドアロン スキル |
次のステップ
- 主なコンセプトを確認して、 Agent Registry で使用される重要な用語を理解する。
- Agent Registry を設定する。
- エージェントの 自動登録と手動登録の違いについて学習する。