Fehlerbehebung bei der Codeausführung

In diesem Dokument werden häufige Probleme und ihre Lösungen bei der Codeausführung in einer isolierten Sandbox-Umgebung beschrieben. Dazu gehören Hilfe bei Fehlern beim Erstellen von Sandboxes, Zeitüberschreitungen bei der Ausführung und Problemen mit der Datei-E/A.

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) (roles/aiplatform.user) „Agent Platform User“ zugewiesen ist.

  • Ungültige Projekt-ID oder ungültiger Standort: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 wurde nicht erstellt:Prüfen Sie vor dem Erstellen einer Sandbox, ob die Agent Platform-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 aus 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 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 denselben sandbox_name verwenden. Prüfen Sie außerdem, ob die Sandbox abgelaufen ist.

  • Zeitüberschreitung:Die Codeausführung wird nach 300 Sekunden abgebrochen. Optimieren Sie Ihren Code für die Leistung oder teilen Sie komplexe Aufgaben in kleinere, übersichtlichere Schritte auf.

Sandbox-Verwaltung und ‑Bereinigung

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

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

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