Skip to content

Commit f4fba1f

Browse files
authored
Merge branch 'MicrosoftDocs:main' into main
2 parents 81b9b2b + 9b3c38e commit f4fba1f

8 files changed

+69
-65
lines changed

articles/ai-services/speech-service/includes/intent-recognition-retire.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@ author: goergenj
33
manager: nitinme
44
ms.service: azure-ai-speech
55
ms.topic: include
6-
ms.date: 07/09/2025
6+
ms.date: 10/06/2025
77
ms.author: jagoerge
88
---
99

1010
> [!IMPORTANT]
11-
> Intent recognition in Azure AI Speech is being retired on September 30, 2025. Your applications won't be able to use intent recognition directly via Azure AI Speech after this date. However, you're still able to perform intent recognition using Azure AI Language Service or Azure OpenAI.
11+
> Intent recognition in Azure AI Speech was retired on September 30, 2025. Applications can no longer use intent recognition via Azure AI Speech. However, you're still able to perform intent recognition using Azure AI Language Service or Azure OpenAI.
1212
>
1313
> This change doesn't affect other Azure AI Speech capabilities such as [speech to text](../speech-to-text.md) (including no change to speaker diarization), [text to speech](../text-to-speech.md), and [speech translation](../speech-translation.md).

articles/ai-services/speech-service/includes/retire-speaker-recognition.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,6 @@ ms.author: pafarley
88
---
99

1010
> [!IMPORTANT]
11-
> Speaker recognition in Azure AI Speech will be retired on September 30th 2025. Your applications won't be able to use speaker recognition after this date.
11+
> Speaker recognition in Azure AI Speech was retired on September 30th, 2025. Applications can no longer use the speaker recognition APIs.
1212
>
13-
> This change doesn't affect other Azure AI Speech capabilities such as [speech to text](../speech-to-text.md) (including no change to speaker diarization), [text to speech](../text-to-speech.md), and [speech translation](../speech-translation.md).
13+
> This change doesn't affect other Azure AI Speech capabilities such as [speech to text](../speech-to-text.md) (including no change to speaker diarization), [text to speech](../text-to-speech.md), and [speech translation](../speech-translation.md).

articles/search/cognitive-search-concept-intro.md

Lines changed: 30 additions & 28 deletions
Large diffs are not rendered by default.

articles/search/cognitive-search-predefined-skills.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -10,27 +10,27 @@ ms.custom:
1010
- build-2024
1111
- ignite-2024
1212
ms.topic: concept-article
13-
ms.date: 03/11/2025
13+
ms.date: 10/06/2025
1414
ms.update-cycle: 365-days
1515
---
1616

1717
# Skills for extra processing during indexing (Azure AI Search)
1818

19-
This article describes the skills in Azure AI Search that you can include in a [skillset](cognitive-search-working-with-skillsets.md) to access external processing.
19+
This article describes the skills in Azure AI Search that you can include in a [skillset](cognitive-search-working-with-skillsets.md) to access external processing.
2020

21-
A *skill* is an atomic operation that transforms content in some way. Often, it's an operation that recognizes or extracts text, but it can also be a utility skill that reshapes the enrichments that are already created. Typically, the output is either text-based so that it can be used in [full text search](search-lucene-query-architecture.md), or vectors used in [vector search](vector-search-overview.md).
21+
A *skill* is an atomic operation that transforms content in some way. Often, it's an operation that recognizes or extracts text, but it can also be a utility skill that reshapes existing enrichments. The output is usually text-based for use in [full-text search](search-lucene-query-architecture.md) or vectors for use in [vector search](vector-search-overview.md).
2222

23-
Skills are organized into categories:
23+
Skills are organized into the following categories:
2424

25-
* A *built-in skill* wraps API calls to an Azure AI resource, where the inputs, outputs, and processing steps are well understood. For skills that call an Azure AI resource, the connection is made over the internal network. For skills that call Azure OpenAI, you provide the connection information that the search service uses to connect to the resource. A small quantity of processing is non-billable, but at larger volumes, processing is billable. Built-in skills are based on pretrained models from Microsoft, which means you can't train the model using your own training data.
25+
* A *built-in skill* wraps API calls to an Azure AI resource, where the inputs, outputs, and processing steps are well understood. For skills that call an Azure AI resource, the connection is made over the internal network. For skills that call Azure OpenAI, you provide the connection information that the search service uses to connect to the resource. A small quantity of processing is nonbillable, but at larger volumes, processing is billable. Built-in skills are based on pretrained models from Microsoft, which means you can't train the model using your own training data.
2626

