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. Es enthält Hilfe bei Fehlern bei der Sandbox-Erstellung, Ausführungstimeouts und Problemen mit der Datei-E/A.

Probleme bei der Sandbox-Erstellung

  • 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 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 Platform-Instanz erfolgreich erstellt wurde. Die Methode agent_engine.create() muss ohne Fehler abgeschlossen werden.

Probleme bei der Codeausführung

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

  • Probleme mit der Datei-E/A :

    • Datei nicht gefunden:Achten Sie darauf, dass alle in der files-Array Ihrer input_data angegebenen Eingabedateien 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 die erwartete Ausgabedatei schreibt und ob keine Fehler die Erstellung oder das Schreiben von Dateien verhindern.

    • Größenbeschränkungen:Die maximale Dateigröße beträgt 100 MB.

  • Statuspersistenz:Wenn Ihr Code vom vorherigen Status abhängt, prüfen Sie, ob Sie für nachfolgende Aufrufe denselben sandbox_name verwenden. Achten Sie außerdem darauf, dass die Sandbox nicht abgelaufen ist.

  • Timeout:Die Codeausführung wird nach 300 Sekunden beendet. Sie können Ihren Code für eine bessere Leistung optimieren oder komplexe Aufgaben in kleinere, übersichtlichere Schritte unterteilen.

Sandbox-Verwaltung und -Bereinigung

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

  • Agent Engine zum Löschen nicht gefunden:Prüfen Sie wie bei Sandboxes den 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 auf Ressourcenkontingentbeschränkungen 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 Kontingente für die Agent Engine finden Sie unter Kontingente.