AI-modellen verfijnen in Microsoft Foundry met de Azure Developer CLI-extensie voor het afstemmen

In dit artikel leert u hoe u de Azure Developer CLI (azd) AI-verfijningsuitbreiding kunt gebruiken om verfijningsklussen in Microsoft Foundry in te stellen en uit te voeren. Met de extensie kunt u projecten initialiseren vanuit sjablonen, verfijningstaken verzenden en beheren en nauwkeurig afgestemde modellen rechtstreeks vanuit uw terminal implementeren.

Voorwaarden

  • De Azure Developer CLI (azd) geïnstalleerd (versie 1.22.1 of hoger) en geverifieerd (azd auth login).
  • De azd fijn-afstemmings-AI-extensie is geïnstalleerd (azd ext install azure.ai.finetune). Zie De afstemmende extensie installeren voor meer informatie.
  • Een Azure-abonnement met machtigingen voor het maken en beheren van Microsoft Foundry-resources.
  • (Optioneel) De GitHub CLI geïnstalleerd als u voorbeeldsjablonen uit GitHub opslagplaatsen wilt downloaden.

De Azure Developer CLI installeren

Installeer azd voor uw besturingssysteem.

winget install microsoft.azd

De installatie controleren

Controleer na de installatie of azd deze is geïnstalleerd en voldoet aan de minimale versievereiste:

azd version

Controleer of in de uitvoer versie 1.22.1 of hoger wordt weergegeven. Als u een upgrade wilt uitvoeren, voert u het volgende uit:

winget upgrade Microsoft.azd

Installeer de fijnregelings-extensie

Voeg de Azure AI-extensie voor het afstemmen toe aan azd:

azd ext install azure.ai.finetune

Controleer of de extensie is geïnstalleerd:

azd ext list

Verifiëren

Aanmelden bij Azure (vereist)

Verifieer met uw Azure-account voor toegang tot uw abonnement en resources:

azd auth login

Uw project initialiseren

Gebruik de azd ai finetuning init opdracht om een basisstructuur op te zetten voor een fijn-afstemmingsproject. Navigeer naar de gewenste werkmap voordat u een van de volgende initialisatiemethoden uitvoert.

Tip

U kunt initialisatie volledig overslaan door de optie Snel verzenden te gebruiken, waarmee u een fine-tuning taak kunt indienen door het abonnement en het Foundry project-eindpunt inline op te geven.

Uw ARM-resource-id voor uw project zoeken

Als u wilt initialiseren met een Azure AI Foundry project, hebt u de ARM-resource-id van het project nodig. De resource-id volgt deze indeling:

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

U vindt deze waarde in de Azure-portal door te navigeren naar de pagina Profile van uw AI Foundry-project onder Project details.

Optie 1: Project + sjabloon

Gebruik een bestaand Azure AI Foundry-project met een sjabloon:

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

Voorbeeld:

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}

Optie 2: Project + bestaande taak

Kopieer de configuratie van een bestaande fine-tuning taak.

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

Voorbeeld:

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

Optie 3: alleen sjabloon

Begin met een sjabloon en configureer het project later:

azd ai finetuning init -t <template-url>

Voorbeeld:

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

Optie 4: Klonen vanuit een job

Configuratie klonen van een bestaande taak-id:

azd ai finetuning init -j <job-id>

Voorbeeld:

azd ai finetuning init -j ftjob-4cad7de198a34baeb4f0c95ff01ac844

Optie 5: alleen projecteindpunt

Initialiseer met alleen uw Azure AI Foundry projecteindpunt:

azd ai finetuning init -e <project-endpoint>

Voorbeeld:

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

Optie 6: Interactieve modus

Uitvoeren zonder parameters voor begeleide installatieprompts:

azd ai finetuning init

Optie 7: Minimale initialisatie (met abonnement look-up)

Gebruik minimale initialisatie voor een vereenvoudigde interactieve ervaring met het opzoeken van abonnementen:

azd init --minimal

Deze optie biedt begeleide aanwijzingen om uw abonnement te selecteren en uw omgeving te configureren.

Opdrachten voor afstemmen uitvoeren

Navigeer naar uw projectmap (waar fine-tune-job.yaml zich bevindt) en gebruik de volgende opdrachten om afstemmingswerkzaamheden te beheren.

Tip

Zoekt u voorbeeld YAML-bestanden voor taakconfiguraties? Bekijk de Afstemmen van CLI-voorbeelden in de Foundry-voorbeeldopslagplaats.

Snel verzenden (initialisatie overslaan)

U kunt een job direct indienen zonder eerst azd init uit te voeren, door het abonnement en het projecteindpunt inline op te geven.

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

Voorbeeld:

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 Beschrijving
-f Pad naar het YAML-bestand van de taak
-s Azure-abonnements-id
-e Project-eindpunt-URL

Een taak verzenden

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

Banen weergeven

azd ai finetuning jobs list

Taakdetails weergeven

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

Een taak onderbreken

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

Een taak hervatten

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

Een taak annuleren

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

Uw nauwkeurig afgestemde model implementeren

Zodra de fijn afstemmingstaak succesvol is voltooid, implementeert u het model voor inferentie:

azd ai finetuning jobs deploy -i <job-id> -d "<deployment-name>" -c 100 -m "OpenAI" -s "GlobalStandard" -v "1"
Parameter Beschrijving
-i Job-ID
-d Implementatienaam
-c Capaciteit
-m Modelaanbieder
-s SKU-naam
-v Versie

Snelzoekgids

Initparameters

Parameter Beschrijving
-p Project resource-ID (ARM)
-e Project-eindpunt-URL
-t Sjabloon-URL of pad
-j Klonen vanuit taak-id
-w Werkmap
-n Omgevingsnaam
-s Abonnements-id

Taakparameters

Parameter Beschrijving
-f YAML-bestandspad
-i Job-ID

Aanvullende informatiebronnen