↓ メインコンテンツへスキップ

Google Cloud Agent Gatewayとは? Agent Runtimeの通信を通して、接続先の制御とModel Armorの検査を確かめる

著者
Taro Yamauchi

Google Cloud Agent Gatewayは、Google Cloud上のAgentの通信を中継し、接続先の許可や内容の検査を行うゲートウェイです。Agentの数が増えたときに、どのAgentがどのLLMやMCPサーバー、ほかのAgentを呼び出しているかを1か所で記録し、必要に応じて止めるために使います。この記事では、Agent Runtime(Agentを実行するマネージド環境)上のAgentをゲートウェイに紐づけ(以下「バインド」)ました。そのうえで、導入の手順、接続先の制御、Model Armorによる検査、制約の4点を確かめています。

この記事では、Agent Runtime上のAgentから、LLM、MCPサーバー、ほかのAgent(A2Aで呼び出す)への3種類の通信をゲートウェイに通し、東京リージョンとus-central1で、ゲートウェイのログと監査ログから結果を確かめました。わかったことは次のとおりです。

  • Agentのコードと接続先のURLは変えずに、Agent Runtimeを作成するときの設定だけでゲートウェイを経由させられる。ただし、接続先の許可と、カスタムコンテナではゲートウェイの証明書の組み込みを別に準備する必要がある
  • 東京リージョンでは、許可していない接続先へのSendMessage(A2AでほかのAgentに処理を依頼するリクエスト)が403になった。A2Aでは、相手のAgent Cardに書かれたURLも許可の対象として管理する必要がある
  • us-central1では、3種類の通信がModel Armorで検査された
  • 東京リージョンでは、確認できた範囲でゲートウェイ経由の検査が動かず、リクエストが500エラーになった。東京で使う場合は、本番の構成を作る前に確認したほうがよい
  • Agentのバインド設定を変更すると、既存のリビジョンが元に戻せない形でアーカイブされる。検証は本番とは別のプロジェクトで行うほうが安全

Google Cloud Agent Gatewayの概要
#

Google Cloud Agent Gatewayは、Gemini Enterprise Agent Platformのうち、Agentの通信を受け持つ機能です。ユーザーとAgent、Agentとツール、Agent同士の通信を中継し、認証や接続先の許可、内容の検査を行います。2026年6月18日にGAになり、ゲートウェイでModel Armorによる検査を行う機能も6月24日にGAになりました(リリースノート )。

公式ドキュメント では、通信の向きによって2つのモードを挙げています。

モード対象の通信ゲートウェイが行うこと
Client-to-Agent(ingress)Webアプリや開発者のCLIなどのクライアントから、Agentやツールへの通信入口での利用者の認証、プロンプトの検査
Agent-to-Anywhere(egress)Agentから、外部のツール、MCPサーバー、SaaSのAPI、ほかのAgentへの通信接続先へのアクセス可否の判定、内容の検査

Google管理のゲートウェイを使えるのは、Agent Runtime(両方のモード)とGemini Enterprise(Agent-to-Anywhereのみ)です。GKE(Preview)とCloud Run(Limited Preview)でも使えます。ただし、GKEとCloud Runでは、自分のプロジェクトで管理するロードバランサやSecure Web Proxyと組み合わせます(2026年11月時点の公式ドキュメント)。この記事で扱うのは、Agent Runtime上のAgentを、Google管理のAgent-to-Anywhereのゲートウェイにバインドした構成です。

Agent-to-Anywhereは、使った分だけ課金されます。課金の単位は、ゲートウェイを通したAPI呼び出しまたは認可リクエストの件数です。15,000件が、Agent Computeの1 vCPU時間($0.085)に相当します(2026年11月時点の料金ページ )。

検証した構成
#

題材にしたのは、架空のサービスにおける障害の一次対応です。受付Agentがアラートを受け取り、LLMで検索条件を決め、MCPサーバーからログを取得し、原因分析AgentにA2Aで分析を依頼します。原因分析Agentは受け取ったログをLLMで分析し、結果を返します。

受付AgentはAgent Runtime上に、原因分析AgentとMCPサーバーはCloud Run上に構築しました。そのうえで、受付AgentをGoogle Cloud Agent Gatewayにバインドしました。ゲートウェイを経由するのは、受付Agentから外部への次の3種類の通信です。原因分析AgentはCloud Run上にあり、LLMを直接呼び出すため、ゲートウェイを経由しません。

