Merge pull request #209533 from PatrickFarley/cogserv-qss

v-regandowner · web-flow · commit d122939b1ef4 · 2022-08-29T16:47:47.000-04:00
[cog svcs] try split up portal instructions into tabs
diff --git a/articles/cognitive-services/cognitive-services-apis-create-account.md b/articles/cognitive-services/cognitive-services-apis-create-account.md
@@ -14,7 +14,7 @@ ms.author: aahi
 
 # Quickstart: Create a Cognitive Services resource using the Azure portal
 
-Use this quickstart to create a Cognitive Services resource. After you create a Cognitive Service resource in the Azure portal , you'll get an endpoint and a key for authenticating your applications.
+Use this quickstart to create a Cognitive Services resource. After you create a Cognitive Service resource in the Azure portal, you'll get an endpoint and a key for authenticating your applications.
 
 Azure Cognitive Services are cloud-based services with REST APIs, and client library SDKs available to help developers build cognitive intelligence into applications without having direct artificial intelligence (AI) or data science skills or knowledge. Azure Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, understand, and even begin to reason.
 
@@ -46,59 +46,30 @@ The multi-service resource is named **Cognitive Services** in the portal. The mu
     
     :::image type="content" source="media/cognitive-services-apis-create-account/resource_create_screen-multi.png" alt-text="Multi-service resource creation screen":::
 
-1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
+1. Configure other settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
 
 ### [Decision](#tab/decision)
 
