Merge pull request #4087 from eric-urban/eur/move-ai-services-doc

move AI services article to ai-services directory

Author: denrea

articles/ai-foundry/.openpublishing.redirection.ai-studio.json

@@ -704,8 +704,8 @@
         },
         {
             "source_path_from_root": "/articles/ai-studio/ai-services/how-to/connect-ai-services.md",
-            "redirect_url": "/azure/ai-foundry/ai-services/how-to/connect-ai-services",
-            "redirect_document_id": true
+            "redirect_url": "/azure/ai-services/connect-services-ai-foundry-portal",
+            "redirect_document_id": false
         },
         {
             "source_path_from_root": "/articles/ai-studio/ai-services/how-to/connect-azure-openai.md",
@@ -880,7 +880,7 @@
         },
         {
             "source_path_from_root": "/articles/ai-studio/how-to/models-foundation-azure-ai.md",
-            "redirect_url": "/azure/ai-studio/ai-services/how-to/connect-ai-services",
+            "redirect_url": "/azure/ai-services/connect-services-ai-foundry-portal",
             "redirect_document_id": true
         },
         {
@@ -960,17 +960,17 @@
         },
         {
             "source_path_from_root": "/articles/ai-studio/ai-services/get-started.md",
-            "redirect_url": "/azure/ai-studio/ai-services/how-to/connect-ai-services",
+            "redirect_url": "/azure/ai-services/connect-services-ai-foundry-portal",
             "redirect_document_id": false
         },
         {
             "source_path_from_root": "/articles/ai-studio/ai-services/where-to-use-ai-services.md",
-            "redirect_url": "/azure/ai-studio/ai-services/how-to/connect-ai-services",
+            "redirect_url": "/azure/ai-services/connect-services-ai-foundry-portal",
             "redirect_document_id": false
         },
         {
             "source_path_from_root": "/articles/ai-studio/ai-services/connect-ai-services.md",
-            "redirect_url": "/azure/ai-studio/ai-services/how-to/connect-ai-services",
+            "redirect_url": "/azure/ai-services/connect-services-ai-foundry-portal",
             "redirect_document_id": false
         },
         {
@@ -1132,6 +1132,11 @@
             "source_path_from_root": "/articles/ai-foundry/how-to/prompt-flow.md",
             "redirect_url": "/azure/ai-foundry/concepts/prompt-flow",
             "redirect_document_id": true
+        },
+        {
+          "source_path_from_root": "/articles/ai-foundry/ai-services/how-to/connect-ai-services.md",
+          "redirect_url": "/azure/ai-services/connect-services-ai-foundry-portal",
+          "redirect_document_id": false
         }
     ]
 }

articles/ai-foundry/how-to/develop/connections-add-sdk.md

@@ -73,7 +73,7 @@ ml_client.connections.create_or_update(wps_connection)
 
 ## Azure AI services
 
