Kontingente und Limits für den Workflow-Builder

Ein Kontingent ist ein konfigurierbares oder zugewiesenes Limit für die Menge einer Ressource, die Sie verwenden können, z. B. die tägliche Erstellung von Agenten oder Abfragen. Bei nutzerbasierten Abos werden die Kontingente automatisch an die Anzahl der Lizenzen angepasst, die Ihre Organisation erwirbt. Ein Limit ist eine Systembeschränkung oder ein Kapazitätsschwellenwert, z. B. die Tiefe von Sub-Agenten, die Uploadgröße von Dateien oder die Anzahl der Personen, mit denen ein Agent geteilt werden kann. Systemlimits sind feste Einschränkungen, sofern sie nicht explizit als anpassbare administrative Einstellung angegeben sind.

Informationen zu den allgemeinen Gemini Enterprise-Kontingenten, zum Pooling über verschiedene Versionen hinweg und zu den Preisen für die „Pay as you go“-Nutzung über dem Kontingent finden Sie unter Kontingente und „Pay as you go“-Nutzung.

Feature- und editionsbasierte Kontingente

Das Erstellen und Ausführen von KI-Agenten im Workflow Builder hängt von Ihrer Gemini Enterprise-Version ab.

Tägliche Erstellungskontingente

Für das Erstellen, Entwerfen und Registrieren von KI-Agenten wird ein tägliches Erstellungskontingent verbraucht, das je nach Version (discoveryengine.googleapis.com/agents_tier_enterprise_regional) zugewiesen wird. Die täglichen Erstellungskontingente werden für alle Nutzer mit Lizenzen für diese Version innerhalb eines bestimmten Projekts und Standorts zusammengefasst und täglich um Mitternacht (Pacific Time, PT) zurückgesetzt.

Dieses tägliche Erstellungskontingent gilt für:

  • Benutzerdefinierte KI-Agenten im Workflow Builder erstellen und entwerfen.
  • Externe, benutzerdefinierte oder Partner-Agenten (z. B. A2A-Agenten, ADK-Agenten oder Dialogflow-Agenten) bei einer App-Instanz oder Engine über die Google Cloud Console oder die agents.create API registrieren.
Version Tägliches Erstellungskontingent Beschreibung
Frontline Worker / Starter 0 Benutzerdefinierte Agenten können nicht erstellt oder registriert werden. Frontline-Lizenzen bieten kein Erstellungskontingent und tragen nicht zum gemeinsamen Erstellungskontingent des Projekts bei. Nutzer können nur KI-Agenten ausführen, die für sie freigegeben wurden.
Standard 1 KI-Agent pro Nutzer und Tag (gemeinsam genutzt) Gemeinsam für alle lizenzierten Standard-Lizenzen im Projekt und am Standort. Beispiel: 100 Lizenzen ermöglichen 100 Erstellungs- und Registrierungsvorgänge pro Tag für das Projekt.
Plus 10 Agenten pro Nutzer und Tag (gemeinsam genutzt) Gemeinsam für alle lizenzierten Arbeitsplätze der Plus-Version im Projekt und am Standort. Beispiel: 100 Lizenzen ermöglichen 1.000 Erstellungs- und Registrierungsvorgänge pro Tag für das Projekt.
Pay as you go Unbegrenzt Keine Tageslimits für die Erstellung. Die Nutzung wird nach dem zugrunde liegenden Ressourcenverbrauch und dem Abfragevolumen abgerechnet.

Weitere Informationen dazu, wie Kontingente für die „Pay as you go“-Nutzung über dem Kontingent für alle Versionen zusammengefasst, berechnet und abgerechnet werden, finden Sie unter Kontingente und „Pay as you go“-Nutzung.

Kapazitätslimits für KI-Agenten

Die folgenden Limits gelten für die Anzahl der aktiven Agents, die in einer Anwendungsinstanz vorhanden sein können:

Ressource Standardlimit Umfang Beschreibung
KI-Agenten pro Nutzer 1.000 Pro Nutzerkonto Die maximale Anzahl von KI-Agenten, die ein einzelner Nutzer erstellen und besitzen kann.
KI-Agenten pro Anwendungsinstanz 10.000 Pro Anwendungsinstanz Die maximale Anzahl von KI-Agenten, die für alle Nutzer in einer Anwendungsinstanz vorhanden sein können.

Freigabebeschränkungen

Wenn Sie einen KI-Agenten für Kollegen in Ihrer Organisation freigeben, gelten die folgenden Limits:

Einstellung Limit Beschreibung
Maximale Anzahl einzelner Mitglieder pro KI-Agenten 1.500 einzelne Konten Die maximale Anzahl einzelner Nutzerkonten, die direkt der Zugriffsliste eines Agenten hinzugefügt werden können. Erzwungen durch Google Cloud IAM-Zulassungsrichtlinien.
Support für Google Groups Unbegrenzte Anzahl von Mitgliedern insgesamt (1 Gruppe = 1 Richtlinienmitglied) Wenn Sie eine Datei für eine Google-Gruppe freigeben,wird diese als ein einzelnes Mitglied auf das Limit von 1.500 Mitgliedern angerechnet.