-1. You can select one of these links to create a Decision resource: 
-    - [Anomaly Detector](https://portal.azure.com/#create/Microsoft.CognitiveServicesAnomalyDetector)
-    - [Content Moderator](https://portal.azure.com/#create/Microsoft.CognitiveServicesContentModerator)
-    - [Metrics Advisor](https://portal.azure.com/#create/Microsoft.CognitiveServicesMetricsAdvisor)
-    - [Personalizer](https://portal.azure.com/#create/Microsoft.CognitiveServicesPersonalizer)
-
-1. On the **Create** page, provide the following information:
-
-    [!INCLUDE [Create Azure resource for subscription](./includes/quickstarts/cognitive-resource-project-details.md)]
-
-1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
+[!INCLUDE [Create Decision resource for subscription](./includes/quickstarts/create-decision-resource-portal.md)]
 
 ### [Language](#tab/language)
 
-1. You can select one of these links to create a Language resource: 
-    - [Immersive reader](https://portal.azure.com/#create/Microsoft.CognitiveServicesImmersiveReader)
-    - [Language Understanding (LUIS)](https://portal.azure.com/#create/Microsoft.CognitiveServicesLUISAllInOne)
-    - [Language service](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextAnalytics)
-    - [Translator](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation)
-    - [QnA Maker](https://portal.azure.com/#create/Microsoft.CognitiveServicesQnAMaker)
-
-1. On the **Create** page, provide the following information:
-
-    [!INCLUDE [Create Azure resource for subscription](./includes/quickstarts/cognitive-resource-project-details.md)]
-
-1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
+[!INCLUDE [Create Language resource for subscription](./includes/quickstarts/create-language-resource-portal.md)]
 
 ### [Speech](#tab/speech)
 
-1. You can select this link to create a Speech resource: [Speech Services](https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices)
+1. Select the following links to create a Speech resource: 
+   - [Speech Services](https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices)
 
 1. On the **Create** page, provide the following information:
 
     [!INCLUDE [Create Azure resource for subscription](./includes/quickstarts/cognitive-resource-project-details.md)]
 
-1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
+1. Select **Review + create**.
 
 ### [Vision](#tab/vision)
 
-1. You can select one of these links to create a Vision resource: 
-    - [Computer vision](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision)
-    - [Custom vision service](https://portal.azure.com/#create/Microsoft.CognitiveServicesCustomVision)
-    - [Face](https://portal.azure.com/#create/Microsoft.CognitiveServicesFace) 
-
-1. On the **Create** page, provide the following information:
-
-    [!INCLUDE [Create Azure resource for subscription](./includes/quickstarts/cognitive-resource-project-details.md)]
-
-1. Configure additional settings for your resource as needed, read and accept the conditions (as applicable), and then select **Review + create**.
+[!INCLUDE [Create Vision resource for subscription](./includes/quickstarts/create-vision-resource-portal.md)]
 
 ---
 
@@ -126,7 +97,7 @@ If you want to clean up and remove a Cognitive Services subscription, you can de
 1. In the Azure portal, expand the menu on the left side to open the menu of services, and choose **Resource Groups** to display the list of your resource groups.
 1. Locate the resource group containing the resource to be deleted.
 1. If you want to delete the entire resource group, select the resource group name. On the next page, Select **Delete resource group**, and confirm.
-1. If you want to delete only the Cognitive Service resource, select the resource group to see all the resources within it. On the next page, select the resource that you want to delete, click the ellipsis menu for that row, and select **Delete**. 
+1. If you want to delete only the Cognitive Service resource, select the resource group to see all the resources within it. On the next page, select the resource that you want to delete, select the ellipsis menu for that row, and select **Delete**. 
 
 If you need to recover a deleted resource, see [Recover deleted Cognitive Services resources](manage-resources.md).
 
diff --git a/articles/cognitive-services/includes/quickstarts/create-decision-resource-portal.md b/articles/cognitive-services/includes/quickstarts/create-decision-resource-portal.md
@@ -0,0 +1,45 @@
+---
+title: Create a Decision resource
+services: cognitive-services
+author: PatrickFarley
+manager: nitinme
+ms.service: cognitive-services
+ms.topic: include
+ms.date: 08/29/2022
+ms.author: pafarley
+---
+
+#### [Anomaly Detector](#tab/anomaly-detector)
+
+1. Select the following link to create an Anomaly Detector resource:
+   - [Anomaly Detector](https://portal.azure.com/#create/Microsoft.CognitiveServicesAnomalyDetector)
+1. On the **Create** page, provide the following information:
+   [!INCLUDE [Create Azure resource for subscription](./cognitive-resource-project-details.md)]
+1. Select **Review + create**.
+
+#### [Content Moderator](#tab/content-moderator)
+
+1. Select the following link to create a Content Moderator resource:
+   - [Content Moderator](https://portal.azure.com/#create/Microsoft.CognitiveServicesContentModerator)
+1. On the **Create** page, provide the following information:
+
+   [!INCLUDE [Create Azure resource for subscription](./cognitive-resource-project-details.md)]
+1. Select **Review + create**.
+
+#### [Metrics Advisor](#tab/metrics-advisor)
+
+1. Select the following link to create a Metrics Advisor resource:
+   - [Metrics Advisor](https://portal.azure.com/#create/Microsoft.CognitiveServicesMetricsAdvisor)
+1. On the **Create** page, provide the following information:
+
+   |Project details| Description   |
+   |--|--|
+   | **Subscription** | Select one of your available Azure subscriptions. |
+   | **Resource group** | The Azure resource group that will contain your Cognitive Services resource. You can create a new group or add it to a pre-existing group. |
+   | **Region** | The location of your cognitive service instance. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
+   | **Name** | A descriptive name for your cognitive services resource. For example, *MyCognitiveServicesResource*. |
+   | **Pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the API [pricing details](/azure/cognitive-services/custom-vision-service/limits-and-quotas).|
+   | **Storage** | You can optionally use your own Azure database resource to store the data that Metrics Advisor will use.
+1. Mark your acknowledgment of the Service Agreement and Terms and then select **Review + create**.
+
+---
diff --git a/articles/cognitive-services/includes/quickstarts/create-language-resource-portal.md b/articles/cognitive-services/includes/quickstarts/create-language-resource-portal.md
@@ -0,0 +1,70 @@
+---
+title: Create a Language resource
+services: cognitive-services
+author: PatrickFarley
+manager: nitinme
+ms.service: cognitive-services
+ms.topic: include
+ms.date: 08/29/2022
+ms.author: pafarley
+---
+
+#### [Language service](#tab/language-service)
+
+1. Select the following link to create a Language resource:
+   - [Language service](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextAnalytics)
+1. On the **Select additional features** page, choose whether you'd like to include the customization features that work with other services.
+1. On the **Create** page, provide the following information:
+
+   [!INCLUDE [Create Azure resource for subscription](./cognitive-resource-project-details.md)]
+1. Mark your acknowledgment of the Responsible AI terms and select **Review + create**.
+
+#### [Language Understanding (LUIS)](#tab/luis)
+
+1. Select the following link to create a LUIS resource:
+   - [Language Understanding (LUIS)](https://portal.azure.com/#create/Microsoft.CognitiveServicesLUISAllInOne)
+1. On the **Create** page, provide the following information:
+
+   |Project details| Description   |
+   |--|--|
+   | **Create options** | LUIS uses two separate resources together. The **Authoring** resource lets you train models, and the **Prediction** resource lets you publish and query models. Select **Both** if you're starting the project from scratch. |
+   | **Subscription** | Select one of your available Azure subscriptions. |
+   | **Resource group** | The Azure resource group that will contain your Cognitive Services resource. You can create a new group or add it to a pre-existing group. |
+   | **Name** | A descriptive name for your cognitive services resource. For example, *MyCognitiveServicesResource*. |
+   | **Authoring Resource Region** | The location of your Authoring resource. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
+   | **Authoring Pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the API [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/language-understanding-intelligent-services/#pricing).|
+   | **Prediction Resource Region** | The location of your Prediction resource. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
+   | **Prediction Pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the API [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/language-understanding-intelligent-services/#pricing).|
+1. Select **Review + create**.
+
+#### [Translator](#tab/translator)
+
+1. Select the following link to create a Translator resource:
+   - [Translator](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation)
+1. On the **Create** page, provide the following information:
+
+    [!INCLUDE [Create Azure resource for subscription](./cognitive-resource-project-details.md)]
+
+1. Select **Review + create**.
+
+#### [QnA Maker](#tab/qna)
+
+1. Select the following link to create a QnA Maker resource:
+   - [QnA Maker](https://portal.azure.com/#create/Microsoft.CognitiveServicesQnAMaker)
+1. On the **Create** page, provide the following information:
+
+    |Project details| Description   |
+    |--|--|
+    | **Subscription** | Select one of your available Azure subscriptions. |
+    | **Resource group** | The Azure resource group that will contain your Cognitive Services resource. You can create a new group or add it to a pre-existing group. |
+    | **Name** | A descriptive name for your cognitive services resource. For example, *MyCognitiveServicesResource*. |
+    | **Pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the API [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/translator/#pricing).|
+    | **Azure Search location** | The location of the Azure Search instance that will go with your QnA Maker resource. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
+    | **Azure Search pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the Cognitive Search [pricing details](https://azure.microsoft.com/pricing/details/search/#pricing).|
+    | **App name** | Enter a name for the App Service app that will handle your QnA Maker queries.|
+    | **Website location** | The location of the App Service instance that will go with your QnA Maker resource. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
+    | **App insights** | Choose whether you'd like to use an Application Insights resource in tandem with your QnA Maker resource. |
+    | **App insights location** | Different locations may introduce latency, but have no impact on the runtime availability of your resource.|
+1. Select **Review + create**.
+
+---
diff --git a/articles/cognitive-services/includes/quickstarts/create-vision-resource-portal.md b/articles/cognitive-services/includes/quickstarts/create-vision-resource-portal.md
@@ -0,0 +1,48 @@
+---
+title: Create a Vision resource
+services: cognitive-services
+author: PatrickFarley
+manager: nitinme
+ms.service: cognitive-services
+ms.topic: include
+ms.date: 08/29/2022
+ms.author: pafarley
+---
+
+#### [Computer Vision](#tab/computer-vision)
+
+1. Select the following link to create a Computer Vision resource:
+   - [Computer vision](https://portal.azure.com/#create/Microsoft.CognitiveServicesComputerVision)
+
+1. On the **Create** page, provide the following information:
+   [!INCLUDE [Create Azure resource for subscription](./cognitive-resource-project-details.md)]
+1. Mark your acknowledgment of the Responsible AI terms and then select **Review + create**.
+
+#### [Face](#tab/face)
+
+1. Select the following link to create a Face resource:
+   - [Face](https://portal.azure.com/#create/Microsoft.CognitiveServicesFace) 
+1. On the **Create** page, provide the following information:
+
+   [!INCLUDE [Create Azure resource for subscription](./cognitive-resource-project-details.md)]
+1. Mark your acknowledgment of the Face terms of use and then select **Review + create**.
+
+#### [Custom Vision](#tab/custom-vision)
+
+1. Select the following link to create a Custom Vision resource:
+   - [Custom Vision service](https://portal.azure.com/#create/Microsoft.CognitiveServicesCustomVision)
+1. On the **Create** page, provide the following information:
+
+    |Project details| Description   |
+    |--|--|
+    | **Create options** | Custom Vision uses two separate resources together. The **Training** resource lets you train models, and the **Prediction** resource lets you publish and query models. Select **Both** if you're starting the project from scratch. |
+    | **Subscription** | Select one of your available Azure subscriptions. |
+    | **Resource group** | The Azure resource group that will contain your Cognitive Services resource. You can create a new group or add it to a pre-existing group. |
+    | **Region** | The location of your cognitive service instance. Different locations may introduce latency, but have no impact on the runtime availability of your resource. |
+    | **Name** | A descriptive name for your cognitive services resource. For example, *MyCognitiveServicesResource*. |
+    | **Training pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the API [pricing details](/azure/cognitive-services/custom-vision-service/limits-and-quotas).|
+    | **Prediction pricing tier** | The cost of your Cognitive Services account depends on the options you choose and your usage. For more information, see the API [pricing details](/azure/cognitive-services/custom-vision-service/limits-and-quotas/).
+1. Select **Review + create**.
+
+
+---
