Merge pull request #285431 from MicrosoftDocs/main

Taojunshen · web-flow · commit fa198a2a7a71 · 2024-08-24T05:59:59.000+08:00
8/23/2024 PM Publish
diff --git a/articles/ai-services/cognitive-services-support-options.md b/articles/ai-services/cognitive-services-support-options.md
@@ -14,16 +14,25 @@ ms.author: pafarley
 
 Are you just starting to explore the functionality of Azure AI services? Perhaps you are implementing a new feature in your application. Or after using the service, do you have suggestions on how to improve it? Here are options for where you can get support, stay up-to-date, give feedback, and report bugs for Azure AI services.
 
+## Get solutions to common issues
+
+In the Azure portal, you can find answers to common AI service issues. 
+
+1. Go to your Azure AI services resource in the Azure portal. You can find it on the list on this page: [Azure AI services](https://ms.portal.azure.com/#view/Microsoft_Azure_ProjectOxford/CognitiveServicesHub/~/AllCognitiveServices). If you're a United States government customer, use the [Azure portal for the United States government](https://portal.azure.us).
+1. In the left pane, under **Help**, select **Support + Troubleshooting**.
+1. Describe your issue in the text box, and answer the remaining questions in the form.
+1. You'll find Learn articles and other resources that might help you resolve your issue.
+
+
 ## Create an Azure support request
 
 <div class='icon is-large'>
     <img alt='Azure support' src='/media/logos/logo_azure.svg'>
 </div>
 
-Explore the range of [Azure support options and choose the plan](https://azure.microsoft.com/support/plans) that best fits, whether you're a developer just starting your cloud journey or a large organization deploying business-critical, strategic applications. Azure customers can create and manage support requests in the Azure portal.
+Explore the range of Azure support options and [choose the plan](https://azure.microsoft.com/support/plans) that best fits, whether you're a developer just starting your cloud journey or a large organization deploying business-critical, strategic applications. Azure customers can create and manage support requests in the Azure portal.
 
-* [Azure portal](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview)
-* [Azure portal for the United States government](https://portal.azure.us)
+To submit a support request for Azure AI services, follow the instructions on the [New support request](https://ms.portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade) page in the Azure portal. Select **Cognitive Services** in the **Service type** dropdown field.
 
 ## Post a question on Microsoft Q&A
 
diff --git a/articles/ai-services/language-service/personally-identifiable-information/concepts/entity-categories.md b/articles/ai-services/language-service/personally-identifiable-information/concepts/entity-categories.md
@@ -383,34 +383,9 @@ The entity in this category can have the following subcategories.
 :::row-end:::
 
 
-## Category: Quantity
+## Subcategory: Age
 
-This category contains the following entities:
-
-:::row:::
-    :::column span="":::
-        **Entity**
-
-        Quantity
-
-    :::column-end:::
-    :::column span="2":::
-        **Details**
-
-        Numbers and numeric quantities.
-      
-    :::column-end:::
-    :::column span="2":::
-      **Supported document languages**
-
-      `en`, `es`, `fr`, `de`, `it`, `zh-hans`, `ja`, `ko`, `pt-pt`, `pt-br`
-      
-   :::column-end:::
-:::row-end:::
-
-#### Subcategories
-
-The entity in this category can have the following subcategories.
+The PII service supports the Age subcategory within the broader Quantity category (since Age is the personally identifiable piece of information). 
 
 :::row:::
     :::column span="":::
diff --git a/articles/ai-services/openai/concepts/provisioned-migration.md b/articles/ai-services/openai/concepts/provisioned-migration.md
diff --git a/articles/ai-services/openai/how-to/provisioned-get-started.md b/articles/ai-services/openai/how-to/provisioned-get-started.md
@@ -8,7 +8,7 @@ ms.custom: openai
 ms.topic: how-to
 author: ChrisHMSFT
 ms.author: chrhoder
-ms.date: 08/07/2024
+ms.date: 08/23/2024
 recommendations: false
 ---
 
@@ -115,6 +115,12 @@ Learn more about the purchase model and how to purchase a reservation:
 * [Azure OpenAI provisioned onboarding guide](./provisioned-throughput-onboarding.md) 
 * [Guide for Azure OpenAI provisioned reservations](../concepts/provisioned-throughput.md) 
 
+## Optionally purchase a reservation 
+
+Following the creation of your deployment, you might want to purchase a term discount via an Azure Reservation.  An Azure Reservation can provide a substantial discount on the hourly rate for users intending to use the deployment beyond a few days.   
+
+For more information on purchasing a reservation, see [Save costs with Microsoft Azure OpenAI service Provisioned Reservations](../../../cost-management-billing/reservations/azure-openai.md).
+
 ## Make your first inferencing calls
 The inferencing code for provisioned deployments is the same a standard deployment type. The following code snippet shows a chat completions call to a GPT-4 model. For your first time using these models programmatically, we recommend starting with our [quickstart guide](../quickstart.md). Our recommendation is to use the OpenAI library with version 1.0 or greater since this includes retry logic within the library.
 
diff --git a/articles/ai-services/openai/how-to/provisioned-throughput-onboarding.md b/articles/ai-services/openai/how-to/provisioned-throughput-onboarding.md
@@ -117,6 +117,15 @@ To assist customers with purchasing the correct reservation amounts. The total n
 
 :::image type="content" source="../media/provisioned/available-quota.png" alt-text="A screenshot showing available PTU quota." lightbox="../media/provisioned/available-quota.png":::
 
+Managing Azure Reservations 
+
+After a reservation is created, it is a best practice monitor it to ensure it is receiving the usage you are expecting.  This may be done via the Azure Reservation Portal or Azure Monitor.  Details on these topics and others can be found here: 
+
+* [View Azure reservation utilization](../../../cost-management-billing/reservations/reservation-utilization.md) 
+* [View Azure Reservation purchase and refund transactions](../../../cost-management-billing/reservations/view-purchase-refunds.md) 
+* [View amortized benefit costs](../../../cost-management-billing/reservations/view-amortized-costs.md) 
+* [Charge back Azure Reservation costs](../../../cost-management-billing/reservations/charge-back-usage.md)
+* [Automatically renew Azure reservations](../../../cost-management-billing/reservations/reservation-renew.md)
 
 ## Next steps
 
diff --git a/articles/ai-services/translator/document-translation/reference/get-documents-status.md b/articles/ai-services/translator/document-translation/reference/get-documents-status.md
@@ -8,7 +8,7 @@ ms.author: lajanuar
 author: laujan
 ms.service: azure-ai-translator
 ms.topic: reference
-ms.date: 06/27/2024
+ms.date: 08/23/2024
 ---
 
 # Get status for all documents
@@ -81,9 +81,9 @@ Request headers are:
 
 |Headers|Description|Condition|
 |--- |--- |---|
-|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|Required|
-|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |&bullet; ***Required*** when using a regional (geographic) resource like **West US**.</br>&bullet.|
-|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.|&bullet; **Required**|
+|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|***Required***|
+|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |***Required*** when using a regional (geographic) resource like **West US**|
+|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.| ***Required***|
 
 ## Response status codes
 
diff --git a/articles/ai-services/translator/document-translation/reference/get-supported-glossary-formats.md b/articles/ai-services/translator/document-translation/reference/get-supported-glossary-formats.md
@@ -8,7 +8,7 @@ ms.author: lajanuar
 author: laujan
 ms.service: azure-ai-translator
 ms.topic: reference
-ms.date: 02/09/2024
+ms.date: 08/23/2024
 ---
 
 # Get supported glossary formats
@@ -36,9 +36,9 @@ Request headers are:
 
 |Headers|Description|Condition|
 |--- |--- |---|
-|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|Required|
-|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |&bullet; ***Required*** when using a regional (geographic) resource like **West US**.</br>&bullet.|
-|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.|&bullet; **Required**|
+|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|***Required***|
+|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |***Required*** when using a regional (geographic) resource like **West US**.</br>&bullet.|
+|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.| ***Required***|
 
 
 
diff --git a/articles/ai-services/translator/document-translation/reference/get-translation-status.md b/articles/ai-services/translator/document-translation/reference/get-translation-status.md
@@ -8,7 +8,7 @@ ms.author: lajanuar
 author: laujan
 ms.service: azure-ai-translator
 ms.topic: reference
-ms.date: 02/09/2024
+ms.date: 08/23/2024
 ---
 
 # Get status for a specific translation job
@@ -54,9 +54,9 @@ Request headers are:
 
 |Headers|Description|Condition|
 |--- |--- |---|
-|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|Required|
-|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |&bullet; ***Required*** when using a regional (geographic) resource like **West US**.</br>&bullet.|
-|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.|&bullet; **Required**|
+|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|***Required***|
+|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |***Required*** when using a regional (geographic) resource like **West US**.</br>&bullet.|
+|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.|***Required***|
 
 ## Response status codes
 
diff --git a/articles/ai-services/translator/document-translation/reference/get-translations-status.md b/articles/ai-services/translator/document-translation/reference/get-translations-status.md
@@ -8,7 +8,7 @@ ms.author: lajanuar
 author: laujan
 ms.service: azure-ai-translator
 ms.topic: reference
-ms.date: 02/09/2024
+ms.date: 08/23/2024
 ---
 
 # Get status for all translation jobs
@@ -67,9 +67,9 @@ Request headers are:
 
 |Headers|Description|Condition|
 |--- |--- |---|
-|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|Required|
-|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |&bullet; ***Required*** when using a regional (geographic) resource like **West US**.</br>&bullet.|
-|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.|&bullet; **Required**|
+|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|***Required***|
+|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |***Required*** when using a regional (geographic) resource like **West US**.</br>&bullet.|
+|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.|***Required***|
 
 ## Response status codes
 
diff --git a/articles/ai-services/translator/document-translation/reference/start-batch-translation.md b/articles/ai-services/translator/document-translation/reference/start-batch-translation.md
@@ -8,7 +8,7 @@ ms.author: lajanuar
 author: laujan
 ms.service: azure-ai-translator
 ms.topic: reference
-ms.date: 02/12/2024
+ms.date: 08/23/2024
 ---
 
 # Start batch translation
@@ -40,9 +40,9 @@ Request headers are:
 
 |Headers|Description|Condition|
 |--- |--- |---|
-|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|Required|
-|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |&bullet; ***Required*** when using a regional (geographic) resource like **West US**.</br>&bullet.|
-|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.|&bullet; **Required**|
+|**Ocp-Apim-Subscription-Key**|Your Translator service API key from the Azure portal.|***Required***|
+|**Ocp-Apim-Subscription-Region**|The region where your resource was created. |***Required*** when using a regional (geographic) resource like **West US**.</br>&bullet.|
+|**Content-Type**|The content type of the payload. The accepted value is **application/json** or **charset=UTF-8**.|***Required***|
 
 ## BatchRequest (body)
 
diff --git a/articles/ai-studio/how-to/deploy-models-serverless.md b/articles/ai-studio/how-to/deploy-models-serverless.md
@@ -324,6 +324,8 @@ In this section, you create an endpoint with the name **meta-llama3-8b-qwerty**.
     1. Give the deployment a name. This name becomes part of the deployment API URL. This URL must be unique in each Azure region.
 
         :::image type="content" source="../media/deploy-monitor/serverless/deployment-name.png" alt-text="A screenshot showing how to specify the name of the deployment you want to create." lightbox="../media/deploy-monitor/serverless/deployment-name.png":::
+       > [!TIP]
+       > The **Content filter (preview)** option is enabled by default. Leave the default setting for the service to detect harmful content such as hate, self-harm, sexual, and violent content. For more information about content filtering, see [Content filtering in Azure AI Studio](../concepts/content-filtering.md).
 
     1. Select **Deploy**. Wait until the deployment is ready and you're redirected to the Deployments page.
 
diff --git a/articles/ai-studio/tutorials/deploy-chat-web-app.md b/articles/ai-studio/tutorials/deploy-chat-web-app.md
@@ -38,6 +38,8 @@ The steps in this tutorial are:
 
 - You need a local copy of product data. The [Azure-Samples/rag-data-openai-python-promptflow repository on GitHub](https://github.com/Azure-Samples/rag-data-openai-python-promptflow/) contains sample retail product information that's relevant for this tutorial scenario. Specifically, the `product_info_11.md` file contains product information about the TrailWalker hiking shoes that's relevant for this tutorial example. [Download the example Contoso Trek retail product data in a ZIP file](https://github.com/Azure-Samples/rag-data-openai-python-promptflow/raw/main/tutorial/data.zip) to your local machine.
 
+- You need to have **Microsoft.Web** resource provider registered in the selected subscription, to be able to deploy to a web app.
+
 ## Add your data and try the chat model again
 
 In the [AI Studio playground quickstart](../quickstarts/get-started-playground.md) (that's a prerequisite for this tutorial), you can observe how your model responds without your data. Now you add your data to the model to help it answer questions about your products.
@@ -67,6 +69,9 @@ Publishing creates an Azure App Service in your subscription. It might incur cos
 
 To deploy the web app:
 
+> [!NOTE]
+> You need to have **Microsoft.Web** resource provider registered in the selected subscription, to be able to deploy to a web app. 
+
 1. Complete the steps in the previous section to [add your data](#add-your-data-and-try-the-chat-model-again) to the playground. 
 
     > [!NOTE]
