YAML-syntaxen som beskrivs i det här dokumentet baseras på JSON-schemat för den senaste versionen av ML CLI v2-tillägget. Den här syntaxen är garanterad att endast fungera med den senaste versionen av ML CLI v2-tillägget.
Du hittar scheman för äldre tilläggsversioner på https://azuremlschemasprod.azureedge.net/.
YAML-syntax
Nyckel
Typ
Beskrivning
Tillåtna värden
Standardvärde
$schema
sträng
YAML-schemat. Om du använder Tillägget Azure Mašinsko učenje VS Code för att skapa YAML-filen kan du anropa schema- och resursslutningar om du tar med $schema längst upp i filen.
type
Const
Obligatoriskt. Typen av jobb.
sweep
sweep
name
sträng
Namnet på jobbet. Måste vara unikt för alla jobb på arbetsytan. Om det utelämnas skapar Azure Mašinsko učenje automatiskt ett GUID för namnet.
display_name
sträng
Visningsnamn för jobbet i studiogränssnittet. Kan vara icke-unik på arbetsytan. Om det utelämnas skapar Azure Mašinsko učenje automatiskt en adjektiv-substantividentifierare som kan läsas av människor för visningsnamnet.
experiment_name
sträng
Organisera jobbet under experimentnamnet. Körningsposten för varje jobb ordnas under motsvarande experiment på fliken Experiment i studion. Om det utelämnas experiment_name är Azure Mašinsko učenje som standard namnet på arbetskatalogen där jobbet skapades.
Obligatoriskt. Ordlista för hyperparameterns sökutrymme. Hyperparameternamnet är nyckeln och värdet är parameteruttrycket.
Hyperparametrar kan refereras i trial.command med - ${{ search_space.<hyperparameter> }} uttrycket.
search_space.<hyperparameter>
objekt
Gå till Parameteruttryck för den uppsättning möjliga uttryck som ska användas.
objective.primary_metric
sträng
Obligatoriskt. Namnet på det primära mått som rapporteras av varje utvärderingsjobb. Måttet måste loggas i användarens träningsskript med mlflow.log_metric() samma motsvarande måttnamn.
objective.goal
sträng
Obligatoriskt. Optimeringsmålet för objective.primary_metric.
maximize, minimize
early_termination
objekt
Principen för tidig uppsägning som ska användas. Ett utvärderingsjobb avbryts när kriterierna för den angivna principen uppfylls. Om det utelämnas tillämpas ingen princip för förtidsavslut. En av BanditPolicy, MedianStoppingPolicy eller TruncationSelectionPolicy.
Obligatoriskt. Namnet på beräkningsmålet som jobbet ska köras på med syntaxen azureml:<compute_name> .
trial
objekt
Obligatoriskt. Jobbmallen för varje utvärderingsversion. Varje utvärderingsjobb har en annan kombination av hyperparametervärden som systemexemplen från search_space. Gå till Attribut för trial nyckeln.
inputs
objekt
Ordlista över indata till jobbet. Nyckeln är ett namn på indata i jobbets kontext och värdet är indatavärdet.
Indata kan refereras i command med uttrycket ${{ inputs.<input_name> }} .
inputs.<input_name>
tal, heltal, booleskt värde, sträng eller objekt
Ett av ett literalvärde (av typnummer, heltal, booleskt värde eller sträng) eller ett objekt som innehåller en dataspecifikation för jobbindata.
outputs
objekt
Ordlista över utdatakonfigurationer för jobbet. Nyckeln är ett namn på utdata i jobbets kontext och värdet är utdatakonfigurationen.
Utdata kan refereras i command med uttrycket ${{ outputs.<output_name> }} .
outputs.<output_name>
objekt
Du kan lämna objektet tomt, och i så fall är utdata som standard av uri_folder typen och Azure Mašinsko učenje system genererar en utdataplats för utdata. Alla filer till utdatakatalogen skrivs via läs- och skrivmontering. Om du vill ange ett annat läge för utdata anger du ett objekt som innehåller jobbutdataspecifikationen.
identity
objekt
Identiteten används för dataåtkomst. Det kan vara konfiguration av användaridentitet, konfiguration av hanterad identitet eller Ingen. För UserIdentityConfiguration används identiteten för jobbinskickare för att komma åt indata och skriva resultat till utdatamappen. Annars används den hanterade identiteten för beräkningsmålet.
Samplingsalgoritmer
RandomSamplingAlgorithm
Nyckel
Typ
Beskrivning
Tillåtna värden
Standardvärde
type
Const
Obligatoriskt. Typ av samplingsalgoritm.
random
seed
integer
Ett slumpmässigt frö som ska användas för att initiera slumptalsgenereringen. Om det utelämnas är standardvärdet för startvärde null.
rule
sträng
Vilken typ av slumpmässig sampling som ska användas. Standardvärdet, random, använder enkel enhetlig slumpmässig sampling, medan sobol sobol kvasi-slumpmässig sekvens används.
random, sobol
random
GridSamplingAlgorithm
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Typ av samplingsalgoritm.
grid
BayesianSamplingAlgorithm
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Typ av samplingsalgoritm.
bayesian
Principer för tidig uppsägning
BanditPolicy
Nyckel
Typ
Beskrivning
Tillåtna värden
Standardvärde
type
Const
Obligatoriskt. Policytypen.
bandit
slack_factor
Nummer
Förhållandet som används för att beräkna det tillåtna avståndet från den bästa utvärderingsversionen. En av slack_factor eller slack_amount krävs.
slack_amount
Nummer
Det absoluta avståndet som tillåts från utvärderingsversionen med bäst resultat. En av slack_factor eller slack_amount krävs.
evaluation_interval
integer
Frekvensen för att tillämpa principen.
1
delay_evaluation
integer
Antalet intervall som den första principutvärderingen ska fördröjas för. Om det anges gäller principen för varje multipel av evaluation_interval som är större än eller lika med delay_evaluation.
0
MedianStoppingPolicy
Nyckel
Typ
Beskrivning
Tillåtna värden
Standardvärde
type
Const
Obligatoriskt. Policytypen.
median_stopping
evaluation_interval
integer
Frekvensen för att tillämpa principen.
1
delay_evaluation
integer
Antalet intervall som den första principutvärderingen ska fördröjas för. Om det anges gäller principen för varje multipel av evaluation_interval som är större än eller lika med delay_evaluation.
0
TruncationSelectionPolicy
Nyckel
Typ
Beskrivning
Tillåtna värden
Standardvärde
type
Const
Obligatoriskt. Policytypen.
truncation_selection
truncation_percentage
integer
Obligatoriskt. Procentandelen utvärderingsjobb som ska avbrytas vid varje utvärderingsintervall.
evaluation_interval
integer
Frekvensen för att tillämpa principen.
1
delay_evaluation
integer
Antalet intervall som den första principutvärderingen ska fördröjas för. Om det anges gäller principen för varje multipel av evaluation_interval som är större än eller lika med delay_evaluation.
0
Parameteruttryck
Alternativ
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Uttryckstypen.
choice
values
matris
Obligatoriskt. Listan med diskreta värden som du vill välja mellan.
Randint
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Uttryckstypen.
randint
upper
integer
Obligatoriskt. Den exklusiva övre gränsen för heltalsintervallet.
Qlognormal, qnormal
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Uttryckstypen.
qlognormal, qnormal
mu
Nummer
Obligatoriskt. Medelvärdet av den normala fördelningen.
sigma
Nummer
Obligatoriskt. Standardavvikelsen för den normala fördelningen.
q
integer
Obligatoriskt. Utjämningsfaktorn.
Qloguniform, quniform
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Uttryckstypen.
qloguniform, quniform
min_value
Nummer
Obligatoriskt. Minimivärdet i intervallet (inklusive).
max_value
Nummer
Obligatoriskt. Det maximala värdet i intervallet (inklusive).
q
integer
Obligatoriskt. Utjämningsfaktorn.
Lognormal, normal
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Uttryckstypen.
lognormal, normal
mu
Nummer
Obligatoriskt. Medelvärdet av den normala fördelningen.
sigma
Nummer
Obligatoriskt. Standardavvikelsen för den normala fördelningen.
Loguniform
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Uttryckstypen.
loguniform
min_value
Nummer
Obligatoriskt. Minimivärdet i intervallet är exp(min_value) (inkluderande).
max_value
Nummer
Obligatoriskt. Det maximala värdet i intervallet är exp(max_value) (inkluderande).
Uniform
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Uttryckstypen.
uniform
min_value
Nummer
Obligatoriskt. Minimivärdet i intervallet (inklusive).
max_value
Nummer
Obligatoriskt. Det maximala värdet i intervallet (inklusive).
Attribut för limits nyckeln
Nyckel
Typ
Beskrivning
Standardvärde
max_total_trials
integer
Det maximala antalet utvärderingsjobb.
1000
max_concurrent_trials
integer
Det maximala antalet utvärderingsjobb som kan köras samtidigt.
Standardvärdet är max_total_trials.
timeout
integer
Den maximala tiden i sekunder som hela svepjobbet tillåts att köras. När den här gränsen har nåtts avbryter systemet svepjobbet, inklusive alla utvärderingsversioner.
5184000
trial_timeout
integer
Den maximala tiden i sekunder som varje utvärderingsjobb tillåts köras. När den här gränsen har nåtts avbryter systemet utvärderingsversionen.
Attribut för trial nyckeln
Nyckel
Typ
Beskrivning
Standardvärde
command
sträng
Obligatoriskt. Kommandot som ska köras.
code
sträng
Lokal sökväg till källkodskatalogen som ska laddas upp och användas för jobbet.
environment
sträng eller objekt
Obligatoriskt. Miljön som ska användas för jobbet. Det här värdet kan antingen vara en referens till en befintlig version av miljön på arbetsytan eller en infogad miljöspecifikation.
Om du vill referera till en befintlig miljö använder du syntaxen azureml:<environment-name>:<environment-version> .
Om du vill definiera en infogad miljö följer du miljöschemat. name Exkludera egenskaperna och version eftersom infogade miljöer inte stöder dem.
environment_variables
objekt
Ordlista med miljövariabelns namn/värde-par som ska anges i processen där kommandot körs.
Obligatoriskt. Antalet processer per nod som ska startas för jobbet.
PyTorchConfiguration
Nyckel
Typ
Beskrivning
Tillåtna värden
Standardvärde
type
Const
Obligatoriskt. Distributionstyp.
pytorch
process_count_per_instance
integer
Antalet processer per nod som ska startas för jobbet.
1
TensorFlowConfiguration
Nyckel
Typ
Beskrivning
Tillåtna värden
Standardvärde
type
Const
Obligatoriskt. Distributionstyp.
tensorflow
worker_count
integer
Antalet arbetare som ska startas för jobbet.
Standardvärdet är resources.instance_count.
parameter_server_count
integer
Antalet parameterservrar som ska startas för jobbet.
0
Jobbindata
Nyckel
Typ
Beskrivning
Tillåtna värden
Standardvärde
type
sträng
Typ av jobbindata. Ange uri_file för indata som pekar på en enda filkälla eller uri_folder för indata som pekar på en mappkälla. Mer information finns i Läs mer om dataåtkomst.
uri_file, uri_folder, , mltablemlflow_model
uri_folder
path
sträng
Sökvägen till de data som ska användas som indata. Det här värdet kan anges på några sätt:
– En lokal sökväg till datakällans fil eller mapp, till exempel path: ./iris.csv. Data överförs under jobböverföringen.
– En URI för en molnsökväg till filen eller mappen som ska användas som indata. URI-typer som stöds är azureml, https, wasbs, abfss, adl. Mer information om hur du använder azureml:// URI-formatet finns i Core yaml-syntax.
– En befintlig registrerad Azure-Mašinsko učenje datatillgång som ska användas som indata. Om du vill referera till en registrerad datatillgång använder du syntaxen azureml:<data_name>:<data_version> eller azureml:<data_name>@latest (för att referera till den senaste versionen av den datatillgången) – till exempel path: azureml:cifar10-data:1 eller path: azureml:cifar10-data@latest.
mode
sträng
Läge för hur data ska levereras till beräkningsmålet.
För skrivskyddad montering (ro_mount) används data som en monteringssökväg. En mapp monteras som en mapp och en fil monteras som en fil. Azure Mašinsko učenje löser indata till monteringssökvägen.
För download läge laddas data ned till beräkningsmålet. Azure Mašinsko učenje löser indata till den nedladdade sökvägen.
För bara URL:en för lagringsplatsen för dataartefakten eller artefakterna använder direct du läget i stället för att montera eller ladda ned själva data. Detta skickar in URL:en för lagringsplatsen som jobbindata. I det här fallet är du helt ansvarig för att hantera autentiseringsuppgifter för att få åtkomst till lagringen.
ro_mount, , downloaddirect
ro_mount
Jobbutdata
Nyckel
Typ
Beskrivning
Tillåtna värden
Standardvärde
type
sträng
Jobbutdatatypen. För standardtypen uri_folder motsvarar utdata en mapp.
uri_file, uri_folder, , mltablemlflow_model
uri_folder
mode
sträng
Läge för leverans av utdatafilen eller filerna till mållagringen. För skrivskyddat monteringsläge (rw_mount) är utdatakatalogen en monterad katalog. För uppladdningsläget laddas alla filer som skrivs upp i slutet av jobbet.
rw_mount, upload
rw_mount
Identitetskonfigurationer
UserIdentityConfiguration
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Identitetstyp.
user_identity
ManagedIdentityConfiguration
Nyckel
Typ
Beskrivning
Tillåtna värden
type
Const
Obligatoriskt. Identitetstyp.
managed eller managed_identity
Kommentarer
Du kan använda az ml job kommandot för att hantera Azure Mašinsko učenje-jobb.
Exempel
Gå till exempel GitHub-lagringsplatsen i exemplen. Flera visas här:
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.