Merge pull request #260271 from MicrosoftDocs/main

12/5 11:00 AM IST Publish

Author: Saisang

articles/ai-services/openai/how-to/migration.md

@@ -211,16 +211,21 @@ Additional examples including how to handle semantic text search without `embedd
 OpenAI doesn't support calling asynchronous methods in the module-level client, instead you should instantiate an async client.
 
 ```python
+import os
+import asyncio
 from openai import AsyncAzureOpenAI
 
-client = AsyncAzureOpenAI(  
-  api_key = os.getenv("AZURE_OPENAI_KEY"),  
-  api_version = "2023-10-01-preview",
-  azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
-)
-response = await client.chat.completions.create(model="gpt-35-turbo", messages=[{"role": "user", "content": "Hello world"}])
+async def main():
+    client = AsyncAzureOpenAI(  
+      api_key = os.getenv("AZURE_OPENAI_KEY"),  
+      api_version = "2023-10-01-preview",
+      azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
+    )
+    response = await client.chat.completions.create(model="gpt-35-turbo", messages=[{"role": "user", "content": "Hello world"}])
 
-print(response.model_dump_json(indent=2))
+    print(response.model_dump_json(indent=2))
+
+asyncio.run(main())
 ```
 
 ## Authentication

articles/ai-services/policy-reference.md

@@ -1,7 +1,7 @@
 ---
 title: Built-in policy definitions for Azure AI services
 description: Lists Azure Policy built-in policy definitions for Azure AI services. These built-in policy definitions provide common approaches to managing your Azure resources.
-ms.date: 11/29/2023
+ms.date: 12/04/2023
 author: nitinme
 ms.author: nitinme
 ms.service: azure-ai-services

articles/ai-services/speech-service/text-to-speech-avatar/batch-synthesis-avatar.md

@@ -32,7 +32,7 @@ To perform batch synthesis, you can use the following REST API operations.
 | [List batch synthesis](#list-batch-synthesis)   | GET     | texttospeech/3.1-preview1/batchsynthesis/talkingavatar |
 | [Delete batch synthesis](#delete-batch-synthesis) | DELETE  | texttospeech/3.1-preview1/batchsynthesis/talkingavatar/{SynthesisId} |
 
-You can refer to the code samples on [GitHub](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples).
+You can refer to the code samples on [GitHub](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/batch-avatar).
 
 ## Create a batch synthesis request
 

articles/ai-services/speech-service/text-to-speech-avatar/real-time-synthesis-avatar.md

@@ -172,7 +172,7 @@ avatarSynthesizer.speakTextAsync(spokenText).then(
 });
 ```
 
-You can find end-to-end working samples on [GitHub](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/js/browser).
+You can find end-to-end working samples on [GitHub](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/js/browser/avatar).
 
 ## Edit background
 

articles/ai-services/speech-service/text-to-speech-avatar/what-is-text-to-speech-avatar.md

@@ -60,11 +60,11 @@ You can create custom text to speech avatars that are unique to your product or
 
 ## Sample code
 
-Sample code for text to speech avatar is available on GitHub. These samples cover the most popular scenarios:
+Sample code for text to speech avatar is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples). These samples cover the most popular scenarios:
 
