Agent Registry verwendet Kontingente und Systemlimits, um eine faire Ressourcenzuweisung zu gewährleisten, Dienstüberlastungen zu vermeiden und Ihnen bei der Verwaltung der Ressourcennutzung zu helfen.
Kontingente und Systemlimits sind ähnlich, unterscheiden sich aber in folgenden Punkten:
- Kontingente haben Standardwerte, aber Sie können in der Regel Anpassungen anfordern.
- Systemlimits sind feste Werte, die nicht geändert werden können.
Google Cloud nutzt Kontingente, um für Fairness zu sorgen und Spitzen bei der Ressourcennutzung und ‑verfügbarkeit zu reduzieren. Ein Kontingent schränkt ein, wie viel von einerGoogle Cloud Ressource Ihr Google Cloud Projekt nutzen kann. Kontingente gelten für eine Reihe von Ressourcentypen, einschließlich Hardware, Software und Netzwerkkomponenten. Mit Kontingenten können Sie beispielsweise die Anzahl der API-Aufrufe an einen Dienst, die Anzahl der von Ihrem Projekt nebenläufig verwendeten Load Balancer oder die Anzahl der Projekte begrenzen, die Sie erstellen können. Kontingente sollen eine Überlastung von Diensten verhindern und dadurch die Community derGoogle Cloud Nutzer schützen. Sie helfen Ihnen auch bei der Verwaltung Ihrer eigenen Google Cloud Ressourcen.
Das Cloud-Kontingentsystem tut Folgendes:
- Es überwacht Ihren Verbrauch von Google Cloud Produkten und Diensten.
- Es schränkt Ihren Verbrauch dieser Ressourcen ein.
- Es bietet eine Möglichkeit, Änderungen am Kontingentwert zu beantragen und Kontingentanpassungen zu automatisieren.
Wenn Sie versuchen, mehr von einer Ressource zu verbrauchen, als das Kontingent zulässt, blockiert das System in den meisten Fällen den Zugriff auf die Ressource. Die Aufgabe, die Sie auszuführen versuchen, schlägt dann fehl.
Kontingente gelten in der Regel auf Google Cloud Projektebene. Die Nutzung einer Ressource in einem Projekt hat keinen Einfluss auf das verfügbare Kontingent in einem anderen Projekt. Innerhalb eines Google Cloud Projekts werden die Kontingente für alle Anwendungen und IP-Adressen gemeinsam genutzt.
Weitere Informationen finden Sie unter Cloud-Kontingente – Übersicht.
Zuteilungskontingente
Zuteilungskontingente beschränken die Menge einer bestimmten Ressource, die Sie in der Agent Registry zu einem bestimmten Zeitpunkt verwenden können. Wenn Sie eine Ressource erstellen, verringert sich Ihr verfügbares Kontingent für diese Ressource. Wenn Sie die Ressource löschen, wird das Kontingent wiederhergestellt.
In der folgenden Tabelle sind die Zuteilungskontingente aufgeführt, die für die Agent Registry gelten, sowie der Standardwert für jedes Kontingent.
| Kontingent | Wert |
|---|---|
| Maximale Anzahl von KI-Agenten pro Projekt | 100 (global und pro Region) |
| Maximale Anzahl von MCP-Servern pro Projekt | 100 (global und pro Region) |
| Maximale Anzahl von Endpunkten pro Projekt | 100 (global und pro Region) |
| Maximale Anzahl von Bindungen pro Projekt | 100 (global und pro Region) |
| Maximale Anzahl von A2A-Skills pro Projekt | 100 (global und pro Region) |
| Maximale Anzahl eigenständiger Skills pro Projekt und Standort | 100 (global, multiregional und pro Region) |
| Maximale Anzahl von Skill-Versionen pro Projekt und Standort, die von allen Skills am Standort gemeinsam genutzt werden | 500 (global, multiregional und pro Region) |
Ratenkontingente
Ratenkontingente beschränken die Rate, mit der Sie eine Ressource nutzen können. Minutenkontingente werden jede Minute zurückgesetzt. In der folgenden Tabelle sind die Ratenkontingente für die Agent Registry und der Standardwert für jedes Kontingent aufgeführt.
| Kontingent | Wert |
|---|---|
| API-Anfragen über globale und regionale Methoden hinweg aggregieren | 12.000 pro Minute und Projekt (200 Abfragen pro Sekunde) |
| Globale API-Anfragen | 1.200 pro Minute und Projekt (20 Abfragen pro Sekunde) |
| Regionale API-Anfragen | 1.200 pro Minute,Projekt und Region (20 Abfragen pro Sekunde) |
| Anfragen für Skills und Skill-Versionen erstellen, aktualisieren und löschen | 120 pro Minute, Projekt und Standort (2 Abfragen pro Sekunde). Global, multiregional und pro Region) |
| Anfragen für Skills und Skill-Versionen abrufen, auflisten und suchen | 1.200 pro Minute,Projekt und Standort (20 Abfragen pro Sekunde). Global, multiregional und pro Region) |
Systemlimits
In der folgenden Tabelle sind die Systemlimits für die Agent Registry und die Werte für die einzelnen Systemlimits aufgeführt.
| Systemlimit | Wert |
|---|---|
| Länge des Anzeigenamens | 63 Zeichen (Dienste und Bindungen); 128 Zeichen (Skills) |
| Länge der Beschreibung | 2.048 Zeichen |
| Größe des Inhalts der Agentenspezifikation | 10 KB |
| Inhaltsgröße der MCP-Serverspezifikation | 10 KB |
| Maximale Größe der komprimierten Skill-Nutzlast (ZIP) | 1 MB |
| Maximale unkomprimierte Gesamtgröße der Skill-Nutzlast für gescannte Skills | 10 MB, wird erzwungen, wenn das Scannen aktiviert ist |
| Maximale Größe einer einzelnen unkomprimierten Datei in der Skill-Nutzlast für gescannte Skills | 1 MB, erzwungen, wenn das Scannen aktiviert ist |
| Maximale Anzahl von A2A-Skills oder ‑Tools pro Dienst | 100 |
| Maximale Seitennummerierungsgröße | 100 |
| Maximale Anzahl von Mitgliedsprojekten pro Verwaltungsprojekt für projektübergreifende Roll-ups | 10.000 |
Kontingente für agentische A2A- und nachgelagerte Dienste
Wenn Ihre Orchestrator-Agenten Agent2Agent-Agenten (A2A) oder MCP-Tools (Model Context Protocol) erkennen und aufrufen, wertet Google Cloud den Kontingentverbrauch auf drei separaten Ebenen aus:
- Kontingente für die Erkennung und Verwaltung von Registries: Die in diesem Dokument aufgeführten Zuweisungs- und Ratenkontingente gelten nur für Anfragen zur Registrierung, Verwaltung, Suche und Metadatensuche, die an die Agent Registry gesendet werden. Laufzeit-Agenten- und Toolaufrufe verbrauchen kein Agent Registry-Ratenkontingent, nachdem Ihr Client eine Ziel-Agenten- oder MCP-Server-Endpunkt-URL abgerufen hat.
- Kontingente für die Ziel-Agent-Laufzeit: Jede Ziel-Laufzeit oder jeder Google Cloud-Dienst erzwingt eigene Kontingente für die Rate. Informationen zu dienstspezifischen Limits finden Sie in der Kontingentdokumentation für den Zieldienst oder unter API-spezifische Kontingente aufrufen.
- Nachgelagerte API- und Token-Kontingente pro Dienst: Wenn ein A2A-Agent nachgelagerte Google Cloud -APIs oder MCP-Tools aufruft, verbrauchen diese Aufrufe die API-Ratenkontingente pro Dienst des Kontingentprojekts oder Ressourcenprojekts, das für jede Anfrage abgerechnet wird. Autonome Reasoning Loops, Wiederholungsversuche und parallele Sub-Agents können zu Traffic-Spitzen führen, die die Kontingente für gemeinsam genutzte Projekte überschreiten. Überwachen Sie die Nutzung in Cloud-Kontingente und reduzieren Sie die Nutzung, indem Sie niedrigere Kontingentwerte anfordern, wie unter Kontingente ansehen und verwalten beschrieben. Wenn Sie die gemeinsame LLM-Tokennutzung für ausgehenden Agent-Traffic begrenzen möchten, konfigurieren Sie Richtlinien für die Tokenverwaltung in Secure Web Proxy und Agent Gateway.
Messwertnamen für Kontingente und Systemlimits abrufen
Kontingente und Systemlimits haben zwei Arten von Namen: Anzeigenamen und Messwertnamen. Anzeigenamen enthalten Leerzeichen und Großbuchstaben, damit sie für Menschen leichter zu lesen sind. Messwertnamen werden eher in Kleinbuchstaben geschrieben und durch Unterstriche anstelle von Leerzeichen getrennt. Das genaue Format hängt vom Dienst ab.
In der folgenden Anleitung wird beschrieben, wie Sie Messwertnamen für Kontingente und Systemlimits entweder über die Google Cloud Console oder die Google Cloud CLI abrufen.
Console
Gehen Sie in der Google Cloud Console zu IAM und Verwaltung > Kontingente und Systemlimits:
Zur Seite „Kontingente und Systemlimits“
In der Tabelle auf dieser Seite werden Kontingente und Systemlimits mit Nutzung oder angepassten Werten sowie ein Referenzeintrag für andere Kontingente angezeigt. Der Referenzeintrag enthält am Ende des Eintrags in der Spalte Name das Wort „default“ in Klammern.
SetIAMPolicy requests per minute per region (default)ist beispielsweise der Referenzeintrag für das KontingentSetIamPolicyRequestsPerMinutePerProject.Wenn die Spalte Messwert nicht angezeigt wird, gehen Sie wie beschrieben vor:
- Klicken Sie auf Spaltenanzeigeoptionen.
- Wählen Sie Metric (Messwert) aus.
- Klicken Sie auf OK. Die Spalte Messwert wird in der Tabelle angezeigt.
In der Spalte Messwert werden die Messwertnamen angezeigt. Wenn Sie die Ergebnisse filtern möchten, geben Sie einen Namen oder Wert für das Attribut in das Feld neben Filter ein.
gcloud
Führen Sie den Befehl quotas info list aus, um die Messwertnamen für einen Google Cloud -Dienst mithilfe der gcloud CLI abzurufen. Wenn Sie Zeilen überspringen möchten, in denen keine Messwertnamen aufgeführt sind, übergeben Sie die Ausgabe an einen Befehl wie grep mit metric: als Suchbegriff oder verwenden Sie das gcloud CLI-Flag --format:
gcloud beta quotas info list --project=PROJECT_ID_OR_NUMBER \
--service=SERVICE_NAME --format="value(metric)"
Ersetzen Sie Folgendes:
PROJECT_ID_OR_NUMBER: die Projekt-ID oder Projektnummer.SERVICE_NAME: Der Name des Dienstes, dessen Kontingentmesswerte Sie sehen möchten. Der Dienstname für Compute Engine lautet beispielsweisecompute.googleapis.com. Geben Sie den Teilgoogleapis.comdes Dienstnamens an.
Kontingentanpassung anfordern
Die meisten Kontingente können Sie in der Google Cloud Console anpassen. Weitere Informationen finden Sie unter Kontingentanpassung anfordern.