Merge pull request #2807 from eric-urban/eur/freshness-feb

tier 1 freshness

Author: JillGrant615

articles/ai-services/authentication.md

@@ -2,22 +2,22 @@
 title: Authentication in Azure AI services
 titleSuffix: Azure AI services
 description: "There are three ways to authenticate a request to an Azure AI services resource: a resource key, a bearer token, or a multi-service subscription. In this article, you'll learn about each method, and how to make a request."
-author: mgreenegit
+author: eric-urban
 manager: nitinme
 ms.service: azure-ai-services
 ms.custom: devx-track-azurepowershell
 ms.topic: how-to
-ms.date: 8/1/2024
-ms.author: migreene
+ms.date: 2/7/2025
+ms.author: eur
 ---
 
 # Authenticate requests to Azure AI services
 
 Each request to an Azure AI service must include an authentication header. This header passes along a resource key or authentication token, which is used to validate your subscription for a service or group of services. In this article, you'll learn about three ways to authenticate a request and the requirements for each.
 
-* Authenticate with a [single-service](#authenticate-with-a-single-service-resource-key) or [multi-service](#authenticate-with-a-multi-service-resource-key) resource key
-* Authenticate with a [token](#authenticate-with-an-access-token)
-* Authenticate with [Microsoft Entra ID](#authenticate-with-azure-active-directory)
+* Authenticate with a [single-service](#authenticate-with-a-single-service-resource-key) or [multi-service](#authenticate-with-a-multi-service-resource-key) resource key.
+* Authenticate with a [token](#authenticate-with-an-access-token).
+* Authenticate with [Microsoft Entra ID](#authenticate-with-azure-active-directory).
 
 ## Prerequisites
 
@@ -106,7 +106,7 @@ Some Azure AI services accept, and in some cases require, an access token. Curre
 * Speech Services: Speech to text API
 * Speech Services: Text to speech API
 
->[!WARNING]
+> [!WARNING]
 > The services that support access tokens may change over time, please check the API reference for a service before using this authentication method.
 
 Both single service and multi-service resource keys can be exchanged for authentication tokens. Authentication tokens are valid for 10 minutes. They're stored in JSON Web Token (JWT) format and can be queried programmatically using the [JWT libraries](https://jwt.io/libraries). 
@@ -176,13 +176,13 @@ The first step is to create a custom subdomain. If you want to use an existing A
    Set-AzContext -SubscriptionName <SubscriptionName>
    ```
 
-2. Next, [create an Azure AI services resource](/powershell/module/az.cognitiveservices/new-azcognitiveservicesaccount) with a custom subdomain. The subdomain name needs to be globally unique and cannot include special characters, such as: ".", "!", ",".
+1. Next, [create an Azure AI services resource](/powershell/module/az.cognitiveservices/new-azcognitiveservicesaccount) with a custom subdomain. The subdomain name needs to be globally unique and cannot include special characters, such as: ".", "!", ",".
 
    ```powershell-interactive
    $account = New-AzCognitiveServicesAccount -ResourceGroupName <RESOURCE_GROUP_NAME> -name <ACCOUNT_NAME> -Type <ACCOUNT_TYPE> -SkuName <SUBSCRIPTION_TYPE> -Location <REGION> -CustomSubdomainName <UNIQUE_SUBDOMAIN>
    ```
 
-3. If successful, the **Endpoint** should show the subdomain name unique to your resource.
+1. If successful, the **Endpoint** should show the subdomain name unique to your resource.
 
 
 ### Assign a role to a service principal
@@ -202,7 +202,7 @@ Now that you have a custom subdomain associated with your resource, you're going
 
    You're going to need the **ApplicationId** in the next step.
 
-2. Next, you need to [create a service principal](/powershell/module/az.resources/new-azadserviceprincipal) for the Microsoft Entra application.
+1. Next, you need to [create a service principal](/powershell/module/az.resources/new-azadserviceprincipal) for the Microsoft Entra application.
 
    ```powershell-interactive
    New-AzADServicePrincipal -ApplicationId <APPLICATION_ID>
@@ -211,7 +211,7 @@ Now that you have a custom subdomain associated with your resource, you're going
    > [!NOTE]
    > If you register an application in the Azure portal, this step is completed for you.
 
-3. The last step is to [assign the "Cognitive Services User" role](/powershell/module/az.Resources/New-azRoleAssignment) to the service principal (scoped to the resource). By assigning a role, you're granting service principal access to this resource. You can grant the same service principal access to multiple resources in your subscription.
+1. The last step is to [assign the "Cognitive Services User" role](/powershell/module/az.Resources/New-azRoleAssignment) to the service principal (scoped to the resource). By assigning a role, you're granting service principal access to this resource. You can grant the same service principal access to multiple resources in your subscription.
 
    > [!NOTE]
    > The ObjectId of the service principal is used, not the ObjectId for the application.
@@ -231,7 +231,7 @@ In this sample, a password is used to authenticate the service principal. The to
    $context.Tenant.Id
    ```
 
-2. Get a token:
+1. Get a token:
    ```powershell-interactive
    $tenantId = $context.Tenant.Id
    $clientId = $app.ApplicationId
@@ -253,7 +253,7 @@ In this sample, a password is used to authenticate the service principal. The to
    > [!NOTE]
    > Anytime you use passwords in a script, the most secure option is to use the PowerShell Secrets Management module and integrate with a solution such as Azure Key Vault.
   
-3. Call the Computer Vision API:
+1. Call the Computer Vision API:
    ```powershell-interactive
    $url = $account.Endpoint+"vision/v1.0/models"
    $result = Invoke-RestMethod -Uri $url  -Method Get -Headers @{"Authorization"="Bearer $accessToken"} -Verbose
@@ -284,7 +284,7 @@ You can [use Azure Key Vault](./use-key-vault.md) to securely develop Azure AI s
 
 Authentication is done via Microsoft Entra ID. Authorization may be done via Azure role-based access control (Azure RBAC) or Key Vault access policy. Azure RBAC can be used for both management of the vaults and access data stored in a vault, while key vault access policy can only be used when attempting to access data stored in a vault.
 
-## See also
+## Related content
 
 * [What are Azure AI services?](./what-are-ai-services.md)
 * [Azure AI services pricing](https://azure.microsoft.com/pricing/details/cognitive-services/)

articles/ai-services/cognitive-services-environment-variables.md

@@ -6,15 +6,15 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-services
 ms.topic: how-to
-ms.date: 8/11/2024
+ms.date: 2/7/2025
 ms.author: eur
 ---
 
 # Use environment variables with Azure AI services
 
 This guide shows you how to set and retrieve environment variables for your Azure AI services credentials when you test applications.
 
-[!INCLUDE [Azure key vault](~/reusable-content/ce-skilling/azure/includes/ai-services/security/azure-key-vault.md)]
+[!INCLUDE [Azure key vault](~/reusable-content/ce-skilling/azure/includes/ai-services/security/microsoft-entra-id-akv.md)]
 
 ## Set an environment variable
 

articles/ai-services/create-account-resource-manager-template.md

@@ -6,7 +6,7 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-services
 ms.topic: quickstart
-ms.date: 8/1/2024
+ms.date: 2/7/2025
 ms.author: eur
 ms.custom:
   - subject-armqs
@@ -35,7 +35,7 @@ The template that you use in this quickstart is from [Azure Quickstart Templates
 
 One Azure resource is defined in the Bicep file. The `kind` field in the Bicep file defines the type of resource.
 
-As needed, change the `sku` parameter value to the [pricing](https://azure.microsoft.com/pricing/details/cognitive-services/) instance you want. The `sku` depends on the resource `kind` that you use. For example, use `TextAnalytics` for the Azure AI Language service. The `TextAnalytics` kind uses `S` instead of `S0` for the `sku` value.
+As needed, change the `sku` parameter value to the [pricing](https://azure.microsoft.com/pricing/details/cognitive-services/) instance you want. The `sku` depends on the resource `kind` that you use. For example, use `AIServices` for the Azure AI Language service. 
 
 ## Deploy the template
 

articles/ai-services/index.yml

@@ -13,7 +13,7 @@ metadata:
   ms.author: eur
   manager: nitinme
   ms.custom: ignite-2023
-  ms.date: 9/5/2024
+  ms.date: 2/7/2025
 highlightedContent:
 # itemType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | whats-new
   items:

articles/ai-services/multi-service-resource.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: azure-ai-services
 ms.custom: devx-track-azurecli, devx-track-azurepowershell, build-2024, ignite-2024
 ms.topic: quickstart
-ms.date: 8/20/2024
+ms.date: 2/7/2025
 ms.author: eur
 zone_pivot_groups: programming-languages-portal-cli-ps
 ---
@@ -37,7 +37,8 @@ The multi-service resource enables access to the following Azure AI services wit
 
 | Service | Description | Kind (via API) |
 | --- | --- | --- |
-| ![Azure AI model inference icon](~/reusable-content/ce-skilling/azure/media/ai-services/ai-foundry.svg) [Azure AI Model Inference](../ai-foundry/model-inference/index.yml) | Performs model inference for flagship models in the Azure AI model catalog. | `AIServices` |
+| ![Azure icon](~/reusable-content/ce-skilling/azure/media/ai-services/azure.svg) [Azure AI Agent Service](./agents/index.yml) | Combine the power of generative AI models with tools that allow agents to access and interact with real-world data sources. | `AIServices` |
+| ![Azure AI Foundry icon](~/reusable-content/ce-skilling/azure/media/ai-services/ai-foundry.svg) [Azure AI Model Inference](../ai-foundry/model-inference/index.yml) | Performs model inference for flagship models in the Azure AI model catalog. | `AIServices` |
 | ![Azure OpenAI Service icon](~/reusable-content/ce-skilling/azure/media/ai-services/azure-openai.svg) [Azure OpenAI](./openai/index.yml) | Perform a wide variety of natural language tasks. | `AIServices`<br/>`OpenAI` |
 | ![Content Safety icon](~/reusable-content/ce-skilling/azure/media/ai-services/content-safety.svg) [Content Safety](./content-safety/index.yml) | An AI service that detects unwanted contents. | `AIServices`<br/>`ContentSafety` |
 | ![Custom Vision icon](~/reusable-content/ce-skilling/azure/media/ai-services/custom-vision.svg) [Custom Vision](./custom-vision-service/index.yml) | Customize image recognition for your business. | `CustomVision.Prediction` (Prediction only)<br/>`CustomVision.Training` (Training only) |

articles/ai-services/speech-service/how-to-async-meeting-transcription.md

@@ -5,7 +5,7 @@ description: Learn how to use asynchronous conversation transcription using the
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: how-to
-ms.date: 9/9/2024
+ms.date: 2/7/2025
 ms.devlang: csharp
 ms.custom: cogserv-non-critical-speech, devx-track-csharp, devx-track-extended-java
 zone_pivot_groups: programming-languages-set-twenty-one

articles/ai-services/speech-service/how-to-audio-content-creation.md

@@ -6,7 +6,7 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: how-to
-ms.date: 9/9/2024
+ms.date: 2/7/2025
 ms.author: eur
 ---
 
@@ -19,15 +19,13 @@ Build highly natural audio content for various scenarios, such as audiobooks, ne
 The tool is based on [Speech Synthesis Markup Language (SSML)](speech-synthesis-markup.md). It allows you to adjust text to speech output attributes in real-time or batch synthesis, such as voice characters, voice styles, speaking speed, pronunciation, and prosody.
 
 - No-code approach: You can use the Audio Content Creation tool for text to speech synthesis without writing any code. The output audio might be the final deliverable that you want. For example, you can use the output audio for a podcast or a video narration. 
-- Developer-friendly: You can listen to the output audio and adjust the SSML to improve speech synthesis. Then you can use the [Speech SDK](speech-sdk.md) or [Speech CLI](spx-basics.md) to integrate the SSML into your applications. For example, you can use the SSML for building a chat bot.
+- Developer-friendly: You can listen to the output audio and adjust the SSML to improve speech synthesis. Then you can use the [Speech SDK](speech-sdk.md) or [Speech CLI](spx-basics.md) to integrate the SSML into your applications. 
 
 You have easy access to a broad portfolio of [languages and voices](language-support.md?tabs=tts). These voices include state-of-the-art prebuilt neural voices and your custom neural voice, if you built one.
 
-To learn more, view the Audio Content Creation tutorial video [on YouTube](https://youtu.be/ygApYuOOG6w).
-
 ## Get started
 
-The Audio Content Creation tool in Speech Studio is free to access, but you pay for Speech service usage. To work with the tool, you need to sign in with an Azure account and create a Speech resource. For each Azure account, you have free monthly speech quotas, which include 0.5 million characters for prebuilt neural voices (referred to as *Neural* on the [pricing page](https://aka.ms/speech-pricing)). Usually, the monthly allotted amount is enough for a small content team of around 3-5 people. 
+The Audio Content Creation tool in Speech Studio is free to access, but you pay for Speech service usage. To work with the tool, you need to sign in with an Azure account and create a Speech resource. 
 
 The next sections cover how to create an Azure account and get a Speech resource.
 
@@ -39,28 +37,28 @@ To work with Audio Content Creation, you need a [Microsoft account](https://acco
 
 ### Step 2: Create a Speech resource
 
-After you sign up for the Azure account, you need to create a Speech resource in your Azure account to access Speech services. Create a Speech resource on the [Azure portal](https://portal.azure.com). For more information, see [Create an Azure AI services resource](../multi-service-resource.md?pivots=azportal).
+After you sign up for the Azure account, you need to create a Speech resource in your Azure account to access Speech services. Create a Speech resource on the [Azure portal](https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices). For more information, see [Create an Azure AI services resource](../multi-service-resource.md?pivots=azportal).
 
 It takes a few moments to deploy your new Speech resource. After the deployment is complete, you can start using the Audio Content Creation tool.
 
- > [!NOTE]
-   > If you plan to use neural voices, make sure that you create your resource in [a region that supports neural voices](regions.md#regions).
+> [!NOTE]
+> If you plan to use neural voices, make sure that you create your resource in [a region that supports neural voices](regions.md#regions).
 
 ### Step 3: Sign in to Audio Content Creation with your Azure account and Speech resource
 
 1. After you get the Azure account and the Speech resource, sign in to [Speech Studio](https://aka.ms/speechstudio/), and then select **Audio Content Creation**.
 
 1. Select the Azure subscription and the Speech resource you want to work with, and then select **Use resource**. 
 
-   The next time you sign in to Audio Content Creation, you're linked directly to the audio work files under the current Speech resource. You can check your Azure subscription details and status in the [Azure portal](https://portal.azure.com/).  
-   
-   If you don't have an available Speech resource and you're the owner or admin of an Azure subscription, you can create a Speech resource in Speech Studio by selecting **Create a new resource**. 
-   
-   If you have a user role for a certain Azure subscription, you might not have permissions to create a new Speech resource. To get access, contact your admin. 
+The next time you sign in to Audio Content Creation, you're linked directly to the audio work files under the current Speech resource. You can check your Azure subscription details and status in the [Azure portal](https://portal.azure.com/).  
+
+If you don't have an available Speech resource and you're the owner or admin of an Azure subscription, you can create a Speech resource in Speech Studio by selecting **Create a new resource**. 
 
-   To switch your Speech resource at any time, select **Settings** at the top of the page.
+If you have a user role for a certain Azure subscription, you might not have permissions to create a new Speech resource. To get access, contact your admin. 
 
-   To switch directories, select **Settings** or go to your profile. 
+To switch your Speech resource at any time, select **Settings** at the top of the page.
+
+To switch directories, select **Settings** or go to your profile. 
 
 ## Use the tool
 
@@ -94,7 +92,6 @@ Each step in the preceding diagram is described here:
 
 You can get your content into the Audio Content Creation tool in either of two ways:
 
-
 ### Option 1: Create a new audio tuning file
 
 1. Select **New** > **Text file** to create a new audio tuning file.
@@ -179,8 +176,10 @@ To add users to a Speech resource so that they can use Audio Content Creation, d
 
 1. In the [Azure portal](https://portal.azure.com/), select **All services** from the left navigation pane, and then search for **Azure AI services** or **Speech**.
 1. Select your Speech resource.
+
    > [!NOTE]
    > You can also set up Azure RBAC for whole resource groups, subscriptions, or management groups. Do this by selecting the desired scope level and then navigating to the desired item (for example, selecting **Resource groups** and then selecting your resource group).
+
 1. Select **Access control (IAM)** on the left navigation pane.
 1. Select **Add** > **Add role assignment**.
 1. On the **Role** tab on the next screen, select a role (such as **Owner**) that you want to add.

articles/ai-services/speech-service/how-to-configure-azure-ad-auth.md

@@ -6,7 +6,7 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: how-to
-ms.date: 9/9/2024
+ms.date: 2/7/2025
 ms.author: eur
 zone_pivot_groups: programming-languages-set-two
 ms.custom: devx-track-azurepowershell, devx-track-extended-java, devx-track-python, devx-track-azurecli
@@ -123,9 +123,6 @@ For programming languages where a Microsoft identity platform client library isn
 
 You need your Speech resource ID to make SDK calls using Microsoft Entra authentication.
 
-> [!NOTE]
-> For Intent Recognition use your LUIS Prediction resource ID.
-
 # [Azure portal](#tab/portal)
 
 To get the resource ID in the Azure portal:
@@ -153,7 +150,6 @@ To get the resource ID using PowerShell, confirm that you have PowerShell versio
 
 Now run `Connect-AzAccount` to create a connection with Azure.
 
-
 ```azurepowershell
 Connect-AzAccount
 $subscriptionId = "Your Azure subscription Id"

articles/ai-services/speech-service/how-to-use-meeting-transcription.md

@@ -6,7 +6,7 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: quickstart
-ms.date: 9/9/2024
+ms.date: 2/7/2025
 ms.author: eur
 zone_pivot_groups: acs-js-csharp-python
 ms.custom: cogserv-non-critical-speech, references_regions, devx-track-extended-java, devx-track-js, devx-track-python
@@ -15,7 +15,7 @@ ms.custom: cogserv-non-critical-speech, references_regions, devx-track-extended-
 # Quickstart: Real-time conversation transcription multichannel diarization (preview)
 
 > [!NOTE]
-> This feature is currently in public preview. This preview is provided without a service-level agreement, and is not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
+> This feature is currently in public preview. This preview is provided without a service-level agreement, and isn't recommended for production workloads. Certain features might not be supported or might have constrained capabilities. For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
 With conversation transcription multichannel diarization, you can transcribe meetings with the ability to add, remove, and identify multiple participants by streaming audio to the Speech service. You first create voice signatures for each participant using the REST API, and then use the voice signatures with the Speech SDK to transcribe meetings. See the conversation transcription [overview](meeting-transcription.md) for more information.