建立及管理實驗執行

使用 Python 適用的 Agent Platform SDK 建立及管理實驗執行作業。您可以使用 Google Cloud 主控台刪除實驗執行作業。

Agent Platform SDK for Python

下列範例使用 aiplatform Package 函式中的 init、start_run 和 end_run 方法，以及 ExperimentClass 中的 delete。

建立並啟動執行作業

Python

from typing import Optional, Union

from google.cloud import aiplatform


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：提供實驗名稱。 如要查看實驗清單，請在 Google Cloud 控制台選取區段導覽中的「實驗」。
  • run_name：指定要與目前工作階段建立關聯的執行名稱。請參閱 Agent Platform SDK 參考說明文件中的 start_run。
  • experiment_run_tensorboard： 選用。支援的 TensorBoard 資源，可啟用並儲存使用 log_time_series_metrics 記錄到這項實驗執行的時間序列指標。
  • project：您可以在 Google Cloud 控制台歡迎頁面中找到這些 ID。
  • location：請參閱「支援的地區清單」

結束跑步

Python

from google.cloud import aiplatform


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：提供實驗名稱。 如要查看實驗清單，請在 Google Cloud 控制台選取區段導覽中的「實驗」。
  • run_name：指定執行名稱。
  • project：。您可以在 Google Cloud 控制台的「歡迎」頁面中找到這些資訊。
  • location：請參閱支援的地點清單

繼續執行

Python

from google.cloud import aiplatform


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：提供實驗名稱。 如要查看實驗清單，請在 Google Cloud 控制台選取區段導覽中的「實驗」。
  • run_name：指定要繼續執行的執行名稱。
  • project：。您可以在 Google Cloud 控制台的「歡迎」頁面中找到這些資訊。
  • location：請參閱支援的地點清單

刪除執行作業

Python

from typing import Union

from google.cloud import aiplatform


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：這項實驗的名稱或執行個體。您可以在 Google Cloud 控制台中選取區段導覽列的「實驗」，查看實驗清單。
  • run_name：指定要刪除的執行名稱。
  • project：。您可以在 Google Cloud 控制台的「歡迎」頁面中找到這些資訊。
  • location：請參閱支援的地點清單
  • delete_backing_tensorboard_run：是否要刪除儲存此執行階段時間序列指標的支援 Vertex AI TensorBoard 執行階段。

管理狀態

Python

from typing import Union

from google.cloud import aiplatform


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：與實驗相關聯的執行名稱
  • experiment_name：實驗名稱。如要查看實驗清單，請在 Google Cloud 控制台選取區段導覽中的「實驗」。
  • project：您可以在 Google Cloud 控制台歡迎頁面中找到這些專案 ID。
  • location：請參閱「支援的地區清單」
  • state：state 的可能值，在 Google Cloud 控制台中會顯示為「狀態」：
    • 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

Google Cloud 控制台

請按照下列步驟刪除實驗執行。
  1. 前往 Google Cloud 控制台的「實驗」頁面。
    前往「實驗」頁面
  2. 在實驗詳細資料頁面中，按一下與要刪除的實驗執行項目相關聯的實驗名稱。系統會顯示「實驗執行項目」頁面，其中列出該實驗的所有實驗執行項目。
  3. 選取要刪除的執行作業相關聯的核取方塊。 系統會隨即顯示「刪除」按鈕。
  4. 按一下「刪除」
    • 或者，您也可以前往實驗執行作業同一列的選項選單，然後選取「刪除」。

查看實驗執行作業清單和執行作業詳細資料

Google Cloud 控制台會以視覺化方式呈現與這些執行作業相關聯的資料。

後續步驟