Merge pull request #4157 from MicrosoftDocs/main

4/15/2025 PM Publish

Author: Taojunshen

articles/ai-foundry/how-to/fine-tune-serverless.md

@@ -7,7 +7,7 @@ author: aahill
 ms.author: aahi
 ms.service: azure-ai-agent-service
 ms.topic: conceptual
-ms.date: 03/21/2025
+ms.date: 04/15/2025
 ms.custom: azure-ai-agents
 ---
 
@@ -37,8 +37,10 @@ Azure AI Agent Service supports the following Azure OpenAI models in the listed
 | francecentral | | -                          | -                          | -                               | ✅                  | ✅                           | -                           | -                               | ✅ | ✅                         | ✅                          | -                          | ✅                             |
 | japaneast    | ✅  | -                          | -                          | -                               | -                   | -                           | -                           | -                               | -                      | ✅                         | -                          | ✅                         | ✅                              |
 | norwayeast   | |-  |  - |  - | -  | ✅ | -  |-  | -  | -  | -  | -  | - |
+| polandcentral  |  - | -  | - | -  | - | - | - | - | - | - | - | - | - |
 | southindia   | | - | - | - | - | ✅ | - | - | - | - | ✅ | ✅ | - |
 | swedencentral  | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | - | ✅ | ✅ | ✅ | ✅ | - | ✅ |
+| switzerlandnorth  |  - | -  | - | -  | ✅ | - | - | - | ✅ | - | - | ✅ | ✅ |
 | uaenorth   | | - | - | - | - | - | - | - | - | - | - | - | - |
 | uksouth     |  | -                          | -                          | -                               | -                   | ✅                          | ✅                           | -                               | -                       | ✅                          | ✅                         | ✅                          | ✅                             |
 | westus      |  | ✅                         | ✅                          | ✅                            | -                   | ✅                          | -                           | ✅                               | - | -                          | ✅                         | ✅                          | -                              |

articles/ai-services/agents/concepts/model-region-support.md

@@ -91,7 +91,7 @@ As a fallback, there's a 60-second maximum wait in the run object when the threa
 
 ## Add file search to an agent using the Azure AI Foundry portal
 
