配額與系統限制

Agent Registry 會使用配額和系統限制,確保資源分配公平、防止服務過載,並協助您管理資源用量。

配額和系統限制類似,但有以下差異:

  • 「配額」有預設值,但通常可以申請調整。
  • 「系統限制」是固定值,無法變更。

Google Cloud 使用配額來確保公平性,並減少資源使用量和可用性出現劇烈波動的情況。配額會限制 Google Cloud 專案可使用的Google Cloud 資源數量,配額適用多種資源類型,包括硬體、軟體和網路元件。舉例來說,配額可能會限制能向特定服務發出的 API 呼叫次數、專案可同時使用的負載平衡器數量,或是可建立的專案數量。配額機制可防止服務過載,保障Google Cloud 使用者社群的權益,同時也有助於您管理自己的 Google Cloud 資源。

Cloud Quotas 系統具備以下功能:

如果嘗試使用的資源量超過配額限制,系統通常會阻擋該資源的存取活動,您所執行的工作就會失敗。

配額的計算通常是以 Google Cloud 專案為基準。在某個專案中使用資源,不會影響另一個專案的可用配額。在同一個 Google Cloud 專案內,所有應用程式和 IP 位址會共用配額。

詳情請參閱「Cloud Quotas 總覽」。

分配配額

分配配額會限制 Agent Registry 在特定時間允許使用的特定資源數量。建立資源時,該資源的可用配額會減少。刪除資源後,配額就會恢復。

下表列出適用於 Agent Registry 的分配配額,以及各項配額的預設值。

配額 值
每項專案的代理數量上限 100 (全域和各區域)
每項專案的 MCP 伺服器數量上限 100 (全域和各區域)
每項專案的端點數量上限 100 (全域和各區域)
每項專案的繫結數量上限 100 (全域和各區域)
每項專案的 A2A 技能數量上限 100 (全域和各區域)
每項專案的獨立技能數量上限 100 (全域和各區域)
每項技能的修訂版本數量上限 100 (全域和各區域)

頻率配額

頻率配額會限制資源消耗率。每分鐘頻率配額每分鐘重設一次。下表列出適用於 Agent Registry 的頻率配額,以及各項配額的預設值。

配額 值
匯總全域和區域方法的 API 要求 每項專案每分鐘 12,000 次 (200 QPS)
全域 API 要求 每項專案每分鐘 1,200 次 (20 QPS)
區域 API 要求 每項專案每區域每分鐘 1,200 次 (20 QPS)

系統限制

下表列出 Agent Registry 的系統限制,以及各項限制的值。

系統限制 值
顯示名稱長度 63 個字元 (服務和繫結);128 個字元 (技能)
說明長度 2,048 個半形字元
代理規格內容大小 10 KB
MCP 伺服器規格內容大小 10 KB
壓縮技能酬載大小上限 (ZIP) 500 KB
未壓縮技能酬載總大小上限 10 MB
技能酬載中未壓縮的個別檔案大小上限 1 MB
每項服務的 A2A 技能或工具數量上限 100
分頁大小上限 100
每個管理專案的成員專案數量上限 (用於跨專案匯總) 10,000

取得配額和系統限制指標名稱

配額和系統限制有兩種名稱:顯示名稱和指標名稱。顯示名稱包含空格和大小寫,方便使用者閱讀。指標名稱通常會使用小寫,並以底線 (而非空格) 分隔,確切格式取決於服務。

下列操作說明說明如何使用 Google Cloud 控制台或 Google Cloud CLI,取得配額和系統限制的指標名稱。

控制台

  1. 在 Google Cloud 控制台,依序前往 「IAM & Admin」(IAM 與管理) > 「Quotas & System Limits」(配額與系統限制) 頁面:

    前往「Quotas & System Limits」(配額與系統限制)

    本頁面的表格會顯示有使用量或調整值的配額和系統限制,以及其他配額的參考項目。參考項目的「Name」(名稱) 欄結尾會顯示「default」(預設) 字樣。例如,SetIAMPolicy requests per minute per region (default) 是配額 SetIamPolicyRequestsPerMinutePerProject 的參考項目。

  2. 如果沒有看到「指標」欄,請按照下列步驟操作。

    1. 按一下「資料欄顯示選項」。
    2. 選取「公制」。
    3. 按一下 [確定]。表格中會顯示「指標」欄。

「Metric」欄會顯示指標名稱。如要篩選結果,請在「 Filter」(篩選器) 旁的欄位中輸入屬性名稱或值。

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 控制台。詳情請參閱「要求調整配額」。