You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Use the Invoice Object Recommendation Business Blueprint to Train a Machine Learning Model
12
-
<!-- description --> Train a machine learning model for the Data Attribute Recommendation service, using the Invoice Object Recommendation business blueprint.
11
+
# Use the Invoice Object Recommendation (IOR) Business Blueprint to Train a Machine Learning Model
12
+
<!-- description --> Train a machine learning model for the Data Attribute Recommendation service, using the Invoice Object Recommendation (IOR) business blueprint.
13
13
14
14
## You will learn
15
-
- How to train a machine learning model using the Invoice Object Recommendation business blueprint
15
+
- How to train a machine learning model using the Invoice Object Recommendation (IOR) business blueprint
16
16
- How to deploy a machine learning model to get financial object predictions
In the service key you created for Data Attribute Recommendation in the previous tutorial: [Use Free Tier to Set Up Account for Data Attribute Recommendation and Get Service Key](cp-aibus-dar-booster-free-key) or [Use Trial to Set Up Account for Data Attribute Recommendation and Get Service Key](cp-aibus-dar-booster-key), you find a section called `swagger` (as highlighted in the image below) with three entries, called `dm` (data manager), `mm` (model manager) and `inference`.
For this tutorial, copy the URL of the Swagger UI for `mm` and open it in a browser tab. The Swagger UI for the model manager allows you to train a machine learning model, to delete it, to deploy the model as well as to `undeploy` the model.
28
28
29
-
>After finishing this tutorial, keep the Swagger UI for `mm` open to perform the clean up tasks in [Use the Invoice Object Recommendation Business Blueprint to Predict Financial Objects](cp-aibus-dar-swagger-ior-predict).
29
+
>After finishing this tutorial, keep the Swagger UI for `mm` open to perform the clean up tasks in [Use the Invoice Object Recommendation (IOR) Business Blueprint to Predict Financial Objects](cp-aibus-dar-swagger-ior-predict).
30
30
31
31
1. To be able to use the Swagger UI endpoints, you need to authorize yourself. In the top right corner, click **Authorize**.
2. Get the `access_token` value created in the previous tutorial: [Get OAuth Access Token for Data Attribute Recommendation Using Any Web Browser](cp-aibus-dar-web-oauth-token), then add **Bearer** (with capitalized "B") in front of it, and enter in the **Value** field.
36
36
@@ -40,32 +40,32 @@ For this tutorial, copy the URL of the Swagger UI for `mm` and open it in a brow
To train a machine learning model using the data that you uploaded in [Use an Invoice Object Recommendation Dataset Schema to Upload Training Data to Data Attribute Recommendation](cp-aibus-dar-swagger-ior-upload), you create a training job.
50
+
To train a machine learning model using the data that you uploaded in [Use an Invoice Object Recommendation (IOR) Dataset Schema to Upload Training Data to Data Attribute Recommendation](cp-aibus-dar-swagger-ior-upload), you create a training job.
51
51
52
-
With each training job you provide a model template or a business blueprint which combines data processing rules and machine learning model architecture. You can find the list of available model templates [here](https://help.sap.com/docs/Data_Attribute_Recommendation/105bcfd88921418e8c29b24a7a402ec3/1e76e8c636974a06967552c05d40e066.html). The only business blueprint currently available is Invoice Object Recommendation, as you can see [here](https://help.sap.com/docs/Data_Attribute_Recommendation/105bcfd88921418e8c29b24a7a402ec3/091eace025e14793be0e83ef2109b349.html).
52
+
With each training job you provide a model template or a business blueprint which combines data processing rules and machine learning model architecture. You can find the list of available model templates [here](https://help.sap.com/docs/Data_Attribute_Recommendation/105bcfd88921418e8c29b24a7a402ec3/1e76e8c636974a06967552c05d40e066.html), and the list of available business blueprints [here](https://help.sap.com/docs/Data_Attribute_Recommendation/105bcfd88921418e8c29b24a7a402ec3/091eace025e14793be0e83ef2109b349.html).
53
53
54
-
The Invoice Object Recommendation business blueprint that you use in this tutorial is suited to assign G/L (general ledger) accounts and other financial objects to incoming invoices without a purchase order reference.
54
+
The Invoice Object Recommendation (IOR) business blueprint that you use in this tutorial is suited to assign G/L (general ledger) accounts and other financial objects to incoming invoices without a purchase order reference.
55
55
56
56
To create the training job, proceed as follows:
57
57
58
58
1. Expand the endpoint **POST /jobs** by clicking on it. Then click **Try it out**.
2. In the text area, replace the parameter value for `datasetId` with the `id` of your dataset that you have created in [Use an Invoice Object Recommendation Dataset Schema to Upload Training Data to Data Attribute Recommendation](cp-aibus-dar-swagger-ior-upload). Delete the `modelTemplateId` line from the **Request body**. Replace the parameter value `modelName` with your model name, `ior_tutorial_model`, for example. Make sure the parameter value for `businessBlueprintId` is `4788254b-0bad-4757-a67f-92d5b55f322d`. Click **Execute** to create the training job.
62
+
2. In the text area, replace the parameter value for `datasetId` with the `id` of your dataset that you have created in [Use an Invoice Object Recommendation (IOR) Dataset Schema to Upload Training Data to Data Attribute Recommendation](cp-aibus-dar-swagger-ior-upload). Delete the `modelTemplateId` line from the **Request body**. Replace the parameter value `modelName` with your model name, `ior_tutorial_model`, for example. Make sure the parameter value for `businessBlueprintId` is `4788254b-0bad-4757-a67f-92d5b55f322d`. Click **Execute** to create the training job.
3. In the response of the service, you find the `id` of your training job. Copy the `id` as you'll need it in the next step. Along side the `id`, you find the training job's current status. Initially, the status is `PENDING` which says that the training job is in queue but has not started yet.
@@ -78,15 +78,15 @@ To know when your training job has ended, you have to frequently check its statu
78
78
79
79
1. Expand the endpoint `GET /jobs/{jobId}` by clicking on it. Then click **Try it out**.
80
80
81
-
<!-- border -->
81
+
<!-- border -->
82
82
83
83
2. Fill the parameter `jobId` with `id` of your training job that you copied in the previous step. Click **Execute**.
84
84
85
-
<!-- border -->
85
+
<!-- border -->
86
86
87
87
3. In the response, you find again the current status of your training job along with other details. Immediately after creation of the training job, the status is `PENDING`. Shortly after, it changes to `RUNNING` which means that the model is being trained. The training of the sample data usually takes about 5 minutes to complete but may run longer, up to a few hours due to limited availability of resources in the free tier environment. You can check the status every now and then. Once training is finished, the status changes to `SUCCEEDED` which means the service has created a machine learning model and you can proceed.
88
88
89
-
<!-- border -->
89
+
<!-- border -->
90
90
91
91
You have successfully trained a machine learning model.
92
92
@@ -99,15 +99,15 @@ To use the trained model, you need to deploy it. Once deployed, the model is rea
99
99
100
100
1. Expand the endpoint `POST /deployments` by clicking on it. Then click **Try it out**.
3. In the response of the service, you find the `id` of the deployment and its status. Initially, the status is `PENDING`, indicating the deployment is in progress. Make sure to copy the `id` as you need it in the next step.
@@ -118,16 +118,14 @@ Finally, you have to ensure that your model is deployed successfully in order to
118
118
119
119
1. Expand the endpoint `GET /deployments/{id}` by clicking on it. Then click **Try it out**.
120
120
121
-
<!-- border -->
121
+
<!-- border -->
122
122
123
123
2. Fill the parameter `deploymentId` with the `id` of your deployment that you copied in the previous step. Click **Execute**.
124
124
125
-
<!-- border -->
125
+
<!-- border -->
126
126
127
127
3. In the response of the service, you find the current status of the deployment. If the status is `SUCCEEDED`, your deployment is done. If the status is still `PENDING`, check back in a few minutes.
128
128
129
-
<!-- border -->
130
-
131
-
You have successfully trained a machine learning model and deployed it. Next, you'll use your model to make predictions.
132
-
129
+
<!-- border -->
133
130
131
+
You have successfully trained a machine learning model and deployed it. Next, you'll use your model to make predictions.
0 commit comments