Fehlerbehebung bei der Gemini Enterprise Agent Platform

Diese Seite ist der Ausgangspunkt für die Fehlerbehebung bei der Gemini Enterprise Agent Platform. Sie können damit Fehler diagnostizieren, bestimmte Fehler nachschlagen, die Anleitung für Ihre Aufgabe finden oder Support erhalten.

Fehler diagnostizieren

Bevor Sie nach einer bestimmten Lösung suchen, sollten Sie die folgenden Informationen einholen:

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 Grundes, eines Dokumentlinks oder einer vorgefilterten Protokollansicht identifizieren, sofern diese in der Fehlermeldung vorhanden sind.

Logs suchen

Wenn Sie Agent-Fehlerlogs suchen und filtern möchten, verwenden Sie den Log-Explorer, setzen Sie Ressourcentyp auf Vertex AI Reasoning Engine und wählen Sie den entsprechenden Wert für Ressourcencontainer (Ihre Projektnummer) und Reasoning Engine-ID aus.

Kontingente und Service Health prüfen

Fehler, die zeitweise auftreten oder ohne eine Änderung auf Ihrer Seite begonnen haben, werden häufig durch Kontingente oder einen laufenden Vorfall verursacht:

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 Inhaltsgenerierung
failed to start and cannot serve traffic, bei Ihrer 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 „Ressource erschöpft“ oder „Ratenbegrenzung“
429, RESOURCE_EXHAUSTED, at capacity Region vorübergehend ausgelastet
429, RESOURCE_EXHAUSTED, max_instances Maximale Anzahl von Instanzen überschreitet das regionale Limit
500 interner Serverfehler bei einer vordefinierten Vorlage Fehler bei vordefinierten Vorlagen
cloudpickle- oder pydantic-Versionskonflikte beim Serialisieren des KI-Agenten 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
400, INVALID_ARGUMENT, REASONING_ENGINE_SECRET_ACCESS_DENIED, referenced by spec.deployment_spec.secret_env Secret Manager-Zugriffsfehler
504, DEADLINE_EXCEEDED, REASONING_ENGINE_BUILD_TIMEOUT Zeitüberschreitung beim Erstellen des Container-Image
504, DEADLINE_EXCEEDED, REASONING_ENGINE_CONTAINER_START_TIMEOUT Container wurde nicht rechtzeitig gestartet
InvalidArgument: 400 Provided filter is not valid Fehler beim Filtern der Liste der Agenten
google.api_core.exceptions.Unknown: None, Failed to convert project number to project ID, beim Start Fehler beim Start der Agent Runtime
403 Forbidden für eine ausgehende Anfrage Fehler „403 Forbidden“
Fehler bei der Zertifikatsüberprüfung, die ein selbst signiertes oder privates CA-Ziel erreichen Verbindung zu Zielen mit selbst signierten oder privaten Zertifizierungsstellen schlägt fehl
TLS-Handshake-Fehler von einem benutzerdefinierten Container-Agent (BYOC) Mit benutzerdefiniertem Container (BYOC) bereitgestellter Agent kann keine Verbindung herstellen
Fehler bei der Sandbox-Erstellung Probleme bei der Sandbox-Erstellung
Zeitüberschreitung bei der Codeausführung, Datei-E/A-Fehler in einer Sandbox Probleme bei der Code-Ausführung
RuntimeError: Failed to generate memory oder keine gemerkten Informationen nach einer Sitzung zurückgegeben wurden Es wurden keine Erinnerungen generiert

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-Agenten in Agent Runtime bereitstellen Agentenbereitstellung
Externen Dienst von einem Agenten aus aufrufen Agent Gateway-Konnektivität
Bereitgestellten KI-Agenten auflisten, aktualisieren oder löschen Bereitgestellte KI-Agenten verwalten
Code in einer Sandbox ausführen Code-Ausführung
Gemerkte Informationen generieren oder abrufen Agent Platform Memory Bank
Modell bereitstellen oder Modellkontingent erreichen Fehlerbehebung bei Diensten für maschinelles Lernen

Support anfordern

Wenn die Anleitungen auf dieser Seite Ihr Problem nicht lösen, finden Sie unter Hilfe für Agenten Informationen zu Supportpaketen, Community-Foren und Fehlerberichten. Antworten auf Fragen zur Abrechnung finden Sie unter 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.