Update instructions to create AI Foundry resource. Tweak TOC.

Author: bojunehsu

articles/ai-services/content-understanding/how-to/create-multi-service-resource.md

@@ -13,7 +13,11 @@ ms.author: lajanuar
 
 # Create an Azure AI Foundry resource
 
-To use Content Understanding, you need an Azure AI Foundry resource. This multi-service resource enables access to multiple Azure AI services with a single set of credentials.
+To use Content Understanding, you need an Azure AI Foundry resource.
+
+> [!IMPORTANT]
+> The steps below explain how to create a resource for use with the [REST API](../quickstart/use-rest-api.md). To use Content Understanding in the Azure AI Foundry portal, see the [AI Foundry quickstart](../quickstart/use-ai-foundry.md).
+
 
 ## Prerequisites
 
@@ -23,9 +27,6 @@ To use Content Understanding, you need an Azure AI Foundry resource. This multi-
 
     :::image type="content" source="../media/overview/azure-multi-service-resource.png" alt-text="Screenshot of the AI Foundry resource page in the Azure portal.":::
 
-    > [!IMPORTANT]
-    > Azure provides more than one resource type for Azure AI services. Be sure to select the one that is listed under **AI Foundry** > **AI Foundry** with the logo as shown previously.
-
 1. Select the **Create** button.
 
 ## Create a resource
@@ -57,5 +58,5 @@ To use the Azure AI Content Understanding service, you must create your Azure AI
 
 Now that you created your Azure AI Foundry resource, you're ready to try out the Content Understanding service.
 
