配額與系統限制

這份文件列出 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 的分配配額，以及各項配額的預設值。

配額	值
區域服務：每個區域每項專案的註冊代理、MCP 伺服器和端點	100
全域服務：每個專案註冊的代理、MCP 伺服器和端點	100

頻率配額

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

配額	值
每項專案每分鐘的 API 要求總數	12,000
每分鐘的區域位置資訊 API 要求數	1,200
每分鐘的全球位置資訊 API 要求數	1,200

系統限制

下表列出適用於代理程式登錄的系統限制，以及各項系統限制的值。

系統限制	值
顯示名稱長度	63 個半形字元
說明長度	2,048 個半形字元
代理規格內容大小	10 KB
MCP 伺服器規格內容大小	10 KB
每個服務的技能或工具數量上限	100

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

配額和系統限制有兩種名稱：顯示名稱和指標名稱。顯示名稱含有空格和大小寫，方便使用者閱讀。指標名稱則多半是小寫，並以底線分隔而非空格；確切格式取決於服務。

以下操作說明將示範如何使用 Google Cloud 控制台或 gcloud CLI，取得配額和系統限制的指標名稱。

控制台

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

   前往「配額與系統限制」頁面

   這個頁面上的表格會顯示已使用或已調整值的配額和系統限制，以及其他配額的參考項目。參考項目的「名稱」欄位清單結尾會以括號標示「預設」一詞。舉例來說，SetIAMPolicy requests per minute per region (default) 是配額 SetIamPolicyRequestsPerMinutePerProject 的參考項目。

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

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

「指標」欄會顯示指標名稱。如要篩選結果，請在「篩選條件」 旁的欄位中輸入屬性名稱或值。

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