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:
- Crear y redactar agentes personalizados en Workflow Builder
- Registrar agentes externos, personalizados o de socios (como agentes
A2A, agentes
ADK o
agentes
de Dialogflow)
con una instancia o un motor de app con la consola de Google Cloud o la
API de
agents.create.
| 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:
- Solicita al administrador de la app que habilite el uso compartido en grupo en los controles de funciones.
- 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. - 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.xlsxcon 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?
- Crea un flujo de trabajo: Crea flujos de trabajo personalizados con el lienzo del compilador de flujos.
- Comparte un agente de chat y Comparte un flujo de trabajo: Administra los permisos de acceso y comparte agentes con miembros del equipo o Grupos de Google.
- Programa la ejecución de un agente de chat: Configura activadores de recurrencia automatizados por hora, diarios o semanales.
- Cuotas y uso de pago por uso: Revisa las cuotas de consultas agrupadas en toda la organización, los límites de indexación de almacenamiento y la facturación de pago por uso para Gemini Enterprise.