Eseguire le esecuzioni dei notebook con parametri

Le istanze di Notebooks gestite da Vertex AI Workbench ti consentono di utilizzare i valori dei parametri nelle esecuzioni dei notebook per specificare le differenze nel modo in cui viene eseguito il codice del file del notebook. Questa pagina descrive come configurare il file del blocco note per utilizzare i parametri e come eseguire le esecuzioni che specificano valori diversi per i parametri del blocco note.

Utilizza i parametri per eseguire diverse iterazioni del file del blocco note

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

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

  • Specifica diverse configurazioni del modello, come 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 blocco note con parametri prevede due passaggi principali:

  1. Aggiungi il tag parameters a una delle celle del file del notebook. Sebbene non sia un requisito tecnico, questa cella in genere contiene codice che assegna valori alle variabili dei parametri, anche se non è un requisito tecnico. Se non assegni valori dei parametri diversi nell'esecuzione, l'esecuzione utilizza i valori dei parametri nel file del blocco note 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 parametro-valore, senza spazi e senza virgolette. Quando viene eseguita l'esecuzione, l'executor aggiunge una cella al blocco note che aggiorna i valori dei parametri direttamente dopo la cella taggata 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. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks and Vertex AI APIs.

    Enable the APIs

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

    Go to project selector

  6. Verify 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 blocchi note gestiti.

    9. Ruoli obbligatori

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

    Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

    L'amministratore potrebbe anche essere in grado di concedere al 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 notebook da eseguire, completa i seguenti passaggi.

    1. Apri JupyterLab.

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

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

    Aggiungere il tag parameters a una cella del notebook

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

    2. Scrivi il codice in una cella che assegna valori alle variabili dei parametri. Questi sono i valori utilizzati dal file del blocco note se non assegni valori dei parametri diversi durante l'esecuzione.

    3. Assicurati che la cella dei parametri sia ancora selezionata, poi nella barra laterale destra, fai clic su  Ispettore delle proprietà.

    4. Nell'inspector delle proprietà, nella sezione Tag cella, fai clic su Aggiungi tag, inserisci parameters e poi 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 a Executor, 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 oppure Esecuzioni ricorrenti basate sulla pianificazione e completa la finestra di dialogo per la pianificazione delle esecuzioni.

    6. In Opzioni avanzate, seleziona la Regione in cui vuoi eseguire il notebook.

    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 notebook in questo bucket Cloud Storage.

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

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

    Passaggi successivi