エージェントを登録すると、Agent Registry 内で検出可能なコンポーネントになります。エージェントの A2A スキルを公開することで、 組織内の他のデベロッパーやオーケストレータ エージェントがお客様の作業を見つけて 再利用できるようになり、AI 開発全体の加速につながります。
Agent Registry は、
Agent2Agent(A2A)プロトコルとその
仕様とシームレスに統合されています。A2A
は、エージェントが機能と ID を宣言できるオープン標準です。Agent Registry は、A2A 仕様のバージョン 0.3 と
1.0 をサポートしています。詳細については、
エージェント カードのスキーマをご覧ください。
エージェント ランタイムに応じて、Agent Registry は 2 つの主要な 登録メカニズムをサポートしています。自動登録と 手動登録です。
エージェント ランタイムに適した登録メカニズムを選択します。
自動登録
サポートされている Google Cloud ランタイムは、デフォルトで、または オプトイン デプロイ ステップを介して、同じプロジェクト内の Agent Registry にエージェントを登録します。自動登録はプロジェクト レベルで動作し、他の Google Cloudプロジェクトにデプロイされたエージェントを自動的に検出することはありません。
自動登録は、次の Google Cloud ランタイムでサポートされています。
- Gemini Enterprise Agent Platform の Agent Runtime: SDK を使用してデプロイされたエージェントは、 追加の設定なしで登録されます。詳細については、 Agent Runtime からエージェントを登録するをご覧ください。
- Google の組み込みエージェント: Google Workspace エージェントや Gemini Enterprise エージェントなど、Google が直接提供するエージェントは、構成なしで検出できます。 詳細については、 Google の組み込みエージェントを登録するをご覧ください。
- Google Kubernetes Engine: Google Kubernetes Engine(GKE)にデプロイされたコンテナ化エージェントは、AI エージェントの 機能タイプ ラベルとエージェント カード アノテーションで構成されている場合に登録されます。GKE クラスタ ランタイム コントローラはイントロスペクション スキャンを実行し、メタデータを Agent Registry に公開します。詳細については、 GKE からエージェントを登録するをご覧ください。
- Cloud Run: Cloud Run サービスまたはジョブにデプロイされたコンテナ化エージェントは、
機能タイプ フラグと ID タイプ フラグを使用してデプロイされると登録されます。Cloud Run は、エージェントの名前、URL、タイプ(
AGENT)を Agent Registry に自動的に登録します。 詳細については、 Cloud Run からエージェントを登録するをご覧ください。
登録時にエージェントにインデックスが作成されるメタデータと機能は、エージェントが Agent2Agent(A2A)プロトコルを実装しているかどうかによって異なります。
- A2A プロトコルを実装するエージェント: システムはエージェントの
エージェント カード(
/.well-known/agent-card.json)をクエリして、公開された A2A スキルと機能を レジストリ カタログに自動的に抽出します。 - A2A プロトコルを実装していないエージェント(標準の REST または gRPC エンドポイント): システムはエージェントのインターフェース URL とトランスポート バインディングを登録しますが、 セマンティック機能を自動的に抽出することはできません。機能を A2A 以外のエンドポイントに関連付けるには、 手動登録を使用して記述するか、 スタンドアロン スキルと AI アプリケーション内の MCP サーバーにリンクします。
自動登録をサポートする Google Cloud ランタイムについては、 自動登録を使用するをご覧ください。
手動登録
外部プラットフォーム、オンプレミス、自動検出をサポートしていない Google Cloud ランタイム、または異なる Google Cloud プロジェクトにホストされているエージェントの場合は、手動登録を使用する必要があります。
エージェントを手動で登録するには、Agent Registry API、Google Cloud CLI、または Terraform を使用して、エージェントのエンドポイントと構成を定義する Service リソースを作成します。この書き込み可能な Service リソースには、エージェントの固有の詳細も含まれています。Service が作成されると、レジストリは検出に使用できる
読み取り専用の Agent リソースを生成します。
次の 2 種類のエージェントを手動で登録できます。
- A2A 準拠のエージェント: A2A 仕様
(
A2A_AGENT_CARD) を実装するエージェント。レジストリは、 エージェント カード (agent-card.json) エンドポイントをスキャンして、A2A スキルにインデックスを付けます。 - 標準の REST エージェント: 標準の REST API エンドポイントなど、A2A
仕様(
NO_SPEC)を実装していないリモート エージェント。
エージェントを手動で登録する方法については、手動登録を使用するをご覧ください。
プロジェクト間登録に関する考慮事項
組織で Agent Gatewayを使用して集中型ガバナンス アーキテクチャを使用している場合は、中央ガバナンス プロジェクトに Agent-to-Anywhere 下り(外向き)ゲートウェイをデプロイし、複数のスポーク プロジェクトまたはワークロード プロジェクトにデプロイされたエージェントを登録できます。
自動登録ではローカル プロジェクトのリソースのみが検出されるため、中央ガバナンス プロジェクトのレジストリにリモート エージェントを手動で登録する必要があります。プロジェクト間登録により、中央ゲートウェイはエージェントを特定して管理できます。手順については、 別のプロジェクトからエージェントを登録するをご覧ください。
スタンドアロン スキルを統合する
Agent Registry を使用すると、エージェントのスタンドアロン
スキルを最上位のリソースとして管理できます。
スタンドアロン スキルはレジストリに Skill リソースとして登録されるため、
管理者はきめ細かいアクセス ポリシーを適用し、
スキル リビジョンを使用してバージョン履歴を管理できます。
Gemini Enterprise でエージェントを構築して管理する際に、 登録済みのスキルを参照してエージェントの機能を拡張できます。 スタンドアロン スキルの登録と管理の方法については、 スキルを登録すると スキルを管理するをご覧ください。