Esecuzione di esecuzioni di blocchi note con parametri

Le istanze Notebooks gestite di Vertex AI Workbench consentono di utilizzare i valori dei parametri nelle esecuzioni dei blocchi note per specificare le differenze nell'esecuzione del codice del file blocco note. Questa pagina descrive come configurare il file del blocco note per l'utilizzo dei parametri e come eseguire esecuzioni che specificano valori diversi per i parametri del blocco note.

Utilizza i parametri per eseguire iterazioni diverse 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 al contempo differenze come le seguenti:

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

  • Specificare diverse configurazioni del modello, come tasso di apprendimento o tipo di ottimizzazione.

  • Esegui modelli diversi o versioni diverse dello stesso modello.

Come utilizzare i parametri nell'esecuzione di un blocco note

Il processo per l'esecuzione di un blocco note con parametri prevede due passaggi principali:

  1. Aggiungi il tag parameters a una delle celle del file del blocco note. Sebbene questo non sia un requisito tecnico, questa cella di solito contiene codice che assegna valori alle variabili dei parametri, anche se non si tratta di un requisito tecnico. Se non assegni valori dei parametri diversi durante l'esecuzione, l'esecuzione utilizza i valori dei parametri nel file del blocco note come valori predefiniti.

  2. Crea un'esecuzione per il file blocco note 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 coppie parametro-valore, senza spazi e senza virgolette. Quando viene eseguita l'esecuzione, l'esecutore aggiunge una cella al blocco note che aggiorna i valori dei parametri direttamente dopo la cella con il tag parameters.

Prima di iniziare

  1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  4. Abilita le API Notebooks and Vertex AI.

    Abilita le API

    5.

  5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  7. Abilita le API Notebooks and Vertex AI.

    Abilita le API

    8.
  8. Se non l'hai ancora fatto, crea un'istanza di blocchi note gestiti.

Ruoli obbligatori

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

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

L'amministratore potrebbe anche essere in grado di concedere all'account di servizio dell'istanza le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Apri JupyterLab

Per aprire JupyterLab e preparare un file di blocco note da eseguire, completa i seguenti passaggi.

  1. Apri JupyterLab.

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

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

Aggiungi il tag parameters a una cella del blocco note

  1. Nell'interfaccia utente JupyterLab dell'istanza di blocchi note gestiti, 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 blocco note se non assegni valori parametro diversi nell'esecuzione.

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

  4. Nella sezione Tag celle della finestra di controllo delle proprietà, fai clic su Aggiungi tag, inserisci parameters e premi Enter.

Fornisci i valori dei parametri per l'esecuzione

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

  2. Nella finestra di dialogo Invia blocchi note a esecutore, 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 seleziona 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'esecutore archivia l'output del blocco note in questo bucket Cloud Storage.

  8. Nella sezione Parametrizzazione blocco note e nella casella di testo Parametri di input, aggiungi i parametri del blocco note separati da virgole, ad esempio optimizer=SGD,learning_rate=0.01. Il formato richiede l'assenza di spazi e virgolette.

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

Blocco note

Passaggi successivi