輸出 HTML 和 Markdown

Vertex AI Pipelines 提供一組預先定義的視覺化類型，用於評估 pipeline 工作的結果 (例如 Metrics、ClassificationMetrics)。不過，在許多情況下，您需要自訂視覺化效果。Vertex AI Pipelines 提供兩種主要方法，可輸出自訂視覺化構件：Markdown 和 HTML 檔案。

匯入必要依附元件

在開發環境中匯入必要依附元件。

from kfp import dsl
from kfp.dsl import (
    Output,
    HTML,
    Markdown
)

輸出 HTML

如要匯出 HTML 檔案，請使用 Output[HTML] 構件定義元件。 您也必須將 HTML 內容寫入構件的路徑。在本範例中，您會使用字串變數來表示 HTML 內容。

@dsl.component
def html_visualization(html_artifact: Output[HTML]):
    public_url = 'https://user-images.githubusercontent.com/37026441/140434086-d9e1099b-82c7-4df8-ae25-83fda2929088.png'
    html_content = \
      '<html><head></head><body><h1>Global Feature Importance</h1>\n<img src="{}" width="97%"/></body></html>'.format(public_url)
    with open(html_artifact.path, 'w') as f:
        f.write(html_content)

Google Cloud 控制台中的 HTML 構件：

控制台中的 HTML 構件

Google Cloud 控制台中的 HTML 構件資訊：

控制台中的 HTML 構件資訊

按一下「查看 HTML」，在新分頁中開啟 HTML 檔案

控制台中的 HTML 構件資訊

輸出 Markdown

如要匯出 Markdown 檔案，請使用 Output[Markdown] 定義構件。您也必須將 Markdown 內容寫入構件的路徑。在這個範例中，您會使用字串變數來代表 Markdown 內容。

@dsl.component
def markdown_visualization(markdown_artifact: Output[Markdown]):
    import urllib.request

    with urllib.request.urlopen('https://gist.githubusercontent.com/zijianjoy/a288d582e477f8021a1fcffcfd9a1803/raw/68519f72abb59152d92cf891b4719cd95c40e4b6/table_visualization.md') as table:
        markdown_content = table.read().decode('utf-8')
        with open(markdown_artifact.path, 'w') as f:
            f.write(markdown_content)

控制台中的 Markdown 構件： Google Cloud

主控台中的 Markdown 構件

控制台中的 Markdown 構件資訊： Google Cloud

控制台中的 Markdown 構件資訊

建立管道

使用 HTML 或 Markdown 構件定義元件後，請建立並執行使用該元件的管道。

@dsl.pipeline(
    name=f'metrics-visualization-pipeline')
def metrics_visualization_pipeline():
    html_visualization_op = html_visualization()
    markdown_visualization_op = markdown_visualization()

提交管道執行作業後，您可以在 Google Cloud 控制台中查看這項作業的圖表。這個圖表包含您在對應元件中宣告的 HTML 和 Markdown 構件。您可以選取這些構件，查看詳細的視覺化資料。