Diese Seite ist der Ausgangspunkt für die Fehlerbehebung bei der Gemini Enterprise Agent Platform. Hier können Sie einen Fehler diagnostizieren, nach einem bestimmten Fehler suchen, die Anleitung für Ihre Aufgabe aufrufen 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 Text der Meldung. Beide finden Sie im Fehlerkatalog.
Sie können den spezifischen Fehler auch anhand eines maschinenlesbaren Grunds, eines Dokumentationslinks oder einer vorgefilterten Logansicht identifizieren, wenn diese in der Fehlermeldung vorhanden sind.
Logs suchen
Wenn Sie nach Fehlerlogs von Agents suchen und diese 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 nur zeitweise auftreten oder ohne Änderungen Ihrerseits begonnen haben, werden häufig durch Kontingente oder einen laufenden Vorfall verursacht:
- Vergleichen Sie Ihre Nutzung mit den Kontingenten und System limits.
- Prüfen Sie Google Cloud Service Health auf einen laufenden Vorfall in Ihrer Region.
Fehlerkatalog
Suchen Sie in der folgenden Tabelle nach dem Fehler, den 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 trafficbei der ersten Bereitstellung eines benutzerdefinierten Containers (BYOC) in einer Region |
Fehler bei der erstmaligen Erstellung 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-Verletzungsfehler |
429, RESOURCE_EXHAUSTED
|
Fehler aufgrund von Ressourcenerschöpfung oder Ratenlimits |
500 interner Serverfehler bei einer vordefinierten Vorlage |
Fehler bei vordefinierten Vorlagen |
cloudpickle - oder pydantic-Versionskonflikte bei der Serialisierung Ihres 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 |
Fehler bei benutzerdefinierten Dienstkonten |
InvalidArgument: 400 Provided filter is not valid
|
Fehler beim Filtern der Liste der Agents |
google.api_core.exceptions.Unknown: None, Failed to convert project number to project ID beim Start |
Fehler beim Start der Agent Runtime |
403 Forbidden bei einer ausgehenden Anfrage |
Fehler „403 Forbidden“ |
| Fehler bei der Zertifikatsprüfung beim Erreichen eines selbstsignierten oder privaten CA-Ziels | Verbindung zu selbstsignierten oder privaten CA-Zielen kann nicht hergestellt werden |
| Fehler beim TLS-Handshake bei einem Agent mit benutzerdefiniertem Container (BYOC) | Verbindung zu einem Agent, der mit einem benutzerdefinierten 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 memoryoder nach einer Sitzung werden keine Erinnerungen zurückgegeben |
Es wurden keine Erinnerungen erstellt |
Anleitungen zur Fehlerbehebung
Wenn Sie keine bestimmte Fehlermeldung erhalten haben oder Ihr Fehler nicht im Fehler katalog enthalten ist, finden Sie in der folgenden Tabelle die entsprechende Anleitung für Ihre Aufgabe:
| Aufgabe | Anleitung |
|---|---|
| Agent Platform SDK installieren und Umgebung einrichten | Agent Runtime-Umgebung einrichten |
| Agent erstellen | Agent erstellen |
| Agent in der Agent Runtime bereitstellen | Agent bereitstellen |
| Externen Dienst von einem Agent aufrufen | Agent Gateway-Verbindung |
| Bereitgestellten Agent auflisten, aktualisieren oder löschen | Bereitgestellte Agents verwalten |
| Code in einer Sandbox ausführen | Codeausführung |
| Erinnerungen erstellen oder abrufen | Memory Bank der Agent Platform |
| Modell bereitstellen oder ein 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 Hilfe für Agents Supportpakete, Community Foren und Informationen zum Melden von Fehlern. Bei Fragen zur Abrechnung finden Sie weitere Informationen unter Abrechnungs fragen.
Wenn Sie einen Fehler melden, geben Sie die folgenden Informationen an:
- Status code
- Fehlermeldung
- (Optional) Feedback, wenn die Fehlermeldung falsch, irreführend oder nicht umsetzbar ist.