core Pacchetto

Contiene pacchetti di base, moduli e classi per Azure Machine Learning.

Le principali aree includono la gestione delle destinazioni di calcolo, la creazione/gestione di aree di lavoro e esperimenti e l'invio/accesso alle esecuzioni del modello e l'esecuzione di output/registrazione.

Pacchetti

compute	Questo pacchetto contiene classi usate per gestire le destinazioni di calcolo in Azure Machine Learning. Per altre informazioni sulla scelta delle destinazioni di calcolo per il training e la distribuzione, vedere Quali sono le destinazioni di calcolo in Azure Machine Learning?
image	Contiene funzionalità per la gestione delle immagini distribuite come endpoint di servizio Web in Azure Machine Learning. Questa classe è DEPRECATA. Utilizzare invece la classe Environment. Un'immagine viene usata per distribuire un Modelfile , script e file associati come endpoint del servizio Web o IoT Edge dispositivo. L'endpoint gestisce le richieste di assegnazione dei punteggi in ingresso e restituisce stime. Le classi chiave del pacchetto sono la Image classe, la classe padre delle immagini di Azure Machine Learning e la classe derivata ContainerImage per Le immagini Docker e le immagini di anteprima come FPGA. A meno che non si abbia un flusso di lavoro che richiede in modo specifico l'uso delle immagini, è consigliabile usare la classe per definire l'immagine Environment . È quindi possibile usare l'oggetto Environment con il metodo per distribuire il Modeldeploy() modello come servizio Web. È anche possibile usare il metodo Model package() per creare un'immagine che può essere scaricata nell'installazione docker locale come immagine o come Dockerfile. Per informazioni sull'uso della classe Model, vedere Distribuire modelli con Azure Machine Learning. Per informazioni sull'uso di immagini personalizzate, vedere Distribuire un modello usando un'immagine di base Docker personalizzata.
webservice	Contiene funzionalità per la distribuzione di modelli di Machine Learning come endpoint di servizio Web in Azure Machine Learning. La distribuzione di un modello di Azure Machine Learning come servizio Web crea un endpoint e un'API REST. È possibile inviare dati a questa API per ottenere la stima restituita dal modello. Si crea un servizio Web quando si distribuisce o ModelImage in Istanze di Azure Container (aci modulo), servizio Azure Kubernetesaks ( modulo) e endpoint di Azure Kubernetes (AksEndpoint) o array di gate programmabili da campo (FPGA). La distribuzione con un modello è consigliata per la maggior parte dei casi d'uso, mentre la distribuzione usando un'immagine è consigliata per i casi d'uso avanzati. Entrambi i tipi di distribuzione sono supportati nelle classi di questo modulo.

Moduli

