Quote e limiti per Workflow Builder

Una quota è un limite configurabile o allocato sulla quantità di una risorsa che puoi utilizzare, ad esempio le creazioni o le query giornaliere degli agenti. Per gli abbonamenti basati sulle utenze, le quote vengono modificate automaticamente in base al numero di licenze acquistate dalla tua organizzazione. Un limite è un vincolo di sistema o una soglia di capacità, come la profondità del subagente, le dimensioni di caricamento dei file o il numero di persone con cui un agente può essere condiviso. I limiti di sistema sono vincoli fissi, a meno che non siano esplicitamente indicati come impostazioni amministrative modificabili.

Per informazioni sulle quote complessive di Gemini Enterprise, sul pooling tra le versioni e sui prezzi per l'utilizzo con pagamento a consumo oltre la quota, consulta Quote e utilizzo con pagamento a consumo.

Quote basate su funzionalità e versione

La creazione e l'esecuzione di agenti in Workflow Builder dipendono dalla tua versione di Gemini Enterprise.

Quote di creazione giornaliere

La creazione, la stesura e la registrazione degli agenti consumano una quota di creazione giornaliera allocata per edizione (discoveryengine.googleapis.com/agents_tier_enterprise_regional). Le quote di creazione giornaliere vengono raggruppate tra tutti gli utenti con licenze per l'edizione in questione all'interno di un progetto e di una località specifici e vengono reimpostate ogni giorno alla mezzanotte del fuso orario del Pacifico (PT).

Questa quota di creazione giornaliera si applica a:

  • Creazione e bozza di agenti personalizzati in Workflow Builder.
  • Registrazione di agenti esterni, personalizzati o partner (come agenti A2A, agenti ADK o agenti Dialogflow) con un'istanza o un motore di app utilizzando la console Google Cloud o l'API agents.create.
Edizione Quota di creazione giornaliera Descrizione
Personale a contatto con il pubblico/Comando iniziale 0 Non può creare o registrare agenti personalizzati. Le licenze Frontline forniscono una quota di creazione pari a 0 e non contribuiscono alla quota di creazione in pool del progetto. Gli utenti possono eseguire solo gli agenti condivisi con loro.
Standard 1 agente per utente al giorno (in pool) In pool tra tutte le utenze con licenza Standard Edition nel progetto e nella località. Ad esempio, 100 licenze forniscono 100 operazioni di creazione e registrazione al giorno per il progetto.
Plus 10 agenti per utente al giorno (in pool) In pool tra tutte le utenze con licenza della versione Plus nel progetto e nella località. Ad esempio, 100 licenze forniscono 1000 operazioni di creazione e registrazione al giorno per il progetto.
Pagamento a consumo Illimitato Nessun limite giornaliero di creazioni. L'utilizzo viene fatturato in base al consumo delle risorse sottostanti e al volume delle query.

Per saperne di più su come vengono raggruppate, calcolate e fatturate le quote per l'utilizzo con pagamento a consumo oltre la quota nelle varie versioni, consulta Quote e utilizzo con pagamento a consumo.

Limiti di capacità degli agenti

I seguenti limiti regolano il numero di agenti attivi che possono esistere in un'istanza dell'applicazione:

Risorsa Limite predefinito Ambito Descrizione
Agenti per utente 1000 Per account utente Il numero massimo di agenti che un singolo utente può creare e possedere.
Agenti per istanza di applicazione 10.000 Per istanza di applicazione Il numero massimo totale di agenti che possono esistere per tutti gli utenti all'interno di un'istanza dell'applicazione.

Limiti di condivisione

Quando condividi un agente con i colleghi della tua organizzazione, si applicano i seguenti limiti:

Impostazione Limite Descrizione
Numero massimo di abbonamenti individuali per agente 1500 account individuali Il numero massimo di account utente individuali che possono essere aggiunti direttamente all'elenco per gli accessi di un agente. Applicato dalle Google Cloud policy di autorizzazione IAM.
Assistenza di Google Gruppi Numero illimitato di membri totali (1 gruppo = 1 membro della policy) La condivisione con un gruppo Google viene conteggiata come un singolo membro ai fini del limite di 1500 membri previsto dalla policy.

