Merge pull request #1695 from MicrosoftDocs/main

Taojunshen · web-flow · commit c3da7e107e89 · 2024-11-23T02:01:21.000+08:00
11/22/2024 AM Publish
diff --git a/articles/ai-services/computer-vision/concept-face-detection.md b/articles/ai-services/computer-vision/concept-face-detection.md
@@ -13,6 +13,7 @@ ms.custom:
 ms.topic: conceptual
 ms.date: 09/18/2024
 ms.author: pafarley
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Face detection, attributes, and input data
diff --git a/articles/ai-services/computer-vision/concept-face-recognition-data-structures.md b/articles/ai-services/computer-vision/concept-face-recognition-data-structures.md
@@ -13,6 +13,7 @@ ms.custom:
 ms.topic: conceptual
 ms.date: 11/04/2023
 ms.author: pafarley
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Face recognition data structures
diff --git a/articles/ai-services/computer-vision/concept-face-recognition.md b/articles/ai-services/computer-vision/concept-face-recognition.md
@@ -12,6 +12,7 @@ ms.custom:
 ms.topic: conceptual
 ms.date: 10/16/2024
 ms.author: pafarley
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Face recognition
diff --git a/articles/ai-services/computer-vision/concept-liveness-abuse-monitoring.md b/articles/ai-services/computer-vision/concept-liveness-abuse-monitoring.md
@@ -7,11 +7,13 @@ author: PatrickFarley
 manager: nitinme
 
 ms.service: azure-ai-vision
+ms.subservice: azure-ai-face
 ms.topic: conceptual
 ms.date: 11/05/2023
 ms.author: pafarley
 ms.custom:
   - ignite-2023
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Abuse monitoring in Face liveness detection
diff --git a/articles/ai-services/computer-vision/enrollment-overview.md b/articles/ai-services/computer-vision/enrollment-overview.md
@@ -10,6 +10,7 @@ ms.subservice: azure-ai-face
 ms.topic: best-practice
 ms.date: 02/14/2024
 ms.author: pafarley
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Best practices for adding users to a Face service
diff --git a/articles/ai-services/computer-vision/how-to/add-faces.md b/articles/ai-services/computer-vision/how-to/add-faces.md
@@ -12,6 +12,7 @@ ms.date: 02/14/2024
 ms.author: pafarley
 ms.devlang: csharp
 ms.custom: devx-track-csharp
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Add faces to a PersonGroup
diff --git a/articles/ai-services/computer-vision/how-to/find-similar-faces.md b/articles/ai-services/computer-vision/how-to/find-similar-faces.md
@@ -11,6 +11,7 @@ ms.subservice: azure-ai-face
 ms.topic: how-to
 ms.date: 02/14/2024
 ms.author: pafarley
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Find similar faces
diff --git a/articles/ai-services/computer-vision/how-to/identity-access-token.md b/articles/ai-services/computer-vision/how-to/identity-access-token.md
@@ -11,6 +11,7 @@ ms.subservice: azure-ai-face
 ms.topic: how-to
 ms.date: 03/07/2024
 ms.author: pafarley
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Use limited access tokens for Face
diff --git a/articles/ai-services/computer-vision/how-to/identity-detect-faces.md b/articles/ai-services/computer-vision/how-to/identity-detect-faces.md
@@ -13,6 +13,7 @@ ms.date: 02/14/2024
 ms.author: pafarley
 ms.devlang: csharp
 ms.custom: devx-track-csharp
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Call the Detect API
diff --git a/articles/ai-services/computer-vision/how-to/mitigate-latency.md b/articles/ai-services/computer-vision/how-to/mitigate-latency.md
@@ -6,13 +6,15 @@ description: Learn how to mitigate network latency and improve service performan
 author: PatrickFarley
 manager: nitinme
 ms.service: azure-ai-vision
+ms.subservice: azure-ai-face
 ms.topic: how-to
 ms.date: 11/06/2023
 ms.author: pafarley
 ms.devlang: csharp
 ms.custom:
   - cogserv-non-critical-vision
   - ignite-2023
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Mitigate latency and improve performance
diff --git a/articles/ai-services/computer-vision/how-to/specify-detection-model.md b/articles/ai-services/computer-vision/how-to/specify-detection-model.md
@@ -13,6 +13,7 @@ ms.date: 06/10/2024
 ms.author: pafarley
 ms.devlang: csharp
 ms.custom: devx-track-csharp
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Specify a face detection model
diff --git a/articles/ai-services/computer-vision/how-to/specify-recognition-model.md b/articles/ai-services/computer-vision/how-to/specify-recognition-model.md
@@ -6,11 +6,13 @@ description: This article shows you how to choose which recognition model to use
 author: PatrickFarley
 manager: nitinme
 ms.service: azure-ai-vision
