Crear o eliminar un experimento

Puedes usar el SDK de Vertex AI para Python o la Google Cloud consola para crear o eliminar un experimento. El SDK es una biblioteca de código Python que puedes usar para crear y gestionar experimentos mediante programación. La consola es una interfaz de usuario basada en la Web que puedes usar para crear y gestionar experimentos de forma visual.

Crear un experimento con una instancia de TensorBoard

SDK de Vertex AI para Python

Crea un experimento y, opcionalmente, asocia una instancia de Vertex AI TensorBoard mediante el SDK de Vertex AI para Python. Añade una descripción del 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: ponle un nombre al experimento.
  • experiment_description: proporciona una descripción del experimento.
  • experiment_tensorboard: Opcional. La instancia de Vertex TensorBoard que se va a usar como TensorBoard de respaldo del experimento proporcionado. Si no se proporciona ningún experiment_tensorboard, este experimento creará y usará una instancia de TB predeterminada. Nota: Si las CMEK (claves de cifrado) deben asociarse a la instancia de TensorBoard, experiment_tensorboard ya no es opcional.
  • project: . Puedes encontrar estos IDs en la página de bienvenida de la Google Cloud consola.
  • location: consulta la lista de ubicaciones disponibles. Si creas una instancia de TensorBoard, asegúrate de usar una región que admita TensorBoard.

Google Cloud consola

Sigue estas instrucciones para crear un experimento.

  1. En la Google Cloud consola, vaya a la página Experimentos.
    Ir a Experimentos
  2. Asegúrate de que estás en el proyecto en el que quieres crear el experimento.
    Vertex AI select project
  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 único para identificar el experimento.
  5. Opcional. En el campo Instancia de TensorBoard, selecciona una instancia del menú desplegable o proporciona un nombre para tu nueva instancia de TensorBoard.
  6. Haz clic en Crear para crear el experimento.

Crear un experimento sin una instancia de TensorBoard predeterminada

SDK de Vertex AI para Python

Cree un experimento. Añade una descripción del 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: ponle un nombre al experimento.
  • experiment_description: proporciona una descripción del experimento.
  • project: . Puedes encontrar estos IDs en la página de bienvenida de la Google Cloud consola.
  • location: consulta la lista de ubicaciones disponibles. Si creas una instancia de TensorBoard, asegúrate de usar una región que admita TensorBoard.

Eliminar experimento

Al eliminar un experimento, se elimina ese experimento y todas las ejecuciones asociadas. El experimento de Vertex AI TensorBoard asociado al experimento no se elimina. Para eliminar un experimento de TensorBoard, consulta Eliminar un experimento de Vertex AI TensorBoard obsoleto.

Además, no se eliminarán las ejecuciones de la canalización, los artefactos ni las ejecuciones asociados al experimento eliminado. Puedes encontrarlos en la Google Cloud consola. En el caso de los artefactos y las ejecuciones, el servicio Vertex ML Metadata se encarga de cobrar 10 USD al mes 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: ponle un nombre al experimento.
  • project: . Puedes encontrar estos IDs en la página de bienvenida de la Google Cloud consola.
  • location: consulta la lista de ubicaciones disponibles.
  • delete_backing_tensorboard_runs: si es True, también se eliminarán las ejecuciones de Vertex AI TensorBoard asociadas a las ejecuciones del experimento que hemos usado para almacenar métricas de series temporales.

Consola

Sigue estas instrucciones para eliminar un experimento.

  1. En la Google Cloud consola, vaya a la página Experimentos.
    Ir a Experimentos
  2. Marca la casilla asociada al experimento que quieras eliminar. Aparecerá la opción Eliminar.
  3. Haz clic en Eliminar.
    • También puedes ir al menú de  opciones que se encuentra en la misma fila que el experimento y seleccionar Eliminar.

Ver la lista de experimentos en la consola de Google Cloud

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

    Ir a la página Experimentos

  2. Comprueba que estés en el proyecto correcto.

  3. Aparecerá una lista de los experimentos de tu proyecto en la vista Seguimiento de experimentos.
    Si has asociado una instancia de Vertex AI TensorBoard a tu experimento, aparecerá en la lista como "tu-experimento Backing TensorBoard Experiment".

Lista de experimentos de Vertex AI

Siguientes pasos

Cuaderno de ejemplo pertinente