-* Try Content Understanding with no code in [Azure AI Foundry](https://ai.azure.com/explore/aiservices/vision/contentunderstanding).
 * Ready to go straight to code? Follow the [REST API QuickStart](../quickstart/use-rest-api.md).
+* Try Content Understanding with no code in [Azure AI Foundry](https://ai.azure.com/explore/aiservices/vision/contentunderstanding).

articles/ai-services/content-understanding/quickstart/use-rest-api.md

@@ -20,13 +20,10 @@ ms.date: 05/19/2025
 
 To get started, you need **an active Azure subscription**. If you don't have an Azure account, [create one for free](https://azure.microsoft.com/free/).
 
-* Once you have your Azure subscription, create an [Azure AI Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) in the Azure portal. This multi-service resource enables access to multiple Azure AI services with a single set of credentials.
+* Once you have your Azure subscription, create an [Azure AI Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) in the Azure portal.
 
    * This resource is listed under **AI Foundry** > **AI Foundry** in the portal.
 
-    > [!IMPORTANT]
-    > Azure provides more than one resource type for Azure AI services. Make certain that you select the one listed under **AI Foundry** > **AI Foundry** as depicted in the following image. For more information, see [Create an Azure AI Foundry resource](../how-to/create-multi-service-resource.md).
-
      :::image type="content" source="../media/overview/azure-multi-service-resource.png" alt-text="Screenshot of the AI Foundry resource page in the Azure portal.":::
 
 * In this quickstart, we use the cURL command line tool. If it isn't installed, you can download a version for your dev environment:
@@ -35,7 +32,7 @@ To get started, you need **an active Azure subscription**. If you don't have an
   * [Mac or Linux](https://learn2torials.com/thread/how-to-install-curl-on-mac-or-linux-(ubuntu)-or-windows)
 
 
-## Get Started with a prebuilt analyzer
+## Get started with a prebuilt analyzer
 
 Analyzers define how your content is processed and the insights that are extracted. We offer [prebuilt analyzers](../concepts/prebuilt-analyzers.md) for common use cases. You can [customize prebuilt analyzers](../concepts/prebuilt-analyzers.md) to better fit your specific needs and use cases.
 This quickstart uses prebuilt document, image, audio, and video analyzers to help you get started.
@@ -45,25 +42,25 @@ This quickstart uses prebuilt document, image, audio, and video analyzers to hel
 Before running the following cURL command, make the following changes to the HTTP request:
 # [Document](#tab/document)
 
-1. Replace `{endpoint}` and `{key}` with the corresponding values from your Azure AI Services instance in the Azure portal.
+1. Replace `{endpoint}` and `{key}` with the corresponding values from your Azure AI Foundry instance in the Azure portal.
 2. Replace `{analyzerId}` with  `prebuilt-documentAnalyzer`. This analyzer extracts text and layout elements such as paragraphs, sections, and tables from a document.
 3. Replace `{fileUrl}` with a publicly accessible URL of the file to analyze—such as a path to an Azure Storage Blob with a shared access signature (SAS), or use the sample URL: `https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/invoice.pdf`.
 
 # [Image](#tab/image)
 
-1. Replace `{endpoint}` and `{key}` with the corresponding values from your Azure AI Services instance in the Azure portal.
+1. Replace `{endpoint}` and `{key}` with the corresponding values from your Azure AI Foundry instance in the Azure portal.
 2. Replace `{analyzerId}` with  `prebuilt-imageAnalyzer`. This analyzer generates a description of the image.
 3. Replace `{fileUrl}` with a publicly accessible URL of the file to analyze—such as a path to an Azure Storage Blob with a shared access signature (SAS), or use the sample URL: `https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/pieChart.jpg`.
 
 # [Audio](#tab/audio)
 
-1. Replace `{endpoint}` and `{key}` with the corresponding values from your Azure AI Services instance in the Azure portal.
+1. Replace `{endpoint}` and `{key}` with the corresponding values from your Azure AI Foundry instance in the Azure portal.
 2. Replace `{analyzerId}` with  `prebuilt-audioAnalyzer`. This analyzer extracts the audio transcript, generates a summary, and performs speaker labeling.
 3. Replace `{fileUrl}` with a publicly accessible URL of the file to analyze—such as a path to an Azure Storage Blob with a shared access signature (SAS), or use the sample URL: `https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/audio.wav`.
 
 # [Video](#tab/video)
 
-1. Replace `{endpoint}` and `{key}` with the corresponding values from your Azure AI Services instance in the Azure portal.
+1. Replace `{endpoint}` and `{key}` with the corresponding values from your Azure AI Foundry instance in the Azure portal.
 2. Replace `{analyzerId}` with  `prebuilt-videoAnalyzer`. This analyzer extracts keyframes, transcript, and chapter segments from video.
 3. Replace `{fileUrl}` with a publicly accessible URL of the file to analyze—such as a path to an Azure Storage Blob with a shared access signature (SAS), or use the sample URL: `https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/FlightSimulator.mp4`.
 ---
@@ -100,7 +97,7 @@ Operation-Location: {endpoint}/contentunderstanding/analyzerResults/{resultId}?a
 
 Use the `resultId` from the [`POST` response](#post-response) and retrieve the result of the analysis.
 
-1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Services instance.
+1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Foundry instance.
 2. Replace `{resultId}` with the `resultId` from the `POST` response.
 
 #### GET request
@@ -352,7 +349,7 @@ The 200 (`OK`) JSON response includes a `status` field indicating the status of
 
 ## Next steps
 
-Learn more about [analyzers](../concepts/analyzer-templates.md) for your use case.
+Learn more about CREATING [analyzers](../concepts/analyzer-templates.md) for your use case.
 
 
 

articles/ai-services/content-understanding/toc.yml

@@ -26,7 +26,7 @@ items:
       - name: Glossary
         displayName: glossary, definition, updates, previews
         href: glossary.md
-  - name: "AI Foundry: Content Understanding"
+  - name: "AI Foundry portal"
     items:
       - name: Quickstart
         displayName: quickstart, extract, text, images, OCR, optical character recognition

articles/ai-services/content-understanding/tutorial/build-rag-solution.md

@@ -27,13 +27,10 @@ This tutorial explains how to create a retrieval-augmented generation (RAG) solu
 
 To get started, you need **An active Azure subscription**. If you don't have an Azure account, you can [create a free subscription](https://azure.microsoft.com/free/).
 
-* Once you have your Azure subscription, create an [Azure AI Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) in the Azure portal. This multi-service resource enables access to multiple Azure AI services with a single set of credentials.
+* Once you have your Azure subscription, create an [Azure AI Foundry resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry) in the Azure portal.
 
    * This resource is listed under **AI Foundry** > **AI Foundry** in the portal.
 
-    > [!IMPORTANT]
-    > Azure provides more than one resource type for Azure AI services. Make certain that you select the one listed under **AI Foundry** > **AI Foundry** as depicted in the following image. For more information, see [Create an Azure AI Foundry resource](../how-to/create-multi-service-resource.md).
-
      :::image type="content" source="../media/overview/azure-multi-service-resource.png" alt-text="Screenshot of the multi-service resource page in the Azure portal.":::
 
 * **Azure AI Search Resource:** Set up an [Azure AI Search resource](../../../search/search-create-service-portal.md) to enable indexing and retrieval of multimodal data.

articles/ai-services/content-understanding/tutorial/create-custom-analyzer.md

@@ -222,25 +222,25 @@ Before running the cURL command, make the following changes to the HTTP request:
 
 # [Document](#tab/document)
 
-1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Services instance.
+1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Foundry instance.
 1. Replace `{analyzerId}` with the name of the custom analyzer created earlier.
 1. Replace `{fileUrl}` with a publicly accessible URL of the file to analyze, such as a path to an Azure Storage Blob with a shared access signature (SAS) or the sample URL `https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/receipt.png`.
 
 # [Image](#tab/image)
 
-1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Services instance.
+1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Foundry instance.
 1. Replace `{analyzerId}` with the name of the custom analyzer created earlier.
 1. Replace `{fileUrl}` with a publicly accessible URL of the file to analyze, such as a path to an Azure Storage Blob with a shared access signature (SAS) or the sample URL `https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/pieChart.jpg`.
 
 # [Audio](#tab/audio)
 
-1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Services instance.
+1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Foundry instance.
 1. Replace `{analyzerId}` with the name of the custom analyzer created earlier.
 1. Replace `{fileUrl}` with a publicly accessible URL of the file to analyze, such as a path to an Azure Storage Blob with a shared access signature (SAS) or the sample URL `https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/audio.wav`.
 
 # [Video](#tab/video)
 
-1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Services instance.
+1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Foundry instance.
 1. Replace `{analyzerId}` with the name of the custom analyzer created earlier.
 1. Replace `{fileUrl}` with a publicly accessible URL of the file to analyze, such as a path to an Azure Storage Blob with a shared access signature (SAS) or the sample URL `https://github.com/Azure-Samples/azure-ai-content-understanding-python/raw/refs/heads/main/data/FlightSimulator.mp4`.
 
@@ -274,7 +274,7 @@ The `202 Accepted` response includes the `{resultId}` which you can use to track
 
 ### Get Analyze Result
 
-1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Services instance.
+1. Replace `{endpoint}` and `{key}` with the endpoint and key values from your Azure portal Azure AI Foundry instance.
 2. Replace `{resultId}` with the `resultId` in `POST` response.
 
 #### GET Request