+ms.subservice: azure-ai-face
 ms.topic: how-to
 ms.date: 01/19/2024
 ms.author: pafarley
 ms.devlang: csharp
 ms.custom: devx-track-csharp
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Specify a face recognition model
diff --git a/articles/ai-services/computer-vision/how-to/use-headpose.md b/articles/ai-services/computer-vision/how-to/use-headpose.md
@@ -14,6 +14,7 @@ ms.devlang: csharp
 ms.custom:
   - devx-track-csharp
   - ignite-2023
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Use the HeadPose attribute
diff --git a/articles/ai-services/computer-vision/how-to/use-large-scale.md b/articles/ai-services/computer-vision/how-to/use-large-scale.md
@@ -15,6 +15,7 @@ ms.devlang: csharp
 ms.custom:
   - devx-track-csharp
   - ignite-2023
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Scale to handle more enrolled users
diff --git a/articles/ai-services/computer-vision/how-to/use-persondirectory.md b/articles/ai-services/computer-vision/how-to/use-persondirectory.md
@@ -13,6 +13,7 @@ ms.date: 02/27/2024
 ms.author: pafarley
 ms.devlang: csharp
 ms.custom: [devx-track-csharp, cogserv-non-critical-vision]
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Use the PersonDirectory data structure (preview)
diff --git a/articles/ai-services/computer-vision/identity-api-reference.md b/articles/ai-services/computer-vision/identity-api-reference.md
@@ -11,6 +11,7 @@ ms.subservice: azure-ai-face
 ms.topic: reference
 ms.date: 02/17/2021
 ms.author: nitinme
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Face API reference list
diff --git a/articles/ai-services/computer-vision/identity-encrypt-data-at-rest.md b/articles/ai-services/computer-vision/identity-encrypt-data-at-rest.md
@@ -7,10 +7,11 @@ manager: nitinme
 
 ms.service: azure-ai-vision
 ms.subservice: azure-ai-face
-ms.topic: conceptual
+ms.topic: how-to
 ms.date: 02/27/2024
 ms.author: pafarley
 ms.custom: cogserv-non-critical-vision
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 #Customer intent: As a user of the Face service, I want to learn how encryption at rest works.
 ---
 
diff --git a/articles/ai-services/computer-vision/identity-quotas-limits.md b/articles/ai-services/computer-vision/identity-quotas-limits.md
@@ -12,6 +12,7 @@ ms.custom:
 ms.topic: conceptual
 ms.date: 10/24/2023
 ms.author: pafarley
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Azure Face service quotas and limits
diff --git a/articles/ai-services/computer-vision/overview-identity.md b/articles/ai-services/computer-vision/overview-identity.md
@@ -13,6 +13,7 @@ ms.author: pafarley
 ms.custom:
   - ignite-2023
 keywords: facial recognition, facial recognition software, facial analysis, face matching, face recognition app, face search by image, facial recognition search
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 #Customer intent: As the developer of an app that deals with images of humans, I want to learn what the Face service does so I can determine if I should use its features.
 ---
 
diff --git a/articles/ai-services/computer-vision/quickstarts-sdk/identity-client-library.md b/articles/ai-services/computer-vision/quickstarts-sdk/identity-client-library.md
@@ -15,6 +15,7 @@ ms.devlang: csharp
 # ms.devlang: csharp, golang, javascript, python
 ms.custom: devx-track-python, devx-track-csharp, mode-api, devx-track-dotnet, devx-track-extended-java, devx-track-js
 keywords: face search by image, facial recognition search, facial recognition, face recognition app
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Quickstart: Use the Face service
diff --git a/articles/ai-services/computer-vision/reference-face-error-codes.md b/articles/ai-services/computer-vision/reference-face-error-codes.md
@@ -7,6 +7,7 @@ ms.subservice: azure-ai-face
 ms.topic: reference
 ms.author: shaoli
 ms.date: 05/24/2024
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Azure AI Face API error codes
diff --git a/articles/ai-services/computer-vision/tutorials/build-enrollment-app.md b/articles/ai-services/computer-vision/tutorials/build-enrollment-app.md
@@ -12,6 +12,7 @@ ms.custom:
 ms.topic: tutorial
 ms.date: 02/14/2024
 ms.author: pafarley
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Build a React Native app to add users to a Face service
diff --git a/articles/ai-services/computer-vision/tutorials/liveness.md b/articles/ai-services/computer-vision/tutorials/liveness.md
@@ -4,10 +4,12 @@ description: In this Tutorial, you learn how to Detect liveness in faces, using
 author: PatrickFarley
 ms.author: pafarley
 ms.service: azure-ai-vision
