Agent Platform のエージェントの割り当てとシステム上限

このドキュメントでは、Gemini Enterprise Agent Platform に適用される割り当てとシステム上限の一覧を示します。

  • 割り当てにはデフォルト値がありますが、通常は調整をリクエストできます。
  • システムの上限は固定値で、変更できません。

Cloud de Confiance by S3NS では、割り当てを使用して公平性を確保し、リソースの使用量と可用性の急増を抑えます。割り当ては、 Cloud de Confiance プロジェクトで使用できるCloud de Confiance リソースの量を制限します。割り当ては、ハードウェア、ソフトウェア、ネットワーク コンポーネントなど、さまざまなリソースタイプに適用されます。たとえば、割り当てによって、サービスへの API 呼び出しの数、プロジェクトで同時に使用されるロードバランサの数、作成可能なプロジェクトの数を制限できます。割り当てを適用することで、サービスの過負荷を防ぎ、Cloud de Confiance ユーザーのコミュニティを保護します。割り当ては、自組織で使用している Cloud de Confiance リソースの管理にも役立ちます。

Cloud Quotas システムは次のことを行います。

ほとんどの場合、割り当ての許容量を超えるリソースを消費しようとすると、システムによってリソースへのアクセスがブロックされ、実行しようとしているタスクは失敗します。

割り当ては通常、 Cloud de Confiance プロジェクト レベルで適用されます。あるプロジェクトでリソースを使用しても、別のプロジェクトで使用可能な割り当てに影響することはありません。 Cloud de Confiance プロジェクト内では、すべてのアプリケーションと IP アドレスで割り当てが共有されます。

詳細については、Cloud Quotas の概要をご覧ください。

割り当て

各リージョンの特定のプロジェクトの Agent Platform にデプロイされたエージェントには、次の割り当てが適用されます。

説明 割り当て 指標
1 分あたりの Agent Platform リソースの作成、削除、更新回数 10 aiplatform.googleapis.com/reasoning_engine_service_write_requests
1 分あたりの Agent Platform の非リージョン（グローバルまたはマルチリージョン）リソースの作成、削除、更新回数 10 aiplatform.googleapis.com/non_regional_reasoning_engine_service_write_requests
1 分あたりの Agent Platform セッションの作成、削除、更新回数 100 aiplatform.googleapis.com/session_write_requests
1 分あたりの Agent Platform のクエリ回数（Query または StreamQuery） 90 aiplatform.googleapis.com/reasoning_engine_service_query_requests
1 分あたりの Agent Platform セッションへのイベントの追加回数 300 aiplatform.googleapis.com/session_event_append_requests
1 分あたりの Agent Platform の非リージョン（グローバルまたはマルチリージョン）セッションの作成、削除、更新回数 100 aiplatform.googleapis.com/non_regional_session_write_requests
1 分あたりの Agent Platform の非リージョン（グローバルまたはマルチリージョン）セッションへのイベントの追加回数 300 aiplatform.googleapis.com/non_regional_session_event_append_requests
Agent Platform リソースの最大数 100 aiplatform.googleapis.com/reasoning_engine_service_entities
Agent Platform の非リージョン（グローバルまたはマルチリージョン）リソースの最大数 100 aiplatform.googleapis.com/non_regional_reasoning_engine_service_entities
1 分あたりの Agent Platform メモリリソースの作成、削除、更新回数 100 aiplatform.googleapis.com/memory_bank_write_requests
1 分あたりの Agent Platform メモリバンクからの取得、一覧表示、取得回数 300 aiplatform.googleapis.com/memory_bank_read_requests
1 分あたりの Agent Platform の非リージョン（グローバルまたはマルチリージョン）メモリリソースの作成、削除、更新回数 100 aiplatform.googleapis.com/non_regional_memory_bank_write_requests
1 分あたりの非リージョン（グローバルまたはマルチリージョン）Agent Platform メモリバンクからの取得、一覧表示、取得回数 300 aiplatform.googleapis.com/non_regional_memory_bank_read_requests
1 分あたりのサンドボックス環境（Code Execution）の実行リクエスト数 1000 aiplatform.googleapis.com/sandbox_environment_execute_requests
リージョンあたりのサンドボックス環境（Code Execution）のエンティティ数 1000 aiplatform.googleapis.com/sandbox_environment_entities
1 分あたりのサンドボックス環境（Code Execution）の書き込みリクエスト数 500 aiplatform.googleapis.com/sandbox_environment_write_requests
1 分あたりの A2A エージェントの POST リクエスト数（sendMessage や cancelTask など） 60 aiplatform.googleapis.com/a2a_agent_post_requests
1 分あたりの A2A エージェントの GET リクエスト数（getTask や getCard など） 600 aiplatform.googleapis.com/a2a_agent_get_requests
BidiStreamQuery API を使用した 1 分あたりの同時ライブ双方向接続数 10 aiplatform.googleapis.com/reasoning_engine_service_concurrent_query_requests
リージョンごとのプロジェクトあたりの最大リビジョン数 6,000 aiplatform.googleapis.com/agent_engine_revisions_per_project_per_region
エージェントごとの最大リビジョン数 950 aiplatform.googleapis.com/agent_engine_revisions_per_agent

