Merge pull request #191957 from aahill/baher-orchestration

Baher orchestration updates

Author: v-regandowner

articles/cognitive-services/language-service/orchestration-workflow/faq.md

@@ -23,7 +23,7 @@ See the [quickstart](./quickstart.md) to quickly create your first project, or t
 -->
 ## How do I connect other service applications in orchestration workflow projects?
 
-See the [Build schema article](./how-to/build-schema.md#build-project-schema-for-orchestration-workflow-projects) for information on connecting another project as an intent.
+See [How to create projects and build schemas](./how-to/create-project.md) for information on connecting another project as an intent.
 
 ## Which LUIS applications can I connect to in orchestration workflow projects?
 
@@ -44,7 +44,7 @@ See the [language support](./language-support.md) article.
 -->
 ## How do I get more accurate results for my project?
 
-Take a look at the [recommended guidelines](./how-to/build-schema.md#guidelines-and-recommendations) for information on improving accuracy.
+Take a look at the [recommended guidelines](./how-to/create-project.md) for information on improving accuracy.
 <!--
 ## How many intents, and utterances can I add to a project?
 

articles/cognitive-services/language-service/orchestration-workflow/how-to/build-schema.md

@@ -1,5 +1,5 @@
 ---
-title: How to create projects in orchestration workflow
+title: How to create projects and build schema in orchestration workflow
 titleSuffix: Azure Cognitive Services
 description: Use this article to learn how to create projects in orchestration workflow
 services: cognitive-services
@@ -15,7 +15,7 @@ ms.custom: language-service-orchestration
 
 # How to create projects in orchestration workflow
 
-Orchestration workflow allows you to create projects that connect your applications in:
+Orchestration workflow allows you to create projects that connect your applications to:
 * Custom Language Understanding
 * Question Answering
 * LUIS
@@ -25,7 +25,7 @@ Orchestration workflow allows you to create projects that connect your applicati
 
 To get started, you have to first sign in to [Language Studio](https://aka.ms/languageStudio) and create a Language resource. Select **Done** once selection is complete.
 
-In language studio, find the **Understand conversational language** section, and select **Orchestration workflow**.
+In language studio, find the **Understand questions and conversational language** section, and select **Orchestration workflow**.
 
 You will see the orchestration workflow projects page.
 
@@ -36,20 +36,20 @@ You will see the orchestration workflow projects page.
 Select **Create new project**. When creating your workflow project, you need to provide the following details:
 - Name: Project name
 - Description: Optional project description
-- Text primary language: The primary language of your project. Your training data should be mainly be in this language.
-- Enable multiple languages: Whether you would like to enable your project to support multiple languages at once.
+- Utterances primary language: The primary language of your utterances.
 
-Once you're done, you now have the option to connect to the other projects and services you wish to orchestrate to. Each connection is represented by its type and relevant data. The intent needs to have a **name**, a **project type** (LUIS, question answering (QnA), or Conversational Language Understanding), and then selecting the project you want to connect to by name. 
+## Building schema and adding intents
+
+Once you're done creating a project, you can connect it to the other projects and services you want to orchestrate to. Each connection is represented by its type and relevant data. 
+
+To create a new intent, click on *+Add* button and start by giving your intent a **name**. You will see two options, to connect to a project or not. You can connect to (LUIS, question answering (QnA), or Conversational Language Understanding) projects, or choose the **no** option. 
 
 > [!NOTE]
 > The list of projects you can connect to are only projects that are owned by the same Language resource you are using to create the orchestration project.
 
-This step is optional and you will still have the option to add intent connections after you create the project.
 
 :::image type="content" source="../media/orchestration-project-detail.png" alt-text="A screenshot showing the Conversational Language Understanding orchestration workflow project modal." lightbox="../media/orchestration-project-detail.png":::
 
-## Add intents
-
 In Orchestration Workflow projects, the data used to train connected intents isn't provided within the project. Instead, the project pulls the data from the connected service (such as connected LUIS applications, Conversational Language Understanding projects, or Custom Question Answering knowledge bases) during training. However, if you create intents that are not connected to any service, you still need to add utterances to those intents.
 
 ## Export and import a project
@@ -61,4 +61,4 @@ To import a project, select the arrow button on the projects page next to **Crea
 
 ## Next Steps
 
-[Build schema](./build-schema.md)
+[Build schema](./train-model.md)

articles/cognitive-services/language-service/orchestration-workflow/how-to/create-project.md

@@ -0,0 +1,26 @@
+---
+title: How to tag utterances in an orchestration workflow project
+titleSuffix: Azure Cognitive Services
+description: Use this article to tag utterances
+services: cognitive-services
+author: aahill
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: language-service
+ms.topic: how-to
+ms.date: 03/03/2022
+ms.author: aahi
+ms.custom: language-service-orchestration
+---
+
+# How to tag utterances in orchestration workflow projects
+
+Once you have [built a schema](create-project.md) for your project, you should add training utterances to your project. The utterances should be similar to what your users will use when interacting with the project. When you add an utterance you have to assign which intent it belongs to. You can only add utterances to the created intents within the project and not the connected intents.
+
+## Filter Utterances
+
+Clicking on **Filter** lets you view only the utterances associated to the intents you select in the filter pane.
+When clicking on an intent in the [build schema](./create-project.md) page then you'll be moved to the **Tag Utterances** page, with that intent filtered automatically. 
+
+## Next Steps
+* [Train and Evaluate Model](./train-model.md)

articles/cognitive-services/language-service/orchestration-workflow/how-to/tag-utterances.md

@@ -0,0 +1,98 @@
+---
+services: cognitive-services
+author: aahill
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: language-service
+ms.topic: include
+ms.date: 03/16/2022
+ms.author: aahi
+---
+
+## Prerequisites
+
+* Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services).
+
+## Sign in to Language Studio
+
+1. Go to the [Language Studio](https://aka.ms/languageStudio) and sign in with your Azure account. 
+
+2. In the **Choose a language resource** window that appears, find your Azure subscription, and choose your Language resource. If you don't have a resource, you can create a new one.
+
+    > [!NOTE]
+    > Currently only resources with the standard (**S**) pricing tier can be used with the Conversational Language Understanding service.
+    
+    :::image type="content" source="../../../conversational-language-understanding/media/quickstart-language-resource.png" alt-text="A screenshot showing the resource selection screen in Language Studio." lightbox="../../../conversational-language-understanding/media/quickstart-language-resource.png":::
+
+## Create an orchestration project
+
+Once you have a Language resource associated with your account, create an orchestration workflow project. In this quickstart, you'll create a project that connects between different Conversation Language Understanding projects and Custom Question Answering projects.
+
+1. In [Language Studio](https://aka.ms/languageStudio), find the section labeled **Understand questions and conversational language** and select **Orchestration Workflow**.  
+   
+   :::image type="content" source="../../../conversational-language-understanding/media/select-custom-clu.png" alt-text="A screenshot showing the location of Custom Language Understanding in the Language Studio landing page." lightbox="../../../conversational-language-understanding/media/select-custom-clu.png"::: 
+    
+
+2. This will bring you to the **Orchestration workflow project** page. Select **Create new project**.
+
+    :::image type="content" source="../../../conversational-language-understanding/media/projects-page.png" alt-text="A screenshot showing the conversation project page in Language Studio." lightbox="../../../conversational-language-understanding/media/projects-page.png":::
+
+
+You then need to provide the following details:
+
+|Value  | Description  |
+|---------|---------|
+|Name     | A name for your project.        |
+|Description    | Optional project description.        |
+|Utterances primary language | The primary language of your project. Your training data should primarily be in this language. For this quickstart, choose **English**.        |
+
+Once you're done, select **Next** and review the details. Select **create project** to complete the process. You should now see the **Build Schema** screen in your project.
+
+## Build schema
+
+1. Click on *+Add* button to add your intent.
+2. Give your intent a name and choose to connect the intent to an existing project.
+3. Click on *Add intent* button. 
+4. Another option is to select *no* when creating an intent and don't connect it to an existing project.
+
+When you select the intent, you will see the [tag utterances](../../how-to/tag-utterances.md) page, where you can add examples for intents.
+
+
+:::image type="content" source="../../../conversational-language-understanding/media/quickstart-intents.png" alt-text="A screenshot showing the schema page in Language studio." lightbox="../../../conversational-language-understanding/media/quickstart-intents.png":::
+
+## Tag utterances
+
+In the tag utterances page, let's add a few examples to the intents. Select the **Greeting** intent from the drop-down box that says **Select Intent**.
+
+In the text box that says **Write your example utterance and press enter**, write the sentence "*Good evening*" and press enter to add it as an example utterance.
+
+Add the rest of these utterances to the **Greeting** intent to the Training set.
+
+|Utterance|
+|--|
+|*Good evening*|
+|*Good morning*|
+|*Hey*|
+|*What's up*|
+
+When you're done, select **Save Changes** to save the utterances and labels to the project. The icon next to the button will turn green when the changes are saved. Next, go to the **Train Model** page.
+
+:::image type="content" source="../../../conversational-language-understanding/media/quickstart-utterances.png" alt-text="A screenshot showing the intents tagging screen in Language Studio." lightbox="../../../conversational-language-understanding/media/quickstart-utterances.png":::
+
+## Train your model and view its details
+
+Select **train model** on the left of the screen. Select **Start a training job**. To train your model, you need to provide a name for the model. Write a name like "*v1*" and press the enter key. 
+
+You should see the **View model details** page. Wait until training completes, which may take about 5 minutes. When training succeeds, Select **Deploy Model** on the left of the screen.
+
+## Deploy your model
+
+From the **Deploy model** page on the left of te screen, Select **Add deployment**. To deploy your model, you need to create a new deployment name. Write a name like "*staging*" and press the next button. 
+
+Once you're done, select **Next** and review the details. For the connected projects, select which deployment name from the drop-down menu and press *Submit*.
+
+## Test your model
+
+Select **Test model** on the left of the screen, and select the deployment name from the drop-down menu. Add your test, for example *Good morning* in the text field and click on **Run the test**. 
+
+You now see the top intent as **Greeting**.