Criar ou excluir um experimento

É possível usar o SDK da Vertex AI para Python ou o console do Google Cloud para criar ou excluir um experimento. O SDK é uma biblioteca de códigos Python que pode ser usada para criar e gerenciar experimentos de maneira programática. O console é uma interface do usuário baseada na Web que pode ser usada para criar e gerenciar experimentos visualmente.

Criar experimento com uma instância do TensorBoard

SDK da Vertex AI para Python

Crie um experimento e, opcionalmente, associe uma instância do TensorBoard da Vertex AI com o SDK do Vertex AI para Python. Adicione uma descrição do experimento para documentar a finalidade dele. Consulte init na documentação de referência do SDK da 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: dê um nome para o experimento.
  • experiment_description: forneça uma descrição para o experimento.
  • experiment_tensorboard: Opcional. A instância do TensorBoard Vertex a ser usada como um TensorBoard de apoio para o experimento fornecido. Se nenhum experiment_tensorboard for fornecido, uma instância de TB padrão será criada e usada por esse experimento. Observação: se for preciso associar CMEKs (chaves de criptografia) à instância do TensorBoard, experiment_tensorboard não será mais opcional.
  • project: o ID do projeto. Esses IDs estão na página de boas-vindas do console do Google Cloud.
  • location: consulte Lista de locais disponíveis. Lembre-se de usar uma região compatível com o TensorBoard ao criar uma instância do TensorBoard.

Console do Google Cloud

Use estas instruções para criar um experimento.

  1. No Console do Google Cloud, acesse a página Experimentos.
    Acessar os Experimentos
  2. Verifique se você está no projeto em que quer criar o experimento.
    Projeto selecionado do Vertex AI
  3. Clique em Criar para abrir o painel Experimento. O painel Criar experimento é exibido.
  4. No campo Nome do experimento, forneça um nome para identificá-lo exclusivamente.
  5. Opcional. No campo Instância do TensorBoard, selecione uma instância na lista suspensa ou forneça um nome para a nova instância do TensorBoard.
  6. Clique em Criar para criar seu experimento.

Criar um experimento sem uma instância padrão do TensorBoard

SDK da Vertex AI para Python

Criar um experimento. Adicione uma descrição do experimento para documentar a finalidade dele. Consulte init na documentação de referência do SDK da 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: dê um nome para o experimento.
  • experiment_description: forneça uma descrição para o experimento.
  • project: o ID do projeto. Esses IDs estão na página de boas-vindas do console do Google Cloud.
  • location: consulte Lista de locais disponíveis. Lembre-se de usar uma região compatível com o TensorBoard ao criar uma instância do TensorBoard.

Excluir experimento

Ao excluir um experimento, ele e todas as execuções associadas a ele são excluídos. O experimento do TensorBoard da Vertex AI associado ao experimento não é excluído. Para excluir um experimento do TensorBoard, consulte Excluir experimento desatualizado do TensorBoard da Vertex AI.

No entanto, as execuções, os artefatos e as execuções do pipeline associados ao experimento excluído não são removidos. Eles podem ser encontrados no Console do Google Cloud. Para artefatos e execuções, uma cobrança mensal de US$10/GB é processada pelo serviço Vertex ML Metadata.

SDK da Vertex AI para Python

O exemplo a seguir usa o método delete da 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: dê um nome para o experimento.
  • 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.
  • delete_backing_tensorboard_runs: se "True" também excluirá as execuções do TensorBoard da Vertex AI associadas às execuções do experimento que usamos para armazenar métricas de série temporal.

Console

Use as instruções a seguir para excluir um experimento.

  1. No Console do Google Cloud, acesse a página Experimentos.
    Acessar os "Experimentos"
  2. Marque a caixa de seleção associada ao experimento que você quer excluir. A opção Excluir é exibida.
  3. Clique em Excluir.
    • Como alternativa, acesse o menu de opções que está na mesma linha do experimento e selecione excluir.

Ver a lista de experimentos no Console do Google Cloud

  1. No Console do Google Cloud, na seção "Vertex AI", acesse a página Experimentos.

    Acessar a página "Experimentos"

  2. Verifique se você está no projeto correto.

  3. Uma lista de experimentos para o projeto aparece na visualização de Rastreamento de experimentos.
    Se você associou uma instância do TensorBoard da Vertex AI ao seu experimento, ela será exibida na lista como "Teste do TensorBoard seu-experimento".

Vertex AIList de experimentos

A seguir

Exemplo de notebook relevante