本番環境の負荷の割り当て管理

トラフィックがスケーリングされると、429 Resource Exhausted エラーを回避するために、特定の Agent Platform API 割り当ての引き上げをリクエストする必要が生じる可能性があります。ランタイムを事前に構成し、割り当てを増やすことで、本番環境の負荷の下でも Agent Runtime インスタンスの応答性、スケーラビリティ、信頼性を維持できます。

Agent Runtime のパフォーマンスを最適化してスケーリングする方法については、Agent Runtime のパフォーマンスを最適化してスケーリングするをご覧ください。

ピーク時の割り当て要件を見積もる手順は次のとおりです。

  1. 変数を定義します。

    • U: 同時ユーザーのピーク数（例: 250）。

    • X: ユーザーあたりの 1 分あたりの平均リクエスト数（例: 2）。

    • Y: リクエストごとに生成されるセッション イベントの平均数（複数のツール呼び出しを含む複雑なチェーンの場合は 12 など）。

  2. ピーク負荷を計算します。

    • 1 分あたりの最大クエリ数（QPM）を計算します: U * X

    • ピーク時のセッション イベント数 / 分を計算します。ピーク時の QPM * Y

  3. バッファ付きの割り当てをリクエストする: 割り当ての増加をリクエストするときに、計算されたピークにバッファ（50% など）を追加して、予期しないスパイクに対応します。

次の表に、Agent Platform のパフォーマンス関連の主要な割り当ての計算を示します。ここでは、peak concurrent users=250、average requests per user per minute=2、average session events generated per request=12 の変数を使用しています。

割り当て名 割り当ての説明 基本計算（ピーク） 推奨値（50% のバッファを含む）
1 分あたりの Query Agent Engine（aiplatform.googleapis.com/reasoning_engine_service_query_requests） エージェントが 1 分あたりに受信できる query または stream_query 呼び出しの合計数。 250 users * 2 req/min = 500 QPM 500 * 1.5 = 750
1 分あたりのセッション イベントを追加（aiplatform.googleapis.com/session_event_append_requests）

進行中のすべてのセッション内のターン数またはイベント数。1 つのクエリで、複数のセッション イベントをチェーンで生成できます。例:

  1. LLM を呼び出す。
  2. LLM レスポンス: ツールを使用します。
  3. ツールを実行します。
  4. ツール レスポンスを使用して LLM を呼び出します。
  5. LLM が最終的な回答を返します。
 500 QPM * 12 events/req = 6,000 6,000 * 1.5 = 9,000
1 分あたりのセッション書き込み数（aiplatform.googleapis.com/session_write_requests） セッション リソースの作成または更新のレート。通常、これはクエリレート以下です。 通常 <= ピーク QPM（500） 通常はクエリの割り当て（750）以下

割り当ての調整をリクエストする

通常、割り当てを調整するには Cloud de Confiance コンソールを使用します。詳細については、割り当ての調整をリクエストするをご覧ください。

Agent Platform エクスプレス モードの割り当て

Agent Platform 無料枠のエクスプレス モードのユーザーには、Agent Platform サービスに対して次の割り当てが無料で提供されます。無料枠とエクスプレス モードの詳細については、エクスプレス モードの Agent Platform の概要をご覧ください。

各リージョンの特定のエクスプレス モード プロジェクトの Agent Platform にデプロイされたエージェントには、次の割り当てが適用されます。

説明 割り当て 指標
Agent Platform リソースの最大数 10 aiplatform.googleapis.com/reasoning_engine_service_entities
1 分あたりの Agent Platform リソースの作成、削除、更新回数 10 aiplatform.googleapis.com/reasoning_engine_service_write_requests
1 分あたりの Agent Platform のクエリ回数（Query または StreamQuery） 10 aiplatform.googleapis.com/reasoning_engine_service_query_requests
BidiStreamQuery API を使用した 1 分あたりの同時ライブ双方向接続数 1 aiplatform.googleapis.com/reasoning_engine_service_concurrent_query_requests
1 分あたりの Agent Platform セッションの作成、削除、更新回数 10 aiplatform.googleapis.com/session_write_requests
1 分あたりの Agent Platform セッションへのイベントの追加回数 30 aiplatform.googleapis.com/session_event_append_requests
1 分あたりの Agent Platform メモリリソースの作成、削除、更新回数 10 aiplatform.googleapis.com/memory_bank_write_requests
メモリバンクから 1 分あたりに取得、一覧表示、取得する 10 aiplatform.googleapis.com/memory_bank_read_requests