authentication	Contiene funzionalità per la gestione di diversi tipi di autenticazione in Azure Machine Learning. Tipi di autenticazione supportati: Accesso interattivo: modalità predefinita quando si usa Azure Machine Learning SDK. Usa una finestra di dialogo interattiva. Interfaccia della riga di comando di Azure: per l'uso con il pacchetto dell'interfaccia della riga di comando di Azure . Entità servizio: per l'uso con flussi di lavoro automatizzati di Machine Learning. MSI: per l'uso con asset abilitati per l'identità del servizio gestito, ad esempio con una macchina virtuale di Azure. Token di Azure ML: usato per l'acquisizione di token di Azure ML solo per le esecuzioni inviate. Per altre informazioni su questi meccanismi di autenticazione, vedere https://aka.ms/aml-notebook-auth.
compute_target	Contiene funzionalità per le destinazioni di calcolo non gestite da Azure Machine Learning. Le destinazioni di calcolo definiscono l'ambiente di calcolo di training e possono essere risorse locali o remote nel cloud. Le risorse remote consentono di aumentare o aumentare facilmente la scalabilità della sperimentazione di Machine Learning sfruttando le funzionalità di elaborazione della CPU e della GPU accelerate. Per informazioni sulle destinazioni di calcolo gestite da Azure Machine Learning, vedere la ComputeTarget classe . Per altre informazioni, vedere Informazioni sulle destinazioni di calcolo in Azure Machine Learning?
conda_dependencies	Contiene funzionalità per la gestione delle dipendenze dell'ambiente conda. Usare la CondaDependencies classe per caricare i file di ambiente conda esistenti e configurare e gestire nuovi ambienti in cui vengono eseguiti gli esperimenti.
container_registry	Contiene funzionalità per la gestione di un Registro Azure Container.
databricks	Contiene funzionalità per la gestione degli ambienti Di Databricks in Azure Machine Learning. Per altre informazioni sull'uso di Databricks in Azure Machine Learning, vedere Configurare un ambiente di sviluppo per Azure Machine Learning.
dataset	Gestisce l'interazione con i set di dati di Azure Machine Learning. Questo modulo offre funzionalità per l'utilizzo di dati non elaborati, la gestione dei dati e l'esecuzione di azioni sui dati in Azure Machine Learning. Usare la Dataset classe in questo modulo per creare set di dati insieme alla funzionalità nel data pacchetto, che contiene le classi FileDataset di supporto e TabularDataset. Per iniziare a usare i set di dati, vedere l'articolo Aggiungere set di dati di registrazione &.
datastore	Contiene funzionalità per la gestione degli archivi dati in Azure Machine Learning.
environment	Contiene funzionalità per la creazione e la gestione di ambienti riproducibili in Azure Machine Learning. Gli ambienti offrono un modo per gestire le dipendenze software in modo che gli ambienti controllati siano riproducibili con una configurazione manuale minima durante lo spostamento tra ambienti di sviluppo cloud locali e distribuiti. Un ambiente incapsula pacchetti Python, variabili di ambiente, impostazioni software per script di training e assegnazione dei punteggi e tempi di esecuzione in Python, Spark o Docker. Per altre informazioni sull'uso degli ambienti per il training e la distribuzione con Azure Machine Learning, vedere Creare e gestire ambienti riutilizzabili.
experiment	Contiene funzionalità usate per inviare esperimenti e gestire la cronologia degli esperimenti in Azure Machine Learning.
keyvault	Contiene funzionalità per la gestione dei segreti nella Key Vault associata a un'area di lavoro di Azure Machine Learning. Questo modulo contiene metodi pratici per l'aggiunta, il recupero, l'eliminazione e l'elenco dei segreti dal Key Vault di Azure associato a un'area di lavoro.
linked_service	Contiene funzionalità per la creazione e la gestione del servizio collegato nell'area di lavoro AML.
model	Contiene funzionalità per la gestione dei modelli di Machine Learning in Azure Machine Learning. Con la Model classe è possibile eseguire le attività principali seguenti: registrare il modello con un'area di lavoro profilare il modello per comprendere i requisiti di distribuzione creare un pacchetto del modello da usare con Docker distribuire il modello in un endpoint di inferenza come servizio Web Per altre informazioni su come vengono usati i modelli, vedere Funzionamento di Azure Machine Learning: Architettura e concetti.
private_endpoint	Contiene funzionalità per la definizione e la configurazione di EndPoint privati di Azure.
profile	Contiene funzionalità per i modelli di profilatura in Azure Machine Learning.
resource_configuration	Contiene funzionalità per la gestione della configurazione delle risorse per le entità di Azure Machine Learning.
run	Contiene funzionalità per la gestione delle metriche e degli artefatti dell'esperimento in Azure Machine Learning.
runconfig	Contiene funzionalità per la gestione della configurazione dell'esecuzione dell'esperimento in Azure Machine Learning. La classe chiave in questo modulo è RunConfiguration, che incapsula le informazioni necessarie per inviare un'esecuzione di training in una destinazione di calcolo specificata. La configurazione include un'ampia serie di definizioni di comportamento, ad esempio se usare un ambiente Python esistente oppure un ambiente Conda compilato a partire da una specifica. Altre classi di configurazione nel modulo sono accessibili tramite RunConfiguration.
script_run	Contiene funzionalità per la gestione delle esecuzioni di training inviate in Azure Machine Learning.
script_run_config	Contiene funzionalità per gestire la configurazione per l'invio di esecuzioni di training in Azure Machine Learning.
util	Contiene la classe per specificare il livello di dettaglio della registrazione.
workspace	Contiene funzionalità per la gestione di un'area di lavoro, la risorsa di primo livello in Azure Machine Learning. Questo modulo contiene la classe e i Workspace relativi metodi e attributi che consentono di gestire elementi di Machine Learning come destinazioni di calcolo, ambienti, archivi dati, esperimenti e modelli. Un'area di lavoro è associata a una sottoscrizione di Azure e a un gruppo di risorse ed è il mezzo principale per la fatturazione. Le aree di lavoro supportano azure Resource Manager controllo degli accessi in base al ruolo e l'affinità dell'area per tutti i dati di Machine Learning salvati nell'area di lavoro.

