Merge pull request #103011 from diberry/diberry/0131-fresh-1

[Cogsvcs] LUIS - quickstarts - fresh - 1

Author: ShannonLeavitt

articles/cognitive-services/LUIS/includes/get-key-quickstart.md

@@ -5,16 +5,16 @@ services: cognitive-services
 author: diberry
 manager: nitinme
 ms.service: cognitive-services
-ms.topic: include 
+ms.topic: include
 ms.date: 11/20/2019
 ms.author: diberry
 ---
 
-Keys and endpoints are provided in the LUIS portal in the **Manage Section** on the **Azure Resources** page. 
- 
-1. Sign in to the [LUIS portal](https://preview.luis.ai/). 
+Keys and endpoints are provided in the LUIS portal in the **Manage Section** on the **Azure Resources** page.
+
+1. Sign in to the [LUIS portal](https://preview.luis.ai/).
 1. Create a new app, or select an existing app from the apps list.
-1. Select **Manage** then select **Azure Resources**. 
-1. Copy the values for the key and endpoint for the Starter resource. You'll need these to run the sample below.
+1. Select **Manage** then select **Azure Resources**.
+1. Copy the values for the key and endpoint for the authoring resource. You'll need these to run the sample below.
    > [!NOTE]
-   > The **Starter** key allows free requests to the authoring API and up to 1000 queries to the prediction endpoint API per month for all your LUIS apps. 
+   > The **Starter** key allows free requests to the authoring API and up to 1000 queries to the prediction endpoint API per month for all your LUIS apps.

articles/cognitive-services/LUIS/includes/get-started-get-intent-rest-csharp.md

@@ -5,8 +5,8 @@ services: cognitive-services
 author: diberry
 manager: nitinme
 ms.service: cognitive-services
-ms.topic: include 
-ms.date: 11/20/2019
+ms.topic: include
+ms.date: 01/31/2020
 ms.author: diberry
 ---
 
@@ -16,79 +16,92 @@ ms.author: diberry
 * [Visual Studio Code](https://code.visualstudio.com/)
 * Public app ID: `df67dcdb-c37d-46af-88e1-8b97951ca1c2`
 
-## Get LUIS key
+## Create LUIS runtime key for predictions
 
-[!INCLUDE [Use authoring key for endpoint](../includes/get-key-quickstart.md)]
+1. Sign into the [Azure portal](https://portal.azure.com)
+1. Click [Create **Language Understanding**](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesLUISAllInOne)
+1. Enter all required settings for Runtime key:
+
+    |Setting|Value|
+    |--|--|
+    |Name|Desired name (2-64 characters)|
+    |Subscription|Select appropriate subscription|
+    |Location|Select any nearby and available location|
+    |Pricing Tier|`F0` - the minimal pricing tier|
+    |Resource Group|Select an available resource group|
+
+1. Click **Create** and wait for the resource to be created. After it is created, navigate to the resource page.
+1. Collect configured `endpoint` and a `key`.
 
 ## Get intent programmatically
 
 Use C# (.NET Core) to query the [prediction endpoint](https://aka.ms/luis-apim-v3-prediction) and get a prediction result.
 
-1. Create a new console application targeting the C# language, with a project and folder name of `predict-with-rest`. 
+1. Create a new console application targeting the C# language, with a project and folder name of `predict-with-rest`.
 
     ```console
     dotnet new console -lang C# -n predict-with-rest
     ```
 
-1. Change to the `predict-with-rest` directory you just created, and install required dependencies with these commands:  
+1. Change to the `predict-with-rest` directory you just created, and install required dependencies with these commands:
 
     ```console
     cd predict-with-rest
     dotnet add package System.Net.Http
     ```
 
 1. Open `Program.cs` in your favorite IDE or editor. Then overwrite `Program.cs` with the following code:
-    
+
    ```csharp
     using System;
     using System.Net.Http;
     using System.Web;
-    
+
     namespace predict_with_rest
     {
         class Program
         {
             static void Main(string[] args)
             {
-                // YOUR-KEY: for example, the starter key
+                // YOUR-KEY: 32 character key
                 var key = "YOUR-KEY";
-                
-                // YOUR-ENDPOINT: example is westus2.api.cognitive.microsoft.com
+
+                // YOUR-ENDPOINT: example is your-resource-name.api.cognitive.microsoft.com
                 var endpoint = "YOUR-ENDPOINT";
 
                 // //public sample app
-                var appId = "df67dcdb-c37d-46af-88e1-8b97951ca1c2"; 
-    
+                var appId = "df67dcdb-c37d-46af-88e1-8b97951ca1c2";
+
                 var utterance = "turn on all lights";
-    
+
                 MakeRequest(key, endpoint, appId, utterance);
-    
+
                 Console.WriteLine("Hit ENTER to exit...");
                 Console.ReadLine();
             }
             static async void MakeRequest(string key, string endpoint, string appId, string utterance)
             {
                 var client = new HttpClient();
                 var queryString = HttpUtility.ParseQueryString(string.Empty);
-    
+
                 // The request header contains your subscription key
                 client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", key);
-    
+
                 // The "q" parameter contains the utterance to send to LUIS
                 queryString["query"] = utterance;
-    
+
                 // These optional request parameters are set to their default values
                 queryString["verbose"] = "true";
                 queryString["show-all-intents"] = "true";
                 queryString["staging"] = "false";
                 queryString["timezoneOffset"] = "0";
-    
+
                 var endpointUri = String.Format("https://{0}/luis/prediction/v3.0/apps/{1}/slots/production/predict?query={2}", endpoint, appId, queryString);
-    
+
                 var response = await client.GetAsync(endpointUri);
-    
+
                 var strResponseContent = await response.Content.ReadAsStringAsync();
-                
+
                 // Display the JSON result from LUIS
                 Console.WriteLine(strResponseContent.ToString());
             }
@@ -97,12 +110,14 @@ Use C# (.NET Core) to query the [prediction endpoint](https://aka.ms/luis-apim-v
 
    ```
 
-1. Replace the following values:
+1. Replace the `YOUR-KEY` and `YOUR-ENDPOINT` values with your own prediction key and endpoint.
 
-    * `YOUR-KEY` with your starter key.
-    * `YOUR-ENDPOINT` with your endpoint. For example, `westus2.api.cognitive.microsoft.com`.
+    |Information|Purpose|
+    |--|--|
+    |`YOUR-KEY`|Your 32 character prediction key.|
+    |`YOUR-ENDPOINT`| Your prediction URL endpoint. For example, `replace-with-your-resource-name.api.cognitive.microsoft.com`.|
 
-1. Build the console application with this command: 
+1. Build the console application with this command:
 
     ```console
     dotnet build
@@ -121,7 +136,7 @@ Use C# (.NET Core) to query the [prediction endpoint](https://aka.ms/luis-apim-v
     {'query': 'turn on all lights', 'prediction': {'topIntent': 'HomeAutomation.TurnOn', 'intents': {'HomeAutomation.TurnOn': {'score': 0.5375382}, 'None': {'score': 0.08687421}, 'HomeAutomation.TurnOff': {'score': 0.0207554}}, 'entities': {'HomeAutomation.Operation': ['on'], '$instance': {'HomeAutomation.Operation': [{'type': 'HomeAutomation.Operation', 'text': 'on', 'startIndex': 5, 'length': 2, 'score': 0.724984169, 'modelTypeId': -1, 'modelType': 'Unknown', 'recognitionSources': ['model']}]}}}}
     ```
 
-    The JSON response formatted for readability: 
+    The JSON response formatted for readability:
 
     ```JSON
     {
@@ -164,13 +179,9 @@ Use C# (.NET Core) to query the [prediction endpoint](https://aka.ms/luis-apim-v
     }
     ```
 
-## LUIS keys
-
-[!INCLUDE [Use authoring key for endpoint](../includes/starter-key-explanation.md)]
-
 ## Clean up resources
 
-When you are finished with this quickstart, delete the file from the file system. 
+When you are finished with this quickstart, delete the file from the file system.
 
 ## Next steps
 

articles/cognitive-services/LUIS/includes/get-started-get-intent-rest-go.md

@@ -5,30 +5,43 @@ services: cognitive-services
 author: diberry
 manager: nitinme
 ms.service: cognitive-services
-ms.topic: include 
-ms.date: 11/20/2019
+ms.topic: include
+ms.date: 01/31/2020
 ms.author: diberry
 ---
 
 ## Prerequisites
 
-* [Go](https://golang.org/) programming language  
+* [Go](https://golang.org/) programming language
 * [Visual Studio Code](https://code.visualstudio.com/)
 * Public app ID: `df67dcdb-c37d-46af-88e1-8b97951ca1c2`
 
-## Get LUIS key
+## Create LUIS runtime key for predictions
 
-[!INCLUDE [Use authoring key for endpoint](../includes/get-key-quickstart.md)]
+1. Sign into the [Azure portal](https://portal.azure.com)
+1. Click [Create **Language Understanding**](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesLUISAllInOne)
+1. Enter all required settings for Runtime key:
+
+    |Setting|Value|
+    |--|--|
+    |Name|Desired name (2-64 characters)|
+    |Subscription|Select appropriate subscription|
+    |Location|Select any nearby and available location|
+    |Pricing Tier|`F0` - the minimal pricing tier|
+    |Resource Group|Select an available resource group|
+
+1. Click **Create** and wait for the resource to be created. After it is created, navigate to the resource page.
+1. Collect configured `endpoint` and a `key`.
 
 ## Get intent programmatically
 
 Use Go to query the [prediction endpoint](https://aka.ms/luis-apim-v3-prediction) and get a prediction result.
 
 1. Create a new file named `predict.go`. Add the following code:
-    
+
     ```go
     package main
-    
+
     /* Do dependencies */
     import (
         "fmt"
@@ -38,65 +51,67 @@ Use Go to query the [prediction endpoint](https://aka.ms/luis-apim-v3-prediction
         "log"
     )
     func main() {
-    	
+
     	// public app
         var appID = "df67dcdb-c37d-46af-88e1-8b97951ca1c2"
-    	
+
     	// utterance for public app
     	var utterance = "turn on all lights"
-    	
-    	// YOUR-KEY - your starter or prediction key
+
+    	// YOUR-KEY - your  key
     	var endpointKey = "YOUR-KEY"
-    	
-    	// YOUR-ENDPOINT - example is westus2.api.cognitive.microsoft.com
+
+    	// YOUR-ENDPOINT - example is your-resource-name.api.cognitive.microsoft.com
         var endpoint = "YOUR-ENDPOINT"
-    
+
     	endpointPrediction(appID, endpointKey, endpoint, utterance)
     }
     func endpointPrediction(appID string, endpointKey string, endpoint string, utterance string) {
-    
+
         var endpointUrl = fmt.Sprintf("https://%s/luis/prediction/v3.0/apps/%s/slots/production/predict?subscription-key=%s&verbose=true&show-all-intents=true&query=%s", endpoint, appID, endpointKey, url.QueryEscape(utterance))
-        
+
         response, err := http.Get(endpointUrl)
-    
+
         if err!=nil {
             // handle error
             fmt.Println("error from Get")
             log.Fatal(err)
         }
-        
+
         response2, err2 := ioutil.ReadAll(response.Body)
-    
+
         if err2!=nil {
             // handle error
             fmt.Println("error from ReadAll")
             log.Fatal(err2)
         }
-    
+
         fmt.Println("response")
         fmt.Println(string(response2))
     }
     ```
 
-1. Replace the following values:
+1. Replace the `YOUR-KEY` and `YOUR-ENDPOINT` values with your own prediction key and endpoint.
 
-    * `YOUR-KEY` with your starter key.
-    * `YOUR-ENDPOINT` with your endpoint. For example, `westus2.api.cognitive.microsoft.com`.
+    |Information|Purpose|
+    |--|--|
+    |`YOUR-KEY`|Your 32 character prediction key.|
+    |`YOUR-ENDPOINT`| Your prediction URL endpoint. For example, `replace-with-your-resource-name.api.cognitive.microsoft.com`.|
 
 1. With a command prompt in the same directory as where you created the file, enter the following command to compile the Go file:
 
     ```console
     go build predict.go
-    ```  
+    ```
 
-1. Run the Go application from the command line by entering the following text in the command prompt: 
+1. Run the Go application from the command line by entering the following text in the command prompt:
 
     ```console
     go run predict.go
     ```
-    
-    The command prompt response is: 
-    
+
+    The command prompt response is:
+
     ```console
     appID has value df67dcdb-c37d-46af-88e1-8b97951ca1c2
     endpointKey has value a7b206911f714e71a1ddae36928a61cc
@@ -150,13 +165,9 @@ Use Go to query the [prediction endpoint](https://aka.ms/luis-apim-v3-prediction
     ```
 
 
-## LUIS keys
-
-[!INCLUDE [Use authoring key for endpoint](../includes/starter-key-explanation.md)]
-
 ## Clean up resources
 
-When you are finished with this quickstart, delete the file from the file system. 
+When you are finished with this quickstart, delete the file from the file system.
 
 ## Next steps