Comportamento di errore relativo al limite di condivisione

Se tenti di condividere un agente con più di 1500 account utente individuali, l'operazione non va a buon fine e viene restituito il seguente errore:

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

Best practice per la condivisione su larga scala

Per condividere un agente con un pubblico ampio (ad esempio, distribuzioni a livello di team, reparto o organizzazione) senza incontrare il limite di 1500 membri di IAM:

  1. Chiedi all'amministratore dell'app di attivare la condivisione di gruppo nei controlli delle funzionalità.
  2. Nella finestra di dialogo di condivisione dell'agente, inserisci l'indirizzo email di un gruppo Google o di un gruppo Workspace (ad esempio support-team@example.com) anziché gli account utente individuali.
  3. Gestisci l'appartenenza al segmento di pubblico in modo dinamico all'interno del gruppo Google; tutti i membri del gruppo ereditano automaticamente l'accesso senza modificare la policy IAM dell'agente.

Per istruzioni passo passo sulla condivisione e sui livelli di autorizzazione, consulta Condividi un agente di chat e Condividi un workflow.

Limiti di complessità del Flow Builder

Il canvas del Flow Builder applica vincoli strutturali e di routing per mantenere una bassa latenza di esecuzione, garantire un'orchestrazione deterministica e impedire grafi di chiamata circolari:

Vincolo Limite Descrizione
Profondità subagente 1 livello Solo profondità del flusso a un livello. I subagenti non possono chiamare altri subagenti. Le gerarchie multilivello nidificate non sono supportate.
Sub-agenti indirizzati dalla radice della chat 50 subagenti Il numero massimo di subagenti che un singolo agente principale della chat può valutare e a cui può indirizzare le richieste.
Nodi per flusso 100 nodi Il numero totale massimo di nodi (inclusi i nodi di trigger, condizione, azione, subagente e human-in-the-loop) consentiti in un singolo workflow.
Competenze per nodo 20 skill Il numero massimo di skill o azioni dello strumento che possono essere collegate a un singolo nodo del flusso.
Esecuzione simultanea dei subagenti 1 subagente alla volta Le esecuzioni del workflow valutano ed eseguono i subagenti in sequenza; l'esecuzione di rami paralleli su più subagenti non è supportata.

Limiti per la knowledge base e il caricamento di file

I seguenti limiti si applicano ai documenti caricati direttamente nella knowledge base di un agente:

Risorsa Limite Descrizione
Massima dimensione del file 20 MB per file La dimensione massima di un singolo file caricato direttamente nella knowledge base di un agente.
Numero massimo di file per agente 100 file Il numero totale massimo di file che possono essere allegati a un singolo agente.
Numero massimo di file per batch di caricamento 10 file Il numero massimo di file che possono essere selezionati e caricati in un'unica operazione.
Numero massimo di token di contesto combinati 800.000 token Il numero massimo di token totali in tutti i file di conoscenza statici allegati a un agente, i file caricati direttamente in una sessione di chat e la cronologia delle conversazioni. Il superamento di questo limite di token restituisce un errore FILE_SIZE_TOO_LARGE o Input too long, anche se i singoli file sono inferiori al limite di 20 MB.
Tipi di documenti supportati PDF, DOCX, TXT, PPTX, CSV, XLSX, HTML e Markdown (.md).

Best practice per documenti di grandi dimensioni e fogli di lavoro con più fogli

