Eseguire esecuzioni del blocco note con parametri

Le istanze di Notebook gestiti da Vertex AI Workbench ti consentono di utilizzare i valori dei parametri nelle esecuzioni dei notebook per specificare le differenze nell'esecuzione del codice del file del notebook. Questa pagina descrive come configurare il file del blocco note in modo da utilizzare i parametri e come eseguire esecuzioni che specificano valori diversi per i parametri del blocco note.

Utilizzare i parametri per eseguire diverse iterazioni del file del notebook

Puoi utilizzare i valori dei parametri del notebook nelle esecuzioni per eseguire lo stesso codice del notebook specificando differenze come le seguenti:

  • Specifica un set di dati diverso da utilizzare o un altro dimensione del campione del set di dati.

  • Specifica configurazioni del modello diverse, ad esempio il tasso di apprendimento o il tipo di ottimizzatore.

  • Esegui modelli diversi o versioni diverse dello stesso modello.

Come utilizzare i parametri nell'esecuzione di un blocco note

La procedura per eseguire un notebook con parametri prevede due passaggi principali:

  1. Aggiungi il tag parameters a una delle celle del file del tuo notebook. Anche se non è un requisito tecnico, questa cella solitamente contiene codice che assegna valori alle variabili parametro, anche se non è un requisito tecnico. Se non assegni valori parametro diversi durante l'esecuzione, l'esecuzione utilizza i valori parametro nel file del notebook come valori predefiniti.

  2. Crea un'esecuzione per il file del notebook che includa nuovi valori per i parametri. Utilizza il seguente pattern per formattare i parametri e i relativi valori: parameter1=value1,parameter2=value2. Il formato richiede virgole tra le coppie di parametro e valore, senza spazi e senza virgolette. Quando viene eseguita l'esecuzione, l'eseguitore aggiunge una cella al notebook che aggiorna i valori dei parametri direttamente dopo la cella con il tag parameters.

Prima di iniziare

  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. Se non l'hai ancora fatto, crea un'istanza di notebook gestiti.

Ruoli obbligatori

Per assicurarti che l'account di servizio della tua istanza disponga delle autorizzazioni necessarie per interagire con l'executor di Vertex AI Workbench, chiedi all'amministratore di concedere all'account di servizio della tua istanza i seguenti ruoli IAM nel progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

L'amministratore potrebbe anche essere in grado di assegnare all'account di servizio della tua istanza le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

Apri JupyterLab

Per aprire JupyterLab e preparare un file del notebook da eseguire, completa i seguenti passaggi.

  1. Apri JupyterLab.

  2. Carica un file del notebook (ipynb), apri un file esistente o apri un nuovo file del notebook e aggiungi il codice che vuoi eseguire al nuovo notebook.

  3. Assicurati che il codice del file del notebook soddisfi i requisiti per l'utilizzo dell'executor.

Aggiungere il tag parameters a una cella del blocco note

  1. Nell'interfaccia utente di JupyterLab dell'istanza di blocchi note gestita, apri il file del blocco note che vuoi eseguire.

  2. Scrivi codice in una cella che assegni valori alle variabili parametro. Questi sono i valori utilizzati dal file del notebook se non assegni valori di parametro diversi durante l'esecuzione.

  3. Assicurati che la cella dei parametri sia ancora selezionata e poi, nella barra laterale destra, fai clic su  Strumento di ispezione proprietà.

  4. Nell'inspector della proprietà, nella sezione Tag cella, fai clic su Aggiungi tag, inserisci parameters e premi Enter.

Fornisci i valori dei parametri per l'esecuzione

  1. Nell'interfaccia utente di JupyterLab dell'istanza di blocchi note gestiti, fai clic sul pulsante  Executor.

  2. Nella finestra di dialogo Invia notebook all'eseguitore, inserisci un nome per l'esecuzione nel campo Nome esecuzione.

  3. Seleziona un Tipo di macchina e un Tipo di acceleratore.

  4. Seleziona un ambiente.

  5. Nel campo Tipo, seleziona Esecuzione una tantum o Esecuzioni ricorrenti basate su pianificazione e completa la finestra di dialogo per la pianificazione delle esecuzioni.

  6. In Opzioni avanzate, seleziona la regione in cui vuoi eseguire il blocco note.

  7. Nel campo Bucket Cloud Storage, seleziona un bucket Cloud Storage disponibile o inserisci un nome per un nuovo bucket e fai clic su Crea e seleziona. L'executor archivia l'output del blocco note in questo bucket Cloud Storage.

  8. Nella sezione Parametrizazione del notebook e nella casella di testo Parametri di input, aggiungi i parametri del notebook separati da virgole, ad esempiooptimizer=SGD,learning_rate=0.01. Il formato richiede che non siano presenti spazi e virgolette.

  9. Configura il resto dell'esecuzione e poi fai clic su Invia.

Notebook

Passaggi successivi