Cotas e limites para o Workflow Builder

Uma cota é um limite configurável ou alocado para a quantidade de um recurso que você pode usar, como criações ou consultas diárias de agentes. Para assinaturas baseadas em licenças, as cotas são ajustadas automaticamente com base no número de licenças que sua organização compra. Um limite é uma restrição do sistema ou um limite de capacidade, como a profundidade do subagente, o tamanho do upload de arquivos ou o número de pessoas com quem um agente pode ser compartilhado. Os limites do sistema são restrições fixas, a menos que sejam explicitamente indicados como uma configuração administrativa ajustável.

Para informações sobre as cotas gerais do Gemini Enterprise, o agrupamento entre edições e os preços de uso do pagamento por uso acima da cota, consulte Cotas e uso do pagamento por uso.

Cotas com base em recursos e edições

A criação e a execução de agentes no Workflow Builder dependem da sua edição do Gemini Enterprise.

Cotas de criação diárias

A criação, o rascunho e o registro de agentes consomem uma cota diária de criação alocada por edição (discoveryengine.googleapis.com/agents_tier_enterprise_regional). As cotas diárias de criação são agrupadas entre todos os usuários com licenças para essa edição em um projeto e local específicos e são redefinidas diariamente à meia-noite do horário do Pacífico (PT).

Essa cota diária de criação se aplica a:

  • Criar e rascunhar agentes personalizados no Workflow Builder.
  • Registrar agentes externos, personalizados ou de parceiros (como agentes A2A, ADK ou Dialogflow) com uma instância de app ou mecanismo usando o console do Google Cloud ou a API agents.create.
Edição Cota diária de criação Descrição
Frontline Worker / Starter 0 Não é possível criar ou registrar agentes personalizados. As licenças Frontline oferecem uma cota de criação de 0 e não contribuem para a cota de criação em pool do projeto. Os usuários só podem executar agentes compartilhados com eles.
Padrão 1 agente por usuário por dia (em pool) Agrupado em todas as licenças da edição Standard no projeto e no local. Por exemplo, 100 licenças fornecem 100 operações de criação e registro por dia para o projeto.
Plus 10 agentes por usuário por dia (em pool) Agrupado em todos os usuários licenciados da edição Plus no projeto e no local. Por exemplo, 100 licenças fornecem 1.000 operações de criação e registro por dia para o projeto.
Pagamento por uso Ilimitado Sem limites diários de criação. O uso é cobrado de acordo com o consumo de recursos subjacentes e o volume de consultas.

Para mais informações sobre como as cotas são agrupadas, calculadas e faturadas para o uso do pagamento por uso acima da cota em todas as edições, consulte Cotas e uso do pagamento por uso.

Limites de capacidade do agente

Os limites a seguir controlam o número de agentes ativos que podem existir em uma instância de aplicativo:

Recurso Limite padrão Escopo Descrição
Agentes por usuário 1.000 Por conta de usuário O número máximo de agentes que um único usuário pode criar e ter.
Agentes por instância do aplicativo 10.000 Por instância do aplicativo O número máximo total de agentes que podem existir em todos os usuários em uma instância de aplicativo.

Limites de compartilhamento

Ao compartilhar um agente com colegas da sua organização, os seguintes limites se aplicam:

Configuração Limite Descrição
Máximo de assinaturas individuais por agente 1.500 contas individuais O número máximo de contas de usuário individuais que podem ser adicionadas diretamente à lista de acesso de um agente. Aplicado por Google Cloud políticas de permissão do IAM.
Suporte do Grupos do Google Total ilimitado de membros (1 grupo = 1 membro da política) O compartilhamento com um Grupo do Google conta como um único membro para o limite de 1.500 membros da política.

Comportamento de erro de limite de compartilhamento

Se você tentar compartilhar um agente com mais de 1.500 contas de usuário individuais, a operação vai falhar e retornar o seguinte erro:

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

Práticas recomendadas para compartilhamento em grande escala

Para compartilhar um agente com públicos grandes (como distribuições para toda a equipe, departamento ou organização) sem atingir o limite de 1.500 membros do IAM:

  1. Peça ao administrador do app para ativar o compartilhamento em grupo nos controles de recursos.
  2. Na caixa de diálogo de compartilhamento do agente, insira o endereço de e-mail de um Grupo do Google ou do Workspace (por exemplo, support-team@example.com) em vez de contas de usuário individuais.
  3. Gerencie a associação do público-alvo de forma dinâmica no Grupo do Google. Todos os membros do grupo herdam o acesso automaticamente sem modificar a política de IAM do agente.

Para instruções detalhadas de compartilhamento e níveis de permissão, consulte Compartilhar um agente de chat e Compartilhar um fluxo de trabalho.

Limites de complexidade do criador de fluxos

A tela do criador de fluxos aplica restrições estruturais e de roteamento para manter uma baixa latência de execução, garantir uma orquestração determinística e evitar gráficos de chamadas circulares:

Restrição Limite Descrição
Profundidade do subagente 1 nível Somente profundidade de fluxo de nível único. Os subagentes não podem chamar outros subagentes. Não há suporte para hierarquias multinível aninhadas.
Subagentes roteados pela raiz do chat 50 subagentes O número máximo de subagentes que um único agente raiz de chat pode avaliar e para os quais pode encaminhar solicitações.
Nós por fluxo 100 nós O número máximo total de nós (incluindo nós de gatilho, condição, ação, subagente e human-in-the-loop) permitidos em um único fluxo de trabalho.
Habilidades por nó 20 habilidades O número máximo de habilidades ou ações de ferramentas que podem ser anexadas a um único nó de fluxo.
Execução simultânea de subagentes 1 subagente por vez As execuções de fluxo de trabalho avaliam e executam subagentes sequencialmente. Não há suporte para a execução de ramificações paralelas em vários subagentes.

