Creare o eliminare un esperimento

Puoi utilizzare l'SDK Vertex AI Python o la Google Cloud console per creare o eliminare un esperimento. L'SDK è una libreria di codice Python che puoi utilizzare per creare e gestire esperimenti a livello di programmazione. La console è una GUI basata sul web che puoi utilizzare per creare e gestire gli esperimenti visivamente.

Quando crei un esperimento utilizzando Google Cloud la console per la prima volta, assicurati che esista un archivio dei metadati default. Per verificare, vai alla pagina Metadati del progetto nella Google Cloud console. Consulta Configurare l'archivio dei metadati del progetto

Creare un esperimento con un'istanza TensorBoard

SDK Vertex AI Python

Crea un esperimento e, facoltativamente, associa un'istanza Vertex AI TensorBoard utilizzando l'SDK Vertex AI Python. Aggiungi una descrizione dell' esperimento per documentarne lo scopo. Consulta init nella documentazione di riferimento dell'SDK della piattaforma dell'agente.

Python

from typing import Optional, Union

from google.cloud import aiplatform


def create_experiment_sample(
    experiment_name: str,
    experiment_description: str,
    experiment_tensorboard: Optional[Union[str, aiplatform.Tensorboard]],
    project: str,
    location: str,
):
    aiplatform.init(
        experiment=experiment_name,
        experiment_description=experiment_description,
        experiment_tensorboard=experiment_tensorboard,
        project=project,
        location=location,
    )

• experiment_name: fornisci un nome per l'esperimento.
• experiment_description: fornisci una descrizione per l'esperimento.
• experiment_tensorboard: facoltativo. L'istanza Vertex TensorBoard da utilizzare come TensorBoard di supporto per l'esperimento fornito. Se non viene fornito alcun experiment_tensorboard, viene creata e utilizzata da questo esperimento un'istanza TB predefinita. Nota: se le chiavi di crittografia CMEK devono essere associate all'istanza TensorBoard, experiment_tensorboard non è più facoltativo.
• project: . Puoi trovare questi ID nella Google Cloud console pagina di benvenuto.
  
• location: consulta Elenco delle località disponibili Assicurati di utilizzare una regione che supporti TensorBoard se crei un'istanza TensorBoard.

Google Cloud Console

Segui queste istruzioni per creare un esperimento.

1. Nella Google Cloud console, vai alla pagina Esperimenti.
   Vai agli Esperimenti
2. Assicurati di essere nel progetto in cui vuoi creare l'esperimento.
   
3. Fai clic su Crea per aprire il riquadro Esperimento. Viene visualizzato il riquadro Crea esperimento.
4. Nel campo Nome esperimento, fornisci un nome per identificare in modo univoco l'esperimento.
5. Facoltativo. Nel campo Istanza TensorBoard, seleziona un'istanza dal menu a discesa o fornisci un nome per la nuova istanza TensorBoard.
6. Fai clic su Crea per creare l'esperimento.

Creare un esperimento senza un'istanza TensorBoard predefinita

SDK Vertex AI Python

Crea un esperimento. Aggiungi una descrizione dell' esperimento per documentarne lo scopo. Consulta init nella documentazione di riferimento dell'SDK della piattaforma dell'agente.

Python

from google.cloud import aiplatform


def create_experiment_without_default_tensorboard_sample(
    experiment_name: str,
    experiment_description: str,
    project: str,
    location: str,
):
    aiplatform.init(
        experiment=experiment_name,
        experiment_description=experiment_description,
        experiment_tensorboard=False,
        project=project,
        location=location,
    )

• experiment_name: fornisci un nome per l'esperimento.
• experiment_description: fornisci una descrizione per l'esperimento.
• project: . Puoi trovare questi ID nella Google Cloud console pagina di benvenuto.
  
• location: consulta Elenco delle località disponibili Assicurati di utilizzare una regione che supporti TensorBoard se crei un'istanza TensorBoard.

Eliminare un esperimento

L'eliminazione di un esperimento comporta l'eliminazione dell'esperimento e di tutte le esecuzioni dell'esperimento associate. L'esperimento Vertex AI TensorBoard associato all'esperimento non viene eliminato. Per eliminare un esperimento TensorBoard, consulta Eliminare un esperimento Vertex AI TensorBoard obsoleto.

Inoltre, le esecuzioni della pipeline, gli artefatti e le esecuzioni associati all'esperimento eliminato non vengono rimossi. Questi sono disponibili nella Google Cloud console. Per gli artefatti e le esecuzioni, il servizio Vertex ML Metadata gestisce un addebito mensile di 10 $/GB.

SDK Vertex AI Python

L'esempio seguente utilizza il delete metodo di ExperimentClass.

Python

from google.cloud import aiplatform


def delete_experiment_sample(
    experiment_name: str,
    project: str,
    location: str,
    delete_backing_tensorboard_runs: bool = False,
):
    experiment = aiplatform.Experiment(
        experiment_name=experiment_name, project=project, location=location
    )

    experiment.delete(delete_backing_tensorboard_runs=delete_backing_tensorboard_runs)

• experiment_name: fornisci un nome per l'esperimento.
• project: . Puoi trovare questi ID nella Google Cloud console pagina di benvenuto.
• location: consulta Elenco delle località disponibili
• delete_backing_tensorboard_runs: se è True, verranno eliminate anche le esecuzioni di Vertex AI TensorBoard associate alle esecuzioni dell'esperimento in questo esperimento che abbiamo utilizzato per archiviare le metriche delle serie temporali.

Console

Segui queste istruzioni per eliminare un esperimento.

1. Nella Google Cloud console, vai alla pagina Esperimenti.
   Vai agli Esperimenti
2. Seleziona la casella di controllo associata all'esperimento che vuoi eliminare. Viene visualizzata l'opzione Elimina.
3. Fai clic su Elimina.
   • In alternativa, puoi andare al  menu delle opzioni nella stessa riga dell'esperimento e selezionare Elimina.

Visualizzare l'elenco degli esperimenti nella Google Cloud console

1. Nella Google Cloud console, nella sezione Vertex AI, vai alla pagina Esperimenti.

   Vai alla pagina Esperimenti

2. Verifica di essere nel progetto corretto.

3. Nell'visualizzazione Monitoraggio esperimenti viene visualizzato un elenco degli esperimenti per il tuo progetto.
   Se hai associato un'istanza Vertex AI TensorBoard all'esperimento, questa viene visualizzata nell'elenco come "your-experiment Backing TensorBoard Experiment".

Passaggi successivi

• Creare e gestire le esecuzioni dell'esperimento
• Eliminare un esperimento Vertex AI TensorBoard obsoleto

Esempio di notebook pertinente

• Addestramento del modello con codice di pre-elaborazione dei dati predefinito