Agent Registry から A2A エージェントをインポートする

Gemini Enterprise の管理者として、Agent Registry から Gemini Enterprise アプリに A2A エージェントを追加できます。

Agent Gateway を介してトラフィックにアクセス制御ポリシーを適用できます。これらのポリシーを使用すると、下り（外向き）ガバナンスを適用してエージェントへのトラフィックを制御できます。

A2A エージェントと Agent Registry について

Agent2Agent（A2A）プロトコルは、オープンな通信プロトコルであり、エージェントの共通言語です。このプロトコルにより、さまざまなビルダーやプラットフォームのエージェントが互いを検出し、コラボレーションやタスクの安全な委任を行えるようになります。

Agent Registry は、クエリ可能な一元化されたカタログです。A2A エージェント、エンドポイント、MCP サーバーの検出、追跡、管理を行うための信頼できる唯一の情報源として機能します。

レジストリ内の A2A エージェントは、ユーザーや同僚が作成したカスタム エージェントであり、Gemini Enterprise Agent Platform の Agent Runtime、Cloud Run、Google Kubernetes Engine（GKE）などのさまざまなランタイムにデプロイできます。これらのエージェントは、Google Workspace などの Google プロダクトに組み込まれたエージェントでもかまいません。

Agent Registry のエージェントを Gemini Enterprise app に関連付けることで、アプリのエンドユーザーがエージェントを利用できるようになります。

Agent Gateway について

Agent Gateway は、Agent Platform のマネージド リージョン ネットワーキング コンポーネントであり、A2A エージェント、MCP サーバー、エンドポイントのトラフィック コントローラおよびランタイム ポリシー適用ポイントとして機能します。クライアントと A2A エージェント、A2A エージェントとバックエンド ツール、A2A エージェントと他のエージェント間の接続を保護し、管理します。

A2A エージェントを Gemini Enterprise アプリに関連付ける前に、エージェント トラフィックをルーティングできる Agent Gateway を設定する必要があります。以下の始める前にをご覧ください。

レジストリ、ゲートウェイ、アプリのリージョン制約

データ所在地の要件を確実に遵守するため、Agent Registry リソースと Agent Gateway リソースはどちらもプロジェクトとリージョンに固有です。

Agent Gateway は、Gemini Enterprise アプリの運用リージョンと互換性のあるリージョンにある Agent Registry に関連付けるように構成する必要があります。これにより、データ所在地の規則違反を防ぐことができます。たとえば、US リージョンで作成された Gemini Enterprise app は、グローバルな Agent Registry ではなく、US リージョンの Agent Registry で構成された Agent Gateway を使用する必要があります。

Gemini Enterprise アプリの場合、リージョンの整合性は特定のバインディング プロセスによって厳密に適用されます。

  • Gemini Enterprise app は、そのアプリで許可されているリージョンのいずれかにある Agent Gateway にのみバインドする必要があります。

  • 選択した Agent Gateway は、Agent Registry に関連付けられている必要があります。この Agent Registry は、Agent Gateway およびアプリと同じ特定のリージョンに配置する必要があります。

  • つまり、3 つのコンポーネント（アプリ、ゲートウェイ、レジストリ）をリージョンに合わせて調整する必要があります。次の表に、特定のリージョン マッピングを示します。

Gemini Enterprise app のロケーション Agent Gateway のロケーション Agent Registry のロケーション
global us-central1 us-central1
us us-central1 us-central1
eu europe-west1 europe-west1

制限事項

Agent Registry からエージェントをインポートする場合は、次の制限事項が適用されます。

  • Agent Registry からエージェントを検出してインポートできるのは、レジストリが Gemini Enterprise アプリ用に設定された Agent Gateway に関連付けられている場合のみです。

  • ガバナンス ポリシーは、Agent Gateway に関連付けられた単一のレジストリ内に存在するエージェントにのみ適用できます。

  • Gemini Enterprise エージェント間、または Gemini Enterprise エージェントと Gemini Enterprise データコネクタ（カスタム MCP サーバーなどの MCP ベースのコネクタを含む）間の直接通信では、Agent Gateway ポリシーの適用はトリガーされません。

始める前に

始める前に、次の前提条件を満たしていることを確認してください。

Agent Registry から Gemini Enterprise app にエージェントをインポートする

Agent Registry から Gemini Enterprise アプリに A2A エージェントをインポートすると、アプリのエンドユーザーがエージェントを利用できるようになります。

コンソール

Agent Registry から Gemini Enterprise app にエージェントをインポートする手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. A2A エージェントを関連付けるアプリの名前をクリックします。

  3. [エージェント] をクリックします。

  4. [+ エージェントを追加] をクリックし、[Agent Runtime によるカスタム エージェント] の [追加] をクリックします。

  5. 追加するエージェントを見つけて、[エージェントを追加] をクリックします。

  6. エージェントの詳細を確認し、[次へ] をクリックします。

  7. 次のいずれかを行います。

    • エージェントが一般公開されている場合、またはランタイムの権限がすでに存在する場合は、[スキップして終了] をクリックします。

    • それ以外の場合は、[プロバイダの認証情報] と [追加の詳細] を確認または入力し、[完了] をクリックします。

      フィールド 説明
      クライアント ID Gemini Enterprise を表すために ID プロバイダに登録した OAuth アプリケーションの固有識別子。
      クライアント シークレット Gemini Enterprise を表すために ID プロバイダに登録した OAuth アプリケーションに関連付けられた機密鍵。
      認可 URL ユーザーが Gemini Enterprise にエージェントへのアクセスを認可するために使用する URL。たとえば、https://accounts.google.com/o/oauth2/v2/auth?client_id=123...abc.apps.googleusercontent&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Foauth-redirect&oauth-redirect&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent とします。
      トークン URL 認可コードをアクセス トークンと交換するために使用されるエンドポイント。たとえば、エージェントが Google によってホストされている場合、トークン URL は https://oauth2.googleapis.com/token です。
      スコープ Gemini Enterprise がユーザーに代わって実行できるアクションや、アクセスできるデータを定義する権限。Gemini Enterprise は、ユーザー認証時にこれらのスコープをリクエストします。たとえば、https://www.googleapis.com/auth/cloud-platform とします。

      スコープを指定する際は、次の点を考慮してください。
      • スコープのスペース区切りのリストを指定します。例: read write。
      • ユーザーがログインしてエージェントを使用できるように、スコープが十分であることを確認します。
      PKCE 検証が有効になっている エージェントで Proof Key for Code Exchange が必要な場合は、これを選択します。

  8. アプリのエンドユーザーがエージェントを利用できるようにするには、次の操作を行います。

    1. エージェントの [ユーザー権限] タブ（[アプリ] > APP_NAME > [エージェント] > AGENT_NAME > [ユーザー権限]）に移動します。

    2. [ユーザーを追加] をクリックします。

    3. [Add user permissions roles to agent] ダイアログで、Agent User ロールをユーザー、グループ、またはすべてのユーザーに割り当てます。

下り（外向き）ガバナンス ポリシーを設定して適用する

Agent Gateway を使用すると、エグレス エージェント トラフィックにセマンティック制御ポリシーと IAM 制御ポリシーを評価して適用できます。きめ細かい下り（外向き）ポリシーを作成して、A2A エージェントのエージェント間アクセスを管理できます。

エージェントによる Agent Registry 内の特定のエントリへのアクセスを制限する許可ルールと拒否ルールを定義します。

エージェントに下り（外向き）ガバナンス ルールを作成して適用するには、次のいずれかを行います。

次のステップ