Merge pull request #265553 from MicrosoftDocs/main

2/7 11:00 AM IST Publish

Author: Saisang

articles/active-directory-b2c/custom-policies-series-validate-user-input.md

@@ -379,7 +379,7 @@ Follow the steps in [Upload custom policy file](custom-policies-series-hello-wor
 
 ## Step 7 - Validate user input by using validation technical profiles
 
-The validation techniques we've used in step 1, step 2 and step 3 aren't applicable for all scenarios. If your business rules are complex to be defined at claim declaration level, you can configure a [Validation Technical](validation-technical-profile.md), and then call it from a [Self-Asserted Technical Profile](self-asserted-technical-profile.md).
+The validation techniques we've used in step 1, step 2 and step 3 aren't applicable for all scenarios. If your business rules are too complex to be defined at claim declaration level, you can configure a [Validation Technical](validation-technical-profile.md), and then call it from a [Self-Asserted Technical Profile](self-asserted-technical-profile.md).
 
 > [!NOTE] 
 > Only self-asserted technical profiles can use validation technical profiles. Learn more about [validation technical profile](validation-technical-profile.md) 

articles/ai-services/document-intelligence/containers/install-run.md

@@ -18,25 +18,29 @@ ms.author: lajanuar
 <!-- markdownlint-disable MD024 -->
 <!-- markdownlint-disable MD051 -->
 
-:::moniker range="doc-intel-2.1.0 || doc-intel-3.1.0||doc-intel-4.0.0"
+:::moniker range="doc-intel-2.1.0 || doc-intel-4.0.0"
 
-Support for containers is currently available with Document Intelligence version `2022-08-31 (GA)` only:
+Support for containers is currently available with Document Intelligence version `2022-08-31 (GA)` for all models and `2023-07-31 (GA)` for Read and Layout only:
 
 * [REST API `2022-08-31 (GA)`](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2022-08-31/operations/AnalyzeDocument)
+* [REST API `2023-07-31 (GA)`](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2023-07-31/operations/AnalyzeDocument)
 * [SDKs targeting `REST API 2022-08-31 (GA)`](../sdk-overview-v3-0.md)
+* [SDKs targeting `REST API 2023-07-31 (GA)`](../sdk-overview-v3-1.md)
 
 ✔️ See [**Install and run Document Intelligence v3.0 containers**](?view=doc-intel-3.0.0&preserve-view=true) for supported container documentation.
 
 :::moniker-end
 
-:::moniker range="doc-intel-3.0.0"
+:::moniker range="doc-intel-3.0.0 || doc-intel-3.1.0"
 
-**This content applies to:** ![checkmark](../media/yes-icon.png) **v3.0 (GA)**
+**This content applies to:** ![checkmark](../media/yes-icon.png) **v3.0 (GA)** ![checkmark](../media/yes-icon.png) **v3.1 (GA)**
 
 Azure AI Document Intelligence is an Azure AI service that lets you build automated data processing software using machine-learning technology. Document Intelligence enables you to identify and extract text, key/value pairs, selection marks, table data, and more from your documents. The results are delivered as structured data that ../includes the relationships in the original file.
 
 In this article you learn how to download, install, and run Document Intelligence containers. Containers enable you to run the Document Intelligence service in your own environment. Containers are great for specific security and data governance requirements.
 
+* **Read**, and **Layout**  models are supported by Document Intelligence v3.1 containers.
+
 * **Read**, **Layout**, **General Document**, **ID Document**,  **Receipt**, **Invoice**, **Business Card**, and **Custom** models are supported by Document Intelligence v3.0 containers.
 
 * **Business Card** model is currently only supported in the [v2.1 containers](install-run.md?view=doc-intel-2.1.0&preserve-view=true).

articles/ai-services/security-controls-policy.md

@@ -1,7 +1,7 @@
 ---
 title: Azure Policy Regulatory Compliance controls for Azure AI services
 description: Lists Azure Policy Regulatory Compliance controls available for Azure AI services. These built-in policy definitions provide common approaches to managing the compliance of your Azure resources.
-ms.date: 01/22/2024
+ms.date: 02/06/2024
 ms.topic: sample
 author: PatrickFarley
 ms.author: pafarley

articles/ai-services/speech-service/includes/release-notes/release-notes-sdk.md

@@ -11,7 +11,7 @@ ms.author: eur
 * With the End of Life for **OpenSSL 1.1.1** on September 11th, we are working on changes to support OpenSSL 3.0 that will release soon. This streamlines usage on Linux Distributions that only have OpenSSL 3.0 pre-installed (such as Ubuntu 22.04).
 * **Ubuntu 18.04** also hit end of life back in April of 2023, so our users should prepare for us to move our minimum version up to Ubuntu 20.04 soon.
 
-### Speech SDK 1.34.1: January 2024 release
+### Speech SDK 1.35.0: February 2024 release
 
 #### New features
 
@@ -26,6 +26,10 @@ ms.author: eur
 *  Return a correct cancellation error code for an internal server error on WebSocket connections.
 *  Fix the failure to load FPIEProcessor.dll library when MAS is used with C#.
 
+#### Samples
+
+* Minor formatting updates for Embedded recognition samples.
+
 ### Speech SDK 1.34.1: January 2024 release
 
 #### Breaking changes

articles/ai-studio/how-to/costs-plan-manage.md

@@ -87,7 +87,7 @@ When you use cost analysis, you view Azure AI hub resource costs in graphs and t
 
 ### Monitor Azure AI Studio project costs
 
-You can get to cost analysis from the [Azure portal](https://portal.azure.com). You can also get to cost analysis from the [Azure AI Studio portal](https://ai.azure.com).
+You can get to cost analysis from the [Azure portal](https://portal.azure.com). You can also get to cost analysis from the [Azure AI Studio](https://ai.azure.com).
 
 > [!IMPORTANT]
 > Your Azure AI project costs are only a subset of your overall application or solution costs. You need to monitor costs for all Azure resources used in your application or solution. See [Azure AI hub resources](../concepts/ai-resources.md) for more information.
@@ -96,14 +96,14 @@ For the examples in this section, assume that all Azure AI Studio resources are
 
 Here's an example of how to monitor costs for an Azure AI Studio project. The costs are used as an example only. Your costs will vary depending on the services that you use and the amount of usage.
 
-1. Sign in to [Azure AI Studio portal](https://ai.azure.com).
+1. Sign in to [Azure AI Studio](https://ai.azure.com).
 1. Select your project and then select **Settings** from the left navigation menu.
 
     :::image type="content" source="../media/cost-management/project-costs/project-settings-go-view-costs.png" alt-text="Screenshot of the Azure AI Studio portal showing how to see project settings." lightbox="../media/cost-management/project-costs/project-settings-go-view-costs.png":::
 
-1. Select **See project cost on Azure portal**. The Azure portal opens to the cost analysis page for your project. 
+1. Select **View cost for resources**. The [Azure portal](https://portal.azure.com) opens to the cost analysis page for your project. 
 
-1. Expand the **Resource** column to see the costs for each service that's underlying your [Azure AI project](../concepts/ai-resources.md#organize-work-in-projects-for-customization). But this view doesn't include costs for all resources that you use in an Azure AI Studio project.
+1. Expand the **Resource** column to see the costs for each service that's underlying your [Azure AI project](../concepts/ai-resources.md#organize-work-in-projects-for-customization). But this view doesn't include costs for all resources that you use in an Azure AI project.
 
     :::image type="content" source="../media/cost-management/project-costs/costs-per-project-resource.png" alt-text="Screenshot of the Azure portal cost analysis with the Azure AI project and associated resources." lightbox="../media/cost-management/project-costs/costs-per-project-resource.png":::
 
@@ -125,7 +125,7 @@ Here's an example of how to monitor costs for an Azure AI Studio project. The co
 
     :::image type="content" source="../media/cost-management/project-costs/costs-per-project-resource-details.png" alt-text="Screenshot of the Azure portal cost analysis with Azure AI project expanded." lightbox="../media/cost-management/project-costs/costs-per-project-resource-details.png":::
 
-1. Expand **contoso_ai_resource** to see the costs for services underlying the [Azure AI](../concepts/ai-resources.md#azure-ai-hub-resources) resource. You can also apply a filter to focus on other costs in your resource group. 
+1. Expand **contoso_ai_resource** to see the costs for services underlying the [Azure AI hub](../concepts/ai-resources.md#azure-ai-hub-resources) resource. You can also apply a filter to focus on other costs in your resource group. 
 
 You can also view resource group costs directly from the Azure portal. To do so:
 1. Sign in to [Azure portal](https://portal.azure.com).

articles/ai-studio/how-to/generate-data-qa.md

@@ -7,7 +7,7 @@ ms.service: azure-ai-studio
 ms.custom:
   - ignite-2023
 ms.topic: how-to
-ms.date: 11/15/2023
+ms.date: 2/6/2024
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
@@ -124,7 +124,7 @@ print(f"Tokens used: {result['token_usage']}")
 
 ## Using the generated data in prompt flow
 
-One of the features of prompt flow is the ability to test and evaluate your flows on batch of inputs. This approach is useful for checking the quality and performance of your flows before deploying them. To use this feature, you need to provide the data in a specific (.jsonl) format that prompt flow can understand. We prepare this data from the questions and answers that we have generated in [Generate data from text](#generate-data-from-text) step. We use this data for batch run and flow evaluation.
+One of the features of [prompt flow](./prompt-flow.md) is the ability to test and [evaluate your flows](./evaluate-flow-results.md) with a batch of inputs. This approach is useful for checking the quality and performance of your flows before deploying them. To use this feature, you need to provide the data in a specific (.jsonl) format that prompt flow can understand. Now prepare this data from the questions and answers that we generated in [Generate data from text](#generate-data-from-text) step. We use this data for batch run and flow evaluation.
 
 ### Format and save the generated data
 
@@ -156,7 +156,7 @@ data_df.to_json(output_file, lines=True, orient="records")
 
 ### Use the data for evaluation
 
-To use the "generated_qa.jsonl" file for evaluation, you need to add this file as data to your evaluation flow. Go to a flow in Azure AI Studio and select **Evaluate**.
+To use the `generated_qa.jsonl` file for evaluation, you need to add this file as data to your evaluation flow. Go to a flow in Azure AI Studio and select **Evaluate**.
 
 1. Enter details in **Basic Settings**
 2. Select **Add new data** from **Batch run settings**.

articles/ai-studio/how-to/index-add.md

@@ -116,9 +116,9 @@ If the Azure AI hub resource the project uses was created through Azure portal:
 
 ## Use an index in prompt flow
 
-1. Open your AI Studio project
-1. In Flows, create a new Flow or open an existing flow 
-1. On the top menu of the flow designer, select **More tools**, and then select ***Index Lookup***
+1. Open your AI Studio project.
+1. In **Flows**, create a new flow or open an existing flow.
+1. On the top menu of the flow designer, select **More tools**, and then select ***Index Lookup***.
 
     :::image type="content" source="../media/index-retrieve/index-lookup-tool.png" alt-text="Screenshot of Vector index Lookup from More Tools." lightbox="../media/index-retrieve/index-lookup-tool.png":::
 

articles/ai-studio/how-to/prompt-flow-tools/faiss-index-lookup-tool.md

@@ -42,7 +42,7 @@ The following are available input parameters:
 
 ## Outputs
 
-The following JSON format response is an example returned by the tool that includes the top-k scored entities. The entity follows a generic schema of vector search result provided by promptflow-vectordb SDK. For the Faiss Index Search, the following fields are populated:
+The following JSON format response is an example returned by the tool that includes the top-k scored entities. The entity follows a generic schema of vector search result provided by the `promptflow-vectordb` SDK. For the Faiss Index Search, the following fields are populated:
 
 | Field Name | Type | Description |
 | ---- | ---- | ----------- |

articles/ai-studio/how-to/prompt-flow-tools/index-lookup-tool.md

@@ -34,12 +34,13 @@ The following are available input parameters:
 
 | Name | Type | Description | Required |
 | ---- | ---- | ----------- | -------- |
-| mlindex_content | string | Type of Index to be used. Input depends on Index type. Example of an Azure Cog Search Index JSON can be seen below the table* | Yes |
-| queries | string, Union[string, List[String]] | The text to be queried.| Yes |
-|query_type | string | The type of query to be performed. Options include Keyword, Semantic, Hybrid, etc.  | Yes |
+| mlindex_content | string | Type of index to be used. Input depends on the index type. An example of an Azure AI Search index JSON can be seen below the table. | Yes |
+| queries | string, `Union[string, List[String]]` | The text to be queried.| Yes |
+|query_type | string | The type of query to be performed. Options include Keyword, Semantic, Hybrid, and others.  | Yes |
 | top_k | integer | The count of top-scored entities to return. Default value is 3. | No |
 
-\**ACS JSON Example:*
+Here's an example of an Azure AI Search index input.
+
 ```json
 embeddings:
   api_base: <api_base>
@@ -68,14 +69,11 @@ index:
   index: <index_name>
   kind: acs
   semantic_configuration_name: azureml-default
-
-
-
 ```
 
 ## Outputs
 
-The following JSON format response is an example returned by the tool that includes the top-k scored entities. The entity follows a generic schema of vector search result provided by promptflow-vectordb SDK. For the Vector Index Search, the following fields are populated:
+The following JSON format response is an example returned by the tool that includes the top-k scored entities. The entity follows a generic schema of vector search result provided by the `promptflow-vectordb` SDK. For the Vector Index Search, the following fields are populated:
 
 | Field Name | Type | Description |
 | ---- | ---- | ----------- |

articles/ai-studio/how-to/prompt-flow-tools/prompt-flow-tools-overview.md

@@ -5,7 +5,7 @@ description: Learn about prompt flow tools that are available in Azure AI Studio
 manager: nitinme
 ms.service: azure-ai-studio
 ms.topic: overview
-ms.date: 12/6/2023
+ms.date: 2/6/2024
 ms.reviewer: keli19
 ms.author: lagayhar
 author: lgayhardt
@@ -35,7 +35,7 @@ To discover more custom tools developed by the open-source community, see [More
 ## Remarks
 - If existing tools don't meet your requirements, you can [develop your own custom tool and make a tool package](https://microsoft.github.io/promptflow/how-to-guides/develop-a-tool/create-and-use-tool-package.html).
 - To install the custom tools, if you are using the automatic runtime, you can readily install the package by adding the custom tool package name into the `requirements.txt` file in the flow folder. Then select the **Save and install** button to start installation. After completion, you can see the custom tools displayed in the tool list. To learn more, see [How to create and manage a runtime](../create-manage-runtime.md).
-:::image type="content" source="./media/prompt-flow-tools-overview/install-package-on-automatic-runtime.png" alt-text="Screenshot of how to install packages on automatic runtime."lightbox = "./media/prompt-flow-tools-overview/install-package-on-automatic-runtime.png":::
+:::image type="content" source="../../media/prompt-flow/install-package-on-automatic-runtime.png" alt-text="Screenshot of how to install packages on automatic runtime."lightbox = "../../media/prompt-flow/install-package-on-automatic-runtime.png":::
 
 ## Next steps