Finjustera AI-modeller i Microsoft Foundry med finjusteringstillägget Azure Developer CLI

I den här artikeln lär du dig att använda Azure Developer CLI (azd) AI-finjusteringstillägg för att konfigurera och köra finjusteringsjobb i Microsoft Foundry. Med tillägget kan du initiera projekt från mallar, skicka och hantera finjusteringsjobb och distribuera finjusterade modeller direkt från terminalen.

Förutsättningar

  • Azure Developer CLI (azd) installerat (version 1.22.1 eller senare) och autentiserat (azd auth login).
  • AI-tillägg för fininställning azd har installerats (azd ext install azure.ai.finetune). Mer information finns i Installera finjusteringstillägget .
  • En Azure-prenumeration med behörighet att skapa och hantera Microsoft Foundry-resurser.
  • (Valfritt) GitHub CLI installerat om du planerar att ladda ned exempelmallar från GitHub lagringsplatser.

Installera Azure Developer CLI

Installera azd för operativsystemet.

winget install microsoft.azd

Kontrollera installationen

När du har installerat kontrollerar du att det azd är installerat och uppfyller minimikravet för version:

azd version

Bekräfta att utdata visar version 1.22.1 eller senare. Om du behöver uppgradera kör du:

winget upgrade Microsoft.azd

Installera anpassningstillägget

Lägg till Azure AI-finjusteringstillägget i azd:

azd ext install azure.ai.finetune

Kontrollera att tillägget är installerat:

azd ext list

Autentisera

Logga in på Azure (krävs)

Autentisera med ditt Azure-konto för att få åtkomst till din prenumeration och dina resurser:

azd auth login

Initiera projektet

Använd azd ai finetuning init kommandot för att skapa ett finjusteringsprojekt. Gå till önskad arbetskatalog innan du kör någon av följande initieringsmetoder.

Tips

Du kan hoppa över initieringen helt med hjälp av alternativet Snabbinskickning, vilket gör att du kan skicka ett finjusteringsjobb genom att ange prenumerationen och Foundry-projektets slutpunkt direkt.

Hitta projektets ARM-resurs-ID

Om du vill initiera med ett Azure AI Foundry projekt behöver du projektets ARM-resurs-ID. Resurs-ID:t följer det här formatet:

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

Du hittar det här värdet i Azure-portalen genom att gå till AI Foundry-projektets Profile-sida under Projektinformation.

Alternativ 1: Projekt + Mall

Använd ett befintligt Azure AI Foundry projekt med en mall:

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

Exempel:

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}

Alternativ 2: Project + befintligt jobb

Klona konfigurationen från ett befintligt finjusteringsjobb:

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

Exempel:

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

Alternativ 3: Endast mall

Börja från en mall och konfigurera projektet senare:

azd ai finetuning init -t <template-url>

Exempel:

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

Alternativ 4: Klona från jobb

Klona konfigurationen från ett befintligt jobb-ID:

azd ai finetuning init -j <job-id>

Exempel:

azd ai finetuning init -j ftjob-4cad7de198a34baeb4f0c95ff01ac844

Alternativ 5: endast projektslutpunkt

Initiera med bara din Azure AI Foundry projektslutpunkt:

azd ai finetuning init -e <project-endpoint>

Exempel:

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

Alternativ 6: Interaktivt läge

Kör utan parametrar för guidade installationsprompter:

azd ai finetuning init

Alternativ 7: Minimal init (med prenumerationssökning)

Använd minimal initiering för en förenklad interaktiv upplevelse med prenumerationssökning:

azd init --minimal

Det här alternativet innehåller guidade uppmaningar om att välja din prenumeration och konfigurera din miljö.

Köra finjusteringskommandon

Navigera till projektmappen (där fine-tune-job.yaml finns) och använd följande kommandon för att hantera finjusteringsjobb.

Tips

Letar du efter YAML-exempelfiler för jobb? Kolla in finjustering CLI-exempel i Foundry-exempellagret.

Snabbinskickning (hoppa över initiering)

Du kan skicka ett jobb direkt utan att först köra azd init genom att ange prenumerationen och projektslutpunkten direkt:

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

Exempel:

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
Parameter Beskrivning
-f Sökväg till jobb-YAML-filen
-s Azure prenumerations-ID
-e Projektets ändpunktsadress

Skicka ett jobb

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

Lista jobb

azd ai finetuning jobs list

Visa jobbinformation

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

Pausa en arbetsuppgift

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

Återuppta ett jobb

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

Avbryt ett jobb

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

Distribuera din finjusterade modell

När finjusteringsjobbet har slutförts distribuerar du modellen för slutsatsdragning:

azd ai finetuning jobs deploy -i <job-id> -d "<deployment-name>" -c 100 -m "OpenAI" -s "GlobalStandard" -v "1"
Parameter Beskrivning
-i Jobb-ID
-d Distributionsnamn
-c Kapacitet
-m Modellprovider
-s SKU-namn
-v Version

Snabbreferens

Initieringsparametrar

Parameter Beskrivning
-p Projektresurs-ID (ARM)
-e Projektets ändpunktsadress
-t Mall-URL eller sökväg
-j Klona från jobb-ID
-w Arbetskatalog
-n Miljönamn
-s Prenumerations-ID

Jobbparametrar

Parameter Beskrivning
-f YAML-filsökväg
-i Jobb-ID

Ytterligare resurser