[py sdk - Conv Authoring] a new release to add GA compatibility (#44323)

* Configurations:  'specification/cognitiveservices/data-plane/LanguageAnalyzeConversationsAuthoring/tspconfig.yaml', API Version: 2025-11-15-preview, SDK Release Type: beta, and CommitSHA: '2fc7fcc9a50bcea5b3dd9307b80f09c440e385bb' in SpecRepo: 'https://github.com/Azure/azure-rest-api-specs' Pipeline run: https://dev.azure.com/azure-sdk/internal/_build/results?buildId=5648533 Refer to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release/sdk-release-prerequisites to prepare for SDK release.

* add first version patch

* add some patch files

* added compatibility and tests for it

* adjust samples

* updated readme versions

* updated changelog

* updated tag in assets.json

* fixed pylint

* update docstring

* fix docstring

---------

Co-authored-by: azure-sdk <[email protected]>

Author: amber-Chen-86

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release History
 
+## 1.0.0b3 (2025-12-09)
+
+### Features Added
+- Added support for service version 2025-11-01.
+
+### Other Changes
+- Updated deployment samples (sync and async) to demonstrate usage with both 2025-11-01 (GA) and 2025-11-15-preview service versions.
+
 ## 1.0.0b2 (2025-11-14)
 
 ### Features Added

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/README.md

@@ -36,6 +36,14 @@ pip install azure-ai-language-conversations-authoring
 
 > Note: This version of the client library defaults to the 2025-11-15-preview version of the service
 
+This table shows the relationship between SDK versions and supported API versions of the service
+
+| SDK version  | Supported API version of service  |
+| ------------ | --------------------------------- |
+| 1.0.0b3 - Latest preview release | 2023-04-01, 2025-11-01, 2025-05-15-preview, 2025-11-15-preview (default) |
+| 1.0.0b2 | 2023-04-01, 2025-05-15-preview, 2025-11-15-preview (default) |
+| 1.0.0b1 | 2023-04-01, 2024-11-15-preview, 2025-05-15-preview (default) |
+
 ### Authenticate the client
 
 To interact with the Conversation Authoring service, you'll need to create an instance of the `ConversationAuthoringClient`. You will need an **endpoint** and an **API key** to instantiate a client object. For more information regarding authenticating with Cognitive Services, see [Authenticate requests to Azure Cognitive Services][cognitive_auth].

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/apiview-properties.json

@@ -20,7 +20,6 @@
         "azure.ai.language.conversations.authoring.models.DataGenerationConnectionInfo": "Language.Conversations.Authoring.AnalyzeConversationAuthoringDataGenerationConnectionInfo",
         "azure.ai.language.conversations.authoring.models.DataGenerationSettings": "Language.Conversations.Authoring.AnalyzeConversationAuthoringDataGenerationSettings",
         "azure.ai.language.conversations.authoring.models.DeploymentDeleteFromResourcesState": "Language.Conversations.Authoring.AnalyzeConversationAuthoringDeploymentDeleteFromResourcesJobState",
-        "azure.ai.language.conversations.authoring.models.DeploymentResource": "Language.Conversations.Authoring.AnalyzeConversationAuthoringDeploymentResource",
         "azure.ai.language.conversations.authoring.models.DeploymentState": "Language.Conversations.Authoring.AnalyzeConversationAuthoringDeploymentJobState",
         "azure.ai.language.conversations.authoring.models.EntitiesEvaluationSummary": "Language.Conversations.Authoring.AnalyzeConversationAuthoringEntitiesEvaluationSummary",
         "azure.ai.language.conversations.authoring.models.EntityEvaluationSummary": "Language.Conversations.Authoring.AnalyzeConversationAuthoringEntityEvaluationSummary",
@@ -99,12 +98,6 @@
         "azure.ai.language.conversations.authoring.aio.ConversationAuthoringClient.create_project": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringClient.createProject",
         "azure.ai.language.conversations.authoring.ConversationAuthoringClient.get_project": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringClient.getProject",
         "azure.ai.language.conversations.authoring.aio.ConversationAuthoringClient.get_project": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringClient.getProject",
-        "azure.ai.language.conversations.authoring.ConversationAuthoringClient.begin_delete_project": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringClient.deleteProject",
-        "azure.ai.language.conversations.authoring.aio.ConversationAuthoringClient.begin_delete_project": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringClient.deleteProject",
-        "azure.ai.language.conversations.authoring.ConversationAuthoringClient.get_export_status": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringClient.getExportStatus",
-        "azure.ai.language.conversations.authoring.aio.ConversationAuthoringClient.get_export_status": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringClient.getExportStatus",
-        "azure.ai.language.conversations.authoring.ConversationAuthoringClient.get_import_status": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringClient.getImportStatus",
-        "azure.ai.language.conversations.authoring.aio.ConversationAuthoringClient.get_import_status": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringClient.getImportStatus",
         "azure.ai.language.conversations.authoring.operations.DeploymentOperations.get_deployment": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringProjectClient.DeploymentOperations.getDeployment",
         "azure.ai.language.conversations.authoring.aio.operations.DeploymentOperations.get_deployment": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringProjectClient.DeploymentOperations.getDeployment",
         "azure.ai.language.conversations.authoring.operations.DeploymentOperations.begin_deploy_project": "Language.ConversationsAuthoringClientCustomizations.ConversationAuthoringProjectClient.DeploymentOperations.deployProject",

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "python",
   "TagPrefix": "python/cognitivelanguage/azure-ai-language-conversations-authoring",
-  "Tag": "python/cognitivelanguage/azure-ai-language-conversations-authoring_20102747af"
+  "Tag": "python/cognitivelanguage/azure-ai-language-conversations-authoring_94c35e32fe"
 }

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/azure/ai/language/conversations/authoring/_client.py

