Workflow Builder 的配额和限制

配额是指您可以使用的资源量（例如每日智能体创建次数或查询次数）的可配置或已分配限制。对于按席位订阅，配额会根据贵组织购买的许可数量自动调整。限制是指系统约束或容量阈值，例如子代理深度、文件上传大小或可与代理共享的个人数量。系统限制是固定约束，除非明确注明为可调整的管理设置。

如需了解 Gemini Enterprise 的总体配额、跨版本共用配额以及超配额用量随用随付价格，请参阅配额和随用随付用量。

基于功能和版本的配额

在 Workflow Builder 中创建和运行智能体取决于您的 Gemini Enterprise 版本。

每日创建配额

创建、草拟和注册智能体时，会消耗按版本分配的每日创建配额 (discoveryengine.googleapis.com/agents_tier_enterprise_regional)。每日创建配额由特定项目和位置中拥有该版本许可的所有用户共享，并在每天美国太平洋时间 (PT) 零点重置。

此每日创建配额适用于以下两项：

版本 每日创建配额 说明
一线员工版/一线员工新手版 0 无法创建或注册自定义代理。一线员工版许可不提供创建配额，也不会计入项目的共用创建配额。用户只能运行与其共享的代理。
标准 每位用户每天 1 个代理（共用） 在项目和位置中，所有标准版许可席位共用。例如，100 个许可每天可为项目提供 100 次创建和注册操作。
Plus 每位用户每天 10 个代理（共用） 在项目和位置中的所有 Plus 版许可席位之间共用。例如，100 个许可每天可为项目提供 1,000 次创建和注册操作。
随用随付 无限制 没有每日创建数量上限。系统会根据底层资源消耗量和查询量对用量进行计费。

如需详细了解如何针对各版本中的超配额用量随用随付汇总、计算和结算配额，请参阅配额和随用随付用量。

代理容量限制

以下限制规定了应用实例中可以存在的活跃代理数量：

资源 默认限额 范围 说明
每个用户的智能体数量 1000 每个用户账号 单个用户可创建和拥有的智能体数量上限。
每个应用实例的智能体数量 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 个文件 单次操作中可选择和上传的文件数量上限。
组合上下文 token 数上限 800,000 个 token 附加到智能体的所有静态知识文件、直接在对话会话中上传的文件以及对话记录中的总 token 数量上限。即使单个文件的大小低于 20 MB，超出此 token 限制也会返回 FILE_SIZE_TOO_LARGE 或 Input too long 错误。
支持的文档类型 PDF、DOCX、TXT、PPTX、CSV、XLSX、HTML 和 Markdown (.md)。

大型文档和多工作表电子表格的最佳实践

在代理中配置知识源或分析复杂文件时，请遵循以下准则，以免超出上下文词元限制和发生处理超时：

  • 为大型静态文档库使用关联的数据存储区 (RAG)：Gemini Enterprise 会在每次对话中，将您上传到智能体知识部分的文件完整加载到模型的提示上下文中。如果您附加了许多文件或内容密集的 PDF（例如超过 100 页的手册），则合并的 token 数量可能会超过 800,000 个 token 的上下文限制，或导致生成超时。相反，应将大型静态参考库注入到连接的 Gemini Enterprise 数据存储区中，该数据存储区会自动对文档进行分块和索引，并为较小的会话特定文件保留直接文件上传。
  • 拆分内容密集的 PDF 文件，以便直接上传：由于 Gemini Enterprise 会对 PDF 文件的每一页及其文本和图文并茂进行词元化，因此一个包含数百页的 PDF 文件可能会消耗大量会话令牌预算，并增加推理延迟时间。直接将 PDF 上传到智能体或对话会话时，请将大型文档拆分为较小的、特定于主题的文件。
  • 多工作表 Excel (.xlsx) 工作簿：当您将多工作表 .xlsx 工作簿上传到智能体的知识库部分或对话中时，Gemini Enterprise 会自动将每个工作表转换为单独的 CSV 表格，以便执行 Python 代码，从而使智能体能够查询、联接和分析工作簿中所有工作表的数据。

存储空间容量

上传的文件和已编入索引的文档会消耗贵组织存储空间容量池中的存储空间。无论使用哪个版本，项目和位置中的所有用户都可共用存储空间：

  • 一线员工版/新手版：每位用户 2 GiB。
  • 标准版：每位用户 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 项技能 一个智能体引用的模块化技能智能体数量上限。

后续步骤