Fehlerbehebung bei der Codeausführung

In diesem Dokument werden häufige Probleme und ihre Lösungen bei der Arbeit mit der Codeausführung in einer isolierten Sandbox-Umgebung beschrieben. Es enthält Hilfe zu Fehlern bei der Sandbox-Erstellung, Zeitüberschreitungen bei der Ausführung und Datei-E/A-Problemen.

Probleme beim Erstellen einer Sandbox

  • Berechtigungsfehler: Wenn beim Erstellen einer Sandbox Fehler auftreten, prüfen Sie, ob Ihr Google Cloud -Projekt die IAM-Rolle (Identity and Access Management) „Agent Platform User“ (roles/aiplatform.user) hat.

  • Ungültige Projekt-ID oder ungültiger Standort: Prüfen Sie, ob die in Ihrem Code verwendeten Variablen PROJECT_ID und LOCATION korrekt und unterstützt sind. 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 Platform-Instanz erfolgreich erstellt wurde. Die Methode agent_engine.create() muss ohne Fehler abgeschlossen werden.

Probleme bei der Code-Ausführung

  • Codefehler: Prüfen Sie die stderr-Ausgabe der execute_code-Antwort, um Syntaxfehler, Laufzeitausnahmen oder logische Fehler in Ihrem Code zu identifizieren.

  • Probleme mit Datei-E/A:

    • Datei nicht gefunden: Achten Sie darauf, dass alle Eingabedateien, die im Array files Ihrer input_data angegeben sind, in Ihrem Code korrekt 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 den erwarteten Dateinamen schreibt und ob keine Fehler die Erstellung oder das Schreiben der Datei verhindern.

    • Größenbeschränkungen: Für Dateien gilt eine Größenbeschränkung von 100 MB.

  • Zustandspersistenz: Wenn Ihr Code auf einem vorherigen Zustand basiert, prüfen Sie, ob Sie für nachfolgende Aufrufe dieselbe sandbox_name verwenden. Achten Sie außerdem darauf, dass die Sandbox nicht abgelaufen ist.

  • Zeitlimit: Die Code-Ausführung wird nach 300 Sekunden abgebrochen. Erwägen Sie, Ihren Code im Hinblick auf die Leistung zu optimieren oder komplexe Aufgaben in kleinere, überschaubarere Schritte aufzuteilen.

Sandbox-Verwaltung und -Bereinigung

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

  • Agent Engine wurde 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, können Sie an die Grenzen der Ressourcenkontingente stoßen. 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.