Auf dieser Seite erfahren Sie, wie Sie Probleme mit der Agent Registry beheben.
API-Ratenkontingent überschritten
Dieses Problem kann auftreten, wenn Sie mit der Agent Registry API interagieren oder schnell durch die Agent Registry in Google Cloud der Console navigieren:
429 Too Many Requests
Implementieren Sie zur Behebung dieses Problems einen exponentiellen Backoff in Ihren API-Clients, um die Anfrageraten zu verwalten. Die Agent Registry API hat ein standardmäßiges Raten kontingent von 1.200 Anfragen pro Minute weltweit und pro Region.
Wenn beim Wechseln von Tabs in der Google Cloud Console eine Drosselung auftritt, warten Sie einige
Augenblicke und versuchen Sie es noch einmal. Wenn Ihr programmatischer Anwendungsfall höhere Limits erfordert,
fordern Sie eine Kontingenterhöhung an
für die RequestsPerMinute Messwert.
Fehler bei der Nutzlastgröße während der manuellen Registrierung
Dieses Problem kann auftreten, wenn Sie einen Agenten oder MCP-Server manuell registrieren: Die API lehnt die Anfrage mit einem Fehler ab, der besagt, dass die Nutzlast zu groß ist.
Prüfen Sie zur Behebung dieses Problems, ob Ihre Datei agent-card.json oder toolspec.json kleiner als 10 KB ist. Die Größen der Inhalte von AgentSpec und McpServerSpec sind auf 10 KB begrenzt. Minimieren Sie Ihre JSON-Dateien, entfernen Sie unnötige Leerzeichen oder fassen Sie Toolbeschreibungen zusammen, um dieses Limit einzuhalten. Weitere Informationen finden Sie unter
JSON-Schemas.
Fehlende Agents oder MCP-Server nach der Erstellung
Dieses Problem kann auftreten, wenn Sie einen Agenten oder MCP-Server in einem
unterstützten Google Cloud Produkt wie Google Workspace oder
Gemini Enterprise erstellen: Die Ressource wird beim Aufrufen der APIs
ListAgents oder ListMcpServers nicht angezeigt.
Warten Sie zur Behebung dieses Problems, bis die Hintergrundsynchronisierung abgeschlossen ist. Ihre Ressourcen werden in Echtzeit aktualisiert, andere Integrationen werden jedoch durch Offline-Batchjobs gefüllt, die regelmäßig ausgeführt werden. Wenn Ihre Ressource nach mehreren Stunden nicht angezeigt wird, prüfen Sie die Einstellungen zur Service Usage Ihres Projekts und stellen Sie sicher, dass die entsprechende API aktiviert ist.
Lang andauernde Vorgänge scheinen festzuhängen
Dieses Problem kann auftreten, wenn Sie Agents bereitstellen oder komplexe Bindungen konfigurieren: Der Vorgang dauert sehr lange und scheint festzuhängen.
Verwenden Sie zur Behebung dieses Problems das MCP-Tool get_operation oder den API-Endpunkt google.longrunning.Operations.GetOperation, um den Status des Vorgangs abzurufen. Für einige Agenten- und MCP-Backend-Erstellungen ist eine erhebliche Infrastrukturbereitstellung erforderlich, was zu Vorgängen mit langer Ausführungszeit (Long-Running Operations, LROs) führen kann, die bis zu 30 Minuten dauern können. Konfigurieren Sie die Timeout-Einstellungen Ihres Clients entsprechend und rufen Sie das boolesche Flag done ab, um den Abschluss zu prüfen.
Leere Ergebnisse beim Abrufen verfügbarer Bindungen
Dieses Problem kann auftreten, wenn Sie verfügbare Bindungen für einen Auth-Anbieter abrufen: Die API gibt ein empty array oder einen Zugriffsfehler zurück, obwohl Sie geprüft haben, dass die Bindung vorhanden ist.
Prüfen Sie zur Behebung dieses Problems, ob das Prinzipal die richtigen IAM-Berechtigungen für die Zielressource AuthProvider hat. Die API führt strenge IAM-Prüfungen durch und entfernt Binding-Objekte, die auf Authentifizierungsanbieter verweisen, auf die der Aufrufer keinen Zugriff hat. Prüfen Sie, ob Ihr Prinzipal den erforderlichen Zugriff auf den Authentifizierungsanbieter und die Rolle roles/agentregistry.viewer für das Projekt hat.