2727
* A *custom skill* provides custom code that executes externally to the search service. It's accessed through a URI. Custom code is often made available through an Azure function app. To attach an open-source or third-party vectorization model, use a custom skill.
2828

29-
* A *utility* is internal to Azure AI Search, with no dependency on external resources or outbound connections. Most utilities are non-billable.
29+
* A *utility* is internal to Azure AI Search, with no dependency on external resources or outbound connections. Most utilities are nonbillable.
3030

3131
## Azure AI resource skills
3232

33-
Skills that call the Azure AI are billed at the Standard rate when you [attach an AI service resource](cognitive-search-attach-cognitive-services.md).
33+
Skills that call Azure AI are billed at the Standard rate when you [attach an Azure AI services multi-service resource](cognitive-search-attach-cognitive-services.md).
3434

3535
| OData type | Description | Metered by |
3636
|-------|-------------|-------------|
@@ -55,18 +55,6 @@ Skills that call models deployed on Azure OpenAI are billed at the Standard rate
5555
|-------|-------------|-------------|
5656
|[Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill](cognitive-search-skill-azure-openai-embedding.md) | Connects to a deployed embedding model on Azure OpenAI for integrated vectorization. | Azure OpenAI ([pricing](https://azure.microsoft.com/pricing/details/cognitive-services/openai-service/#pricing)) |
5757

58-
## Utility skills
59-
60-
Skills that execute only on Azure AI Search, iterate mostly on nodes in the enrichment cache, and are mostly non-billable.
61-
62-
| OData type | Description | Metered by |
63-
|-------|-------------|-------------|
64-
| [Microsoft.Skills.Util.ConditionalSkill](cognitive-search-skill-conditional.md) | Allows filtering, assigning a default value, and merging data based on a condition. | Not applicable |
65-
| [Microsoft.Skills.Util.DocumentExtractionSkill](cognitive-search-skill-document-extraction.md) | Extracts content from a file within the enrichment pipeline. | Azure AI Search ([pricing](https://azure.microsoft.com/pricing/details/search/)) for image extraction. |
66-
| [Microsoft.Skills.Text.MergeSkill](cognitive-search-skill-textmerger.md) | Consolidates text from a collection of fields into a single field. | Not applicable |
67-
| [Microsoft.Skills.Util.ShaperSkill](cognitive-search-skill-shaper.md) | Maps output to a complex type (a multi-part data type, which might be used for a full name, a multi-line address, or a combination of last name and a personal identifier.) | Not applicable |
68-
| [Microsoft.Skills.Text.SplitSkill](cognitive-search-skill-textsplit.md) | Splits text into pages so that you can enrich or augment content incrementally. | Not applicable |
69-
7058
## Custom skills
7159

7260
[Custom skills](cognitive-search-custom-skill-web-api.md) wrap external code that you design, develop, and deploy to the web. You can then call the module from within a skillset as a custom skill.
@@ -78,8 +66,20 @@ Skills that execute only on Azure AI Search, iterate mostly on nodes in the enri
7866

7967
For guidance on creating a custom skill, see [Define a custom interface](cognitive-search-custom-skill-interface.md) and [Example: Creating a custom skill for AI enrichment](cognitive-search-create-custom-skill-example.md).
8068

81-
## See also
69+
## Utility skills
70+
71+
Skills that execute only on Azure AI Search, iterate mostly on nodes in the enrichment cache, and are mostly nonbillable.
72+
73+
| OData type | Description | Metered by |
74+
|-------|-------------|-------------|
75+
| [Microsoft.Skills.Util.ConditionalSkill](cognitive-search-skill-conditional.md) | Allows filtering, assigning a default value, and merging data based on a condition. | Not applicable |
76+
| [Microsoft.Skills.Util.DocumentExtractionSkill](cognitive-search-skill-document-extraction.md) | Extracts content from a file within the enrichment pipeline. | Azure AI Search ([pricing](https://azure.microsoft.com/pricing/details/search/)) for image extraction. |
77+
| [Microsoft.Skills.Text.MergeSkill](cognitive-search-skill-textmerger.md) | Consolidates text from a collection of fields into a single field. | Not applicable |
78+
| [Microsoft.Skills.Util.ShaperSkill](cognitive-search-skill-shaper.md) | Maps output to a complex type (a multi-part data type, which might be used for a full name, a multi-line address, or a combination of last name and a personal identifier.) | Not applicable |
79+
| [Microsoft.Skills.Text.SplitSkill](cognitive-search-skill-textsplit.md) | Splits text into pages so that you can enrich or augment content incrementally. | Not applicable |
80+
81+
## Related content
8282

83-
+ [How to define a skillset](cognitive-search-defining-skillset.md)
84-
+ [Custom Skills interface definition](cognitive-search-custom-skill-interface.md)
83+
+ [Create a skillset](cognitive-search-defining-skillset.md)
84+
+ [Add a custom skill to an AI enrichment pipeline](cognitive-search-custom-skill-interface.md)
8585
+ [Tutorial: Enriched indexing with AI](tutorial-skillset.md)

articles/search/cognitive-search-skill-azure-openai-embedding.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.custom:
99
- ignite-2023
1010
- build-2024
1111
ms.topic: reference
12-
ms.date: 09/26/2025
12+
ms.date: 10/06/2025
1313
---
1414

1515
# Azure OpenAI Embedding skill
@@ -45,7 +45,7 @@ Parameters are case-sensitive.
4545

4646
| Inputs | Description |
4747
|---------------------|-------------|
48-
| `resourceUri` | Required. The URI of the model provider. This parameter only supports URLs with the `openai.azure.com` domain, such as `https://<resourcename>.openai.azure.com`. If your Azure OpenAI endpoint has a URL with the `cognitiveservices.azure.com` domain, such as `https://<resourcename>.cognitiveservices.azure.com`, you must create a [custom subdomain](/azure/ai-services/openai/how-to/use-your-data-securely#enabled-custom-subdomain) with `openai.azure.com` for the Azure OpenAI resource and use `https://<resourcename>.openai.azure.com` instead. This field is required if your Azure OpenAI resource is deployed behind a private endpoint or uses Virtual Network (VNet) integration. [Azure API Management](/azure/api-management/api-management-key-concepts) endpoints are supported with URL `https://<resourcename>.azure-api.net `. Shared private links aren't supported for API Management endpoints.
48+
| `resourceUri` | Required. The URI of the model provider. This parameter only supports URLs with the `openai.azure.com` domain, such as `https://<resourcename>.openai.azure.com`. This field is required if your Azure OpenAI resource is deployed behind a private endpoint or uses Virtual Network (VNet) integration. [Azure API Management](/azure/api-management/api-management-key-concepts) endpoints are supported with URL `https://<resourcename>.azure-api.net`. Shared private links aren't supported for API Management endpoints. |
4949
| `apiKey` | The secret key used to access the model. If you provide a key, leave `authIdentity` empty. If you set both the `apiKey` and `authIdentity`, the `apiKey` is used on the connection. |
5050
| `deploymentId` | Required. The name of the deployed Azure OpenAI embedding model. The model should be an embedding model, such as text-embedding-ada-002. See the [List of Azure OpenAI models](/azure/ai-services/openai/concepts/models) for supported models.|
5151
| `authIdentity` | A user-managed identity used by the search service for connecting to Azure OpenAI. You can use either a [system or user managed identity](search-how-to-managed-identities.md). To use a system managed identity, leave `apiKey` and `authIdentity` blank. The system-managed identity is used automatically. A managed identity must have [Cognitive Services OpenAI User](/azure/ai-services/openai/how-to/role-based-access-control#azure-openai-roles) permissions to send text to Azure OpenAI. |

articles/search/search-lucene-query-architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.date: 03/07/2025
1313
ms.update-cycle: 365-days
1414
---
1515

16-
# Full text search in Azure AI Search
16+
# Full-text search in Azure AI Search
1717

1818
Full text search is an approach in information retrieval that matches on plain text stored in an index. For example, given a query string "hotels in San Diego on the beach", the search engine looks for tokenized strings based on those terms. To make scans more efficient, query strings undergo lexical analysis: lower-casing all terms, removing stop words like "the", and reducing terms to primitive root forms. When matching terms are found, the search engine retrieves documents, ranks them in order of relevance, and returns the top results.
1919

articles/search/search-region-support.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: Supported Regions
33
titleSuffix: Azure AI Search
4-
description: Shows supported regions and feature availability across regions for Azure AI Search.
4+
description: Learn about the regions that offer Azure AI Search and the features available in each region.
55
author: haileytap
66
ms.author: haileytapia
77
manager: nitinme
8-
ms.date: 09/25/2025
8+
ms.date: 10/06/2025
99
ms.service: azure-ai-search
1010
ms.topic: conceptual
1111
ms.custom:
@@ -121,16 +121,18 @@ You can create an Azure AI Search service in any of the following Azure public r
121121

122122
## Azure operated by 21Vianet
123123

124-
| Region | AI enrichment | Availability zones | Agentic retrieval | Confidential computing | Semantic ranker | Query rewrite |
124+
| Region | AI enrichment <sup>1</sup> | Availability zones | Agentic retrieval | Confidential computing | Semantic ranker | Query rewrite |
125125
|--|--|--|--|--|--|--|
126126
| China East | | | | | | |
127-
| China East 2 <sup>1</sup> || | | | | |
127+
| China East 2 <sup>2</sup> || | | | | |
128128
| China East 3 | | | | | | |
129129
| China North | | | | | | |
130-
| China North 2 <sup>1</sup> | | | | | | |
130+
| China North 2 <sup>2</sup> | | | | | | |
131131
| China North 3 | ||| |||
132132

133-
<sup>1</sup> [Higher storage limits](search-limits-quotas-capacity.md#service-limits) aren't available in this region. If you want higher limits, choose a different region.
133+
<sup>1</sup> Only China East 2 fully supports AI enrichment. In other 21Vianet regions, you can use skillsets with the [Azure OpenAI Embedding skill](cognitive-search-skill-azure-openai-embedding.md) for integrated vectorization, which depends on the availability of Azure OpenAI and Azure AI Search in your region. Otherwise, AI enrichment isn't supported.
134+
135+
<sup>2</sup> [Higher storage limits](search-limits-quotas-capacity.md#service-limits) aren't available in this region. If you want higher limits, choose a different region.
134136

135137
## Related content
136138

articles/search/vector-search-vectorizer-azure-open-ai.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.service: azure-ai-search
88
ms.custom:
99
- build-2024
1010
ms.topic: reference
11-
ms.date: 09/26/2025
11+
ms.date: 10/06/2025
1212
ms.update-cycle: 365-days
1313
---
1414

@@ -39,7 +39,7 @@ Parameters are case-sensitive.
3939

4040
| Parameter name | Description |
4141
|--------------------|-------------|
42-
| `resourceUri` | The URI of the model provider. This parameter only supports URLs with the `openai.azure.com` domain, such as `https://<resourcename>.openai.azure.com`. If your Azure OpenAI endpoint has a URL with the `cognitiveservices.azure.com` domain, such as `https://<resourcename>.cognitiveservices.azure.com`, you must create a [custom subdomain](/azure/ai-services/openai/how-to/use-your-data-securely#enabled-custom-subdomain) with `openai.azure.com` for the Azure OpenAI resource and use `https://<resourcename>.openai.azure.com` instead. [Azure API Management](/azure/api-management/api-management-key-concepts) endpoints are supported with URL `https://<resourcename>.azure-api.net `. Shared private links aren't supported for API Management endpoints. |
42+
| `resourceUri` | The URI of the model provider. This parameter only supports URLs with the `openai.azure.com` domain, such as `https://<resourcename>.openai.azure.com`. [Azure API Management](/azure/api-management/api-management-key-concepts) endpoints are supported with URL `https://<resourcename>.azure-api.net`. Shared private links aren't supported for API Management endpoints. |
4343
| `apiKey` | The secret key used to access the model. If you provide a key, leave `authIdentity` empty. If you set both the `apiKey` and `authIdentity`, the `apiKey` is used on the connection. |
4444
| `deploymentId` | The name of the deployed Azure OpenAI embedding model. The model should be an embedding model, such as text-embedding-ada-002. See the [List of Azure OpenAI models](/azure/ai-services/openai/concepts/models) for supported models.|
4545
| `authIdentity` | A user-managed identity used by the search service for connecting to Azure OpenAI. You can use either a [system or user managed identity](search-how-to-managed-identities.md). To use a system managed identity, leave `apiKey` and `authIdentity` blank. The system-managed identity is used automatically. A managed identity must have [Cognitive Services OpenAI User](/azure/ai-services/openai/how-to/role-based-access-control#azure-openai-roles) permissions to send text to Azure OpenAI. |

0 commit comments

Comments
 (0)