refresh docs

Author: eric-urban

articles/ai-studio/ai-services/how-to/connect-ai-services.md

@@ -9,7 +9,7 @@ ms.custom:
   - build-2024
   - ignite-2024
 ms.topic: how-to
-ms.date: 11/19/2024
+ms.date: 2/12/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
@@ -25,7 +25,7 @@ This article describes how to use new or existing Azure AI services resources in
 
 Depending on the AI service and model you want to use, you can use them in Azure AI Foundry portal via:
 - [Bring your existing Azure AI services resources](#bring-your-existing-azure-ai-services-resources-into-a-project) into a project. You can use your existing Azure AI services resources in an Azure AI Foundry project by creating a connection to the resource.
-- The [model catalog](#discover-azure-ai-models-in-the-model-catalog). You don't need a project to browse and discover Azure AI models. Some of the Azure AI services are available for you to try via the model catalog without a project. Some Azure AI services require a project to use in the playgrounds.
+- The [model catalog](#discover-azure-ai-models-in-the-model-catalog). You don't need a project to browse and discover Azure AI models. Some of the Azure AI services are available for you to try via the model catalog without a project. Some Azure AI services require a project to use them in the playgrounds.
 - The [project-level playgrounds](#try-azure-ai-services-in-the-project-level-playgrounds). You need a project to try Azure AI services such as Azure AI Speech and Azure AI Language. 
 - [Azure AI Services demo pages](#try-out-azure-ai-services-demos). You can browse Azure AI services capabilities and step through the demos. You can try some limited demos for free without a project.
 - [Fine-tune](#fine-tune-azure-ai-services-models) models. You can fine-tune a subset of Azure AI services models in Azure AI Foundry portal.
@@ -40,7 +40,7 @@ Let's look at two ways to connect Azure AI services resources to an Azure AI Fou
 
 ### Connect Azure AI services when you create a project for the first time
 
-When you create a project for the first time, you also create a hub. When you create a hub, you can select an existing Azure AI services resource (including Azure OpenAI) or create a new AI services resource.
+When you create a project for the first time, you can select an existing Azure AI services resource (including Azure OpenAI) or create a new AI services resource.
 
 :::image type="content" source="../../media/how-to/projects/projects-create-resource.png" alt-text="Screenshot of the create resource page within the create project dialog." lightbox="../../media/how-to/projects/projects-create-resource.png":::
 
@@ -58,7 +58,7 @@ To use your existing Azure AI services resources (such as Azure AI Speech) in an
 
     :::image type="content" source="../../media/ai-services/connections-add.png" alt-text="Screenshot of the connected resources page with the button to create a new connection." lightbox="../../media/ai-services/connections-add.png":::
 
-1. On the **Add a connection to external assets** page, select the kind of AI service that you want to connect to the project. For example, you can select Azure OpenAI Service, Azure AI Content Safety, Azure AI Speech, Azure AI Language, and other AI services.
+1. On the **Add a connection to external assets** page, select the kind of AI service that you want to connect to the project. For example, you can select Azure AI services (for a connection to multiple services in one resource), Azure OpenAI Service, Azure AI Content Safety, Azure AI Speech, Azure AI Language, and other AI services.
 
     :::image type="content" source="../../media/ai-services/connections-add-assets.png" alt-text="Screenshot of the page to select the kind of AI service that you want to connect to the project." lightbox="../../media/ai-services/connections-add-assets.png":::
 
@@ -72,7 +72,7 @@ To use your existing Azure AI services resources (such as Azure AI Speech) in an
 
 You can discover Azure AI models in the model catalog without a project. Some Azure AI services are available for you to try via the model catalog without a project. 
 
-1. Go to the [Azure AI Foundry home page](https://ai.azure.com).
+1. Go to the [Azure AI Foundry portal home page](https://ai.azure.com).
 1. Select the tile that says **Model catalog and benchmarks**. 
 
     :::image type="content" source="../../media/explore/ai-studio-home-model-catalog.png" alt-text="Screenshot of the home page in Azure AI Foundry portal with the option to select the model catalog tile." lightbox="../../media/explore/ai-studio-home-model-catalog.png":::
@@ -139,9 +139,9 @@ Once you have a project, several Azure AI services models are already deployed a
 1. Go to your Azure AI Foundry project.
 1. Select **Management center** from the left pane.
 1. Select **Models + endpoints** (under **Project**) from the left pane. 
-1. Select the **Service deployments** tab to view the list of Azure AI services models that are already deployed.
+1. Select the **Service endpoints** tab to view the list of Azure AI services models that are already deployed.
 
-    :::image type="content" source="../../media/ai-services/endpoint/models-endpoints-ai-services-deployments.png" alt-text="Screenshot of the models and endpoints page to view Azure AI services deployments." lightbox="../../media/ai-services/endpoint/models-endpoints-ai-services-deployments.png":::
+    :::image type="content" source="../../media/ai-services/endpoint/models-endpoints-ai-services-deployments.png" alt-text="Screenshot of the models and endpoints page to view Azure AI services endpoints." lightbox="../../media/ai-services/endpoint/models-endpoints-ai-services-deployments.png":::
 
     In this example, we see:
     - Six Azure AI Services deployments (such as Azure AI Speech and Azure AI Language) via the default connection. These models were already available for use when you created the project.
@@ -151,7 +151,6 @@ There's no option to deploy Azure AI services models from the **Models + endpoin
 
 However, you can deploy [fine-tuned Azure AI services models](#fine-tune-azure-ai-services-models). For example, you might want to deploy a custom speech model that you fine-tuned. In this case, you can deploy the model from the corresponding fine-tuning page. 
 
-
 ## Related content
 
 - [What are Azure AI services?](../../../ai-services/what-are-ai-services.md?context=/azure/ai-studio/context/context)

articles/ai-studio/ai-services/how-to/connect-azure-openai.md

@@ -9,7 +9,7 @@ ms.custom:
   - build-2024
   - ignite-2024
 ms.topic: how-to
-ms.date: 11/19/2024
+ms.date: 2/12/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
@@ -102,7 +102,7 @@ Here are a few guides to help you get started with Azure OpenAI Service playgrou
 - [Quickstart: Use GPT-4o in the real-time audio playground](../../../ai-services/openai/realtime-audio-quickstart.md?context=/azure/ai-studio/context/context)
 - [Quickstart: Analyze images and video with GPT-4 for Vision in the playground](../../quickstarts/multimodal-vision.md)
 
-Each playground has different model requirements and capabilities. The supported regions will vary depending on the model. For more information about model availability per region, see the [Azure OpenAI Service models documentation](../../../ai-services/openai/concepts/models.md).
+Each playground has different model requirements and capabilities. The supported regions vary depending on the model. For more information about model availability per region, see the [Azure OpenAI Service models documentation](../../../ai-services/openai/concepts/models.md).
 
 ## Fine-tune Azure OpenAI models
 

articles/ai-studio/quickstarts/hear-speak-playground.md

@@ -9,7 +9,7 @@ ms.custom:
   - build-2024
   - ignite-2024
 ms.topic: quickstart
-ms.date: 11/19/2024
+ms.date: 2/12/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
@@ -36,7 +36,7 @@ The speech to text and text to speech features can be used together or separatel
 
 Before you can start a chat session, you need to configure the chat playground to use the speech to text and text to speech features.
 
-1. Sign in to [Azure AI Foundry](https://ai.azure.com).
+1. Sign in to the [Azure AI Foundry portal](https://ai.azure.com).
 1. Go to your Azure AI Foundry project. If you need to create a project, see [Create an Azure AI Foundry project](../how-to/create-projects.md).
 1. Select **Playgrounds** from the left pane and then select a playground to use. In this example, select **Try the chat playground**.
 1. Select your deployed chat model from the **Deployment** dropdown. 
@@ -48,9 +48,9 @@ Before you can start a chat session, you need to configure the chat playground t
     :::image type="content" source="../media/quickstarts/hear-speak/playground-settings-select.png" alt-text="Screenshot of the chat playground with options to get to the chat capabilities settings." lightbox="../media/quickstarts/hear-speak/playground-settings-select.png":::
 
     > [!NOTE]
-    > You should also see the options to select the microphone or speaker buttons. If you select either of these buttons, but haven't yet enabled speech to text or text to speech, you are prompted to enable them in **Chat capabilities**. 
+    > You should also see the options to select the microphone or speaker buttons. If you select either of these buttons, but didn't yet enable speech to text or text to speech, you're prompted to enable them in **Chat capabilities**. 
 
-1. On the **Chat capabilities** page, select the box to acknowledge that usage of the speech feature will incur additional costs. For more information, see [Azure AI Speech pricing](https://azure.microsoft.com/pricing/details/cognitive-services/speech-services/).
+1. On the **Chat capabilities** page, select the box to acknowledge that usage of the speech feature incurs extra costs. For more information, see [Azure AI Speech pricing](https://azure.microsoft.com/pricing/details/cognitive-services/speech-services/).
 
 1. Select **Enable speech to text** and **Enable text to speech**.  
 
@@ -67,7 +67,7 @@ Before you can start a chat session, you need to configure the chat playground t
 
 In this chat session, you use both speech to text and text to speech. You use the speech to text feature to speak to the assistant, and the text to speech feature to hear the assistant's response. 
 
-1. Complete the steps in the [Configure the playground](#configure-the-chat-playground) section if you haven't already done so. To complete this quickstart you need to enable the speech to text and text to speech features.
+1. Complete the steps in the [Configure the playground](#configure-the-chat-playground) section. To complete this quickstart, you need to enable the speech to text and text to speech features.
 1. Select the microphone button and speak to the assistant. For example, you can say "Do you know where I can get an Xbox".
 
     :::image type="content" source="../media/quickstarts/hear-speak/chat-session-speaking.png" alt-text="Screenshot of the chat session with the enabled microphone icon and send button highlighted." lightbox="../media/quickstarts/hear-speak/chat-session-speaking.png":::
@@ -76,7 +76,7 @@ In this chat session, you use both speech to text and text to speech. You use th
 1. Select the send button (right arrow) to send your message to the assistant. The assistant's response is displayed in the chat session pane.
 
     > [!NOTE]
-    > If the speaker button is turned on, you'll hear the assistant's response. If the speaker button is turned off, you won't hear the assistant's response, but the response will still be displayed in the chat session pane.
+    > If the speaker button is turned on, you hear the assistant's response. If the speaker button is turned off, you don't hear the assistant's response, but the response is still displayed in the chat session pane.
 
 1. You can change the system prompt to change the assistant's response format or style.