Crea y administra ejecuciones de experimentos

Usa el SDK de Vertex AI para Python a fin de crear y administrar tus ejecuciones de experimentos. Puedes usar la consola de Google Cloud para borrar ejecuciones de experimentos.

SDK de Vertex AI para Python

En los siguientes ejemplos, se usan los métodos init, start_run y end_run de las funciones del paquete aiplatform y delete de ExperimentClass.

Crea y comienza la ejecución

Python

def create_experiment_run_sample(
    experiment_name: str,
    run_name: str,
    experiment_run_tensorboard: Optional[Union[str, aiplatform.Tensorboard]],
    project: str,
    location: str,
):
    aiplatform.init(experiment=experiment_name, project=project, location=location)

    aiplatform.start_run(run=run_name, tensorboard=experiment_run_tensorboard)

  • experiment_name: Proporciona el nombre del experimento. Para encontrar tu lista de experimentos en la consola de Google Cloud, selecciona "Experimentos" en la barra de navegación de secciones.
  • run_name: Especifica un nombre de ejecución para asociarlo con tu sesión actual. Consulta start_run en la documentación de referencia del SDK de Vertex AI.
  • experiment_run_tensorboard: Opcional. Un recurso de TensorBoard de respaldo para habilitar y almacenar métricas de series temporales registradas en esta ejecución de experimento con log_time_series_metrics.
  • 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.

Finaliza la ejecución

Python

def end_experiment_run_sample(
    experiment_name: str,
    run_name: str,
    project: str,
    location: str,
):
    aiplatform.init(experiment=experiment_name, project=project, location=location)

    aiplatform.start_run(run=run_name, resume=True)

    aiplatform.end_run()

  • experiment_name: Proporciona el nombre del experimento. Para encontrar tu lista de experimentos en la consola de Google Cloud, selecciona "Experimentos" en la barra de navegación de secciones.
  • run_name: Especifica un nombre de ejecución.
  • project: El ID del proyecto. Puedes encontrarlos en la página de Bienvenida de la consola de Google Cloud.
  • location: Consulta Lista de ubicaciones disponibles

Reanuda la ejecución

Python

def resume_experiment_run_sample(
    experiment_name: str,
    run_name: str,
    project: str,
    location: str,
):
    aiplatform.init(experiment=experiment_name, project=project, location=location)

    aiplatform.start_run(run=run_name, resume=True)

  • experiment_name: Proporciona el nombre del experimento. Para encontrar tu lista de experimentos en la consola de Google Cloud, selecciona "Experimentos" en la barra de navegación de secciones.
  • run_name: Especifica el nombre de la ejecución que deseas reanudar.
  • project: El ID del proyecto. Puedes encontrarlos en la página de Bienvenida de la consola de Google Cloud.
  • location: Consulta Lista de ubicaciones disponibles

Borrar ejecución

Python

def delete_experiment_run_sample(
    run_name: str,
    experiment: Union[str, aiplatform.Experiment],
    project: str,
    location: str,
    delete_backing_tensorboard_run: bool = False,
):
    experiment_run = aiplatform.ExperimentRun(
        run_name=run_name, experiment=experiment, project=project, location=location
    )

    experiment_run.delete(delete_backing_tensorboard_run=delete_backing_tensorboard_run)

  • experiment: El nombre o la instancia de este experimento. Para encontrar tu lista de experimentos en la consola de Google Cloud, selecciona "Experimentos" en la barra de navegación de secciones.
  • run_name: Especifica el nombre de la ejecución que deseas borrar.
  • project: El ID del proyecto. Puedes encontrarlos en la página de Bienvenida de la consola de Google Cloud.
  • location: Consulta Lista de ubicaciones disponibles
  • delete_backing_tensorboard_run: Indica si se debe borrar la ejecución de respaldo de Vertex AI TensorBoard que almacena métricas de series temporales para esta ejecución.

Administra el estado

Python

def update_experiment_run_state_sample(
    run_name: str,
    experiment: Union[str, aiplatform.Experiment],
    project: str,
    location: str,
    state: aiplatform.gapic.Execution.State,
) -> None:
    experiment_run = aiplatform.ExperimentRun(
        run_name=run_name,
        experiment=experiment,
        project=project,
        location=location,
    )

    experiment_run.update_state(state)

  • run_name: Es el nombre de la ejecución asociada con tu experimento.
  • experiment_name: El nombre de tu experimento. Para encontrar tu lista de experimentos en la consola de Google Cloud, selecciona Experimentos en la barra de navegación de secciones.
  • project: El ID del proyecto. Puedes encontrar estos IDs en la página de bienvenida de la consola de Google Cloud.
  • location: Consulta Lista de ubicaciones disponibles
  • state: Los valores posibles para state, que aparecen como “estado” en la consola de Google Cloud, son los siguientes:
    • aiplatform.gapic.Execution.State.CACHED
    • aiplatform.gapic.Execution.State.CANCELLED
    • aiplatform.gapic.Execution.State.COMPLETE
    • aiplatform.gapic.Execution.State.FAILED
    • aiplatform.gapic.Execution.State.NEW
    • aiplatform.gapic.Execution.State.RUNNING

Consola de Google Cloud

Sigue estos pasos para borrar una ejecución de experimento.
  1. En la consola de Google Cloud, ve a la página Experimentos.
    <a{: class="button button-primary" l10n-attrs-original-order="href,target,class,track-name,track-type" l10n-encrypted-href="V3Ae1hvcBOij4KvUNiRrMltigmNHgUGOXn/QVSGplOhBlpxunv8WHL3F/z3VuS9rwbZOYpOQCXa+v4aZ0dt03w==" target="console" track-name="consoleLink" track-type="tasks" }="">Ir a Experimentos </a{:>
  2. En la página de detalles del experimento, haz clic en el nombre del experimento asociado con la ejecución de experimento que deseas borrar. La página Ejecuciones de experimentos aparece con la lista de todas las ejecuciones de experimentos para ese experimento.
  3. Selecciona la casilla de verificación asociada con la ejecución que deseas borrar. Aparecerá el botón Borrar.
  4. Haz clic en Borrar
    • Como alternativa, puedes ir al menú de opciones que se encuentra en la misma fila que la ejecución del experimento y seleccionar borrar.

Visualiza la lista de ejecuciones del experimento y los detalles de la ejecución

La consola de Google Cloud proporciona una visualización de los datos asociados con estas ejecuciones.

¿Qué sigue?