適用于 Python 的 Azure ML 套件用戶端程式庫 - 1.12.1 版

  • 發行項

我們很高興推出 Azure Machine Learning Python SDK v2 的 GA。 Python SDK v2 引進新的 SDK 功能，例如獨立本機作業、管線可重複使用的元件，以及受控線上/批次推斷。 Python SDK v2 可讓您輕鬆且累加地從簡單到複雜的工作。 這是使用通用物件模型來啟用的，可讓各種工作之間的動作概念重複使用和一致性。 SDK v2 會與 CLI v2 共用其基礎，這也是 GA。

| 原始程式碼套件 (PyPI) | 封裝 (Conda) | API 參考檔 | 產品檔 | 樣品

此套件已經過 Python 3.7、3.8、3.9 和 3.10 的測試。

如需一組更完整的 Azure 程式庫，請參閱 https://aka.ms/azsdk/python/all

開始使用

Prerequisites

安裝套件

使用 pip安裝適用于 Python 的 Azure ML 用戶端程式庫：

pip install azure-ai-ml
pip install azure-identity

驗證用戶端

from azure.ai.ml import MLClient
from azure.identity import DefaultAzureCredential

ml_client = MLClient(
    DefaultAzureCredential(), subscription_id, resource_group, workspace
)

重要概念

Azure Machine Learning Python SDK v2 隨附許多新功能，例如獨立本機作業、管線可重複使用的元件，以及受控線上/批次推斷。 SDK v2 可跨平臺的所有資產提供一致性和方便使用。 Python SDK v2 提供下列功能：

  • 執行 獨立作業 - 以作業身分執行離散 ML 活動。 此作業可以在本機或雲端上執行。 我們目前支援下列類型的作業：
    • 命令 - (Python、R、Windows Command、Linux Shell 等 ) 執行命令
    • 掃掠 - 在命令上執行超參數掃掠
  • 使用改善的管線執行多個作業
    • 執行一系列已結合到管線中的命令， (New)
    • 元件 - 使用可重複使用的元件來執行管線， (新增)
  • 使用您的模型進行 Managed Online 推斷 ， (新)
  • 使用您的模型進行受控 批次推斷
  • 管理 AML 資源 – 工作區、計算、資料存放區
  • 管理 AML 資產 - 資料集、環境、模型
  • AutoML - 針對各種 ml-tasks 執行獨立 AutoML 訓練：
    • 分類 (表格式資料)
    • 表格式資料 (回歸)
    • 時間序列預測 (表格式資料)
    • 影像分類 (多類別) (新增)
    • 影像分類 (多標籤) (新增)
    • 影像物件偵測 (新)
    • 影像實例分割 (新)
    • NLP 文字分類 (多類別) (新)
    • NLP 文字分類 (多標籤) (新增)
    • NLP 文字具名實體辨識 (NER) (New)

範例

疑難排解

一般

Azure ML 用戶端會引發 Azure Core中定義的例外狀況。

from azure.core.exceptions import HttpResponseError

try:
    ml_client.compute.get("cpu-cluster")
except HttpResponseError as error:
    print("Request failed: {}".format(error.message))

記錄

此程式庫會使用標準記錄程式庫進行 記錄 。 HTTP 會話的基本資訊 (URL、標頭等。) 會記錄在 INFO 層級。

您可以在具有 引數的用戶端 logging_enable 上啟用詳細的 DEBUG 層級記錄，包括要求/回應主體和未處理的標頭。

如需完整的 SDK 記錄檔，請參閱 這裡的範例。

遙測

Azure ML Python SDK 包含遙測功能，可收集 SDK 的使用方式和失敗資料，並在您只在Jupyter Notebook中使用 SDK 時將其傳送給 Microsoft。 不會收集遙測，以在Jupyter Notebook外部使用 Python SDK。

遙測資料可協助 SDK 小組瞭解 SDK 的使用方式，以便改善 SDK，以及失敗的相關資訊可協助小組解決問題並修正錯誤。 SDK 遙測功能預設會針對Jupyter Notebook使用量啟用，而且無法針對非 Jupyter 案例啟用。 若要退出宣告 Jupyter 案例中的遙測功能，請在建構 MLClient 物件時傳入 enable_telemetry=False 。

下一步

參與

此專案歡迎參與和提供建議。 大部分的參與都要求您同意「參與者授權合約 (CLA)」，宣告您有權且確實授與我們使用投稿的權利。 如需詳細資訊，請造訪 cla.microsoft.com。

當您提交提取要求時，CLA Bot 會自動判斷您是否需要提供 CLA，並適當地裝飾 PR (例如標籤、註解)。 請遵循 bot 提供的指示。 您只需要使用我們的 CLA 在所有存放庫上執行此動作一次。

此專案採用 Microsoft Open Source Code of Conduct (Microsoft 開放原始碼管理辦法)。 如需詳細資訊，請參閱管理辦法常見問題集，如有任何其他問題或意見請連絡 opencode@microsoft.com。