[Conv Authoring] Create dotnet sdk preview 20250515 (Azure#51142)

* generate the first version of 2025-05-15-preview sdk

* update commit id in tsp-location.yaml

* updated some tests for 2025-05-15-preview

* add tests for Train_withDataGenerationSettings

* update the tests for importProject

* added the tests for training with data generation

* added tests for deployProjectWithAssignedResrouce and importProjectWithAssignedResources

* updated the tests.

* udpate samples for training with data generation

* adjust the DeployProject_WithAssignedResources, and successfully record it.

* add GetDeploymentAsync and GetDeployment tests and samples

* updated {endpoint} and {api-key} in snippets

* updated the live test GetDeploymentAsync

* add tests and samples for deployProject_with_assignResources

* add tests and samples for import_withAssetsMetaData

* updated test records

* record tests for getModelEvaluationResultAsync

* run `Export API`

* use the latest commit id

* added 1.0.0-beta.2 in readme

* add the tests for assigndeploymentResources and getAssignstatus

* add test samples for unassignDeploymentResource and getUnassignDeploymentResourceStatus

* remove options from clients for unassignDeploymentResources

* added samples for UnassignDeploymentResources and updated snippets

* add samples for AssingDeploymentResourceAsync and getStatus, and removed the record tests

* trigger CI

* add tests and samples for assign/unassignDeployments and getAssign/UnassignStatus

* updated samples and links in main readme file

* udpate samples and links in samples readme file

* update change log

* generate the sdk with importRawJson

* customize importRawJson funciton and add the record tests

* customize the low-level importRawJsonAsync and importRawJson

* changed name "ImportRawJson" to "import"

* added samples and tests for importWithRawJson

* updated the snippets and export API

* add import raw json string to change log

* Run Export-API.ps1

* modify the release date in change log

* udpate import version to 2025-05-15-preview in samples

* updated the versions on readme

* update all smaple links from amber to main

* update exportedProjectFormat to projectFormat in import functions

* updated exportedProject to projectJson for importJson

* updated all the values to placeholder in samples

* update rigion to placeholder

* udpated the date on changelog

* update all sync and async sample into one file

* run Update-Snippets.ps1

* update key and AAD client for each sample

* run Export-API.ps1

* add using System.Threading.Tasks; to all samples

* add customized importRawJson feature

* run Export-API.ps1

---------

Co-authored-by: Xiong Chen <[email protected]>

Author: amber-Chen-86

sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/CHANGELOG.md

@@ -1,15 +1,28 @@
 # Release History
 
-## 1.0.0-beta.2 (Unreleased)
+## 1.0.0-beta.2 (2025-07-24)
 
 ### Features Added
 
-### Breaking Changes
-
-### Bugs Fixed
+- Added import feature for raw json string.
+- Added support for Conversations Authoring API Versions
+  - 2025-05-15-preview
+- Added `DataGenerationSettings` in `TrainingJobDetails` when training a model.
+  - Added corresponding test and sample.
+- Added `DataGenerationConnectionInfo` in `DeploymentResource` when deploying a model.
+  - Added corresponding test and sample.
+- Added `ExportedAssociatedEntityLabel` in `ConversationExportedIntent` when importing a project.
+  - Added corresponding test and sample.
 
 ### Other Changes
 
+- Added tests and samples for some legacy features.
+  - Get Deployment
+  - Assign Deployment Resources
+  - Get Assign Deployment Resources Status
+  - Unassign Deployment Resources
+  - Get Unassign Deployment Resources Status
+
 ## 1.0.0-beta.1 (2025-03-04)
 
 ### Other Changes

sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/README.md

@@ -3,14 +3,24 @@
 Azure Conversations Authoring is part of the Azure Cognitive Service for Language, a cloud-based service that provides tools for creating, managing, and deploying conversational AI solutions. This client library offers the following features:
 
 * Creating and managing conversation projects
-* Importing and exporting conversation projects
+* Importing conversation projects
+* Exporting conversation projects
+* Getting project details
+* Deleting projects
 * Training models for conversational AI
-* Evaluating trained models
-* Deploying conversational AI models
-* Swapping deployments for active models
 * Canceling active training jobs
+* Evaluating model summaries
+* Evaluating model results
 * Managing project snapshots
-* Deleting trained models and deployments
+* Loading snapshots
+* Deploying conversational AI models
+* Swapping deployments for active models
+* Deleting trained models
+* Deleting deployments
+* Assigning deployment resources
+* Getting deployment resource assignment status
+* Unassigning deployment resources
+* Getting deployment resource unassignment status
 
 [Source code][source_root] | [Package (NuGet)][package]| [API reference documentation][text_refdocs] | [Product documentation][text_docs] | [Samples][source_samples]
 
@@ -27,8 +37,9 @@ dotnet add package Azure.AI.Language.Conversations.Authoring --prerelease
 ```
 
 |SDK version  |Supported API version of service
-|-------------|-------------------------------------------------------------
-|1.0.0-beta.1 | 2022-05-01, 2023-04-01, 2023-11-15-preview, 2024-11-15-preview (default)
+|-------------|----------------------------------------------------------------------
+|1.0.0-beta.1 | 2023-04-01, 2023-04-15-preview, 2024-11-15-preview (default)
+|1.0.0-beta.2 | 2023-04-01, 2023-04-15-preview, 2024-11-15-preview, 2025-05-15-preview (default)
 
 ### Prerequisites
 
@@ -60,8 +71,8 @@ using Azure.AI.Language.Conversations.Authoring;
 With your endpoint and API key, you can instantiate a `ConversationAnalysisAuthoringClient` using specific service options:
 
 ```C# Snippet:CreateAuthoringClientForSpecificApiVersion
-Uri endpoint = new Uri("https://myaccount.cognitiveservices.azure.com");
-AzureKeyCredential credential = new("your apikey");
+Uri endpoint = new Uri("{endpoint}");
+AzureKeyCredential credential = new AzureKeyCredential("{api-key}");
 ConversationAnalysisAuthoringClientOptions options = new ConversationAnalysisAuthoringClientOptions(ConversationAnalysisAuthoringClientOptions.ServiceVersion.V2024_11_15_Preview);
 ConversationAnalysisAuthoringClient client = new ConversationAnalysisAuthoringClient(endpoint, credential, options);
 ```
@@ -86,7 +97,7 @@ using Azure.Core;
 Then you can create an instance of `DefaultAzureCredential` and pass it to a new instance of your client:
 
 ```C# Snippet:AnalyzeConversationAuthoring_CreateWithDefaultAzureCredential
-Uri endpoint = new Uri("https://myaccount.cognitiveservices.azure.com");
+Uri endpoint = new Uri("{endpoint}");
 DefaultAzureCredential credential = new DefaultAzureCredential();
 ConversationAnalysisAuthoringClient client = new ConversationAnalysisAuthoringClient(endpoint, credential);
 ```
@@ -104,8 +115,8 @@ You have the flexibility to explicitly select a supported service API version wh
 For example,
 
 ```C# Snippet:CreateAuthoringClientForSpecificApiVersion
-Uri endpoint = new Uri("https://myaccount.cognitiveservices.azure.com");
-AzureKeyCredential credential = new("your apikey");
+Uri endpoint = new Uri("{endpoint}");
+AzureKeyCredential credential = new AzureKeyCredential("{api-key}");
 ConversationAnalysisAuthoringClientOptions options = new ConversationAnalysisAuthoringClientOptions(ConversationAnalysisAuthoringClientOptions.ServiceVersion.V2024_11_15_Preview);
 ConversationAnalysisAuthoringClient client = new ConversationAnalysisAuthoringClient(endpoint, credential, options);
 ```
@@ -142,33 +153,23 @@ We guarantee that all client instance methods are thread-safe and independent of
 You can familiarize yourself with different APIs using [Samples](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples).
 
 * [Create a New Project (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample1_ConversationsAuthoring_CreateProject.md)
-* [Create a New Project (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample1_ConversationsAuthoring_CreateProjectAsync.md)
 * [Import a Project (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample2_ConversationsAuthoring_Import.md)
-* [Import a Project (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample2_ConversationsAuthoring_ImportAsync.md)
 * [Export a Project (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample3_ConversationsAuthoring_Export.md)
-* [Export a Project (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample3_ConversationsAuthoring_ExportAsync.md)
 * [Get Project Details (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample4_ConversationsAuthoring_GetProject.md)
-* [Get Project Details (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample4_ConversationsAuthoring_GetProjectAsync.md)
 * [Delete a Project (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample5_ConversationsAuthoring_DeleteProject.md)
-* [Delete a Project (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample5_ConversationsAuthoring_DeleteProjectAsync.md)
 * [Train a Model (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample6_ConversationsAuthoring_Train.md)
-* [Train a Model (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample6_ConversationsAuthoring_TrainAsync.md)
 * [Cancel Training Job (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample7_ConversationsAuthoring_CancelTrainingJob.md)
-* [Cancel Training Job (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample7_ConversationsAuthoring_CancelTrainingJobAsync.md)
 * [Get Model Evaluation Summary (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample8_ConversationsAuthoring_GetModelEvaluationSummary.md)
-* [Get Model Evaluation Summary (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample8_ConversationsAuthoring_GetModelEvaluationSummaryAsync.md)
 * [Get Model Evaluation Results (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample9_ConversationsAuthoring_GetModelEvaluationResults.md)
-* [Get Model Evaluation Results (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample9_ConversationsAuthoring_GetModelEvaluationResultsAsync.md)
 * [Load Snapshot (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample10_ConversationsAuthoring_LoadSnapshot.md)
-* [Load Snapshot (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample10_ConversationsAuthoring_LoadSnapshotAsync.md)
 * [Delete a Trained Model (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample11_ConversationsAuthoring_DeleteTrainedModel.md)
-* [Delete a Trained Model (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample11_ConversationsAuthoring_DeleteTrainedModelAsync.md)
 * [Swap Deployments (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample12_ConversationsAuthoring_SwapDeployments.md)
-* [Swap Deployments (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample12_ConversationsAuthoring_SwapDeploymentsAsync.md)
 * [Delete a Deployment (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample13_ConversationsAuthoring_DeleteDeployment.md)
-* [Delete a Deployment (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample13_ConversationsAuthoring_DeleteDeploymentAsync.md)
 * [Deploy a Project (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample14_ConversationsAuthoring_DeployProject.md)
-* [Delete a Project (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample14_ConversationsAuthoring_DeployProjectAsync.md)
+* [Assign Deployment Resources (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample16_ConversationsAuthoring_AssignDeploymentResources.md)
+* [Get Assign Deployment Resources Status (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample17_ConversationsAuthoring_GetAssignDeploymentResourcesStatus.md)
+* [Unassign Deployment Resources (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample18_ConversationsAuthoring_UnassignDeploymentResources.md)
+* [Get Unassign Deployment Resources Status (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/samples/Sample19_ConversationsAuthoring_GetUnassignDeploymentResourcesStatus.md)
 
 ## Troubleshooting