Merge pull request #6340 from MicrosoftDocs/main

learn-build-service-prod[bot] · web-flow · commit 0a310bc301dc · 2025-08-01T05:09:20.000Z
Auto Publish – main to live - 2025-08-01 05:06 UTC
diff --git a/articles/ai-foundry/openai/concepts/model-versions.md b/articles/ai-foundry/openai/concepts/model-versions.md
@@ -4,7 +4,7 @@ titleSuffix: Azure OpenAI
 description: Learn about model versions in Azure OpenAI. 
 ms.service: azure-ai-openai
 ms.topic: conceptual 
-ms.date: 04/30/2025
+ms.date: 07/31/2025
 manager: nitinme
 author: mrbullwinkle #ChrisHMSFT
 ms.author: mbullwin #chrhoder
diff --git a/articles/ai-foundry/openai/encrypt-data-at-rest.md b/articles/ai-foundry/openai/encrypt-data-at-rest.md
@@ -5,7 +5,7 @@ author: mrbullwinkle
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 04/17/2025
+ms.date: 07/31/2025
 ms.author: mbullwin
 ---
 
diff --git a/articles/ai-foundry/openai/how-to/create-resource.md b/articles/ai-foundry/openai/how-to/create-resource.md
@@ -6,7 +6,7 @@ manager: nitinme
 ms.service: azure-ai-openai
 ms.custom: devx-track-azurecli, build-2023, build-2023-dataai, devx-track-azurepowershell, innovation-engine
 ms.topic: how-to
-ms.date: 04/30/2025
+ms.date: 07/31/2025
 zone_pivot_groups: openai-create-resource
 author: mrbullwinkle
 ms.author: mbullwin
diff --git a/articles/ai-foundry/openai/how-to/deployment-types.md b/articles/ai-foundry/openai/how-to/deployment-types.md
@@ -4,7 +4,7 @@ description: Learn how to use Azure AI Foundry deployment types | Global-Standar
 author: mrbullwinkle
 ms.author: mbullwin
 manager: nitinme
-ms.date: 04/30/2025
+ms.date: 7/31/2025
 ms.service: azure-ai-openai
 ms.topic: how-to
 ms.custom:
diff --git a/articles/ai-foundry/openai/how-to/dynamic-quota.md b/articles/ai-foundry/openai/how-to/dynamic-quota.md
@@ -5,7 +5,7 @@ author: mrbullwinkle
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: how-to
-ms.date: 04/30/2025
+ms.date: 07/31/2025
 ms.author: mbullwin
 ---
 
diff --git a/articles/ai-foundry/openai/how-to/evaluations.md b/articles/ai-foundry/openai/how-to/evaluations.md
@@ -6,7 +6,7 @@ manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: how-to
 ms.custom: references_regions
-ms.date: 04/30/2025
+ms.date: 07/31/2025
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
diff --git a/articles/ai-foundry/openai/how-to/manage-costs.md b/articles/ai-foundry/openai/how-to/manage-costs.md
@@ -6,7 +6,7 @@ ms.author: mbullwin
 ms.custom: subject-cost-optimization
 ms.service: azure-ai-openai
 ms.topic: how-to
-ms.date: 04/30/2025
+ms.date: 07/31/2025
 ---
 
 
diff --git a/articles/ai-foundry/openai/how-to/managed-identity.md b/articles/ai-foundry/openai/how-to/managed-identity.md
@@ -4,7 +4,7 @@ titleSuffix: Azure OpenAI
 description: Provides guidance on how to set managed identity with Microsoft Entra ID
 ms.service: azure-ai-openai
 ms.topic: how-to 
-ms.date: 04/30/2025
+ms.date: 07/31/2025
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
diff --git a/articles/ai-foundry/openai/how-to/migration-javascript.md b/articles/ai-foundry/openai/how-to/migration-javascript.md
@@ -7,7 +7,7 @@ ms.author: mbullwin
 ms.service: azure-ai-openai
 ms.custom: devx-track-python
 ms.topic: how-to
-ms.date: 04/30/2025
+ms.date: 07/31/2025
 manager: nitinme
 ---
 
diff --git a/articles/ai-foundry/openai/how-to/network.md b/articles/ai-foundry/openai/how-to/network.md
@@ -5,7 +5,7 @@ description: How to secure your Azure OpenAI resource inside a virtual network w
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: how-to
-ms.date: 04/25/2025
+ms.date: 07/31/2025
 author: mrbullwinkle
 ms.author: mbullwin
 recommendations: false
