Merge pull request #7736 from HeidiSteen/main

Azure AI Search skills dependency on AI services multiservice account

Author: ttorble

articles/ai-services/media/cognitive-services-resource-portal.png

@@ -4,14 +4,16 @@ titleSuffix: Azure AI services
 description: Learn how to create a multi-service resource to use Azure AI Search skills with an Azure AI Foundry resource.
 author: jonburchel
 ms.author: jburchel
-ms.date: 10/07/2025
+ms.date: 10/20/2025
 ms.service: azure-ai-services
 ms.topic: quickstart
 ---
 
 # Use Azure AI Foundry with Azure AI Search skills
 
-[Azure AI Search skills](../search/tutorial-skillset.md) don't natively support the AI Foundry resource. You need to create a different _multi-service_ resource, instead, to use Azure AI Search skills with an Azure AI Foundry resource.
+In this Quickstart, you learn how to create a classic Azure AI services multi-service account that supports [skillset processing](/azure/search/cognitive-search-concept-intro) in Azure AI Search. 
+
+[Azure AI Search skills](../search/tutorial-skillset.md) don't natively support the AI Foundry resource. You need to create a classic _multi-service_ resource, instead, to use Azure AI Search skills with Azure AI Foundry and any other workflow that includes built-in skills.
 
 ## Create a multi-service resource
 
@@ -20,6 +22,7 @@ The multi-service resource that you can use with Azure AI Search skills is liste
 :::image type="content" source="./media/cognitive-services-resource-portal.png" alt-text="Screenshot of the Azure AI services multi-service account in the Azure portal." lightbox="./media/cognitive-services-resource-portal.png":::
 
 To create a multi-service resource for Azure AI Search skills follow these instructions:
+
 1. Select this link to create an **Azure AI services multi-service account (classic)** resource: [https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne](https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne)
 
 1. On the **Create** page, provide the following information:
@@ -28,7 +31,7 @@ To create a multi-service resource for Azure AI Search skills follow these instr
     |--|--|
     | **Subscription** | Select one of your available Azure subscriptions. |
     | **Resource group** | The Azure resource group that contains your Azure AI services multi-service account resource. You can create a new group or add it to a preexisting group. |
