Cuotas y límites para el Creador de flujos de trabajo

Una cuota es un límite configurable o asignado para la cantidad de un recurso que puedes usar, como las creaciones o consultas diarias de agentes. En el caso de las suscripciones basadas en licencias, las cuotas se ajustan automáticamente según la cantidad de licencias que compre tu organización. Un límite es una restricción del sistema o un umbral de capacidad, como la profundidad del agente secundario, el tamaño de carga de archivos o la cantidad de personas con las que se puede compartir un agente. Los límites del sistema son restricciones fijas, a menos que se indique de forma explícita como un parámetro de configuración administrativo ajustable.

Para obtener información sobre las cuotas generales de Gemini Enterprise, la agrupación en ediciones y los precios de uso de pago por uso por encima de la cuota, consulta Cuotas y uso de pago por uso.

Cuotas basadas en funciones y ediciones

La creación y ejecución de agentes en Workflow Builder depende de tu edición de Gemini Enterprise.

Cuotas de creación diarias

La creación, el borrador y el registro de agentes consumen una cuota de creación diaria asignada por edición (discoveryengine.googleapis.com/agents_tier_enterprise_regional). Las cuotas de creación diarias se agrupan entre todos los usuarios con licencias para esa edición dentro de un proyecto y una ubicación específicos, y se restablecen todos los días a la medianoche, hora del Pacífico (PT).

Esta cuota de creación diaria se aplica a lo siguiente:

Edición Cuota de creación diaria Descripción
Trabajador de primera línea/Starter 0 No se pueden crear ni registrar agentes personalizados. Las licencias de Frontline proporcionan una cuota de creación de 0 y no contribuyen a la cuota de creación conjunta del proyecto. Los usuarios solo pueden ejecutar los agentes que se compartieron con ellos.
Estándar 1 agente por usuario por día (agrupado) Se agrupan en todos los puestos con licencia de la edición Standard en el proyecto y la ubicación. Por ejemplo, 100 licencias proporcionan 100 operaciones de creación y registro por día para el proyecto.
Plus 10 agentes por usuario por día (agrupados) Se agrupa en todos los puestos con licencia de la edición Plus en el proyecto y la ubicación. Por ejemplo, 100 licencias proporcionan 1,000 operaciones de creación y registro por día para el proyecto.
Pago por uso Ilimitado No hay límites de creación diarios. El uso se factura según el consumo de recursos subyacente y el volumen de consultas.

Para obtener más información sobre cómo se agrupan, calculan y facturan las cuotas para el uso de pago por uso por encima de la cuota en todas las ediciones, consulta Cuotas y uso de pago por uso.

Límites de capacidad de los agentes

Los siguientes límites rigen la cantidad de agentes activos que pueden existir en una instancia de aplicación:

Recurso Límite predeterminado Alcance Descripción
Agentes por usuario 1,000 Por cuenta de usuario Es la cantidad máxima de agentes que un solo usuario puede crear y de los que puede ser propietario.
Agentes por instancia de aplicación 10,000 Por instancia de aplicación Es la cantidad máxima total de agentes que pueden existir en todos los usuarios dentro de una instancia de aplicación.

Límites de uso compartido

Cuando compartes un agente con colegas de tu organización, se aplican los siguientes límites:

Configuración Límite Descripción
Cantidad máxima de miembros individuales por agente 1,500 cuentas individuales Es la cantidad máxima de cuentas de usuario individuales que se pueden agregar directamente a la lista de acceso de un agente. Se aplica mediante Google Cloud políticas de permisos de IAM.
Asistencia de Grupos de Google Cantidad ilimitada de miembros totales (1 grupo = 1 miembro de la política) Compartir con un Grupo de Google cuenta como un solo miembro para el límite de la política de 1,500 miembros.

Comportamiento del error de límite de uso compartido

Si intentas compartir un agente con más de 1,500 cuentas de usuario individuales, la operación fallará y mostrará el siguiente error:

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