Classi

ComputeTarget	Classe padre astratta per tutte le destinazioni di calcolo gestite da Azure Machine Learning. Una destinazione di calcolo è un ambiente o una risorsa di calcolo designata in cui si esegue lo script di training o si ospita la distribuzione del servizio. Questo percorso può essere il computer locale o una risorsa di calcolo basata sul cloud. Per altre informazioni, vedere Informazioni sulle destinazioni di calcolo in Azure Machine Learning? Costruttore ComputeTarget di classe. Recuperare una rappresentazione cloud di un oggetto Compute associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Compute recuperato.
ContainerRegistry	Definisce una connessione a un Registro Azure Container. Costruttore Class ContainerRegistry.
Dataset	Rappresenta una risorsa per esplorare, trasformare e gestire i dati in Azure Machine Learning. Un set di dati è un riferimento ai dati in un Datastore url Web pubblico o dietro. Per i metodi deprecati in questa classe, controllare AbstractDataset la classe per le API migliorate. Sono supportati i tipi di set di dati seguenti: TabularDataset rappresenta i dati in formato di tabella creati analizzando il file o l'elenco di file fornito. FileDataset fa riferimento a uno o più file in archivi dati o di URL pubblici. Per iniziare a usare i set di dati, vedere l'articolo Aggiungere set di dati di registrazione & oppure vedere i notebook https://aka.ms/tabulardataset-samplenotebook e https://aka.ms/filedataset-samplenotebook. Inizializzare l'oggetto Dataset. Per ottenere un set di dati già registrato con l'area di lavoro, usare il metodo get.
Datastore	Rappresenta un'astrazione dell'archiviazione su un account di archiviazione di Azure Machine Learning. Gli archivi dati sono collegati alle aree di lavoro e vengono usati per archiviare le informazioni di connessione ai servizi di archiviazione di Azure in modo da poterli fare riferimento in base al nome e non è necessario ricordare le informazioni di connessione e il segreto usati per connettersi ai servizi di archiviazione. Esempi di servizi di archiviazione di Azure supportati che possono essere registrati come archivi dati sono: Contenitore BLOB di Azure Condivisione file di Azure Azure Data Lake Azure Data Lake Gen2 Database SQL di Azure Database di Azure per PostgreSQL File system di Databricks Database di Azure per MySQL Usare questa classe per eseguire operazioni di gestione, tra cui registrare, elencare, ottenere e rimuovere archivi dati. Gli archivi dati per ogni servizio vengono creati con i register* metodi di questa classe. Quando si usa un archivio dati per accedere ai dati, è necessario disporre dell'autorizzazione per accedere ai dati, che dipendono dalle credenziali registrate con l'archivio dati. Per altre informazioni sugli archivi dati e su come possono essere usati in Machine Learning, vedere gli articoli seguenti: Accedere ai dati nei servizi di archiviazione di Azure Eseguire il training di modelli con Azure Machine Learning usando l'oggetto Estimator Creare ed eseguire pipeline di Machine Learning Ottenere un archivio dati in base al nome. Questa chiamata eseguirà una richiesta al servizio di archiviazione dati.
Environment	Configura un ambiente Python riproducibile per gli esperimenti di Machine Learning. Un ambiente definisce pacchetti Python, variabili di ambiente e impostazioni Docker usate negli esperimenti di Machine Learning, inclusi la preparazione dei dati, il training e la distribuzione in un servizio Web. Un ambiente è gestito e con versione in un Azure Machine Learning Workspace. È possibile aggiornare un ambiente esistente e recuperare una versione da riutilizzare. Gli ambienti sono esclusivi dell'area di lavoro in cui vengono creati e non possono essere usati in aree di lavoro diverse. Per altre informazioni sugli ambienti, vedere Creare e gestire ambienti riutilizzabili. Costruttore Ambiente di classe.
Experiment	Rappresenta il punto di ingresso principale per la creazione e l'uso di esperimenti in Azure Machine Learning. Un esperimento è un contenitore di versioni di valutazione che rappresentano più esecuzioni di modelli. Costruttore dell'esperimento.
Image	Definisce la classe padre astratta per Le immagini di Azure Machine Learning. Questa classe è DEPRECATA. Utilizzare invece la classe Environment. Costruttore di immagini. Questa classe è DEPRECATA. Utilizzare invece la classe Environment. Il costruttore di immagini viene usato per recuperare una rappresentazione cloud di un oggetto Image associato all'area di lavoro specificata. Restituirà un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Image recuperato.
Keyvault	Gestisce i segreti archiviati nell'Key Vault di Azure associato a un'area di lavoro di Azure Machine Learning. Ogni area di lavoro di Azure Machine Learning ha un Key Vault di Azure associato. La classe Keyvault è un wrapper semplificato della Key Vault di Azure che consente di gestire i segreti nell'insieme di credenziali delle chiavi, inclusi l'impostazione, il recupero, l'eliminazione e l'inserimento di segreti. Usare la classe Keyvault per passare i segreti alle esecuzioni remote in modo sicuro senza esporre informazioni riservate in testo chiaro. Per altre informazioni, vedere Uso dei segreti nelle esecuzioni di training. Costruttore Keyvault della classe.
LinkedService	Nota Si tratta di una classe sperimentale e può cambiare in qualsiasi momento. Per altre informazioni, vedere https://aka.ms/azuremlexperimental. Definisce una risorsa per la gestione del collegamento tra l'area di lavoro AML e altri servizi in Azure. Inizializzare l'oggetto LinkedService.
Model	Rappresenta il risultato del training di Machine Learning. Un modello è il risultato di un training Run di Azure Machine Learning o di un altro processo di training del modello all'esterno di Azure. Indipendentemente dal modo in cui viene prodotto il modello, può essere registrato in un'area di lavoro, in cui è rappresentato da un nome e una versione. Con la classe Model è possibile creare un pacchetto di modelli da usare con Docker e distribuirli come endpoint in tempo reale che può essere usato per le richieste di inferenza. Per un'esercitazione end-to-end che illustra come vengono creati, gestiti e usati i modelli, vedere Eseguire il training del modello di classificazione delle immagini con i dati MNIST e scikit-learn usando Azure Machine Learning. Costruttore del modello. Il costruttore Model viene usato per recuperare una rappresentazione cloud di un oggetto Model associato all'area di lavoro fornita. Deve specificare il nome o l'ID.
PrivateEndPoint	Definisce un endpoint privato per la gestione delle connessioni endpoint private associate a un'area di lavoro di Azure ML. Inizializzare PrivateEndPoint.
PrivateEndPointConfig	Definisce la configurazione per un punto finale privato di Azure. Endpoint privato di Azure è un'interfaccia di rete che si connette privatamente e in modo sicuro a un'area di lavoro di Azure ML con collegamento privato. Inizializzare PrivateEndPointConfig.
Run	Definisce la classe di base per tutte le esecuzioni dell'esperimento di Azure Machine Learning. Un'esecuzione rappresenta una singola versione di valutazione di un esperimento. Le esecuzioni vengono usate per monitorare l'esecuzione asincrona di una versione di valutazione, le metriche di log e l'archiviazione dell'output della versione di valutazione e per analizzare i risultati e accedere agli artefatti generati dalla versione di valutazione. Gli oggetti di esecuzione vengono creati quando si invia uno script per eseguire il training di un modello in molti scenari diversi in Azure Machine Learning, incluse le esecuzioni di HyperDrive, le esecuzioni della pipeline e le esecuzioni autoML. Un oggetto Run viene creato anche quando si submit o start_logging con la Experiment classe . Per iniziare a usare esperimenti ed esecuzioni, vedere Creare e gestire gli ambienti per il training e la distribuzione Come gestire le esecuzioni Inizializzare l'oggetto Run.
RunConfiguration	Rappresenta la configurazione per le esecuzioni di esperimenti destinate a destinazioni di calcolo diverse in Azure Machine Learning. L'oggetto RunConfiguration incapsula le informazioni necessarie per inviare un'esecuzione di training in un esperimento. In genere, non si creerà direttamente un oggetto RunConfiguration, ma si otterrà uno da un metodo che lo restituisce, ad esempio il submit metodo della Experiment classe. RunConfiguration è una configurazione dell'ambiente di base usata anche in altri tipi di passaggi di configurazione che dipendono dal tipo di esecuzione che si sta attivando. Ad esempio, quando si configura un PythonScriptStepoggetto , è possibile accedere all'oggetto RunConfiguration del passaggio e configurare le dipendenze di Conda o accedere alle proprietà dell'ambiente per l'esecuzione. Per esempi di configurazioni di esecuzione, vedere Selezionare e usare una destinazione di calcolo per eseguire il training del modello. Inizializzare un runConfiguration con le impostazioni predefinite.
ScriptRun	Fornisce l'accesso a livello di codice per la gestione delle esecuzioni di training inviate. Un'esecuzione inviata con ScriptRunConfig rappresenta una singola versione di valutazione in un esperimento. L'invio dell'esecuzione restituisce un oggetto ScriptRun, che può essere usato per monitorare l'esecuzione asincrona dell'esecuzione, le metriche di log e l'archivio dell'esecuzione e analizzare i risultati e gli artefatti di accesso generati dall'esecuzione. Per iniziare a usare esperimenti e ScriptRunConf, vedere Creare e gestire gli ambienti per il training e la distribuzione Come gestire le esecuzioni Costruttore ScriptRun della classe.
ScriptRunConfig	Rappresenta le informazioni di configurazione per l'invio di un'esecuzione di training in Azure Machine Learning. Un pacchetto ScriptRunConfig include le informazioni di configurazione necessarie per inviare un'esecuzione in Azure ML, tra cui lo script, la destinazione di calcolo, l'ambiente e le configurazioni specifiche del processo distribuite. Dopo aver configurato e inviato un'esecuzione di script con submit, viene restituito un oggetto ScriptRun . Costruttore ScriptRunConfig della classe.
SynapseWorkspaceLinkedServiceConfiguration	Nota Si tratta di una classe sperimentale e può cambiare in qualsiasi momento. Per altre informazioni, vedere https://aka.ms/azuremlexperimental. Definisce una configurazione del servizio collegato per il collegamento dell'area di lavoro synapse. Inizializzare l'oggetto SynapseWorkspaceLinkedServiceConfiguration.
Webservice	Definisce le funzionalità di base per la distribuzione di modelli come endpoint di servizio Web in Azure Machine Learning. Il costruttore del servizio Web viene usato per recuperare una rappresentazione cloud di un oggetto Webservice associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Webservice recuperato. La classe Webservice consente di distribuire modelli di Machine Learning da un Model oggetto o Image . Per altre informazioni sull'uso del servizio Web, vedere Distribuire modelli con Azure Machine Learning. Inizializzare l'istanza del servizio Web. Il costruttore del servizio Web recupera una rappresentazione cloud di un oggetto Webservice associato all'area di lavoro specificata. Restituirà un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Webservice recuperato.
Workspace	Definisce una risorsa di Azure Machine Learning per la gestione degli artefatti di training e distribuzione. Un'area di lavoro è una risorsa fondamentale per Machine Learning in Azure Machine Learning. Si usa un'area di lavoro per sperimentare, eseguire il training e distribuire modelli di Machine Learning. Ogni area di lavoro è associata a una sottoscrizione di Azure e a un gruppo di risorse e ha uno SKU associato. Per altre informazioni sulle aree di lavoro, vedere: Che cos'è un'area di lavoro di Azure Machine Learning? Gestire l'accesso a un'area di lavoro Costruttore Area di lavoro classi per caricare un'area di lavoro di Azure Machine Learning esistente.
diagnostic_log	Indirizza i log di debug a un file specificato.

