Runtime と Gemini Enterprise 向けの Agent Gateway

Agent Platform の Agent Gateway は、Agent Runtime と Gemini Enterprise にデプロイされた AI エージェントに、フルマネージドのトラフィック ガバナンスとセキュリティの適用を提供します。

このデプロイモデルでは、Google がすべてのゲートウェイ インフラストラクチャをホストして管理するため、ゲートウェイ ホスティング インフラストラクチャを管理することなく、アクセスルール、mTLS 終端、安全ガードレールを定義できます。

サポートされているアクセスパス

Agent Platform の Agent Gateway で使用できる管理対象アクセスパスは、Agent Runtime プラットフォームによって異なります。

  • Agent Runtime: Client-to-Agent(内向き)モードと Agent-to-Anywhere(外向き)モードの両方をサポートします。
  • Gemini Enterprise: Agent-to-Anywhere(下り(外向き))モードのみをサポートします。
Agent Gateway の動作モード。
Agent Gateway の動作モード(クリックして拡大)。

次の表に、各アクセスパスの Agent Gateway でサポートされているガバナンス管理をまとめます。

次の表は、管理対象のアクセスパスごとに各ガバナンス コンポーネントが果たす役割をまとめたものです。

ガバナンス レイヤ クライアントからエージェントへ エージェントから任意の宛先へ
ID クライアントからゲートウェイに渡されるクライアント ID またはユーザー認証情報。 エージェントに割り当てられたワークロードにバインドされたエージェント ID(SPIFFE ID または WIF トークン)。
Agent Registry クライアントからエージェントへのモードには適用されません。 アウトバウンド ターゲットの宛先リソース(ツール、MCP サーバー、エージェント)を登録します。
アクセス制御ポリシー
IAM 統合アクセス ポリシー 受信クライアント ID とターゲット エージェントに基づいてゲートウェイで評価されます。 エージェント ID と宛先に基づいて、Identity-Aware Proxy(IAP)ポリシーとプリンシパル アクセス境界(PAB)ポリシーによって評価されます。
Model Armor のガードレール 受信したクライアント プロンプトをリアルタイムでスキャンし、プロンプト インジェクション、ジェイルブレイク、有害なコンテンツを検出します。 送信されるツール ペイロードとエージェントのレスポンスを検査して、機密データの漏洩を防ぎます。
セマンティック ガバナンス ポリシー クライアント リクエストに対して自然言語の制約を評価します。 アウトバウンド ツールのアクションとエージェントの委任に対して自然言語制約を評価します。

Agent Gateway がポリシーを適用する方法

Agent Gateway を通過するトラフィックは、トラフィックの方向に応じて特定のポリシー評価を受けます。以降のセクションでは、Agent Gateway を通過するインバウンド リクエストとアウトバウンド リクエストのイベントのシーケンスについて説明します。

Agent Gateway によるアクセス制御。
Agent Gateway によるアクセス制御(クリックして拡大)。

クライアントからエージェントへの適用

クライアントからエージェントへのモード(Agent Runtime にデプロイされたエージェントでのみサポート)では、Agent Gateway に則って管理されるエージェントへのリクエストは、次のイベント シーケンスを経由します。

  1. クライアント リクエスト: クライアント(CLI、ウェブ アプリケーション、デベロッパー ツールなど)がエージェントにリクエストを送信します。リクエストは、エージェントのフロントエンドとして機能するクライアントからエージェントへのモードで動作する Agent Gateway によってインターセプトされます。
  2. リクエストの検査: Agent Gateway は、ゲートウェイに接続された認可ポリシーを使用してリクエストを評価します。
    • Model Armor: 受信したユーザー プロンプトをリアルタイムでスキャンして、プロンプト インジェクション攻撃、ジェイルブレイク、有害なコンテンツをブロックします。
    • セマンティック ガバナンス ポリシー(Model Armor の代わりに構成されている場合): 受信リクエストに対して自然言語の制約を評価します。
  3. リクエストの転送: すべてのチェックに合格すると、Agent Gateway はリクエストを Agent Runtime のターゲット宛先に転送します。