Prácticas recomendadas para compartir a gran escala

Para compartir un agente con públicos grandes (como distribuciones para todo el equipo, todo el departamento o toda la organización) sin alcanzar el límite de 1, 500 miembros de IAM,sigue estos pasos:

  1. Solicita al administrador de la app que habilite el uso compartido en grupo en los controles de funciones.
  2. En el cuadro de diálogo de uso compartido del agente, ingresa la dirección de correo electrónico de un Grupo de Google o un grupo de Workspace (por ejemplo, support-team@example.com) en lugar de cuentas de usuario individuales.
  3. Administra la membresía del público de forma dinámica dentro del Grupo de Google; todos los miembros del grupo heredan el acceso automáticamente sin modificar la política de IAM del agente.

Para obtener instrucciones paso a paso sobre el uso compartido y los niveles de permisos, consulta Comparte un agente de chat y Comparte un flujo de trabajo.

Límites de complejidad del creador de flujos

El lienzo del compilador de flujos aplica restricciones estructurales y de enrutamiento para mantener una latencia de ejecución baja, garantizar una organización determinística y evitar gráficos de llamadas circulares:

Restricción Límite Descripción
Profundidad del subagente 1 nivel Solo se admite la profundidad de flujo de un solo nivel. Los subagentes no pueden llamar a otros subagentes. No se admiten las jerarquías anidadas de varios niveles.
Subagentes enrutados por raíz de chat 50 subagentes Es la cantidad máxima de agentes secundarios a los que un solo agente raíz de chat puede evaluar y enrutar solicitudes.
Nodos por flujo 100 nodos Es la cantidad máxima total de nodos (incluidos los nodos de activador, condición, acción, agente secundario y con intervención humana) permitidos en un solo flujo de trabajo.
Habilidades por nodo 20 habilidades Es la cantidad máxima de habilidades o acciones de herramientas que se pueden adjuntar a un solo nodo de flujo.
Ejecución simultánea de agentes secundarios 1 subagente por vez Las ejecuciones de flujos de trabajo evalúan y ejecutan subagentes de forma secuencial; no se admite la ejecución de ramas paralelas en varios subagentes.

Límites de la base de conocimiento y de carga de archivos

Los siguientes límites se aplican a los documentos que se suben directamente a la base de conocimiento de un agente:

Recurso Límite Descripción
Tamaño máximo de archivo 20 MB por archivo Es el tamaño máximo de un archivo individual que se sube directamente a la base de conocimiento de un agente.
Cantidad máxima de archivos por agente 100 archivos Es la cantidad máxima total de archivos que se pueden adjuntar a un solo agente.
Cantidad máxima de archivos por lote de carga 10 archivos Es la cantidad máxima de archivos que se pueden seleccionar y subir en una sola operación.
Cantidad máxima de tokens de contexto combinados 800,000 tokens Es el recuento máximo total de tokens en todos los archivos de conocimiento estáticos adjuntos a un agente, los archivos subidos directamente en una sesión de chat y el historial de conversaciones. Si se supera este límite de tokens, se devuelve un error FILE_SIZE_TOO_LARGE o Input too long, incluso si los archivos individuales no superan el límite de tamaño de 20 MB.
Tipos de documentos admitidos PDF, DOCX, TXT, PPTX, CSV, XLSX, HTML y Markdown (.md).

Prácticas recomendadas para documentos grandes y hojas de cálculo con varias hojas