Fehlerverhalten bei Freigabelimit

Wenn Sie versuchen,einen KI-Agenten für mehr als 1.500 einzelne Nutzerkonten freizugeben, schlägt der Vorgang fehl und gibt den folgenden Fehler zurück:

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

Best Practices für die Freigabe im großen Maßstab

So geben Sie einen KI-Agenten für große Zielgruppen frei (z. B. team-, abteilungs- oder organisationsweit), ohne das IAM-Limit von 1.500 Mitgliedern zu überschreiten:

  1. Bitten Sie Ihren App-Administrator, die Gruppenfreigabe in den Funktionseinstellungen zu aktivieren.
  2. Geben Sie im Dialogfeld für die Agentenfreigabe die E‑Mail-Adresse einer Google-Gruppe oder Workspace-Gruppe (z. B. support-team@example.com) anstelle einzelner Nutzerkonten ein.
  3. Verwalten Sie die Zielgruppenmitgliedschaft dynamisch innerhalb der Google-Gruppe. Alle Gruppenmitglieder erhalten automatisch Zugriff, ohne dass die IAM-Richtlinie des KI-Agenten geändert werden muss.

Eine detaillierte Anleitung zum Freigeben und zu den Berechtigungsstufen finden Sie unter Chat-Agent freigeben und Workflow freigeben.

Komplexitätslimits für den Flow Builder

Der Canvas des Flow Builders erzwingt strukturelle und Routing-Einschränkungen, um eine niedrige Ausführungslatenz aufrechtzuerhalten, eine deterministische Orchestrierung zu gewährleisten und zirkuläre Aufrufdiagramme zu verhindern:

Einschränkung Limit Beschreibung
Sub-Agenten-Tiefe 1 Stufe Nur einstufige Ablauftiefe. Sub-Agenten können keine weiteren Sub-Agenten aufrufen. Verschachtelte mehrstufige Hierarchien werden nicht unterstützt.
Sub-Agenten, die über den Chat-Stamm weitergeleitet werden 50 Sub-Agenten Die maximale Anzahl von Sub-Agenten, die ein einzelner Chat-Root-Agent bewerten und an die er Anfragen weiterleiten kann.
Knoten pro Ablauf 100 Knoten Die maximale Gesamtzahl der Knoten (einschließlich Trigger-, Bedingungs-, Aktions-, Subagenten- und Human-in-the-Loop-Knoten), die in einem einzelnen Workflow zulässig sind.
Fähigkeiten pro Knoten 20 Skills Die maximale Anzahl von Tool-Skills oder -Aktionen, die an einen einzelnen Ablaufknoten angehängt werden können.
Gleichzeitige Ausführung von Sub-Agenten 1 Sub-Agent nach dem anderen Workflowausführungen bewerten und führen Sub-Agents nacheinander aus. Die parallele Ausführung von Zweigen über mehrere Sub-Agents hinweg wird nicht unterstützt.

Limits für Wissensdatenbank und Dateiuploads

Für Dokumente, die direkt in die Wissensdatenbank eines KI-Agenten hochgeladen werden, gelten die folgenden Limits:

Ressource Limit Beschreibung
Maximale Dateigröße 20 MB pro Datei Die maximale Größe für eine einzelne Datei, die direkt in die Wissensdatenbank eines KI-Agenten hochgeladen wird.
Maximale Anzahl von Dateien pro KI-Agent 100 Dateien Die maximale Gesamtzahl der Dateien, die an einen einzelnen Agenten angehängt werden können.
Maximale Anzahl von Dateien pro Upload-Batch 10 Dateien Die maximale Anzahl von Dateien, die in einem einzigen Vorgang ausgewählt und hochgeladen werden können.
Maximale Anzahl kombinierter Kontext-Tokens 800.000 Tokens Die maximale Gesamtanzahl von Tokens für alle statischen Wissensdateien, die an einen Agenten angehängt sind, Dateien, die direkt in einer Chatsitzung hochgeladen wurden, und den Unterhaltungsverlauf. Wenn dieses Tokenlimit überschritten wird, wird ein FILE_SIZE_TOO_LARGE- oder Input too long-Fehler zurückgegeben, auch wenn die einzelnen Dateien unter dem Größenlimit von 20 MB liegen.
Unterstützte Dokumenttypen PDF, DOCX, TXT, PPTX, CSV, XLSX, HTML und Markdown (.md).

Best Practices für große Dokumente und Tabellen mit mehreren Tabellenblättern

