machine-learning-retrain-machine-learning-model.md

title	description	services	documentationcenter	author	manager	editor	ms.assetid	ms.service	ms.workload	ms.tgt_pltfrm	ms.devlang	ms.topic	ms.date	ms.author
Retrain a Machine Learning Model | Microsoft Docs	Learn how to retrain a model and update the Web service to use the newly trained model in Azure Machine Learning.	machine-learning		vDonGlover	raymondl		d1cb6088-4f7c-4c32-94f2-f7523dad9059	machine-learning	data-services	na	na	article	10/10/2016	v-donglo

Retrain a Machine Learning Model

As part of the process of operationalization of machine learning models in Azure Machine Learning, your model is trained and saved. You then use it to create a predicative Web service. The Web service can then be consumed in web sites, dashboards, and mobile apps.

Models you create using Machine Learning are typically not static. As new data becomes available or when the consumer of the API has their own data the model needs to be retrained.

Retraining may occur frequently. With the Programmatic Retraining API feature, you can programmatically retrain the model using the Retraining APIs and update the Web service with the newly trained model.

This document describes the retraining process, and shows you how to use the Retraining APIs.

Why retrain: defining the problem

As part of the machine learning training process, a model is trained using a set of data. Models you create using Machine Learning are typically not static. As new data becomes available or when the consumer of the API has their own data the model needs to be retrained.

In these scenarios, a programmatic API provides a convenient way to allow you or the consumer of your APIs to create a client that can, on a one-time or regular basis, retrain the model using their own data. They can then evaluate the results of retraining, and update the Web service API to use the newly trained model.

Note

If you have an existing Training Experiment and New Web service, you may want to check out Retrain an existing Predictive Web service instead of following the walkthrough mentioned in the following section.

End-to-end workflow

The process involves the following components: A Training Experiment and a Predictive Experiment published as a Web service. To enable retraining of a trained model, the Training Experiment must be published as a Web service with the output of a trained model. This enables API access to the model for retraining.

The following steps apply to both New and Classic Web services:

Create the initial Predictive Web service:

• Create a training experiment
• Create a predictive web experiment
• Deploy a predictive web service

Retrain the Web service:

• Update training experiment to allow for retraining
• Deploy the retraining web service
• Use the Batch Execution Service code to retrain the model

For a walkthrough of the preceding steps, see Retrain Machine Learning models programmatically.

If you deployed a Classic Web Service:

• Create a new Endpoint on the Predictive Web service
• Get the PATCH URL and code
• Use the PATCH URL to point the new Endpoint at the retrained model

For a walkthrough of the preceding steps, see Retrain a Classic Web service.

If you run into difficulties retraining a Classic Web service, see Troubleshooting the retraining of an Azure Machine Learning Classic Web service.

If you deployed a New Web service:

• Sign in to your Azure Resource Manager account
• Get the Web service definition
• Export the Web Service Definition as JSON
• Update the reference to the ilearner blob in the JSON
• Import the JSON into a Web Service Definition
• Update the Web service with new Web Service Definition

For a walkthrough of the preceding steps, see Retrain a New Web service using the Machine Learning Management PowerShell cmdlets.

The process for setting up retraining for a Classic Web service involves the following steps:

The process for setting up retraining for a New Web service involves the following steps:

Other Resources

• Retraining and Updating Azure Machine Learning models with Azure Data Factory
• Create many Machine Learning models and web service endpoints from one experiment using PowerShell
• The AML Retraining Models Using APIs video shows you how to retrain Machine Learning models created in Azure Machine Learning using the Retraining APIs and PowerShell.