Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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
azdhar 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.
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 |