+ms.subservice: azure-ai-face
 ms.custom:
   - ignite-2023
 ms.topic: tutorial
 ms.date: 09/25/2024
+feedback_help_link_url: https://learn.microsoft.com/answers/tags/156/azure-face
 ---
 
 # Tutorial: Detect liveness in faces
diff --git a/articles/ai-services/openai/concepts/provisioned-throughput.md b/articles/ai-services/openai/concepts/provisioned-throughput.md
@@ -41,14 +41,17 @@ An Azure OpenAI Deployment is a unit of management for a specific OpenAI Model.
 ## How much throughput per PTU you get for each model
 The amount of throughput (tokens per minute or TPM) a deployment gets per PTU is a function of the input and output tokens in the minute. Generating output tokens requires more processing than input tokens and so the more output tokens generated the lower your overall TPM. The service dynamically balances the input & output costs, so users do not have to set specific input and output limits. This approach means your deployment is resilient to fluctuations in the workload shape. 
 
-To help with simplifying the sizing effort, the following table outlines the TPM per PTU for the `gpt-4o` and `gpt-4o-mini` models which represent the max all the traffic is either input or output. The table also shows Service Level Agreement (SLA) Latency Target Values per model.  For more information about the SLA for Azure OpenAI Service, see the [Service Level Agreements (SLA) for Online Services page].(https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services?lang=1)
+To help with simplifying the sizing effort, the following table outlines the TPM per PTU for the `gpt-4o` and `gpt-4o-mini` models which represent the max TPM assuming all traffic is either input or output. To understand how different ratios of input and output tokens impact your Max TPM per PTU, see the [Azure OpenAI capacity calculator](https://oai.azure.com/portal/calculator). The table also shows Service Level Agreement (SLA) Latency Target Values per model.  For more information about the SLA for Azure OpenAI Service, see the [Service Level Agreements (SLA) for Online Services page](https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services?lang=1)
 
-|     | **gpt-4o**, **2024-05-13**   & **gpt-4o**, **2024-08-06**   | **gpt-4o-mini**, **2024-07-18**   |
+|| **gpt-4o**, **2024-05-13**   & **gpt-4o**, **2024-08-06**   | **gpt-4o-mini**, **2024-07-18**   |
 | --- | --- | --- |
-| Deployable Increments | 50 | 25|
+|Global provisioned minimum deployment|15|15|
+|Global provisioned scale increment|5|5|
+| Regional provisioned minimum deployment | 50 | 25|
+|Regional provisioned scale increment|50|25|
 |Max Input TPM per PTU | 2,500 | 37,000  |
 |Max Output TPM per PTU| 833|12,333|
-| Latency Target Value |25 Tokens Per Second* |33 Tokens Per Second*|
+| Latency Target Value |25 Tokens Per Second|33 Tokens Per Second|
 
 For a full list see the [AOAI Studio calculator](https://oai.azure.com/portal/calculator).
 
diff --git a/articles/ai-studio/how-to/develop/evaluate-sdk.md b/articles/ai-studio/how-to/develop/evaluate-sdk.md
@@ -81,7 +81,7 @@ Built-in evaluators can accept *either* query and response pairs or a list of co
 | `HateUnfairnessEvaluator`        | Required: String | Required: String | N/A           | N/A           |Supported |
 | `IndirectAttackEvaluator`      | Required: String | Required: String | Required: String | N/A           |Supported |
 | `ProtectedMaterialEvaluator`  | Required: String | Required: String | N/A           | N/A           |Supported |
-| `QAEvaluator`      | Required: String | Required: String | Required: String | N/A           | Not supported |
+| `QAEvaluator`      | Required: String | Required: String | Required: String | Required: String           | Not supported |
 | `ContentSafetyEvaluator`      | Required: String | Required: String |  N/A  | N/A           | Supported |
 
 - Query: the query sent in to the generative AI application
diff --git a/articles/ai-studio/tutorials/copilot-sdk-create-resources.md b/articles/ai-studio/tutorials/copilot-sdk-create-resources.md
@@ -107,7 +107,7 @@ In the Azure AI Foundry portal, check for an Azure AI Search connected resource.
 1. Use **API key** for **Authentication**.
 
     > [!NOTE]
-    > You can instead use **Microsoft Entra ID** for **Authentication**. If you do this, you must also configure access control for the Azure AI Search service. Assign yourself the **Search Index Data Contributor** and **Search Service Contributor** roles. If you don't know how to do this, or don't have the necessary permissions, use the **API key** for **Authentication**.
+    > You can instead use **Microsoft Entra ID** for **Authentication**. If you do this, you must also configure access control for the Azure AI Search service. Assign the **Search Index Data Contributor** and **Search Service Contributor** roles to your user account. If you don't know how to do this, or don't have the necessary permissions, use the **API key** for **Authentication**.
 
 1. Select **Add connection**.  
 
diff --git a/articles/machine-learning/how-to-manage-environments-in-studio.md b/articles/machine-learning/how-to-manage-environments-in-studio.md
@@ -8,7 +8,7 @@ ms.subservice: core
 author: Blackmist
 ms.author: larryfr
 ms.reviewer: osiotugo
-ms.date: 09/18/2024
+ms.date: 11/22/2024
 ms.topic: how-to
 ms.custom:
 # Customer Intent: As a Data Scientist, I want to understand how to manage environments for training and inference in Azure Machine Learning studio.
@@ -60,13 +60,19 @@ If a new environment is given the same name as an existing environment in the wo
 
 ## View and edit environment details
 
-Once an environment has been created, view its details by selecting the name. Use the dropdown menu to select different versions of the environment. Here you can view metadata and the contents of the environment through its various dependencies.
+1. Once an environment has been created, view its details by selecting the __Name__ from the __Custom environments__ tab.
 
-Select the pencil icons to edit tags, descriptions, configuration files under the **Context** tab.
+    :::image type="content" source="media/how-to-manage-environments-in-studio/select-existing-environment.png" alt-text="Screenshot of the custom environments page." lightbox="media/how-to-manage-environments-in-studio/select-existing-environment.png":::
 
-Keep in mind that any changes to the Docker or Conda sections create a new version of the environment.
+1. Use the __Version__ dropdown menu to select different versions of the environment. From the __Details__ tab, you can view metadata and the contents of the environment through its various dependencies. Select the pencil icons to edit fields such as __Description__ and __Tags__.
 
-:::image type="content" source="media/how-to-manage-environments-in-studio/details-page.png" alt-text="Screenshot of the environment details page.":::
+    :::image type="content" source="media/how-to-manage-environments-in-studio/environment-details.png" alt-text="Screenshot of the environment details tab." lightbox="media/how-to-manage-environments-in-studio/environment-details.png":::
+
+3. Select the __Context__ tab to upload additional files or edit the existing Dockerfile. Use __Save and Build__ to save any changes and rebuild the context.
+
+    Keep in mind that any changes to the Docker or Conda sections create a new version of the environment.
+
+    :::image type="content" source="media/how-to-manage-environments-in-studio/environment-context.png" alt-text="Screenshot of the environment context tab." lightbox="media/how-to-manage-environments-in-studio/environment-context.png":::
 
 ## View logs
 
diff --git a/articles/machine-learning/media/how-to-manage-environments-in-studio/details-page.png b/articles/machine-learning/media/how-to-manage-environments-in-studio/details-page.png
diff --git a/articles/machine-learning/media/how-to-manage-environments-in-studio/environment-context.png b/articles/machine-learning/media/how-to-manage-environments-in-studio/environment-context.png
diff --git a/articles/machine-learning/media/how-to-manage-environments-in-studio/environment-details.png b/articles/machine-learning/media/how-to-manage-environments-in-studio/environment-details.png
diff --git a/articles/machine-learning/media/how-to-manage-environments-in-studio/select-existing-environment.png b/articles/machine-learning/media/how-to-manage-environments-in-studio/select-existing-environment.png
