Workflow Builder 的配額和限制

「配額」是指可設定或分配的資源用量上限，例如每日建立或查詢代理的次數。如果是以帳戶為基礎的訂閱方案，系統會根據貴組織購買的授權數量自動調整配額。「限制」是系統限制或容量門檻，例如子代理深度、檔案上傳大小，或代理可共用的人數。系統限制是固定限制，除非明確註明為可調整的管理設定。

如要瞭解 Gemini Enterprise 的整體配額、各版本集區，以及超額用量 (即付即用) 的定價，請參閱「配額和即付即用用量」。

依功能和版本設定的配額

在 Workflow Builder 建立及執行代理，取決於您的 Gemini Enterprise 版本。

每日建立配額

建立、草擬及註冊代理時，會消耗每日建立配額，配額依版本分配 (discoveryengine.googleapis.com/agents_tier_enterprise_regional)。每日建立配額會匯總特定專案和位置中，所有具備該版本授權的使用者，並在太平洋時間 (PT) 每日午夜重設。

這項每日建立配額適用於：

版本 每日建立配額 說明
第一線工作人員/啟動條件 0 無法建立或註冊自訂代理。Frontline 授權不提供建立配額，也不會計入專案的共用建立配額。使用者只能執行與自己共用的代理。
標準 每位使用者每天 1 個代理 (集區) 集區涵蓋專案和位置中所有 Standard 版本授權名額。舉例來說，100 個授權可為專案提供每天 100 次建立和註冊作業。
Plus 每位使用者每天 10 個代理 (共用) 集結專案和位置中所有 Plus 版授權名額。舉例來說，100 個授權可為專案提供每天 1,000 次建立和註冊作業。
即付即用 無限制 沒有每日建立上限。用量會根據基礎資源消耗量和查詢量計費。

如要進一步瞭解各版本如何集結、計算及收取超額用量 (即付即用) 的配額，請參閱「配額和即付即用用量」。

代理容量限制

應用程式執行個體中可存在的有效代理數量限制如下：

資源 預設限制 範圍 說明
每位使用者的代理數量 1,000 依使用者帳戶數量 單一使用者可建立及擁有的代理數量上限。
每個應用程式執行個體的代理數量 10,000 每個應用程式執行個體 應用程式執行個體中，所有使用者最多總共可以建立幾個代理。

共用限制

與貴組織的同事共用代理時，須遵守下列限制：

設定 限制 說明
每個代理的個別成員數量上限 1,500 個個人帳戶 可直接新增至代理存取清單的個別使用者帳戶數量上限。由 Google Cloud IAM 允許政策強制執行。
Google 網路論壇支援 總成員數不限 (1 個群組 = 1 個政策成員) 與 Google 群組共用時，系統會將群組視為單一成員，計入 1,500 名成員的政策上限。

共用限制錯誤行為

如果嘗試與超過 1,500 個使用者帳戶共用代理，作業會失敗並傳回下列錯誤：

The number of members in the policy (1,501) is larger than the maximum allowed size 1,500.

大規模分享的最佳做法

如要與大量對象 (例如整個團隊、部門或組織) 共用代理，而不受 1,500 名成員的 IAM 限制，請按照下列步驟操作：

  1. 請要求應用程式管理員在功能控制項中啟用群組共用。
  2. 在代理共用對話方塊中，輸入 Google 群組或 Workspace 群組的電子郵件地址 (例如 support-team@example.com)，而非個別使用者帳戶。
  3. 在 Google 群組中動態管理目標對象成員資格；所有群組成員都會自動繼承存取權，不需修改代理的 IAM 政策。

如需逐步分享操作說明和權限層級，請參閱「分享對話代理」和「分享工作流程」。

流程建立工具複雜度限制

流程建構工具畫布會強制執行結構和轉送限制，以維持低執行延遲時間、確保確定性自動化調度管理，並防止循環呼叫圖：

限制 限制 說明
子代理深度 1 個等級 僅限單層流程深度。子代理無法呼叫其他子代理。不支援巢狀多層階層。
由對話根路由的子代理 50 個子代理 單一對話根代理可評估及轉送要求的子代理數量上限。
每個流程的節點 100 個節點 單一工作流程中可包含的節點總數上限 (包括觸發條件、條件、動作、子代理和人工介入迴路節點)。
每個節點的技能 20 項技能 單一流程節點可附加的工具技能或動作數量上限。
同時執行子代理 一次 1 個子代理 工作流程執行作業會依序評估及執行子代理，不支援跨多個子代理執行平行分支。

知識庫和檔案上傳限制

