Skip to content

Commit 8e9a2df

Browse files
committed
Revise
1 parent 413be61 commit 8e9a2df

File tree

1 file changed

+30
-26
lines changed

1 file changed

+30
-26
lines changed

articles/machine-learning/how-to-run-batch-predictions-designer.md

Lines changed: 30 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -15,34 +15,33 @@ ms.custom: Ignite2019
1515
# Run batch predictions using Azure Machine Learning designer
1616
[!INCLUDE [applies-to-skus](../../includes/aml-applies-to-basic-enterprise-sku.md)]
1717

18-
In this article, you learn how to use the designer to create a batch prediction pipeline. Batch prediction lets you continuously score large datasets on-demand. Use the designer to automatically creates a web service that can be triggered from any HTTP library.
18+
In this article, you learn how to use the designer to create a batch prediction pipeline. Batch prediction lets you continuously score large datasets on-demand using a web service that can be triggered from any HTTP library.
1919

20-
In this how-to, you learn the following tasks:
20+
In this how-to, you learn to do the following tasks:
2121

2222
> [!div class="checklist"]
23-
> * Create a parameterized batch inference pipeline
24-
> * Manage and run pipelines manually or from a REST endpoint
23+
> * Create and publish a batch inference pipeline
24+
> * Consume a pipeline endpoint
25+
> * Manage endpoint versions
2526
2627
To learn how to set up batch scoring services using the SDK, see the accompanying [how-to](how-to-run-batch-predictions.md).
2728

2829
## Prerequisites
2930

3031
This how-to assumes you already have a training pipeline. For a guided introduction to the designer, complete [part one of the designer tutorial](tutorial-designer-automobile-price-train-score.md).
3132

32-
## Open the training pipeline
33+
## Create a batch inference pipeline
3334

3435
Your training pipeline must be run at least once to be able to create an inferencing pipeline.
3536

3637
1. Go to the **Designer** tab in your workspace.
3738

38-
1. Select the training pipeline you want to use to score data.
39+
1. Select the training pipeline that trains the model want to use to make prediction.
3940

4041
1. **Run** the pipeline.
4142

4243
![Run the pipeline](./media/how-to-run-batch-predictions-designer/run-training-pipeline.png)
4344

44-
## Create a batch inference pipeline
45-
4645
Now that the training pipeline has been run, you can create a batch inference pipeline.
4746

4847
1. Next to **Run**, select the new dropdown **Create inference pipeline**.
@@ -53,63 +52,68 @@ Now that the training pipeline has been run, you can create a batch inference pi
5352

5453
The result is a default batch inference pipeline.
5554

56-
## Create a dataset parameter
55+
### Add a pipeline parameter
5756

58-
To create predictions on new data, you can either manually connect a different dataset in this pipeline draft view or create a parameter for your dataset. Parameters let you change the behavior of the batch inferencing process at runtime to use new data.
57+
To create predictions on new data, you can either manually connect a different dataset in this pipeline draft view or create a parameter for your dataset. Parameters let you change the behavior of the batch inferencing process at runtime.
5958

60-
In this section, you will create a dataset parameter to specify a different dataset to make predictions on.
59+
In this section, you create a dataset parameter to specify a different dataset to make predictions on.
6160

6261
1. Select the dataset module.
6362

6463
1. A pane will appear to the right of the canvas. At the bottom of the pane, select **Set as pipeline parameter**.
6564

6665
Enter a name for the parameter, or accept the default value.
6766

68-
## Publish batch inferencing pipeline
67+
## Publish your batch inferencing pipeline
6968

70-
Now you're ready to deploy the inferencig pipeline. This will deploy the pipeline and make it avaialble to use by others.
69+
Now you're ready to deploy the inferencing pipeline. This will deploy the pipeline and make it available for others to use.
7170

7271
1. Select the **Publish** button.
7372

74-
1. In the dialog that appears, expand the drop down for **PipelineEndpoint**, and select **New PipelineEndpoint**.
73+
1. In the dialog that appears, expand the drop-down for **PipelineEndpoint**, and select **New PipelineEndpoint**.
7574

7675
1. Provide an endpoint name and optional description.
7776

78-
Near the bottom of the dialog, you can see the `Dataset1` parameter you configured with a default value of the dataset ID used during training.
77+
Near the bottom of the dialog, you can see the parameter you configured with a default value of the dataset ID used during training.
7978

8079
1. Select **Publish**.
8180

82-
![Pipeline deploy](./media/how-to-run-batch-predictions-designer/publish-inference-pipeline.png)
81+
![Publish a pipeline](./media/how-to-run-batch-predictions-designer/publish-inference-pipeline.png)
82+
8383

84-
## Manage endpoints
84+
## Consume an endpoint
85+
86+
Now, you have a published pipeline with a dataset parameter. The pipeline will use the trained model created in the training pipeline to score the dataset you provide as a parameter.
8587

86-
You can visually manage any endpoints you create in Azure Machine Learning. In this section, you will setup a manual pipeline run and alter the pipeline parameter you created in the earlier section.
88+
### Submit a pipeline run
8789

88-
1. After deployment is complete, go to the **Endpoints** section.
90+
In this section, you will set up a manual pipeline run and alter the pipeline parameter to score new data.
91+
92+
1. After the deployment is complete, go to the **Endpoints** section.
8993

9094
1. Select **Pipeline endpoints**.
9195

92-
1. Select the name of the endpoint you just created.
96+
1. Select the name of the endpoint you created.
9397

9498
![Endpoint link](./media/how-to-run-batch-predictions-designer/manage-endpoints.png)
9599

96100
1. Select **Published pipelines**.
97101

98-
This screen shows all published pipelines published under the specific endpoint. You can also set a new pipeline as the default pipeline for the endpoint here.
102+
This screen shows all published pipelines published under this endpoint.
99103

100-
1. Select the pipeline you just published.
104+
1. Select the pipeline you published.
101105

102-
The pipeline details page shows you detailed run history and connection string information for your pipeline.
106+
The pipeline details page shows you a detailed run history and connection string information for your pipeline.
103107

104108
1. Select **Run** to create a manual run of the pipeline.
105109

106110
![Pipeline details](./media/how-to-run-batch-predictions-designer/submit-manual-run.png)
107111

108-
In the run setup, you can provide a description for the run, and change the value for any pipeline parameters.
112+
1. Change the parameter to use a different dataset.
109113

110114
1. Select **Run** to run the pipeline.
111115

112-
## Consume an endpoint
116+
### Use the REST endpoint
113117

114118
You can find information on how to consume pipeline endpoints and published pipeline in the **Endpoints** section.
115119

@@ -123,7 +127,7 @@ To make a REST call, you will need an OAuth 2.0 bearer-type authentication heade
123127

124128
## Versioning endpoints
125129

126-
The designer assigns a version to each pipeline that you publish to an endpoint. You can specify the pipeline version that you want to execute as a parameter in your REST endpoint call. If you don't specify a version number, the default pipeline will execute.
130+
The designer assigns a version to each subsequent pipeline that you publish to an endpoint. You can specify the pipeline version that you want to execute as a parameter in your REST call. If you don't specify a version number, the designer will use the default pipeline.
127131

128132
When you publish a pipeline, you can choose to make it the new default pipeline for that endpoint.
129133

0 commit comments

Comments
 (0)