Esegui esecuzioni di blocchi note con parametri

Esegui esecuzioni di blocchi note con parametri

I blocchi note gestiti di Vertex AI Workbench ritirato. Il 30 gennaio 2025, i blocchi note gestiti non saranno più disponibili e non sarà più possibile creare istanze di blocchi note gestiti verrà rimosso. Le istanze esistenti continueranno a funzionare ma non saranno disponibili patch, aggiornamenti e upgrade. Per continuare a utilizzare Vertex AI Workbench, ti consigliamo migrazione dalle istanze di blocchi note gestiti alle istanze di Vertex AI Workbench.

Istanze di blocchi note gestiti da Vertex AI Workbench consente di utilizzare i valori parametro nelle esecuzioni del blocco note per specificare le differenze di esecuzione del codice del file blocco note. In questa pagina viene descritto come configurare il file 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 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 di modelli, come il tasso di apprendimento 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 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. Anche se non è un requisito tecnico, questa cella di solito contiene codice che assegna valori al parametro variabili, sebbene non si tratti di un requisito tecnico. Se non assegni valori di parametri diversi durante l'esecuzione, l'esecuzione utilizza i valori parametro nel file blocco note come valori predefiniti.

2. Crea un'esecuzione per il file del blocco note che includa nuovi valori per i parametri. Utilizza la per formattare i parametri e i relativi valori: parameter1=value1,parameter2=value2. Il formato richiede virgole tra coppie parametro-valore, senza spazi né virgolette. Quando l'esecuzione è in esecuzione, l'esecutore aggiunge al blocco note una cella che aggiorna dei parametri che seguono la cella con 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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. Se non l'hai già fatto, creazione di un'istanza di blocchi note gestiti.

Ruoli obbligatori

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

• Visualizzatore blocchi note (roles/notebooks.viewer)
• Utente Vertex AI (roles/aiplatform.user)
• Amministratore Storage (roles/storage.admin)

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 fornire l'account di servizio dell'istanza le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Apri JupyterLab

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

1. Apri JupyterLab.

2. Caricare un file blocco note (ipynb), aprire un file esistente, oppure apri un nuovo blocco note file e aggiungi il codice che vuoi eseguire al nuovo blocco note.

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

Aggiungi il tag parameters a una cella del blocco note

1. Nell'istanza di blocco note gestito nell'interfaccia utente di JupyterLab, apri il file del blocco note che vuoi eseguire.

2. Scrivi il codice in una cella che assegni valori a le variabili parametro. Questi sono i valori utilizzati dal file blocco note se non assegni valori parametro diversi durante l'esecuzione.

3. Assicurati che la cella dei parametri sia ancora selezionata, quindi Nella barra laterale di destra, fai clic  Controllo proprietà.

4. Nella finestra di controllo delle proprietà, nella sezione Tag cella, Fai clic su Aggiungi tag, inserisci parameters e premi Enter.

   Nota: se tagghi più di una cella con parameters, l'esecutore aggiunge solo una cella di parametri che segue direttamente la prima con il tag parameters.

Fornisci i valori dei parametri per l'esecuzione

1. Nell'istanza di blocco note gestito nell'interfaccia utente JupyterLab, fai clic  Esecutore.

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 Type (Tipo), Seleziona Esecuzione una tantum oppure seleziona Esecuzioni ricorrenti basate su pianificazione e completa la finestra di dialogo per programmare le 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 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 del blocco note e la casella di testo Parametri di input, aggiungi parametri del blocco note separati da virgole, ad esempio optimizer=SGD,learning_rate=0.01. Il formato richiede che non siano presenti spazi né virgolette.

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

Blocco note

Per vedere un esempio di come utilizzare i parametri nell'esecuzione di un blocco note come parte di un flusso di lavoro più completo, Eseguire il modello "Addestra un modello di classificazione multiclasse per il targeting degli annunci" Blocco note Jupyter in uno dei seguenti ambienti:

Aperto in Colab | Aperto in Colab Enterprise | Aperto nei blocchi note gestiti dall'utente di Vertex AI Workbench | Visualizza su GitHub

Passaggi successivi

• Scopri di più su come eseguire il codice del blocco note in dall'esecutore.