Agent Registry は、割り当てとシステム上限を使用して、公平なリソース割り当てを維持し、サービスの過負荷を防ぎ、リソースの使用を管理できるようにします。
割り当てとシステム上限は類似していますが、次の点で異なります。
- 割り当てにはデフォルト値がありますが、通常は調整をリクエストできます。
- システムの上限は固定値で、変更できません。
Google Cloud では、リソースの使用や可用性における公平性を保って急激な変動を抑えるために、割り当てが使用されています。割り当ては、 Google Cloud プロジェクトで使用できるGoogle Cloud リソースの量を制限します。割り当ては、ハードウェア、ソフトウェア、ネットワーク コンポーネントなど、さまざまなリソースタイプに適用されます。たとえば、割り当てによって、サービスへの API 呼び出しの数、プロジェクトで同時に使用されるロードバランサの数、作成可能なプロジェクトの数を制限できます。割り当てを適用することで、サービスの過負荷を防ぎ、Google Cloud ユーザーのコミュニティを保護します。割り当ては、自組織で使用している Google Cloud リソースの管理にも役立ちます。
Cloud Quotas システムは次のことを行います。
- Google Cloud のプロダクトとサービスの消費量をモニタリングする
- これらのリソースの消費量を制限する
- 割り当て値の変更をリクエストし、割り当ての調整を自動化する手段を提供する
ほとんどの場合、割り当ての許容量を超えるリソースを消費しようとすると、システムによってリソースへのアクセスがブロックされ、実行しようとしているタスクは失敗します。
割り当ては通常、 Google Cloud プロジェクト レベルで適用されます。あるプロジェクトでリソースを使用しても、別のプロジェクトで使用可能な割り当てに影響することはありません。 Google Cloud プロジェクト内では、すべてのアプリケーションと IP アドレスで割り当てが共有されます。
詳細については、Cloud Quotas の概要をご覧ください。
数量に基づく割り当て
数量に基づく割り当てでは、Agent Registry で一度に使用できる特定のリソースの量が制限されます。リソースを作成すると、そのリソースの使用可能な割り当てが減少します。リソースを削除すると、割り当てが復元されます。
次の表に、Agent Registry に適用される数量に基づく割り当てと、各割り当てのデフォルト値を示します。
| 割り当て | 値 |
|---|---|
| プロジェクトあたりの最大エージェント数 | 100（グローバルおよびリージョンごと） |
| プロジェクトあたりの最大 MCP サーバー数 | 100（グローバルおよびリージョンごと） |
| プロジェクトあたりの最大エンドポイント数 | 100（グローバルおよびリージョンごと） |
| プロジェクトあたりの最大バインディング数 | 100（グローバルおよびリージョンごと） |
| プロジェクトあたりの A2A スキルの最大数 | 100（グローバルおよびリージョンごと） |
| プロジェクトごと、ロケーションあたりのスタンドアロン スキルの最大数 | 100（グローバル、マルチリージョン、リージョンごと） |
| ロケーションあたりのプロジェクトごとのスキル リビジョンの最大数。ロケーション内のすべてのスキルで共有されます。 | 500（グローバル、マルチリージョン、リージョンごと） |
レートに基づく割り当て
レートに基づく割り当てでは、リソースの使用レートが制限されます。1 分あたりのレートに基づく割り当ては、1 分ごとにリセットされます。次の表に、Agent Registry に適用されるレートに基づく割り当てと、各割り当てのデフォルト値を示します。
| 割り当て | 値 |
|---|---|
| グローバル メソッドとリージョン メソッドにわたる API リクエストを集計する | プロジェクトあたり毎分 12,000 回（200 QPS） |
| グローバル API リクエスト | プロジェクトあたり毎分 1,200 回（20 QPS） |
| リージョン API リクエスト | 1 プロジェクト、1 リージョンあたり毎分 1,200 回（20 QPS） |
| スキルとスキル リビジョンのリクエストを作成、更新、削除する | 1 ロケーション、1 プロジェクトあたり毎分 120 回（2 QPS）。グローバル、マルチリージョン、リージョンごと） |
| スキルとスキル リビジョンの取得、一覧表示、検索のリクエスト | 1 プロジェクト、1 ロケーションあたり毎分 1,200 回（20 QPS。グローバル、マルチリージョン、リージョンごと） |
システム制限
次の表に、Agent Registry に適用されるシステム上限と、各システム上限の値を示します。
| システムの上限 | 値 |
|---|---|
| 表示名の長さ | 63 文字（サービスとバインディング）、128 文字（スキル） |
| 説明の長さ | 半角 2,048 文字 |
| エージェント仕様のコンテンツ サイズ | 10 KB |
| MCP サーバー仕様のコンテンツ サイズ | 10 KB |
| 圧縮されたスキル ペイロードの最大サイズ（ZIP） | 1 MB |
| スキャンされたスキルの非圧縮スキル ペイロードの最大合計サイズ | 10 MB。スキャンが有効になっている場合に適用されます。 |
| スキャンされたスキルのスキル ペイロードに含まれる個々の非圧縮ファイルの最大サイズ | 1 MB。スキャンが有効になっている場合に適用されます。 |
| サービスあたりの A2A スキルまたはツールの最大数 | 100 |
| 最大ページネーション サイズ | 100 |
| プロジェクト間の統合における管理プロジェクトあたりのメンバー プロジェクトの最大数 | 10,000 |
エージェント A2A とダウンストリーム サービスの割り当て
オーケストレーター エージェントが Agent2Agent（A2A）エージェントまたは Model Context Protocol（MCP）ツールを検出して呼び出すと、 Google Cloud は次の 3 つのレイヤで割り当ての使用量を評価します。
- レジストリの検出と管理の割り当て: このドキュメントに記載されている割り当てとレートに基づく割り当ては、Agent Registry に送信される登録、管理、検索、メタデータ検索のリクエストのみを制御します。クライアントがターゲット エージェントまたは MCP サーバーのエンドポイント URL を検索した後、ランタイム エージェントとツール呼び出しは Agent Registry のレートに基づく割り当てを消費しません。
- Agent Runtime の割り当て: 各ターゲット ランタイムまたは Google Cloudサービスは、独自のレートに基づく割り当てを適用します。サービス固有の上限については、ターゲット サービスの割り当てに関するドキュメントをご覧になるか、API 固有の割り当てを表示してください。
- ダウンストリームのサービスごとの API とトークンの割り当て: A2A エージェントがダウンストリームの Google Cloud API または MCP ツールを呼び出すと、これらの呼び出しは、リクエストごとに課金される割り当てプロジェクトまたはリソース プロジェクトのサービスごとの API レート割り当てを消費します。自律的な推論ループ、再試行、並列サブエージェントは、共有プロジェクトの割り当てに対してバースト トラフィックを生成する可能性があります。Cloud Quotas で使用量をモニタリングし、割り当ての表示と管理の説明に従って割り当て値を下げるようリクエストして、使用量を削減します。エージェントのアウトバウンド トラフィック全体で共有 LLM トークンの消費量を制限するには、Secure Web Proxy と Agent Gateway でトークン管理ポリシーを構成します。
割り当てとシステム上限の指標名を取得する
割り当てとシステム上限には、表示名と指標名の 2 種類の名前があります。表示名には、人間が読みやすいようにスペースと大文字が含まれています。指標名は小文字で、スペースの代わりにアンダースコアで区切られる傾向があります。正確な形式はサービスによって異なります。
次の手順では、 Google Cloud コンソールまたは Google Cloud CLI を使用して、割り当てとシステム上限の指標名を取得する方法について説明します。
コンソール
Google Cloud コンソールで、[IAM と管理] > [割り当てとシステム上限] ページに移動します。
このページの表には、使用量または調整値がある割り当ておよびシステム上限と、その他の割り当ての参照エントリが表示されます。参照エントリには、[名前] 列のリストの末尾に「default」という単語がかっこで囲まれて表示されます。たとえば、
SetIAMPolicy requests per minute per region (default)は割り当てSetIamPolicyRequestsPerMinutePerProjectの参照エントリです。[指標] 列が表示されない場合は、次の操作を行います。
- [ 列表示オプション] をクリックします。
- [指標] を選択します。
- [OK] をクリックします。[指標] 列が表に表示されます。
[指標] 列に指標名が表示されます。結果をフィルタするには、[ フィルタ] の横のフィールドにプロパティ名または値を入力します。
gcloud
gcloud CLI を使用して Google Cloud サービスの指標名を取得するには、quotas info list コマンドを実行します。指標名がリストされていない行をスキップするには、grep などのコマンドに出力を渡し、metric: を検索キーワードとして指定するか、gcloud CLI の --format フラグを使用します。
gcloud beta quotas info list --project=PROJECT_ID_OR_NUMBER \
--service=SERVICE_NAME --format="value(metric)"
次のように置き換えます。
PROJECT_ID_OR_NUMBER: プロジェクト ID またはプロジェクト番号。SERVICE_NAME: 割り当て指標を表示するサービスの名前。たとえば、Compute Engine のサービス名はcompute.googleapis.comです。サービス名のgoogleapis.com部分を含めます。
割り当ての調整をリクエストする
通常、割り当てを調整するには Google Cloud コンソールを使用します。詳細については、割り当ての調整をリクエストするをご覧ください。