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

Gemini Enterprise の管理者は、Agent Registry から Gemini Enterprise app に 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 app に関連付けるには、エージェント トラフィックをルーティングできる Agent Gateway を設定する必要があります。以下の始める前にをご覧ください。

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

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

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

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

  • 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、または global
us us-central1 us-central1 または us
eu europe-west1 europe-west1 または eu

制限事項

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

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

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

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

始める前に

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

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

Agent Registry から Gemini Enterprise app に 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 内の特定のエントリへのアクセスを制限する許可ルールと拒否ルールを定義します。

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

次のステップ