Creare o eliminare un esperimento

Puoi utilizzare l'SDK Vertex AI per Python o la console Google Cloud per per creare o eliminare un esperimento. L'SDK è una libreria di codice Python che che puoi utilizzare per creare e gestire gli esperimenti in modo programmatico. La console è un'interfaccia utente basata sul web che puoi utilizzare per creare e gestire gli esperimenti in modo visivo.

Crea un esperimento con un'istanza TensorBoard

SDK Vertex AI per Python

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

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 valore experiment_tensorboard, viene utilizzata un'istanza TB predefinita create e utilizzate da questo esperimento. Nota: se è necessario eseguire CMEK (chiavi di crittografia) associata all'istanza TensorBoard, quindi experiment_tensorboard non è più facoltativo.
  • project: il tuo ID progetto. Puoi trovare questi ID nella console Google Cloud pagina di benvenuto.
  • location: consulta l'elenco delle località disponibili Assicurati di utilizzare una regione che supporta TensorBoard se crei un'istanza di TensorBoard.

Console Google Cloud

Segui queste istruzioni per creare un esperimento.

  1. Nella console Google Cloud, vai alla pagina Esperimenti.
    Vai a Esperimenti
  2. Assicurati di essere nel progetto in cui vuoi creare l'esperimento.
    Progetto Vertex AI Select
  3. Fai clic su Crea per aprire il riquadro Esperimento. Viene visualizzato il riquadro Crea esperimento.
  4. Nel campo Nome esperimento, inserisci 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.

Crea un esperimento senza un'istanza TensorBoard predefinita

SDK Vertex AI per Python

Crea un esperimento. Aggiungi una descrizione per esperimento per documentarne lo scopo. Vedi init nella documentazione di riferimento dell'SDK Vertex AI.

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: il tuo ID progetto. Puoi trovare questi ID nella pagina di benvenuto della console Google Cloud.
  • location: consulta l'elenco delle località disponibili Assicurati di utilizzare una regione che supporta TensorBoard se crei un'istanza di TensorBoard.

Elimina esperimento

L'eliminazione di un esperimento elimina l'esperimento in questione e tutte le esecuzioni degli esperimenti associati all'esperimento. L'esperimento Vertex AI TensorBoard associato non viene eliminato. Per eliminare una TensorBoard dell'esperimento, consulta Elimina l'esperimento Vertex AI TensorBoard obsoleto.

Inoltre, eventuali esecuzioni, artefatti ed esecuzioni della pipeline associati esperimenti non vengono rimossi. Puoi trovarli nella console Google Cloud. Per gli artefatti e le esecuzioni, viene gestito un addebito mensile di 10 $per GB Vertex ML Metadata.

SDK Vertex AI per Python

L'esempio seguente utilizza il metodo delete 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: il tuo ID progetto. Puoi trovare questi ID nella pagina di benvenuto della console Google Cloud.
  • location: consulta l'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

Per eliminare un esperimento, segui le istruzioni riportate di seguito.

  1. Nella console Google Cloud, vai alla pagina Esperimenti.
    Vai agli esperimenti
  2. Seleziona la casella di controllo associata all'esperimento che vuoi eliminare. La casella di controllo Elimina viene visualizzata l'opzione corrispondente.
  3. Fai clic su Elimina.
    • In alternativa, puoi andare alla Opzioni di che si trova nella stessa riga dell'esperimento e seleziona Elimina.

Visualizza l'elenco degli esperimenti nella console Google Cloud

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

    Vai alla pagina Esperimenti

  2. Verifica di essere nel progetto corretto.

  3. Viene visualizzato un elenco di esperimenti per il tuo progetto in nella vista Monitoraggio esperimenti.
    Se hai associato un'istanza Vertex AI TensorBoard al tuo esperimento, nell'elenco viene visualizzato come "Esperimento di your-experiment su TensorBoard di supporto".

Elenco di esperimenti Vertex AI

Passaggi successivi

Esempio di notebook pertinente