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,取得配額和系統限制的指標名稱。
控制台
在 Google Cloud 控制台,依序前往 「IAM & Admin」(IAM 與管理) > 「Quotas & System Limits」(配額與系統限制) 頁面:
前往「Quotas & System Limits」(配額與系統限制)
本頁面的表格會顯示有使用量或調整值的配額和系統限制,以及其他配額的參考項目。參考項目的「Name」(名稱) 欄結尾會顯示「default」(預設) 字樣。例如,
SetIAMPolicy requests per minute per region (default)是配額SetIamPolicyRequestsPerMinutePerProject的參考項目。如果沒有看到「指標」欄,請按照下列步驟操作。
- 按一下「資料欄顯示選項」。
- 選取「公制」。
- 按一下 [確定]。表格中會顯示「指標」欄。
「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 控制台。詳情請參閱「要求調整配額」。