Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into Azlabs-to-dtl

Author: RoseHJM

CODEOWNERS

@@ -19,3 +19,10 @@
 /articles/virtual-machines-scale-sets @jasonwhowell @thomps23
 /articles/container-instances @jasonwhowell @thomps23
 /articles/service-fabric @jasonwhowell @thomps23
+/articles/machine-learning @jasonwhowell @thomps23
+/articles/ai-studio @jasonwhowell @thomps23
+/articles/ai-services @jasonwhowell @thomps23
+/articles/genomics @jasonwhowell @thomps23
+/articles/open-datasets @jasonwhowell @thomps23
+/articles/search @jasonwhowell @thomps23
+

articles/ai-services/language-service/text-analytics-for-health/how-to/use-containers.md

@@ -215,7 +215,7 @@ server {
 
 #### Example Docker compose file
 
-The below example shows how a [docker compose](https://docs.docker.com/compose/reference/overview) file can be created to deploy NGINX and health containers:
+The below example shows how a [docker compose](https://docs.docker.com/reference/cli/docker/compose/) file can be created to deploy NGINX and health containers:
 
 ```yaml
 version: "3.7"
@@ -262,7 +262,7 @@ Use the host, `http://localhost:5000`, for container APIs.
 
 ### Structure the API request for the container
 
-You can use Postman or the example cURL request below to submit a query to the container you deployed, replacing the `serverURL` variable with the appropriate value.  Note the version of the API in the URL for the container is different than the hosted API.
+You can use the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) or the example cURL request below to submit a query to the container you deployed, replacing the `serverURL` variable with the appropriate value.  Note the version of the API in the URL for the container is different than the hosted API.
 
 [!INCLUDE [Use APIs in container](../includes/container-request.md)]
 

articles/ai-services/openai/how-to/use-your-data-securely.md

@@ -144,7 +144,7 @@ The [custom subdomain](/azure/ai-services/cognitive-services-custom-subdomains)
 
 ### Enable managed identity
 
-To allow your Azure AI Search and Storage Account to recognize your Azure OpenAI service via Microsoft Entra ID authentication, you need to assign a managed identity for your Azure OpenAI service. The easiest way is to toggle on system assigned managed identity on Azure portal.
+To allow your Azure AI Search and Storage Account to recognize your Azure OpenAI Service via Microsoft Entra ID authentication, you need to assign a managed identity for your Azure OpenAI Service. The easiest way is to toggle on system assigned managed identity on Azure portal.
 :::image type="content" source="../media/use-your-data/openai-managed-identity.png" alt-text="A screenshot showing the system assigned managed identity option in the Azure portal." lightbox="../media/use-your-data/openai-managed-identity.png":::
 
 To set the managed identities via the management API, see [the management API reference documentation](/rest/api/aiservices/accountmanagement/accounts/update#identity).
@@ -175,7 +175,7 @@ This step can be skipped only if you have a [shared private link](#create-shared
 
 You can disable public network access of your Azure OpenAI resource in the Azure portal. 
 
-To allow access to your Azure OpenAI service from your client machines, like using Azure OpenAI Studio, you need to create [private endpoint connections](/azure/ai-services/cognitive-services-virtual-networks?tabs=portal#use-private-endpoints) that connect to your Azure OpenAI resource.
+To allow access to your Azure OpenAI Service from your client machines, like using Azure OpenAI Studio, you need to create [private endpoint connections](/azure/ai-services/cognitive-services-virtual-networks?tabs=portal#use-private-endpoints) that connect to your Azure OpenAI resource.
 
 
 ## Configure Azure AI Search
@@ -290,7 +290,7 @@ To enable the developers to use these resources to build applications, the admin
 
 ## Configure gateway and client
 
-To access the Azure OpenAI service from your on-premises client machines, one of the approaches is to configure Azure VPN Gateway and Azure VPN Client.
+To access the Azure OpenAI Service from your on-premises client machines, one of the approaches is to configure Azure VPN Gateway and Azure VPN Client.
 
 Follow [this guideline](/azure/vpn-gateway/tutorial-create-gateway-portal#VNetGateway) to create virtual network gateway for your virtual network.
 

articles/ai-services/openai/includes/dall-e-go.md

@@ -61,6 +61,7 @@ import (
 	"os"
 
 	"github.com/Azure/azure-sdk-for-go/sdk/ai/azopenai"
+	"github.com/Azure/azure-sdk-for-go/sdk/azcore"
 	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
 )
 
@@ -75,19 +76,15 @@ func main() {
 		return
 	}
 
-	keyCredential, err := azopenai.NewKeyCredential(azureOpenAIKey)
-
-	if err != nil {
-		// handle error
-	}
+	keyCredential := azcore.NewKeyCredential(azureOpenAIKey)
 
 	client, err := azopenai.NewClientWithKeyCredential(azureOpenAIEndpoint, keyCredential, nil)
 
 	if err != nil {
 		// handle error
 	}
 
-	resp, err := client.CreateImage(context.TODO(), azopenai.ImageGenerationOptions{
+	resp, err := client.GetImageGenerations(context.TODO(), azopenai.ImageGenerationOptions{
 		Prompt:         to.Ptr("a painting of a cat in the style of Dali"),
 		ResponseFormat: to.Ptr(azopenai.ImageGenerationResponseFormatURL),
 	}, nil)

articles/ai-services/openai/includes/go.md

@@ -38,6 +38,7 @@ import (
 	"os"
 
 	"github.com/Azure/azure-sdk-for-go/sdk/ai/azopenai"
+	"github.com/Azure/azure-sdk-for-go/sdk/azcore"
 	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
 )
 
@@ -52,11 +53,7 @@ func main() {
 		return
 	}
 
-	keyCredential, err := azopenai.NewKeyCredential(azureOpenAIKey)
-
-	if err != nil {
-		// TODO: handle error
-	}
+	keyCredential := azcore.NewKeyCredential(azureOpenAIKey)
 
 	client, err := azopenai.NewClientWithKeyCredential(azureOpenAIEndpoint, keyCredential, nil)
 
@@ -65,10 +62,10 @@ func main() {
 	}
 
 	resp, err := client.GetCompletions(context.TODO(), azopenai.CompletionsOptions{
-		Prompt:       []string{"What is Azure OpenAI, in 20 words or less"},
-		MaxTokens:    to.Ptr(int32(2048)),
-		Temperature:  to.Ptr(float32(0.0)),
-		Deployment: modelDeploymentID,
+		Prompt:         []string{"What is Azure OpenAI, in 20 words or less"},
+		MaxTokens:      to.Ptr(int32(2048)),
+		Temperature:    to.Ptr(float32(0.0)),
+		DeploymentName: &modelDeploymentID,
 	}, nil)
 
 	if err != nil {

articles/ai-services/openai/includes/use-your-data-go.md

@@ -80,15 +80,15 @@ ms.date: 03/07/2024
    		},
    		MaxTokens: to.Ptr[int32](512),
    		AzureExtensionsOptions: []azopenai.AzureChatExtensionConfigurationClassification{
-   			&azopenai.AzureCognitiveSearchChatExtensionConfiguration{
+   			&azopenai.AzureSearchChatExtensionConfiguration{
    				// This allows Azure OpenAI to use an Azure AI Search index.
    				//
    				// > Because the model has access to, and can reference specific sources to support its responses, answers are not only based on its pretrained knowledge
    				// > but also on the latest information available in the designated data source. This grounding data also helps the model avoid generating responses
    				// > based on outdated or incorrect information.
    				//
    				// Quote from here: https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/use-your-data
-   				Parameters: &azopenai.AzureCognitiveSearchChatExtensionParameters{
+   				Parameters: &azopenai.AzureSearchChatExtensionParameters{
    					Endpoint:  &searchEndpoint,
    					IndexName: &searchIndex,
    					Authentication: &azopenai.OnYourDataAPIKeyAuthenticationOptions{
@@ -105,12 +105,9 @@ ms.date: 03/07/2024
    		log.Fatalf("ERROR: %s", err)
    	}
    
-   	// Contains contextual information from your Azure chat completion extensions, configured above in `AzureExtensionsOptions`
-   	msgContext := resp.Choices[0].Message.Context
-   
    	fmt.Fprintf(os.Stderr, "Extensions Context Role: %s\nExtensions Context (length): %d\n",
-   		*msgContext.Messages[0].Role,
-   		len(*msgContext.Messages[0].Content))
+   		*resp.Choices[0].Message.Role,
+   		len(*resp.Choices[0].Message.Content))
    
    	fmt.Fprintf(os.Stderr, "ChatRole: %s\nChat content: %s\n",
    		*resp.Choices[0].Message.Role,

articles/ai-services/qnamaker/How-To/metadata-generateanswer-usage.md

@@ -186,7 +186,7 @@ We offer precise answer feature only with the QnA Maker managed version.
 
 ## Next steps
 
-The **Publish** page also provides information to [generate an answer](../quickstarts/get-answer-from-knowledge-base-using-url-tool.md) with Postman or cURL.
+The **Publish** page also provides information to [generate an answer](../quickstarts/get-answer-from-knowledge-base-using-url-tool.md) with the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) or cURL.
 
 > [!div class="nextstepaction"]
 > [Get analytics on your knowledge base](../how-to/get-analytics-knowledge-base.md)

articles/ai-services/qnamaker/Quickstarts/add-question-metadata-portal.md

@@ -111,4 +111,4 @@ If you are not continuing to the next quickstart, delete the QnA Maker and Bot f
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Get answer with Postman or cURL](get-answer-from-knowledge-base-using-url-tool.md)
+> [Get answer with the Visual Studio Code REST Client extension or cURL](get-answer-from-knowledge-base-using-url-tool.md)

articles/ai-services/qnamaker/Quickstarts/get-answer-from-knowledge-base-using-url-tool.md

@@ -1,7 +1,7 @@
 ---
 title: Use URL tool to get answer from knowledge base - QnA Maker
 titleSuffix: Azure AI services
-description: This article walks you through getting an answer from your knowledge base using a URL test tool such as cURL or Postman.
+description: This article walks you through getting an answer from your knowledge base using a URL test tool such as cURL or the Visual Studio Code REST Client extension..
 #services: cognitive-services
 manager: nitinme
 ms.author: jboback
@@ -29,9 +29,9 @@ ms.date: 01/19/2024
 
 ::: zone-end
 
-::: zone pivot="url-test-tool-postman"
+::: zone pivot="url-test-tool-visual-studio-code-rest-client-extension"
 
-[!INCLUDE [Get answer using Postman](../includes/quickstart-test-tool-Postman.md)]
+[!INCLUDE [Get answer using the Visual Studio Code REST Client extension](../includes/quickstart-test-tool-vscode.md)]
 
 ::: zone-end
 

articles/ai-services/qnamaker/includes/quickstart-test-tool-postman.md renamed to articles/ai-services/qnamaker/includes/quickstart-test-tool-vscode.md

@@ -10,12 +10,12 @@ ms.custom: include file
 ms.date: 01/19/2024
 ---
 
-This Postman-based quickstart walks you through getting an answer from your knowledge base.
+This [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client)-based quickstart walks you through getting an answer from your knowledge base.
 
 ## Prerequisites
 
 * You must have
-    * Latest [**Postman**](https://www.getpostman.com/).
+    * Latest [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client).
     * If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/cognitive-services/) before you begin.
 
 > * A [QnA Maker resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesQnAMaker) created in the Azure portal. Remember your Microsoft Entra ID, Subscription, QnA resource name you selected when you created the resource.
@@ -26,13 +26,13 @@ This Postman-based quickstart walks you through getting an answer from your know
 > [!NOTE]
 > When you are ready to generate an answer to a question from your knowledge base, you must [train](../quickstarts/create-publish-knowledge-base.md#save-and-train) and [publish](../quickstarts/create-publish-knowledge-base.md#publish-the-knowledge-base) your knowledge base. When your knowledge base is published, the **Publish** page displays the HTTP request settings to generate an answer. The **Postman** tab shows the settings required to generate an answer.
 
-## Set up Postman for requests
+## Set up the Visual Studio Code REST Client extension for requests
 
-This quickstart uses the same settings for the Postman **POST** request then configures to POST body JSON sent to the service based on what you are trying to query for.
+This quickstart uses the same settings for the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) **POST** request then configures to POST body JSON sent to the service based on what you are trying to query for.
 
-Use this procedure to configure Postman, then read each subsequent section to configure the POST body JSON.
+Use this procedure to configure the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client), then read each subsequent section to configure the POST body JSON.
 
-1. From the knowledge base's **Settings** page, select the **Postman** tab to see the configuration used to generate an answer from the knowledge base. Copy the following information to use in Postman.
+1. From the knowledge base's **Settings** page, select the **Postman** tab to see the configuration used to generate an answer from the knowledge base. Copy the following information to use in the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client).
 
     |Name|Setting|Purpose and value|
     |--|--|--|
@@ -45,13 +45,13 @@ Use this procedure to configure Postman, then read each subsequent section to co
     > [!IMPORTANT]
     > Remember to remove the key from your code when you're done, and never post it publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](/azure/key-vault/general/overview). See the Azure AI services [security](../../security-features.md) article for more information.
 
-1. Open Postman and create a new basic **POST** request with your published knowledge base settings. In the following sections, alter the POST body JSON to change the query to your knowledge base.
+1. Use the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) to create a new basic **POST** request with your published knowledge base settings. In the following sections, alter the POST body JSON to change the query to your knowledge base.
 
 ## Use metadata to filter answer
 
 In a previous quickstart, metadata was added to two QnA pairs to distinguish between two different questions. Add the metadata to the query to restrict the filter to just the relevant QnA pair.
 
-1. In Postman, change only the query JSON by adding the `strictFilters` property with the name/value pair of `service:qna_maker`. The body JSON should be:
+1. In the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client), change only the query JSON by adding the `strictFilters` property with the name/value pair of `service:qna_maker`. The body JSON should be:
 
     ```json
     {
@@ -112,7 +112,7 @@ In a previous quickstart, metadata was added to two QnA pairs to distinguish bet
 
 Debug information helps you understand how the returned answer was determined. While it is helpful, it is not necessary. To generate an answer with debug information, add the `debug` property:
 
-1. In Postman, change only the body JSON by adding the `debug` property. The JSON should be:
+1. In the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client), change only the body JSON by adding the `debug` property. The JSON should be:
 
     ```json
     {
@@ -218,7 +218,7 @@ Debug information helps you understand how the returned answer was determined. W
 
 If you want to get an answer from the test knowledge base, use the `isTest` body property.
 
-In Postman, change only the body JSON by adding the `isTest` property. The JSON should be:
+In the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client), change only the body JSON by adding the `isTest` property. The JSON should be:
 
 ```json
 {
@@ -234,7 +234,7 @@ The JSON response uses the same schema as the published knowledge base query.
 
 ## Query for a Chit-chat answer
 
-1. In Postman, change only the body JSON to a conversation-ending statement from the user. The JSON should be:
+1. In the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client), change only the body JSON to a conversation-ending statement from the user. The JSON should be:
 
     ```json
     {
@@ -330,7 +330,7 @@ The JSON response uses the same schema as the published knowledge base query.
 
 You can request a minimum threshold for the answer. If the threshold is not met, the default answer is returned.
 
-1. In Postman, change only the body JSON to a conversation-ending statement from the user. The JSON should be:
+1. In the [Visual Studio Code REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client), change only the body JSON to a conversation-ending statement from the user. The JSON should be:
 
     ```json
     {