Diese Seite ist der Ausgangspunkt für die Fehlerbehebung bei der Gemini Enterprise Agent Platform. Sie können damit Fehler diagnostizieren, nach bestimmten Fehlern suchen, Anleitungen für Ihre Aufgabe finden oder Support erhalten.
Fehler diagnostizieren
Bevor Sie nach einer bestimmten Lösung suchen, sollten Sie die folgenden Informationen zusammentragen:
Fehler lesen
Notieren Sie sich den Statuscode, z. B. 400 oder 429, und den genauen Nachrichtentext. Beide können Sie im Fehlerkatalog nachschlagen.
Sie können den spezifischen Fehler auch anhand eines maschinenlesbaren Grunds, eines Dokumentationslinks oder einer vorab gefilterten Protokollansicht ermitteln, sofern diese in der Fehlermeldung enthalten sind.
Logs suchen
Wenn Sie Agent-Fehlerlogs suchen und filtern möchten, verwenden Sie den Logs Explorer, legen Sie Ressourcentyp auf Vertex AI Reasoning Engine fest und wählen Sie den entsprechenden Wert für Ressourcencontainer (Ihre Projektnummer) und Reasoning Engine-ID aus.
Kontingente und Dienststatus prüfen
Fehler, die zeitweise auftreten oder ohne Änderungen auf Ihrer Seite begonnen haben, werden häufig durch das Kontingent oder einen laufenden Vorfall verursacht:
- Vergleichen Sie Ihre Nutzung mit den Kontingenten und Systemlimits.
- Prüfen Sie unter Google Cloud Service Health, ob in Ihrer Region ein aktueller Vorfall vorliegt.
Fehlerkatalog
Suchen Sie in der folgenden Tabelle nach der Fehlermeldung, die Sie erhalten haben. Wenn Ihr Fehler nicht aufgeführt ist, verwenden Sie die Anleitungen zur Fehlerbehebung für die Aufgabe, die Sie ausführen wollten.
| Statuscode oder ‑meldung | Lösung |
|---|---|
ImportError: cannot import name 'reasoning_engines',
ImportError: cannot import name 'agent_engines' |
Veraltete Version des Agent Platform SDK für Python |
401 Context-Aware Access requirements are not met,
401 Request had invalid authentication credentials |
401‑Autorisierungsfehler |
ValueError: Cannot get the Candidate text
|
Fehler bei der Inhaltserstellung |
failed to start and cannot serve traffic bei der ersten Bereitstellung eines benutzerdefinierten Containers (BYOC) in einer Region |
Fehler beim erstmaligen Erstellen von BYOC |
failed to start and cannot serve traffic oder Request is prohibited by organization's policy innerhalb eines VPC Service Controls-Perimeters |
VPC-SC-Verstoßfehler |
429, RESOURCE_EXHAUSTED
|
Fehler aufgrund von Ressourcenerschöpfung oder Ratenbeschränkung |
429, RESOURCE_EXHAUSTED, at capacity
|
Region vorübergehend ausgelastet |
429, RESOURCE_EXHAUSTED, max_instances
|
Maximale Anzahl von Instanzen überschreitet regionales Limit |
500 Interner Serverfehler bei einer vordefinierten Vorlage |
Fehler bei vordefinierten Vorlagen |
cloudpickle- oder pydantic-Versionskonflikte beim Serialisieren des Agents |
Serialisierungsfehler |
NotFound: 404 Can not copy from "gs://..."
|
Unterverzeichnis des Cloud Storage-Buckets wird nicht erstellt |
iam.serviceAccounts.actAs abgelehnt, Metadatenserver nicht verfügbar |
Benutzerdefinierte Dienstkonto-Fehler |
400, INVALID_ARGUMENT,
REASONING_ENGINE_SECRET_ACCESS_DENIED,
referenced by spec.deployment_spec.secret_env |
Secret Manager-Zugriffsfehler |
InvalidArgument: 400 Provided filter is not valid
|
Fehler beim Filtern der Liste der Kundenservicemitarbeiter |
google.api_core.exceptions.Unknown: None,
Failed to convert project number to project ID,
beim Start |
Fehler beim Starten der Agent Runtime |
403 Forbidden für eine ausgehende Anfrage |
Fehler „403 Forbidden“ |
| Fehler bei der Zertifikatsüberprüfung, wenn das Ziel ein selbstsigniertes Zertifikat oder eine private Zertifizierungsstelle ist | Verbindungen zu Zielen mit selbstsignierten Zertifikaten oder Zertifikaten privater Zertifizierungsstellen schlagen fehl |
| Fehler beim TLS-Handshake durch einen benutzerdefinierten Container-Agent (BYOC) | Verbindung zu Agent, der mit benutzerdefiniertem Container (BYOC) bereitgestellt wurde, kann nicht hergestellt werden |
| Fehler bei der Sandbox-Erstellung | Probleme bei der Sandbox-Erstellung |
| Zeitüberschreitung bei der Codeausführung, Fehler bei der Datei-E/A in einer Sandbox | Probleme bei der Codeausführung |
RuntimeError: Failed to generate memory oder nach einer Sitzung werden keine Erinnerungen zurückgegeben |
Es wurden keine Erinnerungen erstellt |
Anleitungen zur Fehlerbehebung
Wenn Sie keine bestimmte Fehlermeldung erhalten oder Ihr Fehler nicht im Fehlerkatalog enthalten ist, finden Sie in der folgenden Tabelle die entsprechende Anleitung für Ihre Aufgabe:
| Aufgabe | Leitfaden |
|---|---|
| Agent Platform SDK installieren und Umgebung einrichten | Agent Runtime-Umgebung einrichten |
| Agent erstellen | Agent erstellen |
| KI‑Agent in Agent Runtime bereitstellen | Agent-Bereitstellung |
| Externen Dienst über einen Agenten aufrufen | Agent Gateway-Verbindung |
| Bereitgestellten KI-Agent auflisten, aktualisieren oder löschen | Bereitgestellte Agents verwalten |
| Code in einer Sandbox ausführen | Codeausführung |
| Erstellen oder Abrufen von gemerkten Informationen | Memory Bank für die Agent Platform |
| Modell bereitstellen oder Modellkontingent erreichen | Fehlerbehebung bei Machine-Learning-Diensten |
Support anfordern
Wenn Sie Ihr Problem mit den Anleitungen auf dieser Seite nicht beheben können, finden Sie unter Support für Kundenservicemitarbeiter Informationen zu Supportpaketen, Communityforen und zum Melden von Fehlern. Bei Fragen zur Abrechnung lesen Sie den Abschnitt Fragen zur Abrechnung.
Wenn Sie einen Fehler melden, geben Sie die folgenden Informationen an:
- Statuscode
- Fehlermeldung
- (Optional) Feedback, wenn die Fehlermeldung falsch, irreführend oder nicht umsetzbar ist.