-* [Batch synthesis (REST)](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples)
-* [Real-time synthesis (SDK)](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/js/browser)
-* [Live chat with Azure Open AI in behind (SDK)](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/js/browser)
+* [Batch synthesis (REST)](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/batch-avatar)
+* [Real-time synthesis (SDK)](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/js/browser/avatar)
+* [Live chat with Azure Open AI in behind (SDK)](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/js/browser/avatar#chat-sample)
 
 ## Pricing
 

articles/ai-studio/concepts/ai-resources.md

@@ -76,7 +76,7 @@ The Azure AI services resource contains the keys and endpoints needed to authent
 | ![Speech icon](../../ai-services/media/service-icons/speech.svg) [Speech](../../ai-services/speech-service/index.yml) | Speech to text, text to speech, translation and speaker recognition |
 | ![Vision icon](../../ai-services/media/service-icons/vision.svg) [Vision](../../ai-services/computer-vision/index.yml) | Analyze content in images and videos |
 
-Large language models that can be used to generate text, speech, images, and more, are hosted by the AI resource. Fine-tuned models and open models deployed from the [model catalog](../how-to/model-catalog.md) are always created in the project context for isolation.<br/><br/>Model-as-as-service endpoints including Azure OpenAI base models 
+Large language models that can be used to generate text, speech, images, and more, are hosted by the AI resource. Fine-tuned models and open models deployed from the [model catalog](../how-to/model-catalog.md) are always created in the project context for isolation.
 
 ## Centralized setup and governance
 

articles/ai-studio/how-to/create-azure-ai-resource.md

@@ -18,31 +18,35 @@ ms.author: eur
 
 As an administrator, you can create and manage Azure AI resources. Azure AI resources provide a hosting environment for the projects of a team, and help you as an IT admin centrally set up security settings and govern usage and spend. You can create and manage an Azure AI resource from the Azure portal or from the Azure AI Studio. 
 
-In this article, you learn how to create an Azure AI resource from AI studio (for getting started) and from the Azure portal (for advanced security setup) and manage it from the Azure portal and Azure AI Studio.
+In this article, you learn how to create and manage an Azure AI resource in Azure AI Studio (for getting started) and from the Azure portal (for advanced security setup).
 
-## Create an Azure AI resource in AI studio for getting started
-To create a new Azure AI resource, you need either the Owner or Contributor role on the resource group or on an existing Azure AI resource. If you are unable to create an Azure AI resource due to permissions, reach out to your administrator. 
+## Create an Azure AI resource in AI Studio for getting started
+To create a new Azure AI resource, you need either the Owner or Contributor role on the resource group or on an existing Azure AI resource. If you are unable to create an Azure AI resource due to permissions, reach out to your administrator. If your organization is using [Azure Policy](../../governance/policy/overview.md), don't create the resource in AI Studio. Create the Azure AI resource [in the Azure Portal](#create-a-secure-azure-ai-resource-in-the-azure-portal) instead.
 
-1. From Azure AI studio, navigate to `manage` and select `New Azure AI resoure`.
+Follow these steps to create a new Azure AI resource in AI Studio.
+
+1. From Azure AI Studio, navigate to `manage` and select `New Azure AI resource`.
 
 1. Fill in **Subscription**, **Resource group**, and **Location** for your new Azure AI resource.
 
     :::image type="content" source="../media/how-to/resource-create-advanced.png" alt-text="Screenshot of the Create an Azure AI resource wizard with the option to set basic information." lightbox="../media/how-to/resource-create-advanced.png":::
 
 1. Optionally, choose an existing Azure AI services provider. By default a new provider is created. New Azure AI services include multiple API endpoints for Speech, Content Safety and Azure OpenAI. You can also bring an existing Azure OpenAI resource.
 
-1. Optionally, connect an existing Azure AI Search instance to share search indices with all projects in this Azure AI resource. No AI Search instance is created for you if you don't provide one.
+1. Optionally, connect an existing Azure AI Search instance to share search indices with all projects in this Azure AI resource. An Azure AI Search instance isn't created for you if you don't provide one.
 
 ## Create a secure Azure AI resource in the Azure portal
 
+If your organization is using [Azure Policy](../../governance/policy/overview.md), setup a resource that meets your organization's requirements instead of using AI Studio for resource creation.
+
 1. From the Azure portal, search for `Azure AI Studio` and create a new resource by selecting **+ New Azure AI**
 1.	Fill in **Subscription**, **Resource group**, and **Region**. **Name** your new Azure AI resource.  
     - For advanced settings, select **Next: Resources** to specify resources, networking, encryption, identity, and tags. 
     - Your subscription must have access to Azure AI to create this resource.
 
         :::image type="content" source="../media/how-to/resource-create-basics.png" alt-text="Screenshot of the option to set Azure AI resource basic information." lightbox="../media/how-to/resource-create-basics.png":::
 
-1.	Select an existing **Azure AI services** or create a new one. New Azure AI services include multiple API endpoints for Speech, Content Safety and Azure OpenAI. You can also bring an existing Azure OpenAI resource. Optionally, choose an existing **Storage account**, **Key vault**, **Container Registry, and **Application insights** to host artifacts generated when you use AI studio.
+1.	Select an existing **Azure AI services** or create a new one. New Azure AI services include multiple API endpoints for Speech, Content Safety and Azure OpenAI. You can also bring an existing Azure OpenAI resource. Optionally, choose an existing **Storage account**, **Key vault**, **Container Registry, and **Application insights** to host artifacts generated when you use AI Studio.
 
     :::image type="content" source="../media/how-to/resource-create-resources.png" alt-text="Screenshot of the Create an Azure AI resource with the option to set resource information." lightbox="../media/how-to/resource-create-resources.png"::: 
 
@@ -150,4 +154,4 @@ Here you're linked to the Azure portal to review the cost analysis information f
 
 - [Create a project](create-projects.md)
 - [Learn more about Azure AI Studio](../what-is-ai-studio.md)
-- [Learn more about Azure AI resources](../concepts/ai-resources.md)
+- [Learn more about Azure AI resources](../concepts/ai-resources.md)