Vyladění modelů AI v Microsoft Foundry pomocí rozšíření Azure Developer CLI

V tomto článku se dozvíte, jak pomocí rozšíření Azure Developer CLI (azd) nastavit a spouštět úlohy jemného ladění v Microsoft Foundry. Rozšíření umožňuje inicializovat projekty ze šablon, odesílat a spravovat jemně vyladěné úlohy a nasazovat jemně vyladěné modely přímo z terminálu.

Požadavky

  • Nainstalované rozhraní příkazového řádku pro vývojáře Azure (azd) (verze 1.22.1 nebo novější) a ověřené (azd auth login).
  • Nainstalované azd rozšíření pro vyladění AI (azd ext install azure.ai.finetune). Podrobnosti najdete v tématu Instalace rozšíření pro vyladění .
  • Předplatné Azure s oprávněním k vytváření a správě prostředků Microsoft Foundry.
  • (Volitelné) Pokud plánujete stáhnout ukázkové šablony z GitHub úložišť, nainstalujte rozhraní příkazového řádku GitHub.

Instalace rozhraní příkazového řádku pro vývojáře Azure

Nainstalujte azd pro svůj operační systém.

winget install microsoft.azd

Ověření instalace

Po instalaci ověřte, že azd je nainstalovaná a splňuje požadavek na minimální verzi:

azd version

Ověřte, že výstup zobrazuje verzi 1.22.1 nebo novější. Pokud potřebujete upgradovat, spusťte:

winget upgrade Microsoft.azd

Nainstalujte rozšíření pro vyladění

Přidejte do azd rozšíření pro doladění Azure AI:

azd ext install azure.ai.finetune

Ověřte, že je rozšíření nainstalované:

azd ext list

Ověřování

Přihlášení k Azure (povinné)

Ověřte se pomocí účtu Azure pro přístup k předplatnému a prostředkům:

azd auth login

Inicializace projektu

Použijte příkaz azd ai finetuning init pro vytvoření základní struktury projektu pro jemné doladění. Před spuštěním některé z následujících inicializačních metod přejděte do požadovaného pracovního adresáře.

Tip

Inicializaci můžete zcela přeskočit pomocí možnosti Rychlé odeslání, která vám umožňuje odeslat úlohu pro jemné ladění jednoduše zadáním koncového bodu projektu předplatného a Foundry přímo v textu.

Najděte ID zdroje ARM projektu

K inicializaci pomocí Azure AI Foundry projektu potřebujete ID zdroje ARM projektu. ID prostředku se řídí tímto formátem:

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

Tuto hodnotu najdete na portálu Azure, když přejdete na stránku Profile vašeho projektu AI Foundry v části Podrobnosti projektu.

Možnost 1: Project + šablona

Použijte existující projekt Azure AI Foundry se šablonou:

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

Příklad:

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}

Možnost 2: Project + existující úloha

Naklonujte konfiguraci z existující úlohy jemného ladění.

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

Příklad:

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

Možnost 3: Pouze šablona

Začněte ze šablony a nakonfigurujte projekt později:

azd ai finetuning init -t <template-url>

Příklad:

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

Možnost 4: Klonování z jobu

Klonování konfigurace z existujícího ID úlohy:

azd ai finetuning init -j <job-id>

Příklad:

azd ai finetuning init -j ftjob-4cad7de198a34baeb4f0c95ff01ac844

Možnost 5: pouze projektový koncový bod

Inicializujte pouze pomocí koncového bodu projektu Azure AI Foundry:

azd ai finetuning init -e <project-endpoint>

Příklad:

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

Možnost 6: Interaktivní režim

Spusťte bez parametrů pro výzvy k instalaci s asistencí:

azd ai finetuning init

Možnost 7: Minimální inicializace (s vyhledáváním předplatného)

Použití minimální inicializace pro zjednodušené interaktivní prostředí s vyhledáváním předplatného:

azd init --minimal

Tato možnost obsahuje výzvy s asistencí k výběru předplatného a konfiguraci vašeho prostředí.

Spuštění příkazů pro vyladění

Přejděte do složky projektu (kde fine-tune-job.yaml se nachází) a pomocí následujících příkazů můžete spravovat úlohy jemného ladění.

Tip

Hledáte například soubory YAML úlohy? Podívejte se na ukázky rozhraní příkazového řádku pro jemné ladění v úložišti ukázek Foundry.

Rychlé odeslání (přeskočení inicializace)

Úlohu můžete odeslat přímo bez spuštění azd init, a to zadáním koncového bodu předplatného a projektu přímo ve výrazu:

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

Příklad:

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
Parametr Popis
-f Cesta k souboru YAML úlohy
-s ID předplatného Azure
-e adresa URL koncového bodu Project

Odeslání úlohy

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

Výpis úloh

azd ai finetuning jobs list

Zobrazit podrobnosti o úloze

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

Pozastavení úlohy

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

Obnovení úlohy

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

Zrušení úlohy

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

Nasadit váš jemně vyladěný model

Po úspěšném dokončení úlohy vyladění nasaďte model pro odvozování:

azd ai finetuning jobs deploy -i <job-id> -d "<deployment-name>" -c 100 -m "OpenAI" -s "GlobalStandard" -v "1"
Parametr Popis
-i ID úlohy
-d Název nasazení
-c Kapacita
-m Zprostředkovatel modelů
-s Název skladové položky
-v Verze

Stručná referenční dokumentace

Inicializační parametry

Parametr Popis
-p Identifikátor prostředku projektu (ARM)
-e adresa URL koncového bodu Project
-t Adresa URL nebo cesta šablony
-j Klon z ID úlohy
-w Pracovní adresář
-n Název prostředí
-s ID předplatného

Parametry úlohy

Parametr Popis
-f Cesta k souboru YAML
-i ID úlohy

Další zdroje informací

  • Last updated on