Merge pull request #230717 from aahill/clu-qs-update

CLU quickstart update

Author: v-dirichards

articles/cognitive-services/language-service/conversational-language-understanding/includes/quickstarts/rest-api.md

@@ -5,7 +5,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: include
-ms.date: 06/07/2022
+ms.date: 03/14/2023
 ms.author: aahi
 ms.custom: ignite-fall-2021
 ---
@@ -32,7 +32,7 @@ ms.custom: ignite-fall-2021
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST API&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Get-resource-keys-and-endpoint" target="_target">I ran into an issue</a>
 
-## Create a CLU project 
+## Import a new CLU sample project
 
 Once you have a Language resource created, create a conversational language understanding project. A project is a work area for building your custom ML models based on your data. Your project can only be accessed by you and others who have access to the Language resource being used.
 
@@ -41,36 +41,32 @@ For this quickstart, you can download [this sample project](https://go.microsoft
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=RESTAPI&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Create-a-conversational-language-understanding-project" target="_target">I ran into an issue</a>
 
-### Trigger import project job 
+### Trigger the import project job 
 
 [!INCLUDE [create and import project](../rest-api/import-project.md)]
 
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST API&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Trigger-import-project-job" target="_target">I ran into an issue</a>
 
-### Get import job Status
+### Get the import job status
 
 [!INCLUDE [get import project status](../rest-api/get-import-status.md)]
 
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST API&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Get-import-job-status" target="_target">I ran into an issue</a>
 
-## Train your model
+## Start training your model
 
 Typically, after you create a project, you should [build schema](../../how-to/build-schema.md) and [tag utterances](../../how-to/tag-utterances.md). For this quickstart, we already imported a ready project with built schema and tagged utterances. 
 
-### Start training your model
-
-After your project has been imported, you can start training your model. 
-
 [!INCLUDE [train model](../rest-api/train-model.md)]
 
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=REST API&Pillar=Language&Product=Conversational-language-understanding&Page=quickstart&Section=Train-model" target="_target">I ran into an issue</a>
 
-### Get Training Status
+### Get the training job status
 
-Training could take sometime between 10 and 30 minutes. You can use the following request to keep polling the status of the training job until it is successfully completed.
+Training may take time to complete - sometimes between 10 and 30 minutes. You can use the following request to keep polling the status of the training job until it is successfully completed.
 
  [!INCLUDE [get training model status](../rest-api/get-training-status.md)]
 

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/get-deployment-status.md

@@ -9,7 +9,9 @@ ms.date: 05/16/2022
 ms.author: aahi
 ---
 
-Use the following **GET** request to get the status of your deployment job. Replace the placeholder values below with your own values. 
+When you send a successful deployment request, the full request URL for checking the job's status (including your endpoint, project name, and job ID) is contained in the response's `operation-location` header. 
+
+Use the following **GET** request to get the status of your deployment job. Replace the placeholder values with your own values. 
 
 ### Request URL
 
@@ -22,8 +24,8 @@ Use the following **GET** request to get the status of your deployment job. Repl
 |`{ENDPOINT}`     | The endpoint for authenticating your API request.   | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
 |`{PROJECT-NAME}`     | The name for your project. This value is case-sensitive.   | `myProject` |
 |`{DEPLOYMENT-NAME}`     | The name for your deployment. This value is case-sensitive.   | `staging` |
-|`{JOB-ID}`     | The ID for locating your model's training status. This is in the `location` header value you received from the API in response to your model deployment request.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
-|`{API-VERSION}`     | The version of the API you are calling. The value referenced here is for the latest released [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data).  | `2022-05-01` |
+|`{JOB-ID}`     | The ID for locating your model's training status.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
+|`{API-VERSION}`     | The version of the API you're calling. The value referenced here is for the latest released [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data).  | `2022-05-01` |
 
 ### Headers
 
@@ -36,7 +38,7 @@ Use the following header to authenticate your request.
 
 ### Response Body
 
-Once you send the request, you will get the following response. Keep polling this endpoint until the **status** parameter changes to "succeeded". 
+Once you send the request, you'll get the following response. Keep polling this endpoint until the **status** parameter changes to "succeeded". 
 
 ```json
 {

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/get-import-status.md

@@ -6,12 +6,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: include
-ms.date: 05/13/2022
+ms.date: 03/17/2023
 ms.author: aahi
 ms.custom: language-service-clu 
 ---
 
-Use the following **GET** request to query the status of your import job. You can use the URL you received from the previous step, or replace the placeholder values below with your own values. 
+When you send a successful project import request, the full request URL for checking the import job's status (including your endpoint, project name, and job ID) is contained in the response's `operation-location` header. 
+
+Use the following **GET** request to query the status of your import job. You can use the URL you received from the previous step, or replace the placeholder values with your own values. 
 
 ```rest
 {ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
@@ -21,8 +23,8 @@ Use the following **GET** request to query the status of your import job. You ca
 |---------|---------|---------|
 |`{ENDPOINT}`     | The endpoint for authenticating your API request.   | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
 |`{PROJECT-NAME}`     | The name for your project. This value is case-sensitive.  | `myProject` |
-|`{JOB-ID}`     | The ID for locating your export job status. This is in the `location` header value you received in the previous step.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
-|`{API-VERSION}`     | The version of the API you are calling. The value referenced here is for the latest released [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data). | `2022-05-01` |
+|`{JOB-ID}`     | The ID for locating your import job status.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
+|`{API-VERSION}`     | The version of the API you're calling. The value referenced here is for the latest released [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data). | `2022-05-01` |
 
 #### Headers
 
@@ -34,7 +36,7 @@ Use the following header to authenticate your request.
 
 #### Response body
 
-Once you send the request, you will get the following response. Keep polling this endpoint until the status parameter changes to "succeeded".
+Once you send the request, you'll get the following response. Keep polling this endpoint until the status parameter changes to "succeeded".
 
 
 ```json

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/get-training-status.md

@@ -5,10 +5,12 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: include
-ms.date: 05/12/2022
+ms.date: 03/17/2023
 ms.author: aahi
 ---
 
+When you send a successful training request, the full request URL for checking the job's status (including your endpoint, project name, and job ID) is contained in the response's `operation-location` header. 
+
 Use the following **GET** request to get the status of your model's training progress. Replace the placeholder values below with your own values. 
 
 ### Request URL
@@ -21,7 +23,7 @@ Use the following **GET** request to get the status of your model's training pro
 |---------|---------|---------|
 |`{YOUR-ENDPOINT}`     | The endpoint for authenticating your API request.   | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
 |`{PROJECT-NAME}`     | The name for your project. This value is case-sensitive.   | `EmailApp` |
-|`{JOB-ID}`     | The ID for locating your model's training status. This is in the `location` header value you received when submitted your training job.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
+|`{JOB-ID}`     | The ID for locating your model's training status.  | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx` |
 |`{API-VERSION}`     | The version of the API you are calling. The value referenced here is for the latest version released. Learn more about other available [API versions](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data)  | `2022-05-01` |
 
 ### Headers

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/import-project.md

@@ -14,7 +14,7 @@ Submit a **POST** request using the following URL, headers, and JSON body to imp
 
 ### Request URL
 
-Use the following URL when creating your API request. Replace the placeholder values below with your own values. 
+Use the following URL when creating your API request. Replace the placeholder values with your own values. 
 
 ```rest
 {ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}
@@ -23,7 +23,7 @@ Use the following URL when creating your API request. Replace the placeholder va
 |Placeholder  |Value  | Example |
 |---------|---------|---------|
 |`{ENDPOINT}`     | The endpoint for authenticating your API request.   | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
-|`{PROJECT-NAME}`     | The name for your project. This value is case-sensitive.   | `myProject` |
+|`{PROJECT-NAME}`     | The name for your project. This value is case-sensitive, and must match the project name in the JSON file you're importing.   | `EmailAppDemo` |
 |`{API-VERSION}`     | The version of the API you're calling. The value referenced here is for the latest released [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data).  | `2022-05-01` |
 
 ### Headers
@@ -36,7 +36,7 @@ Use the following header to authenticate your request.
 
 ### Body
 
-Use the following sample JSON as your body.
+The JSON body you send is similar to the following example. See the [reference documentation](/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/import?tabs=HTTP#successful-import-project) for more details about the JSON object.
 
 ```json
 {
@@ -96,8 +96,13 @@ Use the following sample JSON as your body.
 |Key  |Placeholder  |Value  | Example |
 |---------|---------|----------|--|
 | api-version | `{API-VERSION}` | The version of the API you're calling. The version used here must be the same API model version in the URL. See the [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data) article to learn more.  | `2022-05-01` |
-| `projectName` | `{PROJECT-NAME}` | The name of your project. This value is case-sensitive. | `EmailApp` |
+| `projectName` | `{PROJECT-NAME}` | The name of your project. This value is case-sensitive. | `EmailAppDemo` |
 | `language` | `{LANGUAGE-CODE}` |  A string specifying the language code for the utterances used in your project. If your project is a multilingual project, choose the [language code](../../language-support.md) of the majority of the utterances. |`en-us`|
-| `multilingual` | `true`| A boolean value that enables you to have documents in multiple languages in your dataset. When your model is deployed, you can query the model in any [supported language](../../language-support.md#multi-lingual-option). This includes languages that aren't included in your training documents.  | `true`|
+| `multilingual` | `true`| A boolean value that enables you to have documents in multiple languages in your dataset. When your model is deployed, you can query the model in any [supported language](../../language-support.md#multi-lingual-option) including languages that aren't included in your training documents.  | `true`|
 | `dataset` | `{DATASET}` |  See [how to train a model](../../how-to/tag-utterances.md) for information on splitting your data between a testing and training set. Possible values for this field are `Train` and `Test`.      |`Train`|
 
+Upon a successful request, the API response will contain an `operation-location` header with a URL you can use to check the status of the import job. It is formatted like this: 
+
+```http
+{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
+``` 

articles/cognitive-services/language-service/conversational-language-understanding/includes/rest-api/train-model.md

@@ -4,7 +4,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: include
-ms.date: 05/12/2022
+ms.date: 03/17/2023
 ms.author: aahi
 ---
 
@@ -13,7 +13,7 @@ Create a **POST** request using the following URL, headers, and JSON body to sub
 
 ### Request URL
 
-Use the following URL when creating your API request. Replace the placeholder values below with your own values. 
+Use the following URL when creating your API request. Replace the placeholder values with your own values. 
 
 ```rest
 {ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:train?api-version={API-VERSION}
@@ -23,7 +23,7 @@ Use the following URL when creating your API request. Replace the placeholder va
 |---------|---------|---------|
 |`{ENDPOINT}`     | The endpoint for authenticating your API request.   | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
 |`{PROJECT-NAME}`     | The name for your project. This value is case-sensitive.   | `EmailApp` |
-|`{API-VERSION}`     | The version of the API you are calling. The value referenced here is for the latest released [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data) released.  | `2022-05-01` |
+|`{API-VERSION}`     | The version of the API you're calling. The value referenced here is for the latest released [model version](../../../concepts/model-lifecycle.md#choose-the-model-version-used-on-your-data) released.  | `2022-05-01` |
 
 ### Headers
 
@@ -36,7 +36,7 @@ Use the following header to authenticate your request.
 
 ### Request body
 
-Use the following object in your request. The model will be named `MyModel` once training is complete.  
+Use the following object in your request. The model will be named after the value you use for the `modelLabel` parameter once training is complete.  
 
 ```json
 {
@@ -67,4 +67,5 @@ Once you send your API request, you will receive a `202` response indicating suc
 ```rest
 {ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
 ``` 
+
 You can use this URL to get the training job status.

articles/cognitive-services/language-service/conversational-language-understanding/quickstart.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: quickstart
-ms.date: 02/28/2023
+ms.date: 03/14/2023
 ms.author: aahi
 ms.custom: language-service-clu, ignite-fall-2021, mode-other
 zone_pivot_groups: usage-custom-language-features