-You can add the Bing Search tool to an agent programatically using the code examples listed at the top of this article, or the [Azure AI Foundry portal](https://ai.azure.com/). If you want to use the portal:
+You can add the File Search tool to an agent programatically using the code examples listed at the top of this article, or the [Azure AI Foundry portal](https://ai.azure.com/). If you want to use the portal:
 
 1. In the **Create and debug** screen for your agent, scroll down the **Setup** pane on the right to **knowledge**. Then select **Add**.
 

articles/ai-services/agents/how-to/tools/file-search.md

@@ -9,7 +9,7 @@ ms.custom:
   - ignite-2023
 ms.service: azure-ai-services
 ms.topic: conceptual
-ms.date: 01/31/2025
+ms.date: 04/15/2025
 ---
 
 # Purchase commitment tier pricing
@@ -29,6 +29,9 @@ Azure AI offers commitment tier pricing, allowing discounted rates compared to t
 
 For more information, see [Azure AI services pricing](https://azure.microsoft.com/pricing/details/cognitive-services/).
 
+> [!NOTE]
+> You cannot use commitment tier pricing with an Azure AI Services or an Azure AI Foundry multi-service resource. You must use resources dedicated to single services, such as a Speech or Translator resource.
+
 ## Create a new resource
 
 1. Sign in to the [Azure portal](https://portal.azure.com) and select **Create a new resource** for one of the applicable Azure AI services or Azure AI services listed.

articles/ai-services/commitment-tier.md

@@ -39,13 +39,15 @@ Azure OpenAI Service is powered by a diverse set of models with different capabi
 |---|---|
 | `gpt-4.1` (2025-04-14) | East US2 (Global Standard), Sweden Central (Global Standard) |
 | `gpt-4.1-nano` (2025-04-14) | East US2 (Global Standard), Sweden Central (Global Standard)|
+| `gpt-4.1-mini` (2025-04-14) | East US2 (Global Standard), Sweden Central (Global Standard)|
 
 ### Capabilities
 
 |  Model ID  | Description | Context Window | Max Output Tokens | Training Data (up to)  |
 |  --- |  :--- |:--- |:---|:---: |
 | `gpt-4.1` (2025-04-14) <br> <br> **Latest model from Azure OpenAI**  | - Text & image input <br> - Text output <br> - Chat completions API <br>- Responses API <br> - Streaming <br> - Function calling <br> Structured outputs (chat completions)   | 1,047,576 | 32,768 | May 31, 2024 |
 | `gpt-4.1-nano` (2025-04-14) <br><br> **Fastest 4.1 model** | - Text & image input <br> - Text output <br> - Chat completions API <br>- Responses API <br> - Streaming <br> - Function calling <br> Structured outputs (chat completions)   | 1,047,576  | 32,768 | May 31, 2024 |
+| `gpt-4.1-mini` (2025-04-14) | - Text & image input <br> - Text output <br> - Chat completions API <br>- Responses API <br> - Streaming <br> - Function calling <br> Structured outputs (chat completions)   | 1,047,576  | 32,768 | May 31, 2024 |
 
 
 ## computer-use-preview

articles/ai-services/openai/concepts/models.md

@@ -290,11 +290,11 @@ The JSON to paste in the Advanced edit JSON editor is:
 
 ## Connecting to Prompt Flow as a data source
 
-[Prompt flows](/azure/ai-foundry/how-to/flow-develop) allow you to define highly customizable RAG and processing logic on a user's queries. 
+[Prompt flows](../../../ai-foundry/how-to/flow-develop.md) allow you to define highly customizable RAG and processing logic on a user's queries.
 
 ### Creating and deploying your prompt flow in Azure AI Foundry portal
 
-Follow [this tutorial](/azure/ai-foundry/tutorials/deploy-copilot-ai-studio) to create, test, and deploy an inferencing endpoint for your prompt flow in [Azure AI Foundry portal](https://ai.azure.com/).
+Follow [this tutorial](../../../ai-foundry/how-to/flow-deploy.md) to create, test, and deploy an inferencing endpoint for your prompt flow in [Azure AI Foundry portal](https://ai.azure.com/).
 
 ### Enable underlying citations from your prompt flow
 

articles/ai-services/openai/how-to/use-web-app.md

@@ -7,7 +7,7 @@ author: eric-urban
 ms.author: eur
 ms.service: azure-ai-speech
 ms.topic: how-to
-ms.date: 2/28/2025
+ms.date: 4/15/2025
 # Customer intent: As a user who implements audio transcription, I want create transcriptions as quickly as possible.
 ---
 
@@ -50,6 +50,9 @@ The following example shows how to transcribe an audio file with a specified loc
 - Replace `YourServiceRegion` with your Speech resource region.
 - Replace `YourAudioFile` with the path to your audio file.
 
+> [!IMPORTANT]
+> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
+
 ```azurecli-interactive
 curl --location 'https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15' \
 --header 'Content-Type: multipart/form-data' \
@@ -299,6 +302,9 @@ The following example shows how to transcribe an audio file with language identi
 - Replace `YourServiceRegion` with your Speech resource region.
 - Replace `YourAudioFile` with the path to your audio file.
 
+> [!IMPORTANT]
+> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
+
 ```azurecli-interactive
 curl --location 'https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15' \
 --header 'Content-Type: multipart/form-data' \
@@ -585,6 +591,9 @@ The following example shows how to transcribe an audio file with diarization ena
 - Replace `YourServiceRegion` with your Speech resource region.
 - Replace `YourAudioFile` with the path to your audio file.
 
+> [!IMPORTANT]
+> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
+
 ```azurecli-interactive
 curl --location 'https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15' \
 --header 'Content-Type: multipart/form-data' \
@@ -854,6 +863,9 @@ The following example shows how to transcribe an audio file that has one or two
 - Replace `YourServiceRegion` with your Speech resource region.
 - Replace `YourAudioFile` with the path to your audio file.
 
+> [!IMPORTANT]
+> For the recommended keyless authentication with Microsoft Entra ID, replace `--header 'Ocp-Apim-Subscription-Key: YourSubscriptionKey'` with `--header "Authorization: Bearer YourAccessToken"`. For more information about keyless authentication, see the [role-based access control](./role-based-access-control.md#authentication-with-keys-and-tokens) how-to guide.
+
 ```azurecli-interactive
 curl --location 'https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15' \
 --header 'Content-Type: multipart/form-data' \

articles/ai-services/speech-service/fast-transcription-create.md

@@ -36,7 +36,7 @@ A role definition is a collection of permissions. When you create an AI Services
 |**Cognitive Services Data Reader (Preview)** |No |View only |Yes |
 
 > [!IMPORTANT]
-> Whether a role can list resource keys is important for [Speech Studio authentication](#speech-studio-authentication). To list resource keys, a role must have permission to run the `Microsoft.CognitiveServices/accounts/listKeys/action` operation. Please note that if key authentication is disabled in the Azure Portal, then none of the roles can list keys.
+> Whether a role can list resource keys is important for [Speech Studio authentication](#speech-studio-authentication). To list resource keys, a role must have permission to run the `Microsoft.CognitiveServices/accounts/listKeys/action` operation. Please note that if key authentication is disabled in the Azure portal, then none of the roles can list keys.
 
 Keep the built-in roles if your Speech resource can have full read and write access to the projects. 
 
@@ -48,6 +48,43 @@ The [roles](#roles-for-speech-resources) define what permissions you have. Authe
 
 To authenticate with Speech resource keys, all you need is the key and region. To authenticate with a Microsoft Entra token, the Speech resource must have a [custom subdomain](speech-services-private-link.md#create-a-custom-domain-name).
 
+Here's how to create a new Azure AI Services resource with a custom subdomain. You can also use an existing resource, but it must have a custom subdomain. For more information about creating a custom subdomain, see [Create a custom domain name](speech-services-private-link.md#create-a-custom-domain-name).
+
+```bash
+resourceGroupName=my-speech-rg
+location=eastus
+AIServicesResourceName=my-aiservices-$location
+
+# create an AIServices resource for Speech and other AI services
+az cognitiveservices account create --name $AIServicesResourceName --resource-group $resourceGroupName --kind AIServices --sku S0 --location $location --custom-domain $AIServicesResourceName
+
+# get the resource id
+speechResourceId=$(az cognitiveservices account show --name $AIServicesResourceName --resource-group $resourceGroupName --query id -o tsv)
+# assign Cognitive Services User role to the app id
+appId=$(az ad signed-in-user show --query id -o tsv)
+az role assignment create --role "Cognitive Services User" --assignee $appId --scope $speechResourceId
+# assign Cognitive Services Speech User role to the app id
+az role assignment create --role "Cognitive Services Speech User" --assignee $appId --scope $speechResourceId
+
+# get an access token
+accessToken=$(az account get-access-token --scope "https://cognitiveservices.azure.com/.default" --query accessToken -o tsv)
+echo $accessToken
+```
+
+The returned `accessToken` is a Microsoft Entra token that you can use to authenticate without API keys. The token has a [limited lifetime](/entra/identity-platform/configurable-token-lifetimes#access-tokens).
+
+Now you can use the `accessToken` to authenticate with the AI Services resource. For example, you can use the token via the [Fast transcription REST API](./fast-transcription-create.md):
+
+```bash
+uri="https://$AIServicesResourceName.cognitiveservices.azure.com/speechtotext/transcriptions:transcribe?api-version=2024-11-15"
+
+curl -v "$uri" \
+    --header 'Content-Type: multipart/form-data' \
+    --form 'definition={"locales": ["en-US"]}' \
+    --form 'audio=@Call1_separated_16k_health_insurance.wav' \
+    --header "Authorization: Bearer $accessToken" 
+```
+
 ### Speech SDK authentication
 
 For the SDK, you configure whether to authenticate with an API key or Microsoft Entra token. For details, see [Microsoft Entra authentication with the Speech SDK](how-to-configure-azure-ad-auth.md).