Creare o eliminare un esperimento

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

Crea un esperimento con un'istanza TensorBoard

SDK Vertex AI per Python

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

Python

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: assegna un nome all'esperimento.
  • experiment_description: fornisci una descrizione dell'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, questo esperimento crea e utilizza un'istanza TB predefinita. Nota: se è necessario associare una CMEK (chiavi di crittografia) all'istanza TensorBoard, experiment_tensorboard non è più facoltativo.
  • project: il tuo ID progetto. Puoi trovare questi ID nella pagina di benvenuto della console Google Cloud.
  • location: consulta l'elenco delle località disponibili Se crei un'istanza TensorBoard, assicurati di utilizzare una regione che supporta TensorBoard.

Console Google Cloud

Utilizza queste istruzioni per creare un esperimento.

  1. Nella console Google Cloud, vai alla pagina Esperimenti.
    <a{: class="button button-primary" l10n-attrs-original-order="href,target,class,track-name,track-type" l10n-encrypted-href="V3Ae1hvcBOij4KvUNiRrMltigmNHgUGOXn/QVSGplOhBlpxunv8WHL3F/z3" astrai
  2. Assicurati di essere all'interno del 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, indica un nome che consenta di 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 dell'esperimento per documentarne lo scopo. Consulta init nella documentazione di riferimento dell'SDK Vertex AI.

Python

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: assegna un nome all'esperimento.
  • experiment_description: fornisci una descrizione dell'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 Se crei un'istanza TensorBoard, assicurati di utilizzare una regione che supporta TensorBoard.

Elimina esperimento

L'eliminazione di un esperimento comporta l'eliminazione dell'esperimento e di tutte le esecuzioni 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, tutte le esecuzioni, gli artefatti e le esecuzioni della pipeline associati all'esperimento eliminato non vengono rimossi. Puoi trovarli nella console Google Cloud. Per artefatti ed esecuzioni, il servizio Vertex ML Metadata gestisce un addebito mensile di 10 $/GB.

SDK Vertex AI per Python

L'esempio seguente utilizza il metodo delete di ExperimentClass.

Python

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: assegna un nome all'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 eliminerà anche le esecuzioni di Vertex AI TensorBoard associate all'esecuzione 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.
    <a{: class="button button-primary" l10n-attrs-original-order="href,target,class,track-name,track-type" l10n-encrypted-href="V3Ae1hvcBOij4KvUNiRrMltigmNHgUGOXn/QVSGplOhBlpxunv8WHL3F/z3" astrai
  2. Seleziona la casella di controllo associata all'esperimento da eliminare. Viene visualizzata l'opzione Elimina.
  3. Fai clic su Elimina.
    • In alternativa, puoi andare al menu opzioni che si trova nella stessa riga dell'esperimento e selezionare 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. Assicurati di essere nel progetto corretto.

  3. Nella vista Monitoraggio esperimento viene visualizzato un elenco di esperimenti per il tuo progetto.
    Se hai associato un'istanza Vertex AI TensorBoard al tuo esperimento, questa verrà visualizzata nell'elenco come "your-experiment Backing TensorBoard esperimento".

Elenco degli esperimenti di Vertex AI

Passaggi successivi

Esempio di blocco note pertinente