Notebook-Ausführungen mit Parametern

Mit von Vertex AI Workbench verwalteten Notebookinstanzen können Sie Parameterwerte in Ihren Notebookausführungen verwenden, um Unterschiede bei der Ausführung des Codes Ihrer Notebookdatei anzugeben. Auf dieser Seite wird beschrieben, wie Sie Ihre Notebookdatei für die Verwendung von Parametern einrichten und Ausführungen ausführen, in denen unterschiedliche Werte für Ihre Notebookparameter angegeben sind.

Parameter zum Ausführen verschiedener Iterationen Ihrer Notebook-Datei verwenden

Sie können in Ihren Ausführungen Notebook-Parameterwerte verwenden, um denselben Notebook-Code auszuführen. Gleichzeitig werden Unterschiede wie die folgenden angegeben:

  • Geben Sie ein anderes Dataset oder eine andere Stichprobengröße des Datasets an.

  • Geben Sie verschiedene Modellkonfigurationen an, z. B. Lernrate oder Optimierungstyp.

  • Führen Sie verschiedene Modelle oder verschiedene Versionen desselben Modells aus.

Parameter in einer Notebookausführung verwenden

Der Vorgang zum Ausführen eines Notebooks mit Parametern umfasst zwei Hauptschritte:

  1. Fügen Sie das parameters-Tag zu einer der Zellen der Notebookdatei hinzu. Dies ist zwar keine technische Anforderung, aber diese Zelle enthält in der Regel Code, der Ihren Parametervariablen Werte zuweist. Dies ist jedoch keine technische Anforderung. Wenn Sie in der Ausführung keine anderen Parameterwerte zuweisen, verwendet die Ausführung die Parameterwerte in Ihrer Notebookdatei als Standardwerte.

  2. Erstellen Sie eine Ausführung für Ihre Notebookdatei, die neue Werte für Ihre Parameter enthält. Verwenden Sie das folgende Muster, um Ihre Parameter und ihre Werte zu formatieren: parameter1=value1,parameter2=value2. Das Format erfordert Kommas zwischen Parameter-Wert-Paaren, keine Leerzeichen und Anführungszeichen. Wenn die Ausführung ausgeführt wird, fügt der Executor dem Notebook eine Zelle hinzu, die die Werte Ihrer Parameter direkt nach der mit parameters gekennzeichneten Zelle aktualisiert.

Hinweis

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks and Vertex AI APIs.

    Enable the APIs

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks and Vertex AI APIs.

    Enable the APIs

    8.
  8. Falls noch nicht geschehen, erstellen Sie eine verwaltete Notebookinstanz.

Erforderliche Rollen

Damit das Dienstkonto Ihrer Instanz die erforderlichen Berechtigungen für die Interaktion mit dem Vertex AI Workbench-Executor hat, bitten Sie Ihren Administrator, dem Dienstkonto Ihrer Instanz die folgenden IAM-Rollen für das Projekt zu erteilen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Ihr Administrator kann dem Dienstkonto Ihrer Instanz möglicherweise auch die erforderlichen Berechtigungen über benutzerdefinierte Rollen oder andere vordefinierte Rollen erteilen.

JupyterLab öffnen

Führen Sie die folgenden Schritte aus, um JupyterLab zu öffnen und eine Notebookdatei für die Ausführung vorzubereiten.

  1. Öffnen Sie JupyterLab.

  2. Laden Sie eine Notebook-Datei (ipynb) hoch, öffnen Sie eine vorhandene Datei oder öffnen Sie eine neue Notebookdatei und fügen Sie den Code hinzu, den Sie im neuen Notebook ausführen möchten.

  3. Achten Sie darauf, dass der Code Ihrer Notebook-Datei die Anforderungen für die Verwendung des Executors erfüllt.

Fügen Sie den Tag parameters zur Notebookzelle hinzu

  1. Öffnen Sie in der JupyterLab-Benutzeroberfläche Ihrer verwalteten Notebook-Instanz die Notebookdatei, die Sie ausführen möchten.

  2. Schreiben Sie Code in eine Zelle, der Ihren Parametervariablen Werte zuweist. Dies sind die Werte, die in der Notebookdatei verwendet werden, wenn Sie bei der Ausführung keine anderen Parameterwerte zuweisen.

  3. Achten Sie darauf, dass die Parameterzelle noch ausgewählt ist, und klicken Sie dann in der rechten Seitenleiste auf den  Attributprüfer.

  4. Im Property-Prüftool, im Abschnitt Zellen-Tags, klicken Sie auf Tag hinzufügen, geben Sie parameters ein und drücken Sie dann Enter.

Parameterwerte für die Ausführung angeben

  1. Klicken Sie in der JupyterLab-Benutzeroberfläche Ihrer verwalteten Notebook-Instanz auf die Schaltfläche  Executor.

  2. Geben Sie im Dialogfeld Notebooks an Executor senden im Feld Ausführungsname einen Namen für die Ausführung ein.

  3. Wählen Sie einen Maschinentyp und einen Beschleunigertyp aus.

  4. Wählen Sie eine Umgebung aus

  5. Wählen Sie im Feld Typ die Option Einmalige Ausführung oder Planbasierte wiederkehrende Ausführungen aus und schließen Sie die Dialogfeld zum Planen von Ausführungen.

  6. Wählen Sie unter Erweiterte Optionen die Region aus, in der Sie Ihr Notebook ausführen möchten.

  7. Wählen Sie im Feld Cloud Storage-Bucket einen verfügbaren Cloud Storage-Bucket aus oder geben Sie einen Namen für einen neuen Bucket ein. Klicken Sie dann auf Erstellen und auswählen. Der Executor speichert Ihre Notebookausgabe in diesem Cloud Storage-Bucket.

  8. Fügen Sie im Abschnitt Notebook-Parametrisierung und im Textfeld Eingabeparameter durch Kommas getrennte Notebookparameter hinzu. Beispiel: optimizer=SGD,learning_rate=0.01. Beim Format müssen keine Leerzeichen und keine Anführungszeichen enthalten sein.

  9. Konfigurieren Sie den Rest der Ausführung und klicken Sie auf Senden.

Notebook

Nächste Schritte