Merge pull request #192044 from MicrosoftDocs/release-cogsvcs-orchestration

Release cogsvcs orchestration

Author: huypub

articles/cognitive-services/LUIS/how-to/orchestration-projects.md

@@ -7,7 +7,7 @@ author: aahill
 ms.manager: nitinme
 ms.subservice: language-understanding
 ms.topic: how-to
-ms.date: 01/06/2022
+ms.date: 03/08/2022
 ---
 
 # Combine LUIS and question answering capabilities
@@ -34,14 +34,14 @@ As an example, if your chat bot receives the text "How do I get to the Human Res
 
 Orchestration helps you connect more than one project and service together. Each connection in the orchestration is represented by a type and relevant data. The intent needs to have a name, a project type (LUIS, question answering, or conversational language understanding, and a project you want to connect to by name.
 
-You can use conversational language understanding to create a new orchestration project, See the [conversational language understanding documentation](../../language-service/conversational-language-understanding/how-to/create-project.md#create-an-orchestration-workflow-project).
+You can use conversational language understanding to create a new orchestration project, See the [conversational language understanding documentation](../../language-service/orchestration-workflow/how-to/create-project.md).
 
 ## Set up orchestration between Cognitive Services features
 
 To use an orchestration project to connect LUIS, question answering, and conversational language understanding, you need:
 
 * A language resource in [Language Studio](https://language.azure.com/) or the Azure portal.
-* To change your LUIS authoring resource to the Language resource. You can also optionally export your application from LUIS, and then [import it into conversational language understanding](../../language-service/conversational-language-understanding/how-to/create-project.md#import-a-project).
+* To change your LUIS authoring resource to the Language resource. You can also optionally export your application from LUIS, and then [import it into conversational language understanding](../../language-service/orchestration-workflow/how-to/create-project.md#export-and-import-a-project).
 
 >[!Note]
 >LUIS can be used with Orchestration projects in West Europe only, and requires the authoring resource to be a Language resource. You can either import the application in the West Europe Language resource or change the authoring resource from the portal.
@@ -60,4 +60,4 @@ You need to follow the following steps to change LUIS authoring resource to a La
 
 ## Next steps
 
-[Conversational language understanding documentation](../../language-service/conversational-language-understanding/how-to/create-project.md#create-an-orchestration-workflow-project).
+* [Conversational language understanding documentation](../../language-service/conversational-language-understanding/how-to/create-project.md)

articles/cognitive-services/language-service/conversational-language-understanding/concepts/backwards-compatibility.md

@@ -8,16 +8,16 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: overview
-ms.date: 11/02/2021
+ms.date: 03/03/2022
 ms.author: aahi
 ms.custom: language-service-clu, ignite-fall-2021
 ---
 
 # Backwards compatibility with LUIS applications
 
-You can reuse some of the content of your existing LUIS applications in Conversational Language Understanding. When working with Conversational Language Understanding projects, you can:
+You can reuse some of the content of your existing LUIS applications in [Conversational Language Understanding](../overview.md). When working with Conversational Language Understanding projects, you can:
 * Create CLU conversation projects from LUIS application JSON files.
-* Create LUIS applications that can be connected to orchestration workflow projects.  
+* Create LUIS applications that can be connected to [orchestration workflow](../../orchestration-workflow/overview.md) projects.  
 
 > [!NOTE]
 > This guide assumes you have created a Language resource. If you're getting started with the service, see the [quickstart article](../quickstart.md). 

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

@@ -21,22 +21,14 @@ Use this article to quickly get the answers to common questions about conversati
 
 See the [quickstart](./quickstart.md) to quickly create your first project, or the [how-to article](./how-to/create-project.md) for more details. 
 
-## How do I connect other service applications in orchestration workflow projects?
+## How do I connect conversation language projects to other service applications?
 
-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.
-
-## Which LUIS applications can I connect to in orchestration workflow projects?
-
-LUIS applications that use the Language resource as their authoring resource will be available for connection. You can only connect to LUIS applications that are owned by the same resource. This option will only be available for resources in West Europe, as it's the only common available region between LUIS and CLU. See [region limits](./service-limits.md#region-limits) for more information. 
+See the [orchestration workflow documentation](../orchestration-workflow/overview.md) for more information.
 
 ## Training is taking a long time, is this expected?
 
 For conversation projects, long training times are expected. Based on the number of examples you have your training times may vary from 5 minutes to 1 hour or more. 
 
-## Can I add entities to orchestration workflow projects?
-
-No. Orchestration projects are only enabled for intents that can be connected to other projects for routing. 
-
 ## How do I use entity components?
 
 See the [entity components](./concepts/entity-components.md) article.

articles/cognitive-services/language-service/conversational-language-understanding/how-to/build-schema.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: how-to
-ms.date: 11/02/2021
+ms.date: 03/03/2022
 ms.author: aahi
 ms.custom: language-service-clu, ignite-fall-2021
 ---
@@ -39,13 +39,6 @@ They might create an intent to represent each of these actions. They might also
 * Date
 * Meeting durations
 
-
-For **orchestration workflow** projects, you can only create intents. The orchestration workflow project is intended to route to other target services that may be enabled with entity extraction to complete the conversation flow. You can add new intents that are connected to other services _or_ create intents that aren't connected to any service (a disconnected intent). 
-
-By adding a disconnected intent, you allow the orchestrator to route to that intent, and return without calling into an additional service. You must provide training examples for disconnected intents. You can only connect to projects that are owned by the same Azure resource. 
-
-Continuing the example from earlier, the developers for a bot might realize that for each skill of their bot (which includes: calendar actions, email actions, and a company FAQ), they need an intent that connects to each of those skills.  
-
 ## Build project schema for conversation projects
 
 To build a project schema for conversation projects:
@@ -60,20 +53,5 @@ To build a project schema for conversation projects:
 
     :::image type="content" source="../media/entity-details.png" alt-text="A screenshot showing the entity details page for conversation projects in Language Studio." lightbox="../media/entity-details.png":::
 
-## Build project schema for orchestration workflow projects
-
-To build a project schema for orchestration workflow projects: 
-
-1. Select **Add** in the **Build Schema** page. You will be prompted for a name and to define a connection for the intent, if any. If you would like to connect an intent you must provide:
-    1. **Service Type**: LUIS, Custom Question Answering (QnA), or Conversational Language Understanding.
-    2. **Project Name**: The project you want the intent to connect to.
-    3. **Version for utterances** (Only for LUIS): which LUIS version should be used to train the orchestrator classification model.
-
-    :::image type="content" source="../media/orchestration-intent.png" alt-text="A screenshot showing the intent creation modal for orchestration projects in Language Studio." lightbox="../media/orchestration-intent.png":::
-
-> [!IMPORTANT]
-> * Connected intents cannot be selected because you cannot add training examples to a connected intent, as it already uses the target project's data to train its intent classification.
-> * You will only be able to connect to target services that are owned by the same resource.
-
 ## Next Steps
 * [Tag utterances](tag-utterances.md)

articles/cognitive-services/language-service/conversational-language-understanding/how-to/create-project.md

@@ -8,14 +8,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: language-service
 ms.topic: how-to
-ms.date: 11/02/2021
+ms.date: 03/03/2022
 ms.author: aahi
 ms.custom: language-service-clu, ignite-fall-2021
 ---
 
 # How to create projects in Conversational Language Understanding
 
-Conversational Language Understanding allows you to create two types of projects: **Conversation** and **Orchestration Workflow** projects.
+Conversational Language Understanding allows you to create conversation projects. To create orchestration projects, see the [orchestration workflow](../../orchestration-workflow/overview.md) documentation. 
 
 ## Sign in to Language Studio
 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.
@@ -39,23 +39,6 @@ After selecting conversation, you need to provide the following details:
 
 Once you're done, click next, review the details, and then click create project to complete the process. 
 
-## Create an orchestration workflow project
-
-After selecting orchestration, 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.
-
-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, custom question answering (QnA), or Conversational Language Understanding), and then selecting the project you want to connect to by name. 
-
-> [!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":::
-
 ## Import a project
 
 You can export a Conversational Language Understanding project as a JSON file at any time by going to the conversation projects page, selecting a project, and pressing **Export**.

articles/cognitive-services/language-service/conversational-language-understanding/how-to/deploy-query-model.md

@@ -14,7 +14,7 @@ ms.devlang: csharp, python
 ms.custom: language-service-clu, ignite-fall-2021
 ---
 
-# Deploy and test model
+# Deploy and test a conversational language understanding model
 
 After you have [trained a model](./train-model.md) on your dataset, you're ready to deploy it. After deploying your model, you'll be able to query it for predictions. 
 
@@ -54,22 +54,6 @@ To delete a deployment, select the deployment you want to delete and click on **
 > [!NOTE]
 > You can only have ten deployment names.
 
-### Orchestration workflow projects deployments
-
-1.	Click on **Add deployment** to submit a new deployment job.
-
-    Like conversation projects, In the window that appears, you can create a new deployment name by giving the deployment a name or override an existing deployment name. Then, you can add a trained model to this deployment name and press next.
-
-    :::image type="content" source="../media/create-deployment-job-orch.png" alt-text="A screenshot showing deployment job creation in Language Studio." lightbox="../media/create-deployment-job-orch.png":::
-
-2. If you're connecting one or more LUIS applications or conversational language understanding projects, specify the deployment name.
-
-    No configurations are required for custom question answering or unlinked intents.
-
-    LUIS projects **must be published** to the slot configured during the Orchestration deployment, and custom question answering KBs must also be published to their Production slots.
-
-    :::image type="content" source="../media/deploy-connected-services.png" alt-text="A screenshot showing the deployment screen for orchestration workflow projects." lightbox="../media/deploy-connected-services.png":::
-
 ## Send a Conversational Language Understanding request
 
 Once your model is deployed, you can begin using the deployed model for predictions. Outside of the test model page, you can begin calling your deployed model via API requests to your provided custom endpoint. This endpoint request obtains the intent and entity predictions defined within the model.
@@ -126,16 +110,6 @@ In a conversations project, you'll get predictions for both your intents and ent
     - Its start location denoted by an offset value
     - The length of the entity text denoted by a length value.
 
-## API response for an orchestration Workflow Project
-
-Orchestration workflow projects return with the response of the top scoring intent, and the response of the service it is connected to.
-- Within the intent, the *targetKind* parameter lets you determine the type of response that was returned by the orchestrator's top intent (conversation, LUIS, or QnA Maker).
-- You will get the response of the connected service in the *result* parameter. 
-
-Within the request, you can specify additional parameters for each connected service, in the event that the orchestrator routes to that service.
-- Within the project parameters, you can optionally specify a different query to the connected service. If you don't specify a different query, the original query will be used.
-- The *direct target* parameter allows you to bypass the orchestrator's routing decision and directly target a specific connected intent to force a response for it.
-
 ## Next steps
 
 * [Conversational Language Understanding overview](../overview.md)

articles/cognitive-services/language-service/conversational-language-understanding/how-to/tag-utterances.md

@@ -30,10 +30,6 @@ For example, to improve a calender bot's performance with users, a developer mig
 * "_Reply as **tentative** to the **weekly update** meeting._" (English)
 * "_Cancelar mi **próxima** reunión_." (Spanish)
 
-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.
-
-For example, a developer might create an intent for each of their skills, and connect it to a respective calendar project, email project, and company FAQ knowledge base. 
-
 ## Tag utterances
 
 :::image type="content" source="../media/tag-utterances.png" alt-text="A screenshot of the page for tagging utterances in Language Studio." lightbox="../media/tag-utterances.png":::

articles/cognitive-services/language-service/conversational-language-understanding/how-to/train-model.md

@@ -19,7 +19,7 @@ After you have completed [tagging your utterances](./tag-utterances.md), you can
 
 You can create and train multiple models within the same project. However, if you re-train a specific model it overwrites the last state.
 
-The training times can be anywhere from a few seconds when dealing with orchestration workflow projects, up to a couple of hours when you reach the [maximum limit](../service-limits.md) of utterances. Before training, you will have the option to enable evaluation, which lets you view how your model performs. 
+The training times can be anywhere from a few seconds up to a couple of hours when you reach the [maximum limit](../service-limits.md) of utterances. Before training, you will have the option to enable evaluation, which lets you view how your model performs. 
 
 ## Train model
 

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

@@ -39,7 +39,7 @@ The supported languages for conversation projects are:
 | Czech | `cs` |
 | Welsh | `cy` |
 | Danish | `da` |
-| German | `de` 
+| German | `de` |
 | Greek | `el` |
 | English (US) | `en-us` |
 | English (Uk) | `en-gb` |
@@ -125,20 +125,6 @@ The supported languages for conversation projects are:
 
 When you enable multiple languages in a project, you can add data in multiple languages to your project. You can also train the project in one language and immediately predict it in other languages. The quality of predictions may vary between languages – and certain language groups work better than others with respect to multilingual predictions.
 
-
-## Supported languages for orchestration workflow projects
-
-|Language| Language code |
-|---|---|
-| Brazilian Portuguese | `pt-br` |
-| English | `en-us` |
-| French | `fr-fr` |
-| German | `de-de` |
-| Italian | `it-it` |
-| Spanish | `es-es` |
-
-Orchestration workflow projects are not available for use in multiple languages.
-
 ## Next steps
 
 [Conversational language understanding overview](overview.md)

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

@@ -27,4 +27,3 @@ Conversational language understanding applies custom machine-learning intelligen
 * Robust and semantically aware classification and extraction models.
 * Simplified model building experience, using Language Studio.
 * Natively multilingual models that let you to train in one language, and test in others.
-* Orchestration project types that allow you to connect services including other Conversational Language Understanding projects, custom question answering knowledge bases, and LUIS applications.