通信呼び出し方
LLMgemini-3.5-flash-liteを、Vertex AIのOpenAI互換エンドポイント(global)のChat Completions APIで呼び出す。非ストリーミング
MCPStreamable HTTPで、MCPサーバーのツール(tools/call)を呼び出す。応答はJSON
A2AA2A v1のJSON-RPCで、原因分析Agentに非ストリーミングのSendMessageを送信する
flowchart LR
  subgraph AR["Agent Runtime"]
    A["受付Agent"]
  end
  G["Google Cloud Agent Gateway"]
  subgraph CR["Cloud Run"]
    B["原因分析Agent"]
    M["MCPサーバー"]
  end
  L["LLM
(Vertex AI)"] A -->|"LLM・MCP・A2A
(バインドで経由)"| G G --> L G --> M G -->|"A2A"| B B -.->|"LLM(ゲートウェイを経由しない)"| L

図:受付Agentの3種類の通信はゲートウェイを経由する。原因分析AgentからLLMへの通信は、ゲートウェイを経由しない。

Agentの実装にはa2a-sdk 1.1.2とmcp 1.30.0(Python 3.12)を、Agent Runtimeの作成にはgoogle-cloud-aiplatform 2.4.0を使いました。検証期間は2026年10月9日〜16日(UTC)です。

検証には、本番のAgentとは別の検証用プロジェクトを使い、東京リージョン(asia-northeast1)とus-central1に同じ題材の構成を作りました。ゲートウェイ経由のModel Armorによる検査は、東京リージョンでは、確認できた範囲で動かなかったため(後述)、us-central1で確かめています。2つのリージョンの条件は次のとおりです。

項目東京リージョン(asia-northeast1)us-central1
主に確かめたこと接続先の制御(許可していない接続先への送信)Model Armorによる検査
接続先の許可の方式とモード(後述)V1・強制モード(Model Armorを試した9回のうち4回はV2・監査モード)V2・監査モード
受付Agent元の受付Agent同じソースから別に作成

特徴
#

ゲートウェイへのバインド
#

受付Agentのコードと接続先のURLは変えずに、Agent Runtimeを作成するときの設定でゲートウェイにバインドできました。バインドすると、受付AgentのLLM・MCP・A2Aの3種類の通信がすべてゲートウェイを経由しました。ただし、接続先の許可と、カスタムコンテナの場合は証明書の追加を、別に準備する必要があります(後述)。

Agent Runtimeはgoogle-cloud-aiplatform 2.4.0のagentplatform.Clientで作成しています。次のコードは、その設定の抜粋です。

config = {
    "container_spec": {"image_uri": image},
    # ...(class_methods、env などは省略)
    "agent_gateway_config": {
        "agent_to_anywhere_config": {
            # projects/<プロジェクト>/locations/<リージョン>/agentGateways/<ゲートウェイ名>
            "agent_gateway": agent_gateway,
        }
    },
    # ゲートウェイを指定するときは必須
    "identity_type": "AGENT_IDENTITY",
}

公式ドキュメントでは、バインドしたAgentから外部への通信はすべてゲートウェイを経由すると説明されています。

接続先の既定拒否
#

ゲートウェイは、明示的に許可していない接続先への通信を拒否します。公式ドキュメント では、IAMのポリシーで許可しない限り、すべての接続がブロックされると説明されています。

接続先の管理と、接続先へのアクセスの許可は、別の仕組みが担います。

  • Agent Registryは、Agentの接続先を登録して管理する仕組みです。登録しただけでは、アクセスは許可されません
  • アクセスの許可は、Identity-Aware Proxy(IAP)の拡張機能が、IAMのポリシーに従って判定します

公式の手順 では、接続先をAgent Registryに登録することが推奨されています。登録した接続先は、ポリシーで個別に指定できるためです。登録していない接続先も、V2の方式(IAMのUnified Access Policies、後述)では、ポリシーの条件にホスト名やパスを書けば許可できます。

今回は接続先をAgent Registryに登録し、接続先ごとに許可を与える方式にしました。登録した接続先は次のとおりです。

  • 原因分析Agent
  • MCPサーバー
  • Google APIのホスト(20個)

Google APIのホストには、Vertex AI(aiplatform)、Cloud Logging、Cloud Trace、Secret Managerなどがあります。多くは、通常のホスト名とmTLS用のホスト名の両方を登録しました。LLMを呼び出すVertex AIのエンドポイントも、ここに含まれます。公式ドキュメント によると、強制モードのゲートウェイにバインドした時点で、Agent PlatformのSessions APIなど、Agentが内部で呼び出すプラットフォームのAPIを許可していないと、Agentの呼び出しがすべて498エラーで失敗します。Agent Registryに登録する場合、ホスト名は完全一致で、*.googleapis.comのようなワイルドカードは使えません。

IAPには、判定結果を記録するだけの「監査モード」と、実際にリクエストを拒否する「強制モード」があります。また、許可のポリシーには2つの方式があり、IAPの拡張機能のiapPolicyVersionで指定します。V2はIAMのUnified Access Policies(UAP)を使う方式で、公式に推奨されています。V1は旧来の許可ポリシーです。東京リージョンではV1の強制モードにし、接続先ごとに受付Agentへroles/iap.egressor(その接続先への送信を許可するロール)を付与しました。V1を選んだ理由は「制約と運用上の注意」で説明します。なお、強制モードの権限付与では、プロジェクトでcloudresourcemanager.googleapis.comが無効だったためにSERVICE_DISABLEDになり、有効化して再実行しました。

IAPを強制モードにした状態で、許可していない接続先へ受付Agentからリクエストを送信させました。A2Aでは、相手のAgentが自身の名前や呼び出し先のURLをAgent Cardとして公開し、呼び出す側はそれを取得してからSendMessageを送信します。今回は、原因分析AgentのAgent Cardに記載するURLだけを、同じ原因分析Agentに到達する別のホスト名に変更しました。受付Agentは登録済みのURLからAgent Cardを取得し、Agent Cardに記載された別のホスト名へSendMessageを送信します。別のホスト名は、Agent Registryに登録していない場合と、登録したがroles/iap.egressorを付与していない場合の2通りを試しました。

送信先受付Agentが受け取った結果ゲートウェイのログIAPの監査ログ原因分析Agent側の記録
未登録のホスト403IAPのポリシーが拒否(DENIED)拒否が1件ゲートウェイが拒否を記録しているため、確認していない
登録済みで、roles/iap.egressorを付与していないホスト403拒否の記録が見つからない0件Cloud Runのリクエストログに、SendMessageの記録がない

どちらの場合もSendMessageは403になりました。未登録のホストでは、ゲートウェイのログとIAPの監査ログの両方に拒否が記録されました。登録済みで許可していないホストでは、どちらのログにも拒否の記録が見つからず、どこが403を返したかは確認できていません。原因分析AgentのCloud Runのリクエストログには、Agent Cardの取得だけが残っていました。ここでいうゲートウェイのログは、Cloud Loggingに出力されるゲートウェイのリクエストログ(networkservices.googleapis.com/gateway_requests)です。

相手のAgentのAgent Cardに記載されたURLも、許可の対象として管理する必要があります。今回の受付Agentは、Agent Cardを取得したURLではなく、Agent Cardに記載されたURLへSendMessageを送信します。また今回の検証では、許可はホスト単位で適用されていました。そのため、Agent Cardの取得先を許可していても、Agent Cardに別のホストが記載されていれば、そのホストも許可しておく必要があります。

TLSの復号とModel Armorによる検査
#

ゲートウェイは、外部への通信のTLS(HTTPSの暗号化)をいったん復号して内容を検査します。このとき接続先との間に入るゲートウェイは、ゲートウェイの認証局(CA)が発行した証明書を使います。Agentがこの認証局を信頼していないと、ゲートウェイを経由したHTTPSの通信は証明書のエラーになります。そこで、受付Agentのコンテナイメージに、ゲートウェイの認証局の証明書(ルートCA証明書)を追加しました。カスタムコンテナでは、ルートCA証明書をイメージの信頼ストアに組み込むよう公式ドキュメント に記載されています。

検査には、Model Armorを使いました。Model Armorは、プロンプトやレスポンスにプロンプトインジェクションや機密情報が含まれていないかを判定するGoogle Cloudのサービスです。Model Armorをゲートウェイの拡張機能として組み込むと、通過する通信の内容を判定させられます。判定の設定はテンプレートにまとめ、今回はプロンプトインジェクションとjailbreakのフィルタだけを有効にしました。

ゲートウェイがModel Armorで検査する通信と、検査せずに通過させる通信は、種類ごとに決められています(公式ドキュメント )。公式ドキュメントに挙がっている主なものは次のとおりです。

通信検査される主なもの検査されずに通過する主なもの
LLM(OpenAI API形式)Chat CompletionsとResponsesの非ストリーミング列挙されていない操作、ストリーミング
MCPtools/call、prompts/gettools/list、resources/*、notifications/*、Streamable HTTP/SSE(公式の記載。今回のJSON応答では検査された)
A2Av1のSendMessage、Agent Cardv1より前のバージョン、ストリーミング(SendStreamingMessage)、GetTaskなどのタスク操作

MCPについては、公式ドキュメントに「Streamable HTTP/SSE for MCP」を検査せずに通過させるという記載があります。今回のMCPはStreamable HTTPで応答はJSONでしたが、tools/callは検査されました。この記載が指す範囲と今回の結果の関係は、確認していません。

us-central1の構成では、受付AgentのLLM、MCPのtools/call、A2AのSendMessageの3区間でModel Armorが呼び出されました。判定は、1回の処理につき3区間のリクエストとレスポンスを合わせて計6回です。原因分析AgentのLLM呼び出しはゲートウェイを経由しないため、この6回には含まれません。

判定の回数は、Model ArmorのData Access監査ログ(既定では無効のため有効にした)で数えました。実行した時刻とテンプレート名で絞り込み、methodNameがSanitizeUserPrompt(リクエストの検査)とSanitizeModelResponse(レスポンスの検査)の記録を数えています。どの記録も呼び出しは成功(invocationResult: SUCCESS)で、判定(sanitizationVerdict)も記録されていました。

Agent Cardは公式ドキュメントでは検査対象とされていますが、今回の構成ではAgent Cardの取得はModel Armorの拡張機能を経由しませんでした。ゲートウェイのログで、Agent Cardの取得には拡張機能の呼び出しの記録がありませんでした。

Model Armorが注入文と判定すると、ゲートウェイはそのリクエストやレスポンスを止め、受付Agentには403が返りました。システムプロンプトの開示を指示する英文の注入文で、LLMへのリクエストとMCPのレスポンスの両方を確かめています(各1回)。どの文面を注入文と判定するかはModel Armorの判定によるもので、文面によってはブロックされませんでした。

制約と運用上の注意
#

1つのプロジェクト・リージョンに、ゲートウェイは複数作れます。ただし、そこにあるAgent Runtime上のAgentは、すべて同じゲートウェイにバインドする必要があります(公式ドキュメント )。また、Agentのバインド設定を変更すると、そのAgentの既存のリビジョンがすべてアーカイブされ、元に戻せません(同ドキュメント。“Archiving is irreversible.")。本番のAgentが動いているプロジェクト・リージョンで、本番とは別のゲートウェイを使って検証しようとすると、本番のAgentのバインド設定も変更することになります。そのため、検証は別のプロジェクトで行うほうが安全です。

公式資料 によると、組織ポリシーiam.managed.disableAccessPolicyBindingが有効だと、UAPを新たにリソースへ紐づけられません。今回の組織では有効だったため、接続先の許可と拒否を確かめる検証では、旧来のV1の方式を使いました。監査モードのV2はこの組織でも設定できたので、Model Armorの検査などでは監査モードのV2を使っています。V1は、公式ドキュメントでは旧来(legacy)の方式とされ、V2(UAP)が強く推奨されています。新しく作るゲートウェイでV1を選ぶ場合は、最新のドキュメントを確認してください。

今回、既存のゲートウェイには、コンソールからModel Armorを後から追加できませんでした。そのため、Model Armorを有効にしたゲートウェイを新たに作成しました。公式ドキュメント では、既存のゲートウェイに新しいModel Armorのポリシーを追加する場合はgcloudを使うとされています。

Model Armorの拡張機能にはfailOpenという設定があります。Service ExtensionsのAPIリファレンス によると、failOpenは、拡張機能の呼び出しが失敗またはタイムアウトしたときの動作を決める設定です。trueなら処理をそのまま続けます。false(既定値)なら、クライアントに応答ヘッダーを送る前は500エラーを返し、送ったあとはHTTPのストリームをリセットします。コンソールで作成した拡張機能は、タイムアウトが10秒、failOpenがtrueでした。筆者がCLIで作成したときは、1秒・falseを指定しています。コンソールで作成した場合も、作成後に設定値を確認してください。

今回使った設定項目の中に、接続先へのリクエストのタイムアウトを設定する項目は見当たりませんでした(上のModel Armorの拡張機能のタイムアウトとは別のものです)。

東京リージョンでのゲートウェイ経由の検査エラー
#

東京リージョン(asia-northeast1)では、確認できた範囲で、ゲートウェイ経由のModel Armorによる検査が動きませんでした。ゲートウェイがModel Armorを呼び出す段階で失敗し、リクエストは500エラーになり、受付Agentの処理も失敗しました。failOpenをtrueにした場合も含め、条件を変えて計9回試し、結果はすべて同じでした。Model Armorに関わる設定をそろえたus-central1の構成では、ゲートウェイ経由で検査でき、Model ArmorのData Access監査ログにも判定が記録されました。

確認したこと結果
東京リージョン(計9回)ゲートウェイのログでは、Model Armorの拡張機能の呼び出しがUNAVAILABLEで失敗。8回はLLMへのリクエスト、1回はMCPへのリクエストが500エラーになった。Data Access監査ログを有効にしたあとの7回では、Model Armorの判定の記録は0件
東京リージョンで変えた条件failOpen(falseとtrue)、IAPの方式とモード(V2・監査モードとV1・強制モード)、ゲートウェイが使うサービスアカウントへのロールの追加
us-central1ゲートウェイ経由で検査でき、Data Access監査ログに判定が記録された。Model Armorの拡張機能、検査のポリシー、テンプレートの設定は東京とそろえた
公式ドキュメントゲートウェイ経由のModel Armorが東京リージョンで使えない、という記載は見当たらない
第三者の報告東京リージョンで同じ症状になり、us-central1では動いたという報告がある(Zenn )

failOpenをtrueにした2回は、拡張機能の呼び出しがリクエストヘッダーの段階で約5秒後にUNAVAILABLEになり、ゲートウェイは検査のポリシーで拒否と判定しました。この失敗がfailOpenの対象になる種類の失敗だったのかは、確認していません。

リージョンによって結果は異なりましたが、原因は切り分けていません。東京リージョンではゲートウェイ経由の検査が使えない制限なのか、不具合なのか、今回の設定によるものなのかは確認していません。試していない設定には、コンソールで作成したゲートウェイと、Model Armorのテンプレートでdata residency(データの処理を、選択したリージョンの法域内に限定する設定)の強制を無効にしたもの(Data residency )があります。今回のテンプレートは強制を有効にしていました。

東京リージョンでGoogle Cloud Agent GatewayとModel Armorを組み合わせる場合は、本番の構成を作る前に、ゲートウェイ経由の検査がModel ArmorのData Access監査ログに記録されるかを確認してください。

まとめ
#

受付Agentのコードは変えずに済みましたが、プロジェクト側では準備が要りました。今回の構成で行ったのは、次の3つです。

  • LLM・MCP・A2Aの接続先と、Agentが内部で使うプラットフォームのAPIを、Agent Registryに登録する
  • IAPのポリシーで、受付Agentから必要な接続先へのアクセスを許可する(今回はV1の方式で、接続先ごとにroles/iap.egressorを付与)
  • ゲートウェイのルートCA証明書を、コンテナイメージに組み込む

また、許可していない接続先への送信は403で止まりましたが、403を返したのがどこかを特定できないケースがありました。ゲートウェイのログに拒否の記録が見つからなかったためです。

これから試す場合は、次の順に進めることをおすすめします。

  1. 本番とは別のプロジェクトで試す。バインド設定を変更すると、Agentの既存のリビジョンがすべてアーカイブされ、元に戻せない
  2. 最初はIAPを監査モードにしてバインドし、Agentが動くことを確かめ、必要な接続先への許可を設定してから強制モードに切り替える。公式ドキュメントによると、強制モードで必要なAPIを許可し忘れると、Agentの呼び出しがすべて498エラーで失敗する
  3. Model Armorを使う場合は、Data Access監査ログを有効にし、利用するリージョンでゲートウェイ経由の検査が記録されるかを確かめる
  4. Model Armorの拡張機能をコンソールで作成した場合は、作成後にfailOpenとタイムアウトの値を確かめる。今回コンソールで作成したときは、タイムアウトが10秒、failOpenがtrueだった

参考資料
#