Schema YAML del componente della pipeline dell'interfaccia della riga di comando (v2)
SI APPLICA A: estensione ML dell'interfaccia della riga di comando di Azure v2 (corrente)
Lo schema JSON di origine è disponibile in https://azuremlschemas.azureedge.net/latest/pipelineComponent.schema.json.
Nota
La sintassi YAML descritta in dettaglio in questo documento si basa sullo schema JSON per la versione più recente dell'estensione dell'interfaccia della riga di comando di Machine Learning v2. Il funzionamento di questa sintassi è garantito solo con la versione più recente dell'estensione dell'interfaccia della riga di comando di Machine Learning v2. È possibile trovare gli schemi per le versioni di estensione precedenti in https://azuremlschemasprod.azureedge.net/.
Sintassi YAML
Chiave | Type | Descrizione | Valori consentiti | Valore predefinito |
---|---|---|---|---|
$schema |
string | Schema YAML. Se si usa l'estensione Azure Machine Learning per Visual Studio Code per creare il file YAML, l'inclusione di $schema nella parte superiore del file consente di richiamare i completamenti dello schema e delle risorse. |
||
type |
const | Tipo di componente. | pipeline |
pipeline |
name |
string | Obbligatorio. Nome del componente. Deve iniziare con una lettera minuscola. I caratteri consentiti sono lettere minuscole, numeri e caratteri di sottolineatura(_). La lunghezza massima consentita è di 255 caratteri. | ||
version |
string | Versione del componente. Se omesso, Azure Machine Learning genera automaticamente una versione. | ||
display_name |
string | Nome visualizzato del componente nell'interfaccia utente di Studio. Può essere non univoco all'interno dell'area di lavoro. | ||
description |
string | Descrizione del componente. | ||
tags |
oggetto | Dizionario dei tag per il componente. | ||
jobs |
oggetto | Obbligatorio. Dizionario del set di singoli processi da eseguire come passaggi all'interno della pipeline. Questi processi sono considerati processi figlio del processo padre della pipeline. La chiave è il nome del passaggio all'interno del contesto del processo della pipeline. Questo nome è diverso dal nome univoco del processo figlio. Il valore è la specifica del processo, che può seguire lo schema del processo di comando o lo schema del processo sweep. Attualmente solo i processi di comando e i processi sweep possono essere eseguiti in una pipeline. |
||
inputs |
oggetto | Dizionario di input per il processo della pipeline. La chiave è un nome per l'input nel contesto del processo e il valore è il valore di input. Questi input della pipeline possono essere a cui fanno riferimento gli input di un singolo processo di passaggio nella pipeline usando l'espressione ${{ parent.inputs.<input_name> }} . Per altre informazioni su come associare gli input di un passaggio della pipeline agli input del processo della pipeline di primo livello, vedere la sintassi dell'espressione per l'associazione di input e output tra i passaggi di un processo della pipeline. |
||
inputs.<input_name> |
number, integer, boolean, string or object | Uno di un valore letterale (di tipo number, integer, boolean o string) o di un oggetto contenente una specifica dei dati di input del componente. | ||
outputs |
oggetto | Dizionario delle configurazioni di output del processo della pipeline. La chiave è un nome per l'output nel contesto del processo e il valore è la configurazione di output. Questi output della pipeline possono essere a cui fanno riferimento gli output di un singolo processo di passaggio nella pipeline usando l'espressione ${{ parents.outputs.<output_name> }} . Per altre informazioni su come associare gli input di un passaggio della pipeline agli input del processo della pipeline di primo livello, vedere la sintassi dell'espressione per l'associazione di input e output tra i passaggi di un processo della pipeline. |
||
outputs.<output_name> |
oggetto | È possibile lasciare vuoto l'oggetto, nel qual caso per impostazione predefinita l'output sarà di tipo uri_folder e Azure Machine Learning genererà un percorso di output per l'output in base al percorso del modello seguente: {settings.datastore}/azureml/{job-name}/{output-name}/ . I file nella directory di output verranno scritti tramite montaggio in lettura/scrittura. Se si desidera specificare una modalità diversa per l'output, specificare un oggetto contenente la specifica di output del componente. |
Input del componente
Chiave | Type | Descrizione | Valori consentiti | Valore predefinito |
---|---|---|---|---|
type |
string | Obbligatorio. Tipo di input del componente. Altre informazioni sull'accesso ai dati | number , integer , boolean , string , uri_file uri_folder , mltable , , mlflow_model custom_model |
|
description |
string | Descrizione dell'input. | ||
default |
number, integer, boolean o string | Valore predefinito per l'input. | ||
optional |
boolean | Indica se l'input è obbligatorio. Se è impostato su true , è necessario usare il comando include input facoltativi con $[[]] |
false |
|
min |
integer o numero | Valore minimo accettato per l'input. Questo campo può essere specificato solo se type il campo è number o integer . |
||
max |
integer o numero | Valore massimo accettato per l'input. Questo campo può essere specificato solo se type il campo è number o integer . |
||
enum |
array | Elenco di valori consentiti per l'input. Applicabile solo se type il campo è string . |
Output del componente
Chiave | Type | Descrizione | Valori consentiti | Valore predefinito |
---|---|---|---|---|
type |
string | Obbligatorio. Tipo di output del componente. | uri_file , uri_folder , mltable , mlflow_model custom_model |
|
description |
string | Descrizione dell'output. |
Osservazioni:
I az ml component
comandi possono essere usati per la gestione dei componenti di Azure Machine Learning.
Esempi
Gli esempi sono disponibili nel repository GitHub di esempi.