Merge pull request #95362 from diberry/diberry/1109-luis-how-to

[Cogsvcs] LUIS - start new app

Author: megvanhuygen

articles/cognitive-services/LUIS/luis-container-howto.md

@@ -9,7 +9,7 @@ ms.custom: seodec18
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 11/04/2019
+ms.date: 11/08/2019
 ms.author: dapine
 ---
 
@@ -31,7 +31,7 @@ To run the LUIS container, note the following prerequisites:
 |--|--|
 |Docker Engine| You need the Docker Engine installed on a [host computer](#the-host-computer). Docker provides packages that configure the Docker environment on [macOS](https://docs.docker.com/docker-for-mac/), [Windows](https://docs.docker.com/docker-for-windows/), and [Linux](https://docs.docker.com/engine/installation/#supported-platforms). For a primer on Docker and container basics, see the [Docker overview](https://docs.docker.com/engine/docker-overview/).<br><br> Docker must be configured to allow the containers to connect with and send billing data to Azure. <br><br> **On Windows**, Docker must also be configured to support Linux containers.<br><br>|
 |Familiarity with Docker | You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic `docker` commands.| 
-|Azure `Cognitive Services` resource and LUIS [packaged app](luis-how-to-start-new-app.md#export-app-for-containers) file |In order to use the container, you must have:<br><br>* A _Cognitive Services_ Azure resource and the associated billing key the billing endpoint URI. Both values are available on the Overview and Keys pages for the resource and are required to start the container. <br>* A trained or published app packaged as a mounted input to the container with its associated App ID. You can get the packaged file from the LUIS portal or the Authoring APIs. If you are getting LUIS packaged app from the [authoring APIs](#authoring-apis-for-package-file), you will also need your _Authoring Key_.<br><br>These requirements are used to pass command-line arguments to the following variables:<br><br>**{AUTHORING_KEY}**: This key is used to get the packaged app from the LUIS service in the cloud and upload the query logs back to the cloud. The format is `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`.<br><br>**{APP_ID}**: This ID is used to select the App. The format is `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`.<br><br>**{API_KEY}**: This key is used to start the container. You can find the endpoint key in two places. The first is the Azure portal within the _Cognitive Services_ resource's keys list. The endpoint key is also available in the LUIS portal on the Keys and Endpoint settings page. Do not use the starter key.<br><br>**{ENDPOINT_URI}**: The endpoint as provided on the Overview page.<br><br>The [authoring key and endpoint key](luis-boundaries.md#key-limits) have different purposes. Do not use them interchangeably. |
+|Azure `Cognitive Services` resource and LUIS [packaged app](luis-how-to-start-new-app.md) file |In order to use the container, you must have:<br><br>* A _Cognitive Services_ Azure resource and the associated billing key the billing endpoint URI. Both values are available on the Overview and Keys pages for the resource and are required to start the container. <br>* A trained or published app packaged as a mounted input to the container with its associated App ID. You can get the packaged file from the LUIS portal or the Authoring APIs. If you are getting LUIS packaged app from the [authoring APIs](#authoring-apis-for-package-file), you will also need your _Authoring Key_.<br><br>These requirements are used to pass command-line arguments to the following variables:<br><br>**{AUTHORING_KEY}**: This key is used to get the packaged app from the LUIS service in the cloud and upload the query logs back to the cloud. The format is `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`.<br><br>**{APP_ID}**: This ID is used to select the App. The format is `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`.<br><br>**{API_KEY}**: This key is used to start the container. You can find the endpoint key in two places. The first is the Azure portal within the _Cognitive Services_ resource's keys list. The endpoint key is also available in the LUIS portal on the Keys and Endpoint settings page. Do not use the starter key.<br><br>**{ENDPOINT_URI}**: The endpoint as provided on the Overview page.<br><br>The [authoring key and endpoint key](luis-boundaries.md#key-limits) have different purposes. Do not use them interchangeably. |
 
 [!INCLUDE [Gathering required container parameters](../containers/includes/container-gathering-required-parameters.md)]
 

articles/cognitive-services/LUIS/luis-how-to-start-new-app.md

@@ -9,28 +9,28 @@ ms.custom: seodec18
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 10/25/2019
+ms.date: 11/08/2019
 ms.author: diberry
 ---
 
 # Create a new LUIS app in the LUIS portal
-There are a couple of ways to create a LUIS app. You can create a LUIS app in the [LUIS](https://www.luis.ai) portal, or through the LUIS authoring [APIs](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c2f).
+There are a couple of ways to create a LUIS app. You can create a LUIS app in the LUIS portal, or through the LUIS authoring [APIs](developer-reference-resource.md).
 
-[!INCLUDE [Waiting for LUIS portal refresh](./includes/wait-v3-upgrade.md)]
+[!INCLUDE [Uses preview portal](includes/uses-portal-preview.md)]
 
 ## Using the LUIS portal
 
-You can create a new app in the LUIS portal in several ways:
+You can create a new app in the preview portal in several ways:
 
 * Start with an empty app and create intents, utterances, and entities.
 * Start with an empty app and add a [prebuilt domain](luis-how-to-use-prebuilt-domains.md).
-* Import a LUIS app from a JSON file that already contains intents, utterances, and entities.
+* Import a LUIS app from a `.lu` or `.json` file that already contains intents, utterances, and entities.
 
 ## Using the authoring APIs
 You can create a new app with the authoring APIs in a couple of ways:
 
-* [Start](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c2f) with an empty app and create intents, utterances, and entities.
-* [Start](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/59104e515aca2f0b48c76be5) with a prebuilt domain.  
+* [Add application](https://westeurope.dev.cognitive.microsoft.com/docs/services/luis-programmatic-apis-v3-0-preview/operations/5890b47c39e2bb052c5b9c2f) - start with an empty app and create intents, utterances, and entities.
+* [Add prebuilt application](https://westeurope.dev.cognitive.microsoft.com/docs/services/luis-programmatic-apis-v3-0-preview/operations/59104e515aca2f0b48c76be5) - start with a prebuilt domain, including intents, utterances, and entities.  
 
 
 <a name="export-app"></a>
@@ -42,51 +42,36 @@ You can create a new app with the authoring APIs in a couple of ways:
 
 ## Create new app in LUIS
 
-1. On **My Apps** page, select **+ Create**.
+1. On **My Apps** page, select your subscription, and authoring resource then **+ Create**. If you are using free trial key, learn how to [create an authoring resource](luis-how-to-azure-subscription.md#create-resources-in-the-azure-portal).
 
-    ![LUIS apps list](./media/luis-create-new-app/apps-list.png)
+    ![LUIS apps list](./media/create-app-in-portal.png)
 
 
-2. In the dialog box, name your application "TravelAgent".
+1. In the dialog box, enter the name of your application, such as `Pizza Tutorial`.
 
-    ![Create new app dialog](./media/luis-create-new-app/create-app.png)
+    ![Create new app dialog](./media/create-pizza-tutorial-app-in-portal.png)
 
-3. Choose your application culture (for TravelAgent app, choose English), and then select **Done**. 
+1. Choose your application culture, and then select **Done**. The description and prediction resource are optional at this point. You can set then at any time in the **Manage** section of the portal.
 
     > [!NOTE]
     > The culture cannot be changed once the application is created. 
 
-## Import an app from file
+    After the app is created, the LUIS portal shows the **Intents** list with the `None` intent already created for you. You now have an empty app. 
+    
+    > [!div class="mx-imgBorder"]
+    > ![Intents list with None intent created with no example utterances.](media/pizza-tutorial-new-app-empty-intent-list.png)
 
-1. On **My Apps** page, select **Import new app**.
-1. In the pop-up dialog, select a valid app JSON file, and then select **Done**.
+## Other actions available
 
-### Import errors
+The context toolbar provides other actions:
 
-Possible errors are: 
-
-* An app with that name already exists. To fix this, reimport the app, and set the **Optional Name** to a new name. 
-
-## Export app for backup
-
-1. On **My Apps** page, select **Export**.
-1. Select **Export as JSON**. Your browser downloads the active version of the app.
-1. Add this file to your backup system to archive the model.
-
-## Export app for containers
-
-1. On **My Apps** page, select **Export**.
-1. Select **Export as container** then select which published slot (production or stage) you want to export.
-1. Use this file with your [LUIS container](luis-container-howto.md). 
-
-    If you are interested in exporting a trained but not yet published model to use with the LUIS container, go to the **Versions** page and export from there. 
-
-## Delete app
-
-1. On **My Apps** page, select the three dots (...) at the end of the app row.
-1. Select **Delete** from the menu.
-1. Select **Ok** in the confirmation window.
+* Rename app
+* Import from file using `.lu` or `.json`
+* Export app as `.lu` (for [LUDown](https://github.com/microsoft/botbuilder-tools/tree/master/packages/Ludown)), `.json`, or `.zip` (for [LUIS container](luis-container-howto.md))
+* Import container endpoint logs, to review endpoint utterances
+* Export endpoint logs, as a `.csv`, for offline analysis
+* Delete app
 
 ## Next steps
 
-Your first task in the app is to [add intents](luis-how-to-add-intents.md).
+If your app design includes intent detection, [create new intents](luis-how-to-add-intents.md), and add example utterances. If your app design is only data extraction, add example utterances to the None intent, then [create entities](luis-how-to-add-example-utterances.md), and label the example utterances with those entities. 

articles/cognitive-services/LUIS/luis-language-support.md

@@ -9,7 +9,7 @@ ms.custom: seodec18
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 10/16/2019
+ms.date: 11/08/2019
 ms.author: diberry
 ---
 
@@ -201,4 +201,4 @@ Tokenizer JSON for version 1.0.1. Notice the property value for  `tokenizerVersi
 
 Tokenization happens at the app level. There is no support for version-level tokenization. 
 
-[Import the file as a new app](luis-how-to-start-new-app.md#import-an-app-from-file), instead of a version. This action means the new app has a different app ID but uses the tokenizer version specified in the file. 
+[Import the file as a new app](luis-how-to-start-new-app.md), instead of a version. This action means the new app has a different app ID but uses the tokenizer version specified in the file. 

articles/cognitive-services/LUIS/media/create-app-in-portal.png

@@ -9,7 +9,7 @@ services: cognitive-services
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 10/25/2019
+ms.date: 11/08/2019
 ms.author: diberry
 ---
 # Language Understanding Frequently Asked Questions (FAQ)
@@ -68,7 +68,7 @@ In the LUIS portal, you can label text for the exact entity you are interested i
 
 ### I tried to import an app or version file but I got an error, what happened? 
 
-Read more about [version import errors](luis-how-to-manage-versions.md#import-errors) and [app import errors](luis-how-to-start-new-app.md#import-errors).
+Read more about [version import errors](luis-how-to-manage-versions.md#import-errors).
 
 <a name="luis-collaborating"></a>