Funzioni

attach_legacy_compute_target

Collega una destinazione di calcolo a questo progetto.

attach_legacy_compute_target(experiment, source_directory, compute_target)

Parametri

Nome	Descrizione
experiment Necessario	Experiment
source_directory Necessario	str
compute_target Necessario	str Oggetto di destinazione di calcolo da collegare.

Restituisce

Tipo	Descrizione
	Nessuna se il collegamento ha esito positivo, in caso contrario genera un'eccezione.

get_run

Ottenere l'esecuzione per questo esperimento con il relativo ID di esecuzione.

get_run(experiment, run_id, rehydrate=True, clean_up=True)

Parametri

Nome	Descrizione
experiment Necessario	Experiment Oggetto contenente l'esperimento.
run_id Necessario	string ID di esecuzione.
rehydrate	<xref:boolean> Indica se l'oggetto run originale viene restituito o solo un oggetto run di base. Se True, questa funzione restituisce il tipo di oggetto run originale. Ad esempio, per un'esecuzione AutoML, viene restituito un AutoMLRun oggetto, mentre per un'esecuzione di HyperDrive viene restituito un HyperDriveRun oggetto. Se False, la funzione restituisce un Run oggetto. valore predefinito: True
clean_up	bool Se true, chiamare _register_kill_handler da run_base valore predefinito: True

