Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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
azdfijn-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.
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 |