在 Microsoft Foundry 中使用 Azure Developer CLI 微調擴充套件來微調 AI 模型。

在本文中，你會學習如何使用 Azure Developer CLI（azd）AI 微調擴充功能，在 Microsoft Foundry 中設定並執行微調工作。 這個擴充功能讓你能從範本初始化專案、提交和管理微調工作，並直接從終端部署微調過的模型。

先決條件

• 安裝Azure 開發者 CLI（）版本1.22.1或更新版本，並已驗證（）。
• 已安裝的 azd AI 微調擴充套件（azd ext install azure.ai.finetune）。 詳情請參見 「安裝微調擴充功能 」。
• 一個 Azure 訂閱，擁有建立和管理 Microsoft Foundry 資源的權限。
• （可選）如果你打算從GitHub軟體庫下載範例範本，GitHub CLI 已經安裝了。

安裝 Azure 開發者命令行界面 (CLI)

安裝 azd 到你的作業系統上。

winget install microsoft.azd

brew tap azure/azd && brew install azd

curl -fsSL https://aka.ms/install-azd.sh | bash

確認安裝情況

安裝後，請確認已 azd 安裝並符合最低版本要求：

azd version

確認輸出顯示的是 1.22.1 或更新版本。 如果需要升級，可以執行：

winget upgrade Microsoft.azd

安裝微調擴充功能

將 Azure AI 的微調擴充功能加入 azd：

azd ext install azure.ai.finetune

確認擴充功能已安裝：

azd ext list

認證

登入 Azure（必須）

使用您的 Azure 帳號認證以存取您的訂閱與資源：

azd auth login

初始化你的專案

使用指令 azd ai finetuning init 來搭建微調專案。 在執行以下任何初始化方法前，先導覽到你想要的工作目錄。

尋找你的專案 ARM 資源 ID

要初始化 Azure AI Foundry 專案，你需要該專案的 ARM 資源 ID。 資源識別碼格式如下：

/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project}

您可以在 Azure 入口網站中，瀏覽至 AI Foundry 專案的 [設定檔] 頁面，然後在 [專案詳細資料] 下找到此值。

選項一：Project + 範本

使用現有的 Azure AI Foundry 專案並搭配範本：

azd ai finetuning init -p <project-resource-id> -t <template-url>

範例：

azd ai finetuning init \
  -t https://github.com/achauhan-scc/foundry-samples/blob/main/samples/python/finetuning/supervised \
  -p /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project}

選項二：Project + 現有工作

從現有的微調任務複製配置：

azd ai finetuning init -p <project-resource-id> -j <job-id>

範例：

azd ai finetuning init \
  -p /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project} \
  -j ftjob-4cad7de198a34baeb4f0c95ff01ac844

選項三：僅使用範本

從範本開始，之後再設定專案：

azd ai finetuning init -t <template-url>

範例：

azd ai finetuning init -t https://github.com/achauhan-scc/foundry-samples/blob/main/samples/python/finetuning/supervised

選項四：從工作中複製

從現有工作 ID 複製設定：

azd ai finetuning init -j <job-id>

範例：

azd ai finetuning init -j ftjob-4cad7de198a34baeb4f0c95ff01ac844

選項 5：僅限專案端點

僅用你的 Azure AI Foundry 專案中繼站來初始化：

azd ai finetuning init -e <project-endpoint>

範例：

azd ai finetuning init -e https://account.services.ai.azure.com/api/projects/project-name

選項六：互動模式

無參數執行以獲取引導設定提示：

azd ai finetuning init

選項七：最小初始化（並查詢訂閱）

使用最小初始化，讓訂閱查詢的互動體驗更簡潔：

azd init --minimal

此選項提供導引提示，協助您選擇訂閱並設定環境。

執行微調指令

請前往你的專案資料夾（該資料夾所在位置 fine-tune-job.yaml ），並使用以下指令管理微調工作。

快速提交（跳過初始化）

你可以直接提交任務，無需先運行 azd init，只需直接提供訂閱和專案端點：

azd ai finetuning jobs submit -f <path-to-yaml> -s <subscription-id> -e <project-endpoint>

範例：

azd ai finetuning jobs submit \
  -f /path-from-working-directory-to-config/job.yaml \
  -s a9096eb7-bfec-47e8-be27-b040b82afac9 \
  -e https://my-resource.services.ai.azure.com/api/projects/my-project

提交作業

azd ai finetuning jobs submit -f ./fine-tune-job.yaml

職業列表

azd ai finetuning jobs list

顯示工作詳情

azd ai finetuning jobs show -i <job-id>

暫停工作

azd ai finetuning jobs pause -i <job-id>

恢復一份工作

azd ai finetuning jobs resume -i <job-id>

取消工作

azd ai finetuning jobs cancel -i <job-id>

部署你精心調整的模型

當你的微調工作成功完成後，部署模型進行推論：

azd ai finetuning jobs deploy -i <job-id> -d "<deployment-name>" -c 100 -m "OpenAI" -s "GlobalStandard" -v "1"

快速參考

初始化參數

工作參數

其他資源

• 安裝Azure開發者CLI
• Azure 開發者 CLI 文件
• Microsoft Foundry 文件
• GitHub CLI
• Foundry 範例存放庫 - 微調 CLI 範例
• 傳送回饋