Restituisce

Tipo	Descrizione
Run	Esecuzione inviata.

is_compute_target_prepared

Verificare che la destinazione di calcolo sia preparata.

Verifica se la destinazione di calcolo, specificata in run_config, è già preparata o meno per la configurazione di esecuzione specificata.

is_compute_target_prepared(experiment, source_directory, run_config)

Parametri

Nome	Descrizione
experiment Necessario	Experiment
source_directory Necessario	str
run_config Necessario	str oppure RunConfiguration Configurazione dell'esecuzione. Questo può essere un nome di configurazione di esecuzione, come stringa o un oggetto azureml.core.runconfig.RunConfiguration.

Restituisce

Tipo	Descrizione
bool	True, se la destinazione di calcolo è preparata.

prepare_compute_target

Preparare la destinazione di calcolo.

Installa tutti i pacchetti necessari per un'esecuzione di esperimento in base a run_config e custom_run_config.

prepare_compute_target(experiment, source_directory, run_config)

Parametri

Nome	Descrizione
experiment Necessario	Experiment
source_directory Necessario	str
run_config Necessario	str oppure RunConfiguration Configurazione dell'esecuzione. Questo può essere un nome di configurazione di esecuzione, come stringa o un oggetto azureml.core.runconfig.RunConfiguration.

Restituisce

Tipo	Descrizione
ScriptRun	Oggetto run

remove_legacy_compute_target

Rimuovere una destinazione di calcolo dal progetto.

remove_legacy_compute_target(experiment, source_directory, compute_target_name)

Parametri

Nome	Descrizione
experiment Necessario	Experiment
source_directory Necessario	str
compute_target_name Necessario	str

Restituisce

Tipo	Descrizione
None	Nessuna se la rimozione della destinazione di calcolo ha esito positivo, in caso contrario genera un'eccezione.