Limites de upload de arquivos e base de conhecimento

Os limites a seguir se aplicam aos documentos enviados diretamente para a base de conhecimento de um agente:

Recurso Limite Descrição
Tamanhos máximos dos arquivos 20 MB por arquivo O tamanho máximo de um arquivo individual enviado diretamente para a base de conhecimento de um agente.
Máximo de arquivos por agente 100 arquivos O número total máximo de arquivos que podem ser anexados a um único agente.
Máximo de arquivos por lote de upload 10 arquivos O número máximo de arquivos que podem ser selecionados e enviados em uma única operação.
Máximo de tokens de contexto combinados 800.000 tokens A contagem máxima de tokens em todos os arquivos de conhecimento estáticos anexados a um agente, arquivos enviados diretamente em uma sessão de chat e histórico de conversas. Exceder esse limite de tokens retorna um erro FILE_SIZE_TOO_LARGE ou Input too long, mesmo que os arquivos individuais estejam abaixo do limite de tamanho de 20 MB.
Tipos de documentos aceitos PDF, DOCX, TXT, PPTX, CSV, XLSX, HTML e Markdown (.md).

Práticas recomendadas para documentos grandes e planilhas com várias páginas

Ao configurar fontes de conhecimento ou analisar arquivos complexos no agente, siga estas diretrizes para evitar limites de tokens de contexto e tempos limite de processamento:

  • Use um repositório de dados conectado (RAG) para grandes bibliotecas de documentos estáticos: o Gemini Enterprise carrega os arquivos que você envia para a seção Base de Conhecimento de um agente no contexto do comando do modelo em cada turno. Se você anexar muitos arquivos ou PDFs densos (como manuais com mais de 100 páginas), a contagem combinada de tokens pode exceder o limite de contexto de 800.000 tokens ou causar tempos limite de geração. Em vez disso, faça a ingestão de grandes bibliotecas de referência estáticas em um repositório de dados conectado do Gemini Enterprise, que divide e indexa documentos automaticamente, e reserve os uploads diretos de arquivos para arquivos menores e específicos da sessão.
  • Divida PDFs densos para uploads diretos: como o Gemini Enterprise tokeniza cada página de um PDF com o texto e o layout visual, um único PDF de centenas de páginas pode consumir uma grande parte do orçamento de tokens de sessão e aumentar a latência de raciocínio. Ao fazer upload de PDFs diretamente para um agente ou sessão de chat, divida documentos grandes em arquivos menores e específicos do tópico.
  • Pastas de trabalho do Excel (.xlsx) com várias planilhas: ao fazer upload de uma pasta de trabalho .xlsx com várias planilhas para a seção Base de Conhecimento de um agente ou em uma sessão de chat, o Gemini Enterprise converte automaticamente cada planilha em uma tabela CSV individual para execução de código Python. Assim, o agente pode consultar, mesclar e analisar dados em todas as planilhas da pasta de trabalho.

Capacidade de armazenamento

Os arquivos enviados e os documentos indexados consomem armazenamento do pool de capacidade de armazenamento da sua organização. O armazenamento é em pool para todos os usuários em um projeto e local, independentemente da edição:

  • Profissional na linha de frente / Starter: 2 GiB por usuário.
  • Standard: 30 GiB por usuário.
  • Plus: 75 GiB por usuário.

Se o conteúdo total armazenado exceder o pool combinado para suas licenças, o Google vai cobrar o uso acima da cota por pagamento por uso a US $5 por GiB por mês. Para mais detalhes, consulte Cotas baseadas em recursos e edições.

Limites da programação de execução

Os seguintes limites e restrições operacionais se aplicam às programações de agentes automatizados:

Configuração Limite ou restrição Descrição
Suporte para locais Somente multirregional As programações de execução de agentes só são compatíveis com implantações multirregionais (como us ou eu).
Frequências de recorrência Por hora, dia, semana, mês ou ano Intervalos configuráveis para acionadores de execução automatizada.
Período de validade da credencial 14 dias Os agentes programados são executados usando as credenciais de usuário delegadas do autor. As credenciais expiram a cada 14 dias e precisam ser atualizadas manualmente no Gemini Enterprise para evitar que as programações sejam pausadas.
Latência do tempo de execução Até 5 minutos de atraso As execuções programadas podem ter um atraso de até 5 minutos, dependendo da carga da fila do sistema.
Pausa para aprovação (HITL) Pausa obrigatória em ações externas As execuções programadas que realizam ações que afetam outras pessoas (como enviar e-mails ou agendar reuniões) são pausadas automaticamente para revisão e exigem a aprovação do usuário no histórico de conversas.

Para instruções sobre como configurar ou atualizar programações, consulte Programar uma execução do agente de chat.

Fontes de dados conectadas e limites de integração

Os limites a seguir se aplicam a repositórios de dados conectados e integrações de terceiros:

Recurso Limite padrão Descrição
Repositórios de dados por aplicativo 100 repositórios de dados O número máximo de repositórios de dados corporativos conectados por instância de aplicativo. Pode ser aumentado para até 500 enviando uma solicitação de aumento de cota.
Conectores por agente 100 conectores O número máximo de conectores de dados de terceiros anexados a um único agente.
Servidores MCP por agente 100 servidores O número máximo de servidores do Protocolo de Contexto de Modelo (MCP) vinculados a um agente.
Agentes de habilidade por agente 100 habilidades O número máximo de agentes de habilidades modulares referenciados por um agente.

A seguir