Moving Intent Recognition to Retirement section

Author: goergenj

articles/ai-services/speech-service/get-started-intent-recognition-clu.md

@@ -13,6 +13,8 @@ zone_pivot_groups: programming-languages-set-thirteen
 keywords: intent recognition
 ---
 
+[!INCLUDE [deprecation notice](./includes/intent-recognition-retire.md)]
+
 # Quickstart: Recognize intents with Conversational Language Understanding
 
 ::: zone pivot="programming-language-csharp"

articles/ai-services/speech-service/get-started-intent-recognition.md

@@ -13,6 +13,8 @@ zone_pivot_groups: programming-languages-speech-services
 keywords: intent recognition
 ---
 
+[!INCLUDE [deprecation notice](./includes/intent-recognition-retire.md)]
+
 # Quickstart: Recognize intents with the Speech service and LUIS
 
 > [!IMPORTANT]

articles/ai-services/speech-service/how-to-use-custom-entity-pattern-matching.md

@@ -14,6 +14,8 @@ ms.custom: devx-track-cpp, devx-track-csharp, mode-other, devx-track-extended-ja
 #Customer intent: As a developer, I want to learn how to recognize intents and custom entities from simple patterns so that I can derive user intent from speech utterances.
 ---
 
+[!INCLUDE [deprecation notice](./includes/intent-recognition-retire.md)]
+
 # How to recognize intents with custom entity pattern matching
 
 The Azure AI services [Speech SDK](speech-sdk.md) has a built-in feature to provide **intent recognition** with **simple language pattern matching**. An intent is something the user wants to do: close a window, mark a checkbox, insert some text, etc.

articles/ai-services/speech-service/how-to-use-simple-language-pattern-matching.md

@@ -14,6 +14,8 @@ ms.custom: devx-track-cpp, devx-track-csharp, mode-other, devx-track-extended-ja
 #Customer intent: As a developer, I want to learn how to recognize intents and entities from simple patterns so that I can understand what the user wants to do.
 ---
 
+[!INCLUDE [deprecation notice](./includes/intent-recognition-retire.md)]
+
 # How to recognize intents with simple language pattern matching
 
 The Azure AI services [Speech SDK](speech-sdk.md) has a built-in feature to provide **intent recognition** with **simple language pattern matching**. An intent is something the user wants to do: close a window, mark a checkbox, insert some text, etc.

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

@@ -0,0 +1,13 @@
+---
+author: eric-urban
+manager: nitinme
+ms.service: azure-ai-speech
+ms.topic: include
+ms.date: 03/08/2023
+ms.author: eur
+---
+
+> [!IMPORTANT]
+> Intent recognition in Azure AI Speech will be retired on September 30th 2025. Your applications won't be able to use intent recognition directly via Azure AI Speech after this date. However, you will still be able to perform intent recognition using Azure AI Language Service or Azure OpenAI.
+> 
+> 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/intent-recognition.md

@@ -13,6 +13,8 @@ ms.date: 3/10/2025
 
 # What is intent recognition?
 
+[!INCLUDE [deprecation notice](./includes/intent-recognition-retire.md)]
+
 In this overview, you learn about the benefits and capabilities of intent recognition. An intent is something the user wants to do: book a flight, check the weather, or make a call. With intent recognition, your applications, tools, and devices can determine what the user wants to initiate or do based on options. You define user intent in the intent recognizer or conversational language understanding (CLU) model.
 
 ## Pattern matching

articles/ai-services/speech-service/pattern-matching-overview.md

@@ -13,6 +13,8 @@ keywords: intent recognition pattern matching
 #Customer intent: I want to understand what pattern matching is and how to use it.
 ---
 
+[!INCLUDE [deprecation notice](./includes/intent-recognition-retire.md)]
+
 # What is pattern matching?
 
 Pattern matching can be customized to group together pattern intents and entities inside a ``PatternMatchingModel``. Using this grouping, it's possible to access more advanced entity types that help make your intent recognition more precise.

articles/ai-services/speech-service/toc.yml

@@ -244,20 +244,6 @@ items:
       href: voice-live-how-to.md
     - name: Audio events reference
       href: /azure/ai-services/openai/realtime-audio-reference?context=/azure/ai-services/speech-service/context/context
-- name: Intent recognition
-  items:
-    - name: Intent recognition overview
-      href: intent-recognition.md
-    - name: Pattern matching concepts
-      href: pattern-matching-overview.md
-    - name: Intent recognition with simple pattern matching quickstart
-      href: how-to-use-simple-language-pattern-matching.md
-    - name: Intent recognition with custom entity pattern matching
-      href: how-to-use-custom-entity-pattern-matching.md
-    - name: Intent recognition with CLU quickstart
-      href: get-started-intent-recognition-clu.md
-    - name: Recognize speech intents with LUIS (deprecated)
-      href: get-started-intent-recognition.md
 - name: Keyword recognition
   items:
     - name: Keyword recognition overview
@@ -503,6 +489,21 @@ items:
       - name: Speaker recognition
         href: speaker-recognition-overview.md
         displayName: migrate,migration,deprecate,retire,sunset
+      - name: Intent recognition
+        displayName: migrate,migration,deprecate,retire,sunset
+        items:
+          - name: Intent recognition overview
+            href: intent-recognition.md
+          - name: Pattern matching concepts
+            href: pattern-matching-overview.md
+          - name: Intent recognition with simple pattern matching quickstart
+            href: how-to-use-simple-language-pattern-matching.md
+          - name: Intent recognition with custom entity pattern matching
+            href: how-to-use-custom-entity-pattern-matching.md
+          - name: Intent recognition with CLU quickstart
+            href: get-started-intent-recognition-clu.md
+          - name: Recognize speech intents with LUIS (deprecated)
+            href: get-started-intent-recognition.md
       - name: Custom commands
         href: custom-commands.md
         displayName: migrate,migration,deprecate,retire,sunset