Criar e gerenciar execuções de experimentos

Use o SDK da Vertex AI para Python para criar e gerenciar as execuções do experimento. É possível usar o Console do Google Cloud para excluir execuções do experimento.

SDK da Vertex AI para Python

Os exemplos a seguir usam os métodos init, start_run e end_run do aiplatform Funções de pacote e delete do ExperimentClass.

Criar e começar a execução

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: informe o nome do experimento. Para ver sua lista de experimentos no Console do Google Cloud, selecione "Experimentos" na seção de navegação.
  • run_name: especifica um nome de execução para associar à sessão atual. Consulte start_run na documentação de referência do SDK da Vertex AI.
  • experiment_run_tensorboard: Opcional. Um recurso de apoio do TensorBoard para ativar e armazenar métricas de série temporal registradas neste experimento executadas usando log_time_series_metrics.
  • project: o ID do projeto. Esses IDs estão na página de boas-vindas do console do Google Cloud.
  • location: consulte a Lista de locais disponíveis.

Finalizar corrida

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: informe o nome do experimento. Para ver sua lista de experimentos no Console do Google Cloud, selecione "Experimentos" na seção de navegação.
  • run_name: especifica um nome para execução.
  • project: o ID do projeto. É possível encontrá-los na página de boas-vindas do Console do Google Cloud.
  • location: Consulte a Lista de locais disponíveis.

Retomar execução

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: informe o nome do experimento. Para ver sua lista de experimentos no Console do Google Cloud, selecione "Experimentos" na seção de navegação.
  • run_name: especifica o nome da execução que você quer retomar.
  • project: o ID do projeto. É possível encontrá-los na página de boas-vindas do Console do Google Cloud.
  • location: Consulte a Lista de locais disponíveis.

Excluir execução

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: o nome ou a instância deste experimento. Encontre sua lista de experimentos no console do Google Cloud selecionando "Experimentos" na seção de navegação.
  • run_name: especifica o nome da execução que você quer excluir.
  • project: o ID do projeto. É possível encontrá-los na página de boas-vindas do Console do Google Cloud.
  • location: Consulte a Lista de locais disponíveis.
  • delete_backing_tensorboard_run: para excluir a execução de apoio do TensorBoard da Vertex AI que armazena métricas de série temporal para essa execução.

Gerenciar o status

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: nome da execução associado ao experimento.
  • experiment_name: nome do experimento. Para ver sua lista de experimentos no Console do Google Cloud, selecione Experimentos no painel de navegação.
  • project: o ID do projeto. Esses IDs do projeto estão na página de boas-vindas do console do Google Cloud.
  • location: consulte a Lista de locais disponíveis.
  • state: os valores possíveis para state, que aparece como "status" no console do Google Cloud, são:
    • 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

Console do Google Cloud

Siga estas etapas para excluir uma execução de experimento.
  1. No Console do Google Cloud, acesse a 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" }="">Go to Experiments </a{:>
  2. Na página de detalhes do experimento, clique no nome dele associado à execução que você quer excluir. A página Execuções do experimento será exibida com a lista de todas as execuções do experimento.
  3. Marque a caixa de seleção associada à execução que você quer excluir. O botão Delete (excluir) é exibido.
  4. Clique em Excluir.
    • Você também pode acessar o menu de opções que está na mesma linha da execução do experimento e selecionar excluir.

Ver a lista de execuções do experimento e os detalhes delas

O console do Google Cloud fornece uma visualização dos dados associados a essas execuções.

A seguir