Merge branch 'main' into release-2025-openai-may-27

v-alje · v-alje · commit 28931c91f457 · 2025-05-23T17:05:43.000Z
diff --git a/articles/ai-foundry/foundry-local/get-started.md b/articles/ai-foundry/foundry-local/get-started.md
@@ -6,7 +6,7 @@ manager: scottpolly
 keywords: Azure AI services, cognitive, AI models, local inference
 ms.service: azure-ai-foundry
 ms.topic: quickstart
-ms.date: 05/20/2025
+ms.date: 05/23/2025
 ms.reviewer: samkemp
 ms.author: samkemp
 author: samuel100
@@ -24,7 +24,7 @@ This guide walks you through setting up Foundry Local to run AI models on your d
 
 Your system must meet the following requirements to run Foundry Local:
 
-- **Operating System**: Windows 10 (x64), Windows 11 (x64/ARM), macOS.
+- **Operating System**: Windows 10 (x64), Windows 11 (x64/ARM), Windows Server 2025, macOS.
 - **Hardware**: Minimum 8GB RAM, 3GB free disk space. Recommended 16GB RAM, 15GB free disk space.
 - **Network**: Internet connection for initial model download (optional for offline use)
 - **Acceleration (optional)**: NVIDIA GPU (2,000 series or newer), AMD GPU (6,000 series or newer), Qualcomm Snapdragon X Elite (8GB or more of memory), or Apple silicon.
diff --git a/articles/ai-foundry/how-to/data-add.md b/articles/ai-foundry/how-to/data-add.md
@@ -10,8 +10,8 @@ ms.custom:
   - ignite-2024
 ms.topic: how-to
 ms.date: 05/21/2025
-ms.author: franksolomon
-author: fbsolo-ms1
+author: Blackmist
+ms.author: larryfr
 ---
 
 # How to add and manage data in your Azure AI Foundry project