直接上傳至代理知識庫的文件有以下限制：

資源 限制 說明
檔案大小上限 每個檔案 20 MB 直接上傳至代理知識庫的個別檔案大小上限。
每個代理的檔案數量上限 100 個檔案 單一代理可附加的檔案總數上限。
每個上傳批次的檔案數量上限 10 個檔案 單次作業中可選取及上傳的檔案數量上限。
合併脈絡詞元數量上限 800,000 個詞元 附加至代理的所有靜態知識檔案、直接在對話工作階段中上傳的檔案，以及對話記錄的總詞元數量上限。如果超過這個詞元限制，即使個別檔案大小低於 20 MB，系統仍會傳回 FILE_SIZE_TOO_LARGE 或 Input too long 錯誤。
支援的文件類型 PDF、DOCX、TXT、PPTX、CSV、XLSX、HTML 和 Markdown (.md)。

大型文件和多工作表試算表的最佳做法

在代理中設定知識來源或分析複雜檔案時，請遵循下列指南，避免超出上下文詞元限制和處理逾時：

  • 使用連結的資料儲存庫 (RAG) 處理大型靜態文件庫：Gemini Enterprise 會將您上傳至代理「知識」專區的檔案，完整載入至模型每次對話的提示詞脈絡。如果附加多個檔案或內容密集的 PDF (例如超過 100 頁的手冊)，合併後的權杖數量可能會超過 80 萬個權杖的脈絡限制，或導致生成作業逾時。請改為將大型靜態參考資料庫，擷取至連結的 Gemini Enterprise 資料儲存庫，系統會自動將文件分塊並建立索引。直接上傳檔案的功能，則保留給較小的特定工作階段檔案。
  • 分割內容密集的 PDF，直接上傳：Gemini Enterprise 會將 PDF 的每一頁、文字和視覺版面配置轉換成符記，因此單一數百頁的 PDF 可能會消耗大量工作階段符記預算，並增加推論延遲時間。直接將 PDF 上傳至代理或對話工作階段時，請將大型文件分割成較小的特定主題檔案。
  • 多工作表 Excel (.xlsx) 活頁簿：將多工作表 .xlsx 活頁簿上傳至代理的「知識」專區或對話工作階段時，Gemini Enterprise 會自動將每個工作表轉換為個別的 CSV 資料表，以便執行程式碼，讓代理查詢、join 及分析活頁簿中所有工作表的資料。

儲存空間容量

上傳的檔案和已建立索引的文件會占用貴組織的儲存空間容量集區。無論版本為何，專案和位置中的所有使用者都會共用集區儲存空間：

  • 第一線工作人員/Starter：每位使用者 2 GiB。
  • Standard：每位使用者 30 GiB。
  • Plus：每位使用者 75 GiB。

如果儲存內容總量超出授權席位的集區總量，Google 會按照即付即用模式，針對超出配額的用量收取每月每 GiB $5 美元的費用。詳情請參閱「功能和版本配額」。

執行排程限制

自動化代理程式排程有下列限制和操作限制：

設定 限制或約束 說明
位置支援 僅限多區域 代理執行排程僅適用於多區域部署 (例如 us 或 eu)。
週期頻率 每小時、每日、每週、每月、每年 可設定自動執行觸發條件的間隔時間。
憑證效期 14 天 排程代理會使用作者委派的使用者憑證執行。憑證每 14 天會失效，必須在 Gemini Enterprise 手動重新整理，以免排程暫停。
執行時間延遲 最多延遲 5 分鐘 視系統佇列負載而定，排定的執行作業最多可能延遲 5 分鐘。
核准暫停 (HITL) 強制暫停外部動作 如果排定的執行作業會影響他人 (例如傳送電子郵件或安排會議)，系統會自動暫停並要求使用者在對話記錄中核准。

如要瞭解如何設定或重新整理排程，請參閱「排定聊天代理執行作業」。

連結的資料來源和整合限制

連結的資料儲存庫和第三方整合服務須遵守下列限制：

資源 預設限制 說明
每個應用程式的資料儲存庫數量 100 個資料儲存庫 每個應用程式執行個體可連結的企業資料儲存庫數量上限。提交配額提高要求，最多可提高至 500 個。
每個代理的連接器數量 100 個連接器 單一代理可附加的第三方資料連接器數量上限。
每個代理的 MCP 伺服器數量 100 個伺服器 連結至代理的 Model Context Protocol (MCP) 伺服器數量上限。
每個代理的技能代理數量 100 項技能 代理參照的模組化技能代理數量上限。

後續步驟