-The following example creates an Azure AI services connection. This example creates one connection for the AI services documented in the [Connect to Azure AI services](../../ai-services/how-to/connect-ai-services.md) article. The same connection also supports the Azure OpenAI service.
+The following example creates an Azure AI services connection. This example creates one connection for the AI services documented in the [Connect to Azure AI services](../../../ai-services/connect-services-ai-foundry-portal.md) article. The same connection also supports the Azure OpenAI service.
 
 ```python
 from azure.ai.ml.entities import AzureAIServicesConnection, ApiKeyConfiguration

articles/ai-foundry/how-to/model-catalog-overview.md

@@ -190,5 +190,5 @@ To set the public network access flag for the Azure AI Foundry hub:
 
 ## Related content
 
-* [Explore foundation models in Azure AI Foundry portal](../ai-services/how-to/connect-ai-services.md)
+* [Explore foundation models in Azure AI Foundry portal](../../ai-services/connect-services-ai-foundry-portal.md)
 * [Model deprecation and retirement in Azure AI model catalog](../concepts/model-lifecycle-retirement.md)

articles/ai-foundry/toc.yml

@@ -135,8 +135,8 @@ items:
   - name: Use Azure OpenAI Service in Azure AI Foundry portal
     href: ai-services/how-to/connect-azure-openai.md
   - name: Use Azure AI services in Azure AI Foundry portal
-    href: ai-services/how-to/connect-ai-services.md
-    displayName: cognitive,task
+    href: ../ai-services/connect-services-ai-foundry-portal.md?context=/azure/ai-foundry/context/context
+    displayName: cognitive,task,speech,vision,language,translator,document,intelligence,content,understanding,safety
   - name: What are Azure AI services?
     href: /azure/ai-services/what-are-ai-services
   - name: Azure OpenAI

articles/ai-foundry/ai-services/how-to/connect-ai-services.md renamed to articles/ai-services/connect-services-ai-foundry-portal.md

@@ -1,15 +1,15 @@
 ---
 title: How to use Azure AI services in Azure AI Foundry portal
-titleSuffix: Azure AI Foundry
+titleSuffix: Azure AI Services
 description: Learn how to use Azure AI services in Azure AI Foundry portal. You can use existing Azure AI services resources in Azure AI Foundry portal by creating a connection to the resource.
 manager: nitinme
-ms.service: azure-ai-foundry
+ms.service: azure-ai-services
 ms.custom:
   - ignite-2023
   - build-2024
   - ignite-2024
 ms.topic: how-to
-ms.date: 2/12/2025
+ms.date: 4/14/2025
 ms.reviewer: eur
 ms.author: eur
 author: eric-urban
@@ -42,29 +42,29 @@ Let's look at two ways to connect Azure AI services resources to an Azure AI Fou
 
 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":::
+:::image type="content" source="./media/ai-foundry/projects-create-resource.png" alt-text="Screenshot of the create resource page within the create project dialog." lightbox="./media/ai-foundry/projects-create-resource.png":::
 
-For more details about creating a project, see the [create an Azure AI Foundry project](../../how-to/create-projects.md) how-to guide or the [create a project and use the chat playground](../../quickstarts/get-started-playground.md) quickstart.
+For more details about creating a project, see the [create an Azure AI Foundry project](../ai-foundry/how-to/create-projects.md) how-to guide or the [create a project and use the chat playground](../ai-foundry/quickstarts/get-started-playground.md) quickstart.
 
 ### Connect Azure AI services after you create a project
 
 To use your existing Azure AI services resources (such as Azure AI Speech) in an Azure AI Foundry project, you need to create a connection to the resource.
 
-1. Create an Azure AI Foundry project. For detailed instructions, see [Create an Azure AI Foundry project](../../how-to/create-projects.md).
+1. Create an Azure AI Foundry project. For detailed instructions, see [Create an Azure AI Foundry project](../ai-foundry/how-to/create-projects.md).
 1. Go to your Azure AI Foundry project.
 1. Select **Management center** from the left pane.
 1. Select **Connected resources** (under **Project**) from the left pane. 
 1. Select **+ New connection**.
 
-    :::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":::
+    :::image type="content" source="./media/ai-foundry/connections-add.png" alt-text="Screenshot of the connected resources page with the button to create a new connection." lightbox="./media/ai-foundry/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 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":::
+    :::image type="content" source="./media/ai-foundry/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-foundry/connections-add-assets.png":::
 
 1. On the next page in the wizard, browse or search to find the resource you want to connect. Then select **Add connection**.  
 
-    :::image type="content" source="../../media/ai-services/connections-add-speech.png" alt-text="Screenshot of the page to select the Azure AI resource that you want to connect to the project." lightbox="../../media/ai-services/connections-add-speech.png":::
+    :::image type="content" source="./media/ai-foundry/connections-add-speech.png" alt-text="Screenshot of the page to select the Azure AI resource that you want to connect to the project." lightbox="./media/ai-foundry/connections-add-speech.png":::
 
 1. After the resource is connected, select **Close** to return to the **Connected resources** page. You should see the new connection listed.
 
@@ -75,32 +75,32 @@ You can discover Azure AI models in the model catalog without a project. Some Az
 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":::
+    :::image type="content" source="./media/ai-foundry/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/ai-foundry/ai-studio-home-model-catalog.png":::
 
     If you don't see this tile, you can also go directly to the [Azure AI model catalog page](https://ai.azure.com/explore/models) in Azure AI Foundry portal.
 
 1. From the **Collections** dropdown, select **Microsoft**. Search for Azure AI services models by entering **azure-ai** in the search box.
 
-    :::image type="content" source="../../media/ai-services/models/ai-services-model-catalog.png" alt-text="Screenshot of the model catalog page in Azure AI Foundry portal with the option to search by collection and name." lightbox="../../media/ai-services/models/ai-services-model-catalog.png":::
+    :::image type="content" source="./media/ai-foundry/ai-services-model-catalog.png" alt-text="Screenshot of the model catalog page in Azure AI Foundry portal with the option to search by collection and name." lightbox="./media/ai-foundry/ai-services-model-catalog.png":::
 
 1. Select a model to view more details about it. You can also try the model if it's available for you to try without a project.
 
 ## Try Azure AI services in the project level playgrounds
 
 In the project-level playgrounds, you can try Azure AI services such as Azure AI Speech and Azure AI Language. 
 
-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. Go to your Azure AI Foundry project. If you need to create a project, see [Create an Azure AI Foundry project](../ai-foundry/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 Speech playground**.
 
-    :::image type="content" source="../../media/ai-services/playgrounds/azure-ai-services-playgrounds.png" alt-text="Screenshot of the project level playgrounds that you can use." lightbox="../../media/ai-services/playgrounds/azure-ai-services-playgrounds.png":::
+    :::image type="content" source="./media/ai-foundry/azure-ai-services-playgrounds.png" alt-text="Screenshot of the project level playgrounds that you can use." lightbox="./media/ai-foundry/azure-ai-services-playgrounds.png":::
 
 1. Optionally, you can select a different connection to use in the playground. In the Speech playground, you can connect to Azure AI Services multi-service resources or Speech service resources. 
 
-    :::image type="content" source="../../media/ai-services/playgrounds/speech-playground.png" alt-text="Screenshot of the Speech playground in a project." lightbox="../../media/ai-services/playgrounds/speech-playground.png":::
+    :::image type="content" source="./media/ai-foundry/speech-playground.png" alt-text="Screenshot of the Speech playground in a project." lightbox="./media/ai-foundry/speech-playground.png":::
 
 If you have other connected resources, you can use them in the corresponding playgrounds. For example, in the Language playground, you can connect to Azure AI Services multi-service resources or Azure AI Language resources.
 
-:::image type="content" source="../../media/ai-services/playgrounds/language-playground.png" alt-text="Screenshot of the Language playground in a project." lightbox="../../media/ai-services/playgrounds/language-playground.png":::
+:::image type="content" source="./media/ai-foundry/language-playground.png" alt-text="Screenshot of the Language playground in a project." lightbox="./media/ai-foundry/language-playground.png":::
 
 ## Try out Azure AI Services demos
 
@@ -109,25 +109,25 @@ You can browse Azure AI services capabilities and step through the demos. You ca
 1. Go to the [Azure AI Foundry home page](https://ai.azure.com) and make sure you're signed in with the Azure subscription that has your Azure AI services resource.
 1. Find the tile that says **Explore Azure AI Services** and select **Try now**. 
 
-    :::image type="content" source="../../media/explore/home-ai-services.png" alt-text="Screenshot of the home page in Azure AI Foundry portal with the option to select Azure AI Services." lightbox="../../media/explore/home-ai-services.png":::
+    :::image type="content" source="./media/ai-foundry/home-ai-services.png" alt-text="Screenshot of the home page in Azure AI Foundry portal with the option to select Azure AI Services." lightbox="./media/ai-foundry/home-ai-services.png":::
 
     If you don't see this tile, you can also go directly to the [Azure AI Services page](https://ai.azure.com/explore/aiservices) in Azure AI Foundry portal.
 
 1. You should see tiles for Azure AI services that you can try. Select a tile to get to the demo page for that service. For example, select **Language + Translator**.
 
-    :::image type="content" source="../../media/ai-services/overview/ai-services-capabilities.png" alt-text="Screenshot of the landing page to try Azure AI Services try out capabilities in Azure AI Foundry portal." lightbox="../../media/ai-services/overview/ai-services-capabilities.png":::
+    :::image type="content" source="./media/ai-foundry/ai-services-capabilities.png" alt-text="Screenshot of the landing page to try Azure AI Services try out capabilities in Azure AI Foundry portal." lightbox="./media/ai-foundry/ai-services-capabilities.png":::
 
 The presentation and flow of the demo pages might vary depending on the service. In some cases, you need to select a project or connection to use the service. 
 
 ## Fine-tune Azure AI services models
 
 In Azure AI Foundry portal, you can fine-tune some Azure AI services models. For example, you can fine-tune a model for custom speech. 
 
-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. Go to your Azure AI Foundry project. If you need to create a project, see [Create an Azure AI Foundry project](../ai-foundry/how-to/create-projects.md).
 1. Select **Fine-tuning** from the left pane.
 1. Select **AI Service fine-tuning**.
 
-    :::image type="content" source="../../media/ai-services/fine-tune-azure-ai-services.png" alt-text="Screenshot of the page to select fine-tuning of Azure AI Services models." lightbox="../../media/ai-services/fine-tune-azure-ai-services.png":::
+    :::image type="content" source="./media/ai-foundry/fine-tune-azure-ai-services.png" alt-text="Screenshot of the page to select fine-tuning of Azure AI Services models." lightbox="./media/ai-foundry/fine-tune-azure-ai-services.png":::
 
 1. Select **+ Fine-tune**.
 1. Follow the wizard to fine-tune a model for the capabilities that you want.
@@ -141,17 +141,17 @@ Once you have a project, several Azure AI services models are already deployed a
 1. Select **Models + endpoints** (under **Project**) from the left pane. 
 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 endpoints." lightbox="../../media/ai-services/endpoint/models-endpoints-ai-services-deployments.png":::
+    :::image type="content" source="./media/ai-foundry/models-endpoints-ai-services-deployments.png" alt-text="Screenshot of the models and endpoints page to view Azure AI services endpoints." lightbox="./media/ai-foundry/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.
-    - Another Azure AI Speech deployment via the `contosoazureaispeecheastus` example connection. This example assumes that you connected to an Azure AI Speech resource after creating the project. For more information about connecting to Azure AI services, see [Use your existing Azure OpenAI and AI services resources](./connect-ai-services.md).
+    - Another Azure AI Speech deployment via the `contosoazureaispeecheastus` example connection. This example assumes that you connected to an Azure AI Speech resource after creating the project. For more information about connecting to Azure AI services, see [Bring your existing Azure AI services resources into a project](#bring-your-existing-azure-ai-services-resources-into-a-project).
 
 There's no option to deploy Azure AI services models from the **Models + endpoints** page. Azure AI services models are already deployed and ready to use.
 
 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)
-- [Connections in Azure AI Foundry portal](../../concepts/connections.md)
+- [What are Azure AI services?](./what-are-ai-services.md)
+- [Connections in Azure AI Foundry portal](../ai-foundry/concepts/connections.md)

articles/ai-services/document-intelligence/studio-overview.md

@@ -78,7 +78,7 @@ Use the help wizard, labeling interface, training step, and interactive visualiz
 
 Document Intelligence is part of the Azure AI services offerings in the [Azure AI Foundry portal](https://ai.azure.com/). Each of the Azure AI services helps developers and organizations rapidly create intelligent, cutting-edge, market-ready, and responsible applications with out-of-the-box and prebuilt and customizable APIs and models.
 
-Learn how to [connect your AI services hub](../../ai-foundry/ai-services/how-to/connect-ai-services.md) with AI services and get started using Document Intelligence.
+Learn how to [connect your AI services hub](../../ai-services/connect-services-ai-foundry-portal.md) with AI services and get started using Document Intelligence.
 
 ---
 

articles/ai-services/includes/quickstarts/ai-foundry-prerequisites.md

@@ -11,4 +11,4 @@ ms.author: eur
 
 > [!div class="checklist"]
 > - Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services).
-> - Some Azure AI services features are free to try in the Azure AI Foundry portal. For access to all capabilities described in this article, you need to [connect AI services in Azure AI Foundry](../../../ai-foundry/ai-services/how-to/connect-ai-services.md). 
+> - Some Azure AI services features are free to try in the Azure AI Foundry portal. For access to all capabilities described in this article, you need to [connect AI services in Azure AI Foundry](../../../ai-services/connect-services-ai-foundry-portal.md).