Quando configuri le fonti di conoscenza o analizzi file complessi nell'agente, segui queste linee guida per evitare limiti di token di contesto e timeout di elaborazione:

  • Utilizza un datastore connesso (RAG) per librerie di documenti statici di grandi dimensioni: Gemini Enterprise carica i file che carichi nella sezione Conoscenza di un agente per intero nel contesto del prompt del modello a ogni turno. Se alleghi molti file o PDF densi (come manuali di oltre 100 pagine), il numero di token combinato può superare il limite di contesto di 800.000 token o causare timeout di generazione. Invece, importa grandi librerie di riferimento statiche in un datastore Gemini Enterprise connesso, che suddivide e indicizza automaticamente i documenti, e riserva i caricamenti diretti dei file per file più piccoli e specifici della sessione.
  • Suddividi i PDF densi per i caricamenti diretti: poiché Gemini Enterprise tokenizza ogni pagina di un PDF insieme al testo e al layout grafico, un singolo PDF di centinaia di pagine può consumare una parte significativa del budget di token di sessione e aumentare la latenza del ragionamento. Quando carichi i PDF direttamente in un agente o in una sessione di chat, suddividi i documenti di grandi dimensioni in file più piccoli e specifici per argomento.
  • Cartelle di lavoro di Excel (.xlsx) con più fogli: quando carichi una cartella di lavoro .xlsx con più fogli nella sezione Contesto di un agente o in una sessione di chat, Gemini Enterprise converte automaticamente ogni foglio di lavoro in una singola tabella CSV per l'esecuzione di codice Python, in modo che l'agente possa eseguire query, unire e analizzare i dati in tutti i fogli della cartella di lavoro.

Capacità dello spazio di archiviazione

I file caricati e i documenti indicizzati consumano spazio di archiviazione del pool di capacità di archiviazione della tua organizzazione. Lo spazio di archiviazione è condiviso in pool tra tutti gli utenti di un progetto e di una località, indipendentemente dalla versione:

  • Personale a contatto con il pubblico/Starter: 2 GiB per utente.
  • Standard: 30 GiB per utente.
  • Plus: 75 GiB per utente.

Se i contenuti archiviati totali superano il pool combinato per le tue postazioni con licenza, Google fattura l'utilizzo con pagamento a consumo oltre la quota a 5 $per GiB al mese. Per maggiori dettagli, consulta Quote basate su funzionalità e versioni.

Limiti della pianificazione delle esecuzioni

Alle pianificazioni degli agenti automatici si applicano i seguenti limiti e vincoli operativi:

Impostazione Limite o vincolo Descrizione
Supporto per la posizione Solo multiregionale Le pianificazioni di esecuzione degli agenti sono supportate solo nei deployment multiregionali (ad esempio us o eu).
Frequenze di ricorrenza Ogni ora, ogni giorno, ogni settimana, ogni mese, ogni anno Intervalli configurabili per i trigger di esecuzione automatica.
Finestra di validità delle credenziali 14 giorni Gli agenti pianificati vengono eseguiti utilizzando le credenziali utente delegate dell'autore. Le credenziali scadono ogni 14 giorni e devono essere aggiornate manualmente in Gemini Enterprise per evitare che le pianificazioni vengano messe in pausa.
Latenza dei tempi di esecuzione Fino a 5 minuti di ritardo Le esecuzioni pianificate potrebbero subire un ritardo di pianificazione fino a 5 minuti a seconda del carico della coda di sistema.
Messa in pausa dell'approvazione (HITL) Pausa obbligatoria per le azioni esterne Le esecuzioni programmate che eseguono azioni che interessano altre persone (come l'invio di email o la pianificazione di riunioni) vengono messe in pausa automaticamente per la revisione e richiedono l'approvazione dell'utente nella cronologia chat.

Per istruzioni sulla configurazione o sull'aggiornamento delle pianificazioni, consulta Pianifica l'esecuzione di un agente di chat.

Origini dati collegate e limiti di integrazione

Ai datastore connessi e alle integrazioni di terze parti si applicano i seguenti limiti:

Risorsa Limite predefinito Descrizione
Datastore per applicazione 100 datastore Il numero massimo di datastore aziendali connessi per istanza di applicazione. Può essere aumentato fino a 500 inviando una richiesta di aumento della quota.
Connettori per agente 100 connettori Il numero massimo di connettori dati di terze parti collegati a un singolo agente.
Server MCP per agente 100 server Il numero massimo di server Model Context Protocol (MCP) collegati a un agente.
Agenti di skill per agente 100 skill Il numero massimo di agenti con competenze modulari a cui un agente fa riferimento.

Passaggi successivi