Come usare un servizio Web di Azure Machine Learning

Dopo aver distribuito un modello predittivo di Azure Machine Learning come servizio Web, è possibile usare un'API REST per inviare dati e ottenere stime. È possibile inviare i dati in tempo reale o in modalità batch.

Per informazioni su come creare e distribuire un servizio Web di Machine Learning tramite Machine Learning Studio:

Nota

Prova gratuita di Azure Machine Learning

Non è necessaria una carta di credito o una sottoscrizione di Azure. Per iniziare >.

Panoramica

Con il servizio Web di Azure Machine Learning, un'applicazione esterna comunica con un modello di valutazione del flusso di lavoro di Machine Learning in tempo reale. Una chiamata al servizio Web di Machine Learning restituisce i risultati della stima a un'applicazione esterna. Per effettuare una chiamata al servizio Web di Machine Learning, passare una chiave API creata quando si distribuisce una stima. Il servizio Web di Machine Learning è basato su REST, una scelta di architettura diffusa per progetti di programmazione Web.

Azure Machine Learning dispone di due tipi di servizi:

  • Servizio di richiesta-risposta (RRS). Un servizio a latenza bassa e altamente scalabile che offre un'interfaccia ai modelli senza stato creati e distribuiti da Machine Learning Studio.
  • Servizio esecuzione batch (BES). Un servizio asincrono che valuta un batch di record di dati.

Per altre informazioni sui servizi Web di Machine Learning, vedere Distribuire un servizio Web di Azure Machine Learning.

Ottenere una chiave di autorizzazione Azure Machine Learning

Quando si distribuisce l'esperimento, vengono generate le chiavi API per il servizio Web, recuperabili da diverse posizioni.

Dal portale dei servizi Web di Microsoft Azure Machine Learning

Accedere al portale dei servizi Web di Microsoft Azure Machine Learning.

Per recuperare la chiave API per un nuovo servizio Web Machine Learning:

  1. Nel portale Servizi Web di Machine Learning di Azure, fare clic sul menu Web Services (Servizi Web) nel menu in alto.
  2. Selezionare il servizio Web per il quale si desidera recuperare la chiave.
  3. Nel menu in alto fare clic su Consume(Uso).
  4. Copiare e salvare la Chiave primaria.

Per recuperare la chiave API per un nuovo servizio Web Machine Learning di tipo classico:

  1. Nel portale Servizi Web di Machine Learning di Azure, fare clic sul menu Classic Web Services (Servizi Web classici) nel menu in alto.
  2. Fare clic sul servizio Web in uso.
  3. Selezionare l'endpoint per il quale si desidera recuperare la chiave.
  4. Nel menu in alto fare clic su Consume(Uso).
  5. Copiare e salvare la Chiave primaria.

Servizio Web classico

La chiave di un servizio Web di tipo classico può essere recuperata anche da Machine Learning Studio o dal portale di Azure classico.

Machine Learning Studio

  1. In Machine Learning Studio fare clic su WEB SERVICES (Servizi Web) a sinistra.
  2. Fare clic su un servizio Web. La chiave API si trova nella scheda DASHBOARD.

portale di Azure classico

  1. Fare clic su MACHINE LEARNING a sinistra.
  2. Fare clic sull'area di lavoro in cui si trova il servizio Web.
  3. Fare clic su WEB SERVICES.
  4. Fare clic su un servizio Web.
  5. Fare clic su un endpoint. La "CHIAVE API" si trova in basso a destra.

Connettersi a un servizio Web di Machine Learning

È possibile connettersi a un servizio Web di Machine Learning usando qualsiasi linguaggio di programmazione che supporta la risposta e la richiesta HTTP. È possibile visualizzare gli esempi in C#, Python e R da una pagina della guida del servizio Web di Machine Learning.

Guida alle API di Machine Learning Una Guida per l'API di Machine Learning viene creata quando si distribuisce un servizio Web. Vedere Procedura dettagliata di Azure Machine Learning - Distribuire il servizio Web. La Guida per l'API di Machine Learning contiene i dettagli su un servizio Web di stima.

  1. Fare clic sul servizio Web in uso.
  2. Selezionare l'endpoint per il quale si desidera visualizzare la pagina della guida alle API.
  3. Nel menu in alto fare clic su Consume(Uso).
  4. Fare clic sulla pagina della guida alle API negli endpoint Request-Response o Esecuzione batch.

Per visualizzare la guida alle API di Machine Learning per un nuovo servizio Web

Nel portale dei servizi Web di Azure Machine Learning:

  1. Fare clic su WEB SERVICES (Servizi Web) nel menu in alto.
  2. Selezionare il servizio Web per il quale si desidera recuperare la chiave.

Fare clic su Consume (Uso) per ottenere l'URI per i servizi Richiesta/Risposta ed Esecuzione in batch, nonché il codice di esempio in C#, R e Python.

Fare clic su Swagger API (API Swagger) per ottenere la documentazione basata su Swagger per le API chiamate dagli URI specificati.

Esempio C#

Per connettersi a un servizio Web di Machine Learning, usare un HttpClient che passa ScoreData. ScoreData contiene FeatureVector, un vettore n-dimensionale di funzioni numeriche che rappresentano ScoreData. Effettuare l'autenticazione al servizio di Machine Learning con una chiave API.

Per connettersi a un servizio Web di Machine Learning, è necessario installare il pacchetto NuGet Microsoft.AspNet.WebApi.Client .

Installare il Nuget Microsoft.AspNet.WebApi.Client in Visual Studio

  1. Pubblicare il set di dati di download dal servizio Web UCI: Adult 2 class dataset.
  2. Fare clic su Strumenti > Gestione pacchetti NuGet > Console di Gestione pacchetti.
  3. Scegliere Install-Package Microsoft.AspNet.WebApi.Client.

Per eseguire l'esempio di codice

  1. Pubblicare l'esperimento "Sample 1: Download dataset from UCI: Adult 2 class dataset", che fa parte della raccolta di esempi di Machine Learning.
  2. Assegnare ad apiKey la chiave di un servizio Web. Vedere la sezione precedente Ottenere una chiave di autorizzazione di Azure Machine Learning .
  3. Assegnare l'URI del servizio con l'URI della richiesta.

Esempio Python

Per connettersi a un servizio Web di Machine Learning, usare la libreria urllib2 con ScoreData. ScoreData contiene FeatureVector, un vettore n-dimensionale di funzioni numeriche che rappresentano ScoreData. Effettuare l'autenticazione al servizio di Machine Learning con una chiave API.

Per eseguire l'esempio di codice

  1. Distribuire l'esperimento "Sample 1: Download dataset from UCI: Adult 2 class dataset", che fa parte della raccolta di esempi di Machine Learning.
  2. Assegnare ad apiKey la chiave di un servizio Web. Vedere la sezione Ottenere una chiave di autorizzazione Azure Machine Learning all'inizio di questo articolo.
  3. Assegnare l'URI del servizio con l'URI della richiesta.