diff --git a/articles/ai-foundry/includes/chat-with-data.md b/articles/ai-foundry/includes/chat-with-data.md
@@ -15,7 +15,7 @@ To complete this section, you need a local copy of product data. The [Azure-Samp
 Follow these steps to add your data in the chat playground to help the assistant answer questions about your products. You're not changing the deployed model itself. Your data is stored separately and securely in your Azure subscription.
 
 1. Go to your project in [Azure AI Foundry](https://ai.azure.com). 
-1. Select **Playgrounds**.
+1. Select **Playgrounds** from the left pane.
 1. Select **Try the chat playground**.
 1. Select your deployed chat model from the **Deployment** dropdown. 
 
diff --git a/articles/ai-services/agents/faq.yml b/articles/ai-services/agents/faq.yml
@@ -37,7 +37,7 @@ sections:
       - question: |
           Is my data used by Microsoft for training models? 
         answer: |
-          No. Data is not used for Microsoft not used for training models. See the [Responsible AI documentation](/legal/cognitive-services/openai/data-privacy?context=%2Fazure%2Fai-services%2Fopenai%2Fcontext%2Fcontext) for more information. 
+          No. Data is not used by Microsoft for training models. See the [Responsible AI documentation](/legal/cognitive-services/openai/data-privacy?context=%2Fazure%2Fai-services%2Fopenai%2Fcontext%2Fcontext) for more information. 
       - question: |
           Where is data stored geographically?
         answer: |
@@ -57,4 +57,4 @@ sections:
       - question: |
           Does the AI Agent Service API support non-Azure OpenAI models?   
         answer: |
-          Yes, the AI Agent Service API supports non-Azure OpenAI models. See the [models](./concepts/model-region-support.md) page for more information.
+          Yes, the AI Agent Service API supports non-Azure OpenAI models. See the [models](./concepts/model-region-support.md) page for more information.
diff --git a/articles/ai-services/content-understanding/how-to/create-multi-service-resource.md b/articles/ai-services/content-understanding/how-to/create-multi-service-resource.md
@@ -34,7 +34,7 @@ To use the Azure AI Content Understanding service, you must create your Azure AI
 
 | Region | Region Identifier |
 | --- | --- |
-| West US 2 | westus2 |
+| West US | westus |
 | Sweden Central | swedencentral |
 | Australia East | australiaeast |
 
diff --git a/articles/ai-services/openai/audio-completions-quickstart.md b/articles/ai-services/openai/audio-completions-quickstart.md
@@ -5,7 +5,7 @@ description: Walkthrough on how to get started with audio generation using Azure
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: how-to
-ms.date: 2/6/2025
+ms.date: 5/23/2025
 author: eric-urban
 ms.author: eur
 ms.custom: references_regions
diff --git a/articles/ai-services/openai/includes/audio-completions-ai-foundry.md b/articles/ai-services/openai/includes/audio-completions-ai-foundry.md
@@ -17,8 +17,14 @@ ms.date: 1/7/2025
 
 To chat with your deployed `gpt-4o-mini-audio-preview` model in the **Chat** playground of [Azure AI Foundry portal](https://ai.azure.com), follow these steps:
 
-1. Go to the [Azure OpenAI in Azure AI Foundry Models page](https://ai.azure.com/resource/overview) in Azure AI Foundry portal. Make sure you're signed in with the Azure subscription that has your Azure OpenAI in Azure AI Foundry Models resource and the deployed `gpt-4o-mini-audio-preview` model.
-1. Select the **Chat** playground from under **Resource playground** in the left pane.
+1. Go to the [Azure AI Foundry portal](https://ai.azure.com) and select your project that has your deployed `gpt-4o-mini-audio-preview` model.
+1. Go to your project in [Azure AI Foundry](https://ai.azure.com). 
+1. Select **Playgrounds** from the left pane.
+1. Select **Audio playground** > **Try the Chat playground**. 
+
+    > [!NOTE]
+    > The **Audio playground** doesn't support the `gpt-4o-mini-audio-preview` model. Use the **Chat playground** as described in this section.
+
 1. Select your deployed `gpt-4o-mini-audio-preview` model from the **Deployment** dropdown. 
 1. Start chatting with the model and listen to the audio responses.
 
diff --git a/articles/ai-services/openai/includes/audio-completions-deploy-model.md b/articles/ai-services/openai/includes/audio-completions-deploy-model.md
@@ -4,15 +4,15 @@ author: eric-urban
 ms.author: eur
 ms.service: azure-ai-openai
 ms.topic: include
-ms.date: 1/21/2025
+ms.date: 5/23/2025
 ---
 
 To deploy the `gpt-4o-mini-audio-preview` model in the Azure AI Foundry portal:
-1. Go to the [Azure OpenAI in Azure AI Foundry Models page](https://ai.azure.com/resource/overview) in Azure AI Foundry portal. Make sure you're signed in with the Azure subscription that has your Azure OpenAI in Azure AI Foundry Models resource and the deployed `gpt-4o-mini-audio-preview` model.
-1. Select the **Chat** playground from under **Playgrounds** in the left pane.
-1. Select **+ Create new deployment** > **From base models** to open the deployment window. 
-1. Search for and select the `gpt-4o-mini-audio-preview` model and then select **Deploy to selected resource**.
-1. In the deployment wizard, select the `2024-12-17` model version.
+1. Go to the [Azure AI Foundry portal](https://ai.azure.com) and create or select your project. 
+1. Select **Models + endpoints** from under **My assets** in the left pane.
+1. Select **+ Deploy model** > **Deploy base model** to open the deployment window. 
+1. Search for and select the `gpt-4o-mini-audio-preview` model and then select **Confirm**.
+1. Review the deployment details and select **Deploy**.
 1. Follow the wizard to finish deploying the model.
 
 Now that you have a deployment of the `gpt-4o-mini-audio-preview` model, you can interact with it in the Azure AI Foundry portal **Chat** playground or chat completions API.
diff --git a/articles/ai-services/openai/includes/realtime-deploy-model.md b/articles/ai-services/openai/includes/realtime-deploy-model.md
@@ -8,11 +8,11 @@ ms.date: 1/21/2025
 ---
 
 To deploy the `gpt-4o-mini-realtime-preview` model in the Azure AI Foundry portal:
-1. Go to the [Azure OpenAI in Azure AI Foundry Models page](https://ai.azure.com/resource/overview) in Azure AI Foundry portal. Make sure you're signed in with the Azure subscription that has your Azure OpenAI in Azure AI Foundry Models resource (with or without model deployments.)
-1. Select the **Real-time audio** playground from under **Playgrounds** in the left pane.
-1. Select **+ Create new deployment** > **From base models** to open the deployment window. 
-1. Search for and select the `gpt-4o-mini-realtime-preview` model and then select **Deploy to selected resource**.
-1. In the deployment wizard, select the `2024-12-17` model version.
+1. Go to the [Azure AI Foundry portal](https://ai.azure.com) and create or select your project. 
+1. Select **Models + endpoints** from under **My assets** in the left pane.
+1. Select **+ Deploy model** > **Deploy base model** to open the deployment window. 
+1. Search for and select the `gpt-4o-mini-realtime-preview` model and then select **Confirm**.
+1. Review the deployment details and select **Deploy**.
 1. Follow the wizard to finish deploying the model.
 
-Now that you have a deployment of the `gpt-4o-mini-realtime-preview` model, you can interact with it in real time in the Azure AI Foundry portal **Real-time audio** playground or Realtime API.
+Now that you have a deployment of the `gpt-4o-mini-realtime-preview` model, you can interact with it in the Azure AI Foundry portal **Audio** playground or Realtime API.
diff --git a/articles/ai-services/openai/includes/realtime-portal.md b/articles/ai-services/openai/includes/realtime-portal.md
@@ -15,17 +15,18 @@ ms.date: 3/20/2025
 
 To chat with your deployed `gpt-4o-mini-realtime-preview` model in the [Azure AI Foundry](https://ai.azure.com) **Real-time audio** playground, follow these steps:
 
-1. Go to the [Azure OpenAI in Azure AI Foundry Models page](https://ai.azure.com/resource/overview) in Azure AI Foundry portal. Make sure you're signed in with the Azure subscription that has your Azure OpenAI in Azure AI Foundry Models resource and the deployed `gpt-4o-mini-realtime-preview` model.
-1. Select the **Real-time audio** playground from under **Playgrounds** in the left pane.
-1. Select your deployed `gpt-4o-mini-realtime-preview` model from the **Deployment** dropdown. 
-1. Select **Enable microphone** to allow the browser to access your microphone. If you already granted permission, you can skip this step.
+1. Go to the [Azure AI Foundry portal](https://ai.azure.com) and select your project that has your deployed `gpt-4o-mini-realtime-preview` model.
+1. Select **Playgrounds** from the left pane.
+1. Select **Audio playground** > **Try the Audio playground**. 
 
-    :::image type="content" source="../media/how-to/real-time/real-time-playground.png" alt-text="Screenshot of the real-time audio playground with the deployed model selected." lightbox="../media/how-to/real-time/real-time-playground.png":::
+    > [!NOTE]
+    > The **Chat playground** doesn't support the `gpt-4o-mini-realtime-preview` model. Use the **Audio playground** as described in this section.
+
+1. Select your deployed `gpt-4o-mini-realtime-preview` model from the **Deployment** dropdown.
+
+    :::image type="content" source="../media/how-to/real-time/real-time-playground.png" alt-text="Screenshot of the audio playground with the deployed model selected." lightbox="../media/how-to/real-time/real-time-playground.png":::
 
 1. Optionally, you can edit contents in the **Give the model instructions and context** text box. Give the model instructions about how it should behave and any context it should reference when generating a response. You can describe the assistant's personality, tell it what it should and shouldn't answer, and tell it how to format responses.
 1. Optionally, change settings such as threshold, prefix padding, and silence duration.
 1. Select **Start listening** to start the session. You can speak into the microphone to start a chat.
-
-    :::image type="content" source="../media/how-to/real-time/real-time-playground-start-listening.png" alt-text="Screenshot of the real-time audio playground with the start listening button and microphone access enabled." lightbox="../media/how-to/real-time/real-time-playground-start-listening.png":::
-
 1. You can interrupt the chat at any time by speaking. You can end the chat by selecting the **Stop listening** button.
diff --git a/articles/ai-services/openai/includes/text-to-speech-rest.md b/articles/ai-services/openai/includes/text-to-speech-rest.md
@@ -73,7 +73,7 @@ echo export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE" >> /etc/envi
 In a bash shell, run the following command. You need to replace `YourDeploymentName` with the deployment name you chose when you deployed the text to speech model. The deployment name isn't necessarily the same as the model name. Entering the model name results in an error unless you chose a deployment name that is identical to the underlying model name.
 
 ```bash
-curl $AZURE_OPENAI_ENDPOINT/openai/deployments/YourDeploymentName/audio/speech?api-version=2024-02-15-preview \
+curl $AZURE_OPENAI_ENDPOINT/openai/deployments/YourDeploymentName/audio/speech?api-version=2025-04-01-preview \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
@@ -83,7 +83,7 @@ curl $AZURE_OPENAI_ENDPOINT/openai/deployments/YourDeploymentName/audio/speech?a
 }' --output speech.mp3
 ```
 
-The format of your first line of the command with an example endpoint would appear as follows curl `https://aoai-docs.openai.azure.com/openai/deployments/{YourDeploymentName}/audio/speech?api-version=2024-02-15-preview \`. 
+The format of your first line of the command with an example endpoint would appear as follows curl `https://aoai-docs.openai.azure.com/openai/deployments/{YourDeploymentName}/audio/speech?api-version=2025-04-01-preview \`. 
 
 > [!IMPORTANT]
 > For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](/azure/key-vault/general/overview). For more information about credential security, see this [security](../../security-features.md) article.
diff --git a/articles/ai-services/openai/includes/text-to-speech-typescript.md b/articles/ai-services/openai/includes/text-to-speech-typescript.md
@@ -86,7 +86,7 @@ For the recommended keyless authentication with Microsoft Entra ID, you need to:
     
     // Required Azure OpenAI deployment name and API version
     const deploymentName = process.env.AZURE_OPENAI_DEPLOYMENT_NAME || "tts";
-    const apiVersion = process.env.OPENAI_API_VERSION || "2024-08-01-preview";
+    const apiVersion = process.env.OPENAI_API_VERSION || "2025-04-01-preview";
 
     // keyless authentication    
     const credential = new DefaultAzureCredential();
@@ -184,7 +184,7 @@ For the recommended keyless authentication with Microsoft Entra ID, you need to:
     
     // Required Azure OpenAI deployment name and API version
     const deploymentName = process.env.AZURE_OPENAI_DEPLOYMENT_NAME || "tts";
-    const apiVersion = process.env.OPENAI_API_VERSION || "2024-08-01-preview";
+    const apiVersion = process.env.OPENAI_API_VERSION || "2025-04-01-preview";
     
     function getClient(): AzureOpenAI {
       return new AzureOpenAI({
diff --git a/articles/ai-services/openai/media/how-to/real-time/real-time-playground-start-listening.png b/articles/ai-services/openai/media/how-to/real-time/real-time-playground-start-listening.png
diff --git a/articles/ai-services/openai/media/how-to/real-time/real-time-playground.png b/articles/ai-services/openai/media/how-to/real-time/real-time-playground.png
diff --git a/articles/ai-services/openai/realtime-audio-quickstart.md b/articles/ai-services/openai/realtime-audio-quickstart.md
@@ -5,7 +5,7 @@ description: Learn how to use GPT-4o Realtime API for speech and audio with Azur
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: how-to
-ms.date: 3/20/2025
+ms.date: 5/23/2025
 author: eric-urban
 ms.author: eur
 ms.custom: references_regions, ignite-2024
diff --git a/articles/ai-services/openai/text-to-speech-quickstart.md b/articles/ai-services/openai/text-to-speech-quickstart.md
@@ -5,7 +5,7 @@ description: Use the Azure OpenAI for text to speech with OpenAI voices.
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: quickstart
-ms.date: 3/10/2025
+ms.date: 5/23/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
diff --git a/articles/ai-services/openai/whisper-quickstart.md b/articles/ai-services/openai/whisper-quickstart.md
@@ -6,7 +6,7 @@ manager: nitinme
 ms.service: azure-ai-openai
 ms.custom: devx-track-python
 ms.topic: quickstart
-ms.date: 3/10/2025
+ms.date: 5/23/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
diff --git a/articles/ai-services/speech-service/includes/language-support/stt.md b/articles/ai-services/speech-service/includes/language-support/stt.md
@@ -93,7 +93,7 @@ ms.author: eur
 | `he-IL` | Hebrew (Israel) | Yes | Audio + human-labeled transcript<br/><br/>Plain text |
 | `hi-IN` | Hindi (India) | Yes | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Phrase list |
 | `hr-HR` | Croatian (Croatia) | No | Plain text<br/><br/>Pronunciation |
-| `hu-HU` | Hungarian (Hungary) | No | Plain text<br/><br/>Pronunciation |
+| `hu-HU` | Hungarian (Hungary) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Pronunciation |
 | `hy-AM` | Armenian (Armenia) | No | Plain text |
 | `id-ID` | Indonesian (Indonesia) | Yes | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Pronunciation<br/><br/>Phrase list |
 | `is-IS` | Icelandic (Iceland) | No | Plain text |
@@ -119,15 +119,15 @@ ms.author: eur
 | `nb-NO` | Norwegian Bokmål (Norway) | No | Plain text<br/><br/>Output format |
 | `ne-NP` | Nepali (Nepal) | No | Plain text |
 | `nl-BE` | Dutch (Belgium) | No | Plain text |
-| `nl-NL` | Dutch (Netherlands) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Pronunciation<br/><br/>Phrase list |
+| `nl-NL` | Dutch (Netherlands) | Yes | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Pronunciation<br/><br/>Phrase list |
 | `or-IN` | Odia (India) | No | Audio + human-labeled transcript |
 | `pa-IN` | Punjabi (India) | No | Audio + human-labeled transcript |
 | `pl-PL` | Polish (Poland) | Yes | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Pronunciation<br/><br/>Phrase list |
 | `ps-AF` | Pashto (Afghanistan) | No | Plain text |
 | `pt-BR` | Portuguese (Brazil) | Yes | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Pronunciation<br/><br/>Phrase list |
 | `pt-PT` | Portuguese (Portugal) | Yes | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Pronunciation<br/><br/>Phrase list |
 | `ro-RO` | Romanian (Romania) | No | Plain text<br/><br/>Pronunciation |
-| `ru-RU` | Russian (Russia) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Phrase list |
+| `ru-RU` | Russian (Russia) | Yes | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Phrase list |
 | `si-LK` | Sinhala (Sri Lanka) | No | Plain text |
 | `sk-SK` | Slovak (Slovakia) | No | Plain text<br/><br/>Pronunciation |
 | `sl-SI` | Slovenian (Slovenia) | No | Plain text<br/><br/>Pronunciation |
@@ -137,11 +137,11 @@ ms.author: eur
 | `sv-SE` | Swedish (Sweden) | Yes | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Pronunciation<br/><br/>Phrase list |
 | `sw-KE` | Kiswahili (Kenya) | No | Plain text |
 | `sw-TZ` | Kiswahili (Tanzania) | No | Plain text |
-| `ta-IN` | Tamil (India) | No | Plain text |
-| `te-IN` | Telugu (India) | No | Plain text |
-| `th-TH` | Thai (Thailand) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Phrase list |
+| `ta-IN` | Tamil (India) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text |
+| `te-IN` | Telugu (India) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text |
+| `th-TH` | Thai (Thailand) | Yes | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Phrase list |
 | `tr-TR` | Turkish (Türkiye) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format |
-| `uk-UA` | Ukrainian (Ukraine) | No | Plain text |
+| `uk-UA` | Ukrainian (Ukraine) | No | Audio + human-labeled transcript<br/><br/>Plain text |
 | `ur-IN` | Urdu (India) | No | Audio + human-labeled transcript |
 | `uz-UZ` | Uzbek (Latin, Uzbekistan) | No | Plain text |
 | `vi-VN` | Vietnamese (Vietnam) | No | Plain text<br/><br/>Phrase list |
@@ -151,7 +151,7 @@ ms.author: eur
 | `zh-CN-shandong` | Chinese (Jilu Mandarin, Simplified) | No | Plain text |
 | `zh-CN-sichuan` | Chinese (Southwestern Mandarin, Simplified) | No | Plain text |
 | `zh-HK` | Chinese (Cantonese, Traditional) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Phrase list |
-| `zh-TW` | Chinese (Taiwanese Mandarin, Traditional) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Phrase list |
+| `zh-TW` | Chinese (Taiwanese Mandarin, Traditional) | No | Audio + human-labeled transcript<br/><br/>Plain text<br/><br/>Structured text<br/><br/>Output format<br/><br/>Phrase list |
 | `zu-ZA` | isiZulu (South Africa) | No | Plain text |
 
 <sup>1</sup> The model is bilingual and also supports English.
diff --git a/articles/ai-services/speech-service/includes/language-support/tts.md b/articles/ai-services/speech-service/includes/language-support/tts.md
diff --git a/articles/ai-services/speech-service/includes/language-support/voice-styles-and-roles.md b/articles/ai-services/speech-service/includes/language-support/voice-styles-and-roles.md
diff --git a/articles/ai-services/speech-service/language-support.md b/articles/ai-services/speech-service/language-support.md
diff --git a/articles/ai-services/speech-service/whisper-overview.md b/articles/ai-services/speech-service/whisper-overview.md
diff --git a/articles/machine-learning/how-to-managed-network.md b/articles/machine-learning/how-to-managed-network.md
diff --git a/zone-pivots/zone-pivot-groups.yml b/zone-pivots/zone-pivot-groups.yml