diff --git a/articles/ai-foundry/openai/how-to/quota.md b/articles/ai-foundry/openai/how-to/quota.md
@@ -5,7 +5,7 @@ author: mrbullwinkle
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: how-to
-ms.date: 04/30/2025
+ms.date: 07/31/2025
 ms.author: mbullwin
 ---
 
diff --git a/articles/ai-foundry/openai/includes/create-resource-cli.md b/articles/ai-foundry/openai/includes/create-resource-cli.md
@@ -43,6 +43,8 @@ az cognitiveservices account create \
 --kind OpenAI \
 --sku s0 \
 --subscription <subscriptionID>
+--custom-domain MyOpenAIResource
+--yes
 ```
 
 ## Retrieve information about the resource
diff --git a/articles/ai-foundry/openai/overview.md b/articles/ai-foundry/openai/overview.md
@@ -6,7 +6,7 @@ author: mrbullwinkle
 ms.author: mbullwin
 ms.service: azure-ai-openai
 ms.topic: overview
-ms.date: 04/16/2025
+ms.date: 07/31/2025
 ms.custom: build-2023, build-2023-dataai
 recommendations: false
 ---
@@ -130,7 +130,7 @@ Once you create an Azure OpenAI Resource, you must deploy a model before you can
 
 ### Prompt engineering
 
-The GPT-3, GPT-3.5, and GPT-4 models from OpenAI are prompt-based. With prompt-based models, the user interacts with the model by entering a text prompt, to which the model responds with a text completion. This completion is the model’s continuation of the input text.
+The GPT-3.5, and GPT-4 models from OpenAI are prompt-based. With prompt-based models, the user interacts with the model by entering a text prompt, to which the model responds with a text completion. This completion is the model’s continuation of the input text.
 
 While these models are powerful, their behavior is also sensitive to the prompt. This makes [prompt engineering](./concepts/prompt-engineering.md) an important skill to develop.
 
diff --git a/articles/ai-foundry/openai/reference.md b/articles/ai-foundry/openai/reference.md
@@ -5,7 +5,7 @@ description: Learn how to use Azure OpenAI's REST API. In this article, you lear
 manager: nitinme
 ms.service: azure-ai-openai
 ms.topic: conceptual
-ms.date: 04/30/2025
+ms.date: 07/31/2025
 author: mrbullwinkle 
 ms.author: mbullwin
 recommendations: false
diff --git a/articles/ai-foundry/toc.yml b/articles/ai-foundry/toc.yml
@@ -656,10 +656,12 @@ items:
         href: how-to/continuous-evaluation-agents.md
       - name: Monitor model deployments
         href: foundry-models/how-to/monitor-models.md
-   - name: Trace your application 
-     href: how-to/develop/trace-application.md
-   - name: Trace your agent
-     href: how-to/develop/trace-agents-sdk.md
+   - name: Tracing
+     items:
+      - name: Trace your application
+        href: how-to/develop/trace-application.md
+      - name: Trace your agent
+        href: how-to/develop/trace-agents-sdk.md
    - name: A/B experimentation
      href: concepts/a-b-experimentation.md
    - name: Transparency Note for safety evaluations
@@ -908,20 +910,22 @@ items:
   items:
   - name: Trustworthy AI overview
     href: responsible-use-of-ai-overview.md
-  - name: Azure AI Content Safety in AI Foundry portal overview
-    href: ai-services/content-safety-overview.md
-  - name: Guardrails + Controls for models deployed with serverless APIs
-    href: concepts/model-catalog-content-safety.md
   - name: Content filtering
-    href: concepts/content-filtering.md
-  - name: Content filtering for Foundry Models
-    href: foundry-models/concepts/content-filter.md
-  - name: Configure content filtering for Foundry Models
-    href: foundry-models/how-to/configure-content-filters.md
-  - name: Default safety policies for Foundry Models
-    href: foundry-models/concepts/default-safety-policies.md
-  - name: Use blocklists
-    href: foundry-models/how-to/use-blocklists.md
+    items:
+     - name: Azure AI Content Safety in AI Foundry portal overview
+       href: ai-services/content-safety-overview.md
+     - name: Guardrails + Controls for models deployed with serverless APIs
+       href: concepts/model-catalog-content-safety.md
+     - name: Content filtering
+       href: concepts/content-filtering.md
+     - name: Content filtering for Foundry Models
+       href: foundry-models/concepts/content-filter.md
+     - name: Configure content filtering for Foundry Models
+       href: foundry-models/how-to/configure-content-filters.md
+     - name: Default safety policies for Foundry Models
+       href: foundry-models/concepts/default-safety-policies.md
+     - name: Use blocklists
+       href: foundry-models/how-to/use-blocklists.md
   - name: Transparency notes for Azure AI Services
     href: ../ai-services/responsible-use-of-ai-overview.md?context=/azure/ai-foundry/context/context
   - name: Limited Access features
diff --git a/articles/ai-services/includes/quickstarts/management-azportal.md b/articles/ai-services/includes/quickstarts/management-azportal.md
@@ -5,7 +5,7 @@ description: Get started with Azure AI services by creating an AI Foundry resour
 author: eric-urban
 ms.author: eur
 manager: nitinme
-ms.date: 8/1/2024
+ms.date: 7/31/2025
 ms.service: azure-ai-services
 ms.topic: quickstart
 ms.custom:
@@ -24,24 +24,18 @@ keywords:
 
 ## Create a new Azure AI Foundry resource
 
-[Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs) provides a way to create a new Azure resource with basic,  defaulted, settings. If your organization requires customized Azure configurations like alternative names, security controls or cost tags, you may need to instead use [Azure portal](https://portal.azure.com) or [template options](../../../ai-foundry/how-to/create-resource-template.md) to comply with your organization's Azure Policy compliance.
+If your organization requires customized Azure configurations like alternative names, security controls or cost tags, you might need to use the [Azure portal](https://portal.azure.com) or [template options](../../../ai-foundry/how-to/create-resource-template.md) to comply with your organization's Azure Policy compliance.
 
-The Azure AI Foundry multi-service resource is listed under **AI Foundry** > **AI Foundry** in the portal. The API kind is **AIServices**. Look for the logo as shown here:
+The Azure AI Foundry multi-service resource is listed under **AI Foundry** > **AI Foundry** in the Azure portal. The API kind is **AIServices**. Look for the logo as shown here:
 
 :::image type="content" source="../../media/ai-services-resource-portal.png" alt-text="Screenshot of the Azure AI Foundry resource in the Azure portal." lightbox="../../media/ai-services-resource-portal.png":::
 
-> [!IMPORTANT]
-> Azure provides more than one resource kinds named Azure AI services. Be sure to select the one that is listed under **AI Foundry** > **AI Foundry** with the logo as shown previously.
-
-To create an AI Foundry resource follow these instructions:
-
 > [!TIP]
-> If you need to create an [!INCLUDE [fdp](../../../ai-foundry/includes/fdp-project-name.md)] or [!INCLUDE [hub](../../../ai-foundry/includes/hub-project-name.md)] resource, you can also use the [Azure Foundry portal](https://ai.azure.com/?cid=learnDocs) to create the resource. For more information, see the following articles:
->
-> - [Create an Azure AI Foundry project](/azure/ai-foundry/how-to/create-projects?tabs=ai-foundry&pivots=fdp-project).
-> - [Create an Azure AI hub based project](/azure/ai-foundry/how-to/create-projects?tabs=ai-foundry&pivots=hub-project).
+> [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs) provides a way to [create a new Azure AI Foundry resource](/azure/ai-foundry/how-to/create-projects?tabs=ai-foundry&pivots=fdp-project) with basic, defaulted, settings. 
+
+To create an AI Foundry resource in the Azure portal follow these instructions:
 
-1. Select this link to create an **AI Foundry** resource: [https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry)
+1. Select this **AI Foundry** resource link: [https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry)
 
 1. On the **Create** page, provide the following information:
 
diff --git a/articles/ai-services/speech-service/text-to-speech-avatar/what-is-text-to-speech-avatar.md b/articles/ai-services/speech-service/text-to-speech-avatar/what-is-text-to-speech-avatar.md
@@ -5,14 +5,14 @@ description: Get an overview of the Text to speech avatar feature of speech serv
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: overview
-ms.date: 4/28/2025
+ms.date: 7/31/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
 ms.custom: references_regions
 ---
 
-# Text to speech avatar overview
+# What is Text to speech avatar?
 
 Text to speech avatar converts text into a digital video of a photorealistic human (either a standard avatar or a [custom text to speech avatar](#custom-text-to-speech-avatar)) speaking with a natural-sounding voice. The text to speech avatar video can be synthesized asynchronously or in real time. Developers can build applications integrated with text to speech avatar through an API, or use a content creation tool on Speech Studio to create video content without coding.
 
diff --git a/articles/ai-services/speech-service/voice-live-how-to.md b/articles/ai-services/speech-service/voice-live-how-to.md
@@ -7,7 +7,7 @@ author: eric-urban
 ms.author: eur
 ms.service: azure-ai-speech
 ms.topic: how-to
-ms.date: 7/1/2025
+ms.date: 7/31/2025
 ms.custom: references_regions
 # Customer intent: As a developer, I want to learn how to use the voice live API for real-time voice agents.
 ---
@@ -98,7 +98,7 @@ You can use input audio properties to configure the input audio stream.
 |----------|----------|----------|------------|
 | `input_audio_sampling_rate` | integer  | Optional | The sampling rate of the input audio.<br/><br/>The supported values are `16000` and `24000`. The default value is `24000`. |
 | `input_audio_echo_cancellation` | object   | Optional | Enhances the input audio quality by removing the echo from the model's own voice without requiring any client-side echo cancellation.<br/><br/>Set the `type` property of `input_audio_echo_cancellation` to enable echo cancellation.<br/><br/>The supported value for `type` is `server_echo_cancellation`, which is used when the model's voice is played back to the end-user through a speaker, and the microphone picks up the model's own voice.  |
-| `input_audio_noise_reduction`   | object   | Optional | Enhances the input audio quality by suppressing or removing environmental background noise.<br/><br/>Set the `type` property of `input_audio_noise_reduction` to enable noise suppression.<br/><br/>The supported value for `type` is `azure_deep_noise_suppression`, which optimizes for speakers closest to the microphone. |
+| `input_audio_noise_reduction`   | object   | Optional | Enhances the input audio quality by suppressing or removing environmental background noise.<br/><br/>Set the `type` property of `input_audio_noise_reduction` to enable noise suppression.<br/><br/>The supported value for `type` is `azure_deep_noise_suppression`, which optimizes for speakers closest to the microphone.<br/><br/>You can set this property to `near_field` or `far_field` if you're using the [Azure OpenAI Realtime API](../../ai-foundry/openai/realtime-audio-reference.md#realtimeaudioinputaudionoisereductionsettings). |
 
 Here's an example of input audio properties is a session object:
 
@@ -142,10 +142,11 @@ Turn detection is the process of detecting when the end-user started or stopped
 
 | Property | Type | Required or optional | Description |
 |----------|----------|----------|------------|
-| `type` | string   | Optional | The type of turn detection system to use. Type `server_vad` detects start and end of speech based on audio volume.<br/><br/>Type `azure_semantic_vad` detects start and end of speech based on semantic meaning. Azure semantic voice activity detection (VAD) improves turn detection by removing filler words to reduce the false alarm rate. The current list of filler words are `['ah', 'umm', 'mm', 'uh', 'huh', 'oh', 'yeah', 'hmm']`. The service ignores these words when there's an ongoing response. Remove feature words feature assumes the client plays response audio as soon as it receives them.<br/><br/>The default value is `server_vad`. |
+| `type` | string   | Optional | The type of turn detection system to use. Type `server_vad` detects start and end of speech based on audio volume.<br/><br/>Type `azure_semantic_vad` detects start and end of speech based on semantic meaning. Azure semantic voice activity detection (VAD) improves turn detection by removing filler words to reduce the false alarm rate. The `remove_filler_words` property must be set to `true`. The current list of filler words are `['ah', 'umm', 'mm', 'uh', 'huh', 'oh', 'yeah', 'hmm']`. The service ignores these words when there's an ongoing response. Remove feature words feature assumes the client plays response audio as soon as it receives them.<br/><br/>The default value is `server_vad`. |
 | `threshold` | number | Optional | A higher threshold requires a higher confidence signal of the user trying to speak. |
 | `prefix_padding_ms` | integer | Optional  | The amount of audio, measured in milliseconds, to include before the start of speech detection signal. |
 | `silence_duration_ms` | integer  | Optional | The duration of user's silence, measured in milliseconds, to detect the end of speech. |
+| `remove_filler_words` | boolean | Determines whether to remove filler words to reduce the false alarm rate. This property must be set to `true` when using `azure_semantic_vad`.<br/><br/>The default value is `false`. |
 | `end_of_utterance_detection` | object | Optional | Configuration for end of utterance detection. The voice live API offers advanced end-of-turn detection to indicate when the end-user stopped speaking while allowing for natural pauses. End of utterance detection can significantly reduce premature end-of-turn signals without adding user-perceivable latency. End of utterance detection is only available when using `azure_semantic_vad`.<br/><br/>Properties of `end_of_utterance_detection` include:<br/>-`model`: The model to use for end of utterance detection. The supported value is `semantic_detection_v1`.<br/>- `threshold`: Threshold to determine the end of utterance (0.0 to 1.0). The default value is 0.01.<br/>- `timeout`: Timeout in seconds. The default value is 2 seconds.|
 
 Here's an example of end of utterance detection in a session object:
