Fehlerbehebung bei der Codeausführung

In diesem Abschnitt werden häufige Probleme und deren Lösungen bei der Verwendung von Agent Engine Code Execution beschrieben.

Probleme beim Erstellen von Sandboxen

  • Berechtigungsfehler:Wenn beim Erstellen einer Sandbox Fehler auftreten, prüfen Sie, ob Ihrem Google Cloud Projekt die IAM-Rolle (Identity and Access Management) „Vertex AI-Nutzer“(roles/aiplatform.user) zugewiesen ist.

  • Ungültige Projekt-ID oder ungültiger Speicherort:Prüfen Sie, ob die in Ihrem Code verwendeten Variablen PROJECT_ID und LOCATION korrekt sind und unterstützt werden. Eine Liste der unterstützten Regionen finden Sie unter Unterstützte Regionen.

  • Agent Engine nicht erstellt:Prüfen Sie vor dem Erstellen einer Sandbox, ob die Agent Engine-Instanz erfolgreich erstellt wurde. Die agent_engine.create()-Methode muss ohne Fehler abgeschlossen werden.

Probleme bei der Codeausführung

  • Codefehler:Sehen Sie sich die stderr-Ausgabe der execute_code-Antwort an, um Syntaxfehler, Laufzeit-Exceptions oder logische Fehler in Ihrem Code zu finden.

  • Probleme mit Datei-E/A:

    • Datei nicht gefunden:Achten Sie darauf, dass alle in der files-Gruppe Ihres input_data angegebenen Eingabedateien in Ihrem Code richtig referenziert werden. Ihr Code wird im selben Ordner wie die Dateien ausgeführt und kann nicht auf andere Ordner zugreifen.

    • Ausgabedatei wurde nicht generiert:Prüfen Sie, ob Ihr Code in die erwartete Ausgabedatei schreibt und ob Fehler die Dateierstellung oder das Schreiben verhindern.

    • Größenbeschränkungen:Dateien dürfen maximal 100 MB groß sein.

  • Statuspersistenz:Wenn Ihr Code auf dem vorherigen Status basiert, prüfen Sie, ob Sie für nachfolgende Aufrufe dieselbe sandbox_name verwenden. Prüfen Sie außerdem, ob die Sandbox abgelaufen ist.

  • Zeitlimit:Die Codeausführung läuft nach 300 Sekunden ab. Erwägen Sie, Ihren Code für die Leistung zu optimieren oder komplexe Aufgaben in kleinere, übersichtlichere Schritte zu unterteilen.

Sandbox-Verwaltung und -Bereinigung

  • Sandbox nicht zum Löschen gefunden:Wenn Sie eine Sandbox nicht löschen können, prüfen Sie, ob die sandbox_name, die Sie verwenden, korrekt ist und ob die Sandbox noch vorhanden ist.

  • Agent Engine not found for deletion (Agent Engine zum Löschen nicht gefunden): Prüfen Sie wie bei Sandboxes die agent_engine_name, wenn Sie versuchen, die Agent Engine zu löschen.

  • Ressourcenkontingente:Wenn Sie viele Sandboxes erstellen oder häufig Ausführungen durchführen, stoßen Sie möglicherweise auf Ressourcenkontingentbeschränkungen. Prüfen Sie die Kontingente Ihres Projekts für Vertex AI-Dienste und fordern Sie bei Bedarf Erhöhungen an. Eine Liste der Agent Engine-Kontingente finden Sie unter Kontingente.