Quote e limiti per Workflow Builder

Una quota è un limite configurabile o allocato alla quantità di una risorsa che puoi utilizzare, ad esempio query o creazioni di agenti giornaliere. 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 impostazione amministrativa modificabile.

Per informazioni sulle quote complessive di Gemini Enterprise, sul pooling tra le versioni e sui prezzi per l'eccedenza, consulta Quote ed eccedenze.

Quote basate su funzionalità e versioni

La creazione e l'esecuzione di agenti in Workflow Builder dipende 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 assegnata in base alla versione (discoveryengine.googleapis.com/agents_tier_enterprise_regional). Le quote di creazione giornaliere vengono raggruppate per tutti gli utenti con licenze per quella versione all'interno di un progetto e di una posizione specifici e vengono reimpostate ogni giorno a 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 dell'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 Impossibile creare o registrare agenti personalizzati. Le licenze Frontline non forniscono una quota di creazione e non contribuiscono alla quota di creazione condivisa 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) Aggregato in tutti i posti con licenza dell'edizione 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 di creazione giornaliero. L'utilizzo viene fatturato in base al consumo delle risorse sottostanti e al volume di query.

Per saperne di più su come vengono raggruppate, calcolate e fatturate le quote per gli addebiti per superamento delle quote nelle varie versioni, consulta Quote e addebiti per superamento delle quote.

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 di cui può essere proprietario.
Agenti per istanza dell'applicazione 10.000 Per istanza dell'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 dai Google Cloud criteri di autorizzazione IAM.
Assistenza di Google Gruppi Membri totali illimitati (1 gruppo = 1 membro delle norme) La condivisione con un gruppo Google viene conteggiata come un singolo membro ai fini del limite di 1500 membri previsto dai criteri.

Comportamento di errore del 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 superare il limite IAM di 1500 membri:

  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é 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, vedi Condividi un agente di chat e Condividi un workflow.

Limiti di complessità del generatore di flussi

Il canvas del generatore di flussi applica vincoli strutturali e di routing per mantenere una bassa latenza di esecuzione, garantire un'orchestrazione deterministica e impedire grafici di chiamate 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 root di chat può valutare e a cui può indirizzare le richieste.
Nodi per flusso 100 nodi Il numero totale massimo di nodi (inclusi nodi di trigger, condizione, azione, subagente e human-in-the-loop) consentiti in un singolo flusso di lavoro.
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 Un subagente alla volta Le esecuzioni del flusso di lavoro valutano ed eseguono i subagenti in sequenza; l'esecuzione parallela dei rami in 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 una singola operazione.
Numero massimo di token di contesto combinati 800.000 token Il numero massimo totale di token 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 non superano il limite di dimensioni 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 origini della 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 Contesto di un agente per intero nel contesto del prompt del modello a ogni turno. Se alleghi molti file o PDF densi (ad esempio manuali di oltre 100 pagine), il conteggio combinato dei token può superare il limite di contesto di 800.000 token o causare timeout di generazione. Importa invece grandi librerie di riferimento statiche in un datastore Gemini Enterprise connesso, che suddivide e indicizza automaticamente i documenti e riserva i caricamenti diretti di file per file più piccoli e specifici della sessione.
  • Dividi i PDF densi per caricarli direttamente: 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 PDF direttamente in una sessione con un agente o di chat, dividi i documenti di grandi dimensioni in file più piccoli e specifici per argomento.
  • Cartelle di lavoro Excel (.xlsx) con più fogli: quando carichi una cartella di lavoro .xlsx con più fogli nella sezione Knowledge 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 dal 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 i tuoi posti con licenza, Google fattura gli addebiti in eccesso a 5 $per GiB al mese. Per maggiori dettagli, vedi Quota di spazio di archiviazione e indicizzazione dei dati.

Limiti della pianificazione dell'esecuzione

Ai programmi degli agenti automatizzati 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 Oraria, giornaliera, settimanale, mensile, annuale Intervalli configurabili per i trigger di esecuzione automatica.
Finestra di validità delle credenziali 14 giorni Gli agenti pianificati vengono eseguiti utilizzando le credenziali dell'utente delegato 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 di temporizzazione dell'esecuzione Ritardo fino a 5 minuti 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 pianificate che eseguono azioni che interessano altre persone (ad esempio l'invio di email o la pianificazione di riunioni) vengono automaticamente messe in pausa per la revisione e richiedono l'approvazione dell'utente nella cronologia chat.

Per istruzioni sulla configurazione o l'aggiornamento delle pianificazioni, vedi Pianificare 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 dell'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 competenze Il numero massimo di agenti di competenze modulari a cui fa riferimento un agente.

Passaggi successivi