Agent Registry のデータモデル

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 コンポーネントのクエリ、一覧表示、検索を行うには、読み取り専用の AgentMcpServerEndpoint リソースを Agent Registry API にリクエストします。

スタンドアロン スキルでは、Service 投影モデルは使用されません。代わりに、スキルを直接管理、バージョン管理、一覧表示します 。SkillSkillRevisionPublisher API リソースを使用します。

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

レジストリに Agentic コンポーネントを登録する

Agent Registry は、自動と手動の 2 つの登録メカニズムを使用して、エージェントと MCP サーバーのカタログを維持します。

Agent Registry は、サポートされている Google Cloud ランタイムにデプロイされたエージェント とサーバーを自動的に登録します。Agent Registry API を有効にして、エージェント、MCP サーバー、エンドポイントを登録して管理します。Google が作成したスキルも、Agent Registry を設定するとすぐに表示されます。

また、Service リソースを使用して、エントリを手動で作成、更新、削除することもできます。次に、読み取り専用の AgentMcpServerEndpoint リソースに対してクエリを実行して、登録済みエージェント、サーバー、エンドポイントを取得、一覧表示、検索します。スキルの手動登録と検索には、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 コンポーネント
スキル 独自のスタンドアロン スキル

次のステップ