Crea o borra un experimento

Puedes usar el SDK de Vertex AI para Python o la consola de Google Cloud para crear o borrar un experimento. El SDK es una biblioteca de código de Python que puedes usar para crear y administrar experimentos de manera programática. La consola es una interfaz de usuario basada en la Web que permite crear y administrar experimentos de forma visual.

Crea el experimento con una instancia de TensorBoard

SDK de Vertex AI para Python

Crea un experimento y asocia, opcionalmente, una instancia de TensorBoard de Vertex AI con el SDK de Vertex AI para Python. Agrega una descripción al experimento para documentar su propósito. Consulta init en la documentación de referencia del SDK de 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: Proporciona un nombre para tu experimento.
  • experiment_description: Proporciona una descripción para tu experimento.
  • experiment_tensorboard: Opcional. La instancia de Vertex TensorBoard que se usa como TensorBoard de respaldo para el experimento proporcionado. Si no se proporciona un experiment_tensorboard, se genera una instancia de TB predeterminada y usa en este experimento. Nota: Si las CMEK (claves de encriptación) necesitan estar asociadas con la instancia de TensorBoard, experiment_tensorboard ya no es opcional.
  • project: El ID del proyecto. Puedes encontrar estos ID en la página de bienvenida de la consola de Google Cloud.
  • location: Consulta la Lista de ubicaciones disponibles. Asegúrate de usar una región compatible con TensorBoard si creas una instancia de TensorBoard.

Consola de Google Cloud

Usa estas instrucciones para crear un experimento.

  1. En la consola de Google Cloud, ve a la página Experimentos.
    Ir a Experimentos
  2. Asegúrate de estar en el proyecto en el que deseas crear el experimento.
    Selección de proyecto de Vertex AI
  3. Haz clic en Crear para abrir el panel Experimento. Aparecerá el panel Crear experimento.
  4. En el campo Nombre del experimento, proporciona un nombre para identificar de forma única tu experimento.
  5. Opcional. En el campo Instancia de TensorBoard, selecciona una instancia del menú desplegable o proporciona un nombre para la instancia nueva de TensorBoard.
  6. Haz clic en Crear para crear el experimento.

Crea un experimento sin una instancia predeterminada de TensorBoard

SDK de Vertex AI para Python

Crea un experimento Agrega una descripción al experimento para documentar su propósito. Consulta init en la documentación de referencia del SDK de 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: Proporciona un nombre para tu experimento.
  • experiment_description: Proporciona una descripción para tu experimento.
  • project: El ID del proyecto. Puedes encontrar estos ID en la página de bienvenida de la consola de Google Cloud.
  • location: Consulta la Lista de ubicaciones disponibles. Asegúrate de usar una región compatible con TensorBoard si creas una instancia de TensorBoard.

Borrar experimento

Borrar un experimento borra ese experimento y todos los que se ejecutan con él. El experimento de Vertex AI TensorBoard asociado con el experimento no se borra. Para borrar un experimento de TensorBoard, consulta Borra el experimento de Vertex AI TensorBoard desactualizado.

Además, no se quitan las ejecuciones de canalizaciones, los artefactos y ni las ejecuciones asociadas con el experimento borrado. Puedes encontrarlos en la consola de Google Cloud. En el caso de los artefactos y las ejecuciones, el servicio de Vertex ML Metadata estipula un cargo mensual de USD 10 por GB.

SDK de Vertex AI para Python

En el siguiente ejemplo, se usa el método delete de 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: Proporciona un nombre para tu experimento.
  • project: El ID del proyecto. Puedes encontrar estos ID en la página de bienvenida de la consola de Google Cloud.
  • location: Consulta Lista de ubicaciones disponibles.
  • delete_backing_tensorboard_runs: Si es verdadero, también se borrarán las ejecuciones de TensorBoard de Vertex AI asociadas con el experimento que se ejecuta en este experimento que usamos para almacenar las métricas de series temporales.

Console

Usa las siguientes instrucciones para borrar un experimento.

  1. En la consola de Google Cloud, ve a la página Experimentos.
    Ir a Experimentos
  2. Selecciona la casilla de verificación asociada con el experimento que deseas borrar. Aparecerá la opción Borrar.
  3. Haz clic en Borrar.
    • Como alternativa, puedes ir al menú de opciones que se encuentra en la misma fila que el experimento y seleccionar borrar.

Visualiza la lista de experimentos en la consola de Google Cloud

  1. En la consola de Google Cloud, en la sección Vertex AI, ve a la página Experimentos.

    Ir a la página Experimentos

  2. Asegúrate de estar en el proyecto correcto.

  3. En la vista Seguimiento de experimentos, aparece una lista de los experimentos de tu proyecto.
    Si asociaste una instancia de TensorBoard de Vertex AI con tu experimento, aparecerá en la lista como Backing Tensorboard Experiment “tu-experimento ”.

Lista de experimentos de Vertex AI

¿Qué sigue?

Muestra de notebook relevante