エージェントから任意の宛先への適用

Agent Runtime または Gemini Enterprise で実行されているエージェントが、外部ツール、MCP サーバー、または別のエージェントに発信呼び出しを送信すると、リクエストは次の一連のイベントを処理します。

  1. アウトバウンド リクエストとインターセプト: エージェント(割り当てられたエージェント ID で識別される)が発信を送信します。リクエストは、Agent-to-Anywhere モードで動作する Agent Gateway によってインターセプトされます。
  2. IAM、プリンシパル アクセス境界、IAP ポリシーの検証: IAP は、エージェント ID に宛先へのアクセス権 iap.resources.egressViaIAP を付与する IAM アクセス ポリシーが存在することを確認します。エージェント ID に適用されているプリンシパル アクセス境界ポリシーも評価されます。プリンシパル アクセス境界ポリシーの対象となるエージェント ID は、これらのポリシーで指定されたリソースにのみアクセスできます。これにより、エージェントは指定されたアクセス境界に厳密に分離されます。
  3. Agent Registry の検証: Agent Gateway は、ターゲットの宛先リソースが Agent Registry に登録されていることを確認します(宛先が未登録の場合は、ターゲット エンドポイント URL を解決します)。リソースごとのきめ細かいアクセス ポリシーとツールレベルの制御を適用するには、Agent Registry に宛先を登録することをおすすめします。宛先が Agent Registry に登録されていない場合は、リンク先 URL をターゲットとする明示的な IAM アクセス ポリシーが必要です。デフォルトでは、一致するアクセス ポリシーが存在しない場合、リクエストは拒否されます。
  4. リクエストの検査: 前述のチェックに合格すると、Agent Gateway は、構成されている可能性のある他の安全ガードレールに対してリクエストを評価します。

    • Model Armor: ツールのペイロードとエージェントのレスポンスを検査して、プロンプト インジェクションと機密データの漏洩を検出します。
    • セマンティック ガバナンス ポリシー: ツールの呼び出しとエージェントのアクションに対して自然言語制約(NLC)を評価します。
    • カスタム認可エンジンに認可を委任する: サービス拡張機能を使用して、認可の決定をカスタム認可エンジンに委任できます。構成された認可ポリシーによっては、これらの認可エンジンの 1 つ以上がリクエストを許可または拒否する場合があります。
  5. リクエストの転送: すべてのチェックに合格すると、Agent Gateway はリクエストをターゲット宛先に転送します。

Agent Platform に Agent Gateway をデプロイする

Google が管理するランタイムに Agent Gateway をデプロイして構成するには、一般的な設定トピックに沿ってゲートウェイ インフラストラクチャとアクセス ポリシーを構成し、ランタイム固有のガイドを参照してエージェント ワークロードからトラフィックをルーティングします。

一般的な設定とポリシーの構成

  • Agent Gateway を設定する: agentGateways リソースの作成、エージェント ID の割り当て、Agent Registry への宛先ツールの登録、アクセス ポリシーの適用方法について説明します。
  • VPC 接続を使用して Agent Gateway を設定する: Agent Gateway が VPC ネットワーク内のリソースにアウトバウンド トラフィックを送信できるように、プライベート VPC 接続を構成する方法について説明します。
  • 認可を委任する: 認可ポリシーと拡張機能を構成して、トラフィックの決定を IAP、Model Armor、セマンティック ガバナンス ポリシー、またはカスタム Service Extensions エンジンに委任する方法を学習します。

ランタイム固有のトラフィック ルーティング

制限事項

Agent Platform の Agent Gateway には、次の制限が適用されます。

  • Gemini Enterprise では、クライアントからエージェントへのモードはサポートされていません。
  • 各 Agent Gateway インスタンスは、Agent Registry に登録されている最大 5,000 個のリソースを管理できます。
  • 選択したデプロイと機能に関連する制限事項については、次のページをご覧ください。

次のステップ

ガイド

Agent Gateway をモニタリングする方法について説明します。

ガイド

Agent Gateway の設定方法を学習します。

トラブルシューティング

Agent Gateway の接続に関するトラブルシューティング方法について説明します。