Beachten Sie beim Konfigurieren von Wissensquellen oder beim Analysieren komplexer Dateien in Ihrem Agenten die folgenden Richtlinien, um Kontext-Token-Limits und Zeitüberschreitungen bei der Verarbeitung zu vermeiden:

  • Verbundene Datenspeicher (RAG) für große statische Dokumentbibliotheken verwenden: Gemini Enterprise lädt Dateien, die Sie in den Bereich Wissen eines Agenten hochladen, bei jeder Interaktion vollständig in den Prompt-Kontext des Modells. Wenn Sie viele Dateien oder umfangreiche PDFs (z. B. Handbücher mit mehr als 100 Seiten) anhängen, kann die kombinierte Tokenanzahl das Kontextlimit von 800.000 Tokens überschreiten oder zu Zeitüberschreitungen bei der Generierung führen. Stattdessen sollten Sie große statische Referenzbibliotheken in einen verbundenen Gemini Enterprise-Datenspeicher aufnehmen, der Dokumente automatisch in Blöcke aufteilt und indexiert. Direkte Dateiuploads sollten Sie für kleinere, sitzungsspezifische Dateien reservieren.
  • Umfangreiche PDFs für direkte Uploads aufteilen: Da Gemini Enterprise jede Seite einer PDF-Datei zusammen mit dem Text und dem visuellen Layout tokenisiert, kann eine einzelne PDF-Datei mit mehreren hundert Seiten einen großen Teil des Sitzungstoken-Budgets verbrauchen und die Latenz beim Schlussfolgern erhöhen. Wenn Sie PDFs direkt in einen KI-Agenten oder eine Chatsitzung hochladen, sollten Sie große Dokumente in kleinere, themenspezifische Dateien aufteilen.
  • Excel-Arbeitsmappen (.xlsx) mit mehreren Tabellenblättern: Wenn Sie eine .xlsx-Arbeitsmappe mit mehreren Tabellenblättern in den Bereich Wissen eines Agenten oder in eine Chatsitzung hochladen, konvertiert Gemini Enterprise jedes Arbeitsblatt automatisch in eine separate CSV-Tabelle für die Python-Code-Ausführung. So kann der Agent Daten aus allen Tabellenblättern der Arbeitsmappe abfragen, zusammenführen und analysieren.

Speicherkapazität

Hochgeladene Dateien und indexierte Dokumente belegen Speicherplatz im Speicherkapazitätspool Ihrer Organisation. Der Speicherplatz wird für alle Nutzer in einem Projekt und an einem Standort gemeinsam genutzt, unabhängig von der Version:

  • Frontline Worker / Starter: 2 GiB pro Nutzer.
  • Standard: 30 GiB pro Nutzer.
  • Plus: 75 GiB pro Nutzer.

Wenn die insgesamt gespeicherten Inhalte das gemeinsame Kontingent für Ihre lizenzierten Arbeitsbereiche überschreiten, stellt Google die Pay as you go-Nutzung über das Kontingent hinaus mit 5 $ pro GiB und Monat in Rechnung. Weitere Informationen finden Sie unter Feature- und editionsbasierte Kontingente.

Limits für Ausführungszeitpläne

Für Zeitpläne für automatisierte KI-Agenten gelten die folgenden Limits und betrieblichen Einschränkungen:

Einstellung Limit oder Einschränkung Beschreibung
Standortunterstützung Nur multiregional Zeitpläne für die Agentenausführung werden nur in multiregionalen Bereitstellungen (z. B. us oder eu) unterstützt.
Wiederholungshäufigkeiten Stündlich, täglich, wöchentlich, monatlich, jährlich Konfigurierbare Intervalle für automatisierte Ausführungstrigger.
Gültigkeitszeitraum der Anmeldedaten 14 Tage Geplante Agenten werden mit den delegierten Nutzeranmeldedaten des Autors ausgeführt. Anmeldedaten laufen alle 14 Tage ab und müssen in Gemini Enterprise manuell aktualisiert werden, damit Zeitpläne nicht pausiert werden.
Latenz bei der Ausführung Bis zu 5 Minuten Verzögerung Bei geplanten Ausführungen kann es je nach Auslastung der Systemwarteschlange zu einer Verzögerung von bis zu 5 Minuten kommen.
Genehmigung pausieren (HITL) Obligatorische Pause bei externen Aktionen Geplante Ausführungen, die Aktionen ausführen, die sich auf andere Personen auswirken (z. B. das Senden von E‑Mails oder das Planen von Besprechungen), werden automatisch zur Überprüfung pausiert und erfordern die Genehmigung des Nutzers im Chatprotokoll.

Eine Anleitung zum Konfigurieren oder Aktualisieren von Zeitplänen finden Sie unter Ausführung eines Chat-Agenten planen.

Verbundene Datenquellen und Integrationslimits

Für verbundene Datenspeicher und Integrationen von Drittanbietern gelten die folgenden Limits:

Ressource Standardlimit Beschreibung
Datenspeicher pro Anwendung 100 Datenspeicher Die maximale Anzahl verbundener Unternehmensdatenspeicher pro Anwendungsinstanz. Kann durch Einreichen einer Anfrage zur Kontingenterhöhung auf bis zu 500 erhöht werden.
Connectors pro KI-Agenten 100 Connectors Die maximale Anzahl von Drittanbieter-Daten-Connectors, die mit einem einzelnen KI-Agenten verknüpft werden können.
MCP-Server pro KI-Agent 100 Server Die maximale Anzahl von MCP-Servern (Model Context Protocol), die mit einem Agenten verknüpft sind.
Skill-Agenten pro Agent 100 Skills Die maximale Anzahl von modularen Skill-Agenten, auf die ein Agent verweist.

Nächste Schritte