-    | **Region** | The location of your Azure AI services multi-service account instance. Different locations might introduce latency, but have no impact on the runtime availability of your resource. |
+    | **Region** | The location of your Azure AI services multi-service account instance. Different locations might introduce latency, but have no impact on the runtime availability of your resource. Check the [Azure AI Search region](/azure/search/search-region-support) support column for *AI Enrichment*.|
     | **Name** | A descriptive name for your Azure AI services multi-service account resource. For example, *MyCognitiveServicesResource*. |
     | **Pricing tier** | The cost of your Azure AI services multi-service account depends on the options you choose and your usage. For more information, see the API [pricing details](https://azure.microsoft.com/pricing/details/cognitive-services/). |
 

articles/ai-services/multi-services-resource-search-skills.md

@@ -6,7 +6,7 @@ author: HeidiSteen
 ms.author: heidist 
 ms.service: azure-ai-search
 ms.topic: how-to
-ms.date: 06/11/2025
+ms.date: 10/20/2025
 ms.update-cycle: 180-days
 ms.custom:
   - ignite-2023
@@ -16,7 +16,7 @@ ms.custom:
 
 # Attach an Azure AI services resource to a skillset in Azure AI Search
 
-If you're using built-in skills for optional [AI enrichment](cognitive-search-concept-intro.md) in Azure AI Search, you can enrich a small number of documents free of charge, limited to 20 transactions daily per index. For larger and more frequent workloads, you should attach a billable [Azure AI services multi-service resource](/azure/ai-services/multi-service-resource#azure-ai-services-resource-for-azure-ai-search-skills?pivots=azportal). 
+If you're using built-in skills for optional [AI enrichment](cognitive-search-concept-intro.md) in Azure AI Search, you can enrich a small number of documents free of charge, limited to 20 transactions daily per index. For larger and more frequent workloads, you should attach a billable [classic Azure AI services multi-service resource](/azure/ai-services/multi-services-resource-search-skills). 
 
 Azure AI Search uses dedicated, internally hosted Azure AI services multi-service resources for built-in skills execution, but needs your multi-service resource for billing purposes. 
 
@@ -26,7 +26,7 @@ An Azure AI services multi-service resource provides a collection of Azure AI se
 + [Azure AI Language](/azure/ai-services/language-service/overview) for language detection, entity recognition, sentiment analysis, and key phrase extraction
 + [Azure AI Translator](/azure/ai-services/translator/translator-overview) for machine text translation
 
-Exceptions to billing through the multi-service resource include [AzureOpenAIEmbedding](cognitive-search-skill-azure-openai-embedding.md) or the [AML skill](cognitive-search-aml-skill.md) billing. Azure AI Search doesn't internally host models from Azure OpenAI or the Azure AI Foundry model catalog. Usage for AML and Azure OpenAI skills and vectorizers are through [Azure OpenAI Standard pricing](https://azure.microsoft.com/pricing/details/cognitive-services/openai-service/#pricing) and [Azure Machine Learning Standard pricing](https://azure.microsoft.com/pricing/details/machine-learning/), respectively. A few other skills, such as Text Split and Text Merge, aren't billable.
+Exceptions to billing through the multi-service resource include the [AzureOpenAIEmbedding skill](cognitive-search-skill-azure-openai-embedding.md), [GenAI Prompt skill](cognitive-search-skill-genai-prompt.md), and [AML skill](cognitive-search-aml-skill.md) billing. Azure AI Search doesn't internally host models from Azure OpenAI or the Azure AI Foundry model catalog. Usage for AML and Azure OpenAI skills and vectorizers are through [Azure OpenAI Standard pricing](https://azure.microsoft.com/pricing/details/cognitive-services/openai-service/#pricing) and [Azure Machine Learning Standard pricing](https://azure.microsoft.com/pricing/details/machine-learning/), respectively. A few other skills, such as Text Split and Text Merge, aren't billable.
 
 To attach an Azure AI multi-service resource, you must provide connection information in the skillset. You can use a key on the connection, or implement a keyless approach that's currently in preview.
 
@@ -35,8 +35,13 @@ To attach an Azure AI multi-service resource, you must provide connection inform
 
 ## Prerequisites
 
-+ Connectivity over a public endpoint, unless your search service meets the creation date, tier, and region requirements for private connections to an Azure AI services multi-service resource.
-+ [Azure AI multi-service resource](/azure/ai-services/multi-service-resource) created via the [Azure portal](https://portal.azure.com) only.
++ Connectivity over a public endpoint, unless your search service meets the creation date, tier, and region requirements for [private connections](search-indexer-howto-access-private.md) to an Azure AI services multi-service resource.
+
++ [Azure AI multi-service resource](/azure/ai-services/multi-services-resource-search-skills) created via the [Azure portal](https://portal.azure.com) only.
+
+  Your multi-service resource should have API kind set to `CognitiveServices`. You can view this property in the Azure portal page for your multi-service account:
+
+  :::image type="content" source="media/cognitive-search-attach-cognitive-services/cognitive-services-kind.png" alt-text="Screenshot of the API kind property in the Azure portal." border="true":::
 
 > [!NOTE]
 > If your Azure AI resource is configured to use a private endpoint, Azure AI Search can connect [using a shared private link](search-indexer-howto-access-private.md) For more information, see the [requirements and limits for using shared private links](search-limits-quotas-capacity.md#shared-private-link-resource-limits).
@@ -68,7 +73,7 @@ As with keys, the details you provide about the Azure AI Services resource are u
 Identity is set to null.
 
 ```http
-POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  
+POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2025-09-01  
 
 {  
     "name": "my skillset name",  
@@ -92,7 +97,7 @@ Identity is set to the resource ID of the user-assigned managed identity. To fin
 For a user-assigned managed identity, set the `@odata.type` and the `userAssignedIdentity` properties.
 
 ```http
-POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  
+POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2025-09-01 
 
 {  
     "name": "my skillset name",