Cuando configures fuentes de conocimiento o analices archivos complejos en tu agente, sigue estos lineamientos para evitar los límites de tokens de contexto y los tiempos de espera de procesamiento:

  • Usa un almacén de datos conectado (RAG) para bibliotecas de documentos estáticos grandes: Gemini Enterprise carga los archivos que subes a la sección Conocimiento de un agente por completo en el contexto de la instrucción del modelo en cada turno. Si adjuntas muchos archivos o PDFs densos (como manuales de más de 100 páginas), el recuento combinado de tokens puede superar el límite de contexto de 800,000 tokens o causar tiempos de espera de generación. En su lugar, transfiere bibliotecas de referencia estáticas grandes a un almacén de datos de Gemini Enterprise conectado, que divide y, luego, indexa automáticamente los documentos, y reserva las cargas directas de archivos para archivos más pequeños y específicos de la sesión.
  • Divide los archivos PDF densos para las cargas directas: Debido a que Gemini Enterprise tokeniza cada página de un PDF junto con su texto y diseño visual, un solo PDF de varios cientos de páginas puede consumir una gran parte del presupuesto de tokens de la sesión y aumentar la latencia de razonamiento. Cuando subas archivos PDF directamente a un agente o una sesión de chat, divide los documentos grandes en archivos más pequeños y específicos de un tema.
  • Libros de Excel (.xlsx) con varias hojas: Cuando subes un libro de .xlsx con varias hojas a la sección Conocimiento de un agente o en una sesión de chat, Gemini Enterprise convierte automáticamente cada hoja de cálculo en una tabla CSV individual para la ejecución de código de Python, de modo que el agente pueda consultar, unir y analizar datos en todas las hojas del libro.

Capacidad de almacenamiento

Los archivos subidos y los documentos indexados consumen almacenamiento del grupo de capacidad de almacenamiento de tu organización. El almacenamiento se agrupa entre todos los usuarios de un proyecto y una ubicación, independientemente de la edición:

  • Trabajador de primera línea/Starter: 2 GiB por usuario
  • Standard: 30 GiB por usuario
  • Plus: 75 GiB por usuario

Si el contenido total almacenado supera el grupo combinado de tus licencias, Google facturará el uso de pago por uso que supere la cuota a USD 5 por GiB al mes. Para obtener más detalles, consulta Cuotas basadas en funciones y ediciones.

Límites de la programación de ejecución

Los siguientes límites y restricciones operativas se aplican a los programas de agentes automatizados:

Configuración Límite o restricción Descripción
Asistencia con la ubicación Solo multirregional Los programas de ejecución de agentes solo se admiten en implementaciones multirregionales (como us o eu).
Frecuencias de recurrencia Por hora, por día, por semana, por mes, por año Intervalos configurables para activadores de ejecución automatizados
Período de validez de las credenciales 14 días Los agentes programados se ejecutan con las credenciales de usuario delegado del autor. Las credenciales vencen cada 14 días y deben actualizarse manualmente en Gemini Enterprise para evitar que se detengan las programaciones.
Latencia de tiempo de ejecución Hasta 5 minutos de retraso Las ejecuciones programadas pueden experimentar un retraso de hasta 5 minutos según la carga de la cola del sistema.
Pausa de aprobación (HITL) Pausa obligatoria en acciones externas Las ejecuciones programadas que realizan acciones que afectan a otras personas (como enviar correos electrónicos o programar reuniones) se pausan automáticamente para su revisión y requieren la aprobación del usuario en el historial de chat.

Para obtener instrucciones sobre cómo configurar o actualizar programas, consulta Programa una ejecución del agente de chat.

Fuentes de datos conectadas y límites de integración

Los siguientes límites se aplican a los almacenes de datos conectados y a las integraciones de terceros:

Recurso Límite predeterminado Descripción
Almacenes de datos por aplicación 100 almacenes de datos Es la cantidad máxima de almacenes de datos empresariales conectados por instancia de aplicación. Se puede aumentar hasta 500 enviando una solicitud de aumento de cuota.
Conectores por agente 100 conectores Es la cantidad máxima de conectores de datos de terceros adjuntos a un solo agente.
Servidores de MCP por agente 100 servidores Es la cantidad máxima de servidores del Protocolo de contexto del modelo (MCP) vinculados a un agente.
Agentes de habilidades por agente 100 habilidades Es la cantidad máxima de agentes de habilidades modulares a los que hace referencia un agente.

¿Qué sigue?