@@ -43,8 +43,6 @@ class ConversationAuthoringClient(_ConversationAuthoringClientOperationsMixin):
      "2025-11-15-preview". Note that overriding this default value may result in unsupported
      behavior.
     :paramtype api_version: str
-    :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
-     Retry-After header is present.
     """
 
     def __init__(self, endpoint: str, credential: Union[AzureKeyCredential, "TokenCredential"], **kwargs: Any) -> None:

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/azure/ai/language/conversations/authoring/_patch.py

@@ -84,6 +84,7 @@ def get_project_client(self, project_name: str) -> ConversationAuthoringProjectC
             endpoint=self._config.endpoint,
             credential=self._config.credential,
             project_name=project_name,
+            api_version=self._config.api_version,
         )
 
 

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/azure/ai/language/conversations/authoring/_version.py

@@ -6,4 +6,4 @@
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
-VERSION = "1.0.0b2"
+VERSION = "1.0.0b3"

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/azure/ai/language/conversations/authoring/aio/_client.py

@@ -43,8 +43,6 @@ class ConversationAuthoringClient(_ConversationAuthoringClientOperationsMixin):
      "2025-11-15-preview". Note that overriding this default value may result in unsupported
      behavior.
     :paramtype api_version: str
-    :keyword int polling_interval: Default waiting time between two polls for LRO operations if no
-     Retry-After header is present.
     """
 
     def __init__(

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/azure/ai/language/conversations/authoring/aio/_patch.py

@@ -84,6 +84,7 @@ def get_project_client(self, project_name: str) -> ConversationAuthoringProjectC
             endpoint=self._config.endpoint,
             credential=self._config.credential,
             project_name=project_name,
+            api_version=self._config.api_version,
         )
 
 

sdk/cognitivelanguage/azure-ai-language-conversations-authoring/azure/ai/language/conversations/authoring/aio/operations/_deployment_op_patch.py

@@ -0,0 +1,88 @@
+# pylint: disable=line-too-long,useless-suppression
+# coding=utf-8
+# --------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------
+"""Customize generated code here.
+Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize
+"""
+
+from typing import Any, Optional, Union
+
+from azure.core.polling import AsyncLROPoller
+from azure.core.tracing.decorator import distributed_trace
+
+from ._operations import DeploymentOperations as _GeneratedDeploymentOperations, JSON
+from ...models import CreateDeploymentDetails
+
+
+class DeploymentOperations(_GeneratedDeploymentOperations):
+    """Deployment operations that handle both:
+    - 2025-11-15-preview: azureResourceIds = List[AssignedProjectResource]
+    - 2025-11-01:        azureResourceIds = List[str]
+    """
+
+    @distributed_trace
+    async def begin_deploy_project(  # type: ignore[override]
+        self,
+        deployment_name: str,
+        body: Union[CreateDeploymentDetails, JSON, Any],
+        **kwargs: Any,
+    ) -> AsyncLROPoller[None]:
+        api_version: Optional[str] = getattr(self._config, "api_version", None)
+
+        if not isinstance(body, CreateDeploymentDetails):
+            return await super().begin_deploy_project(
+                deployment_name=deployment_name,
+                body=body,
+                **kwargs,
+            )
+
+        # If no api_version or preview → use preview shape
+        if api_version in (None, "2025-11-15-preview"):
+            # For preview, we require assigned resources, because region is needed.
+            if body.azure_resource_ids is None:
+                # user tried to use GA-style strings but preview needs region
+                if getattr(body, "_azure_resource_ids_strings", None):
+                    raise ValueError(
+                        "For api_version '2025-11-15-preview', azure_resource_ids must "
+                        "be a list of AssignedProjectResource (with region), not plain strings."
+                    )
+            # Just send the model as-is
+            return await super().begin_deploy_project(
+                deployment_name=deployment_name,
+                body=body,
+                **kwargs,
+            )
+
+        # GA 2025-11-01 → azureResourceIds is List[str]
+        if api_version == "2025-11-01":
+            trained_model_label = body.trained_model_label
+
+            # Prefer GA-style strings if user gave them
+            str_ids = getattr(body, "_azure_resource_ids_strings", None)
+            if str_ids is not None:
+                azure_ids = str_ids
+            else:
+                # Otherwise derive from AssignedProjectResource list
+                azure_ids = None
+                if body.azure_resource_ids is not None:
+                    azure_ids = [r.resource_id for r in body.azure_resource_ids]
+
+            json_body: JSON = {"trainedModelLabel": trained_model_label}
+            if azure_ids is not None:
+                json_body["azureResourceIds"] = azure_ids
+
+            return await super().begin_deploy_project(
+                deployment_name=deployment_name,
+                body=json_body,  # GA wire
+                **kwargs,
+            )
+
+        # Any other version: fall back to default behavior
+        return await super().begin_deploy_project(
+            deployment_name=deployment_name,
+            body=body,
+            **kwargs,
+        )