Amber/creating sdk for text authoring (Azure#47313)

* - initialize the first version of Text Authoring sdk.

* - added custom code

* - complete most of the sample tests

* - complete test samples for text authoring

* - complete all the samples md
- complete live tests

* - delete helloword md

* - add tests record for some functions

* - completed all the recorded tests

* - complete the readme for text authoring

* Remove Azure.AI.Language.Conversations.Authoring folder from the repository

* - modify the snippets to pass validation.

* - run Export-API.ps1 and fix the cspell.json

* change all the "Config" suffix to "Details"

* Trigger CI validation

* - update the PR to the latest version of Typespec

* - updated the sdk pr to the latest version of spec repo

* - add 2024-11-15-preview in readme as the newest version

* - adjusted textAnalysisAuthoring_class in Readme

* - update changelog

* update the snippets to avoid conflicts

* - update the sdk

* - updated the ConversationsAuthoringModelFactory

Author: amber-ccc

.vscode/cspell.json

@@ -1619,6 +1619,12 @@
         "Rerank"
       ]
     },
+    {
+      "filename": "**/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/api/*.cs",
+      "words": [
+        "prebuilts"
+      ]
+    },
     {
       "filename": "**/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/api/*.cs",
       "words": [

sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/src/Generated/ConversationsAuthoringModelFactory.cs

@@ -0,0 +1,37 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.9.34723.18
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Azure.Core.TestFramework", "..\..\core\Azure.Core.TestFramework\src\Azure.Core.TestFramework.csproj", "{ECC730C1-4AEA-420C-916A-66B19B79E4DC}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Azure.AI.Language.Text.Authoring", "src\Azure.AI.Language.Text.Authoring.csproj", "{DFF66C7A-EED6-4AD9-AABB-F65049394E85}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Azure.AI.Language.Text.Authoring.Tests", "tests\Azure.AI.Language.Text.Authoring.Tests.csproj", "{7972BA84-D0F6-4602-8D9D-7C2427B53E30}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{ECC730C1-4AEA-420C-916A-66B19B79E4DC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{ECC730C1-4AEA-420C-916A-66B19B79E4DC}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{ECC730C1-4AEA-420C-916A-66B19B79E4DC}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{ECC730C1-4AEA-420C-916A-66B19B79E4DC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{DFF66C7A-EED6-4AD9-AABB-F65049394E85}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{DFF66C7A-EED6-4AD9-AABB-F65049394E85}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{DFF66C7A-EED6-4AD9-AABB-F65049394E85}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{DFF66C7A-EED6-4AD9-AABB-F65049394E85}.Release|Any CPU.Build.0 = Release|Any CPU
+		{7972BA84-D0F6-4602-8D9D-7C2427B53E30}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7972BA84-D0F6-4602-8D9D-7C2427B53E30}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7972BA84-D0F6-4602-8D9D-7C2427B53E30}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7972BA84-D0F6-4602-8D9D-7C2427B53E30}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {A97F4B90-2591-4689-B1F8-5F21FE6D6CAE}
+	EndGlobalSection
+EndGlobal

sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/Azure.AI.Language.Text.Authoring.sln

@@ -0,0 +1,15 @@
+# Release History
+
+## 1.0.0-beta.1 (Unreleased)
+
+### Features Added
+
+### Breaking Changes
+
+### Bugs Fixed
+
+### Other Changes
+
+## 1.0.0-beta.1
+
+- Initial preview of the Azure.AI.Language.Text.Authoring client library.

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

@@ -0,0 +1,6 @@
+<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <!--
+    Add any shared properties you want for the projects under this package directory that need to be set before the auto imported Directory.Build.props
+  -->
+  <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory).., Directory.Build.props))\Directory.Build.props" />
+</Project>

sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/Directory.Build.props

@@ -0,0 +1,41 @@
+---
+page_type: sample
+languages:
+- csharp
+products:
+# Including relevant stubs from https://review.docs.microsoft.com/help/contribute/metadata-taxonomies#product
+- azure
+name: Azure.AI.Language.Text.Authoring samples for .NET
+description: Samples for the Azure.AI.Language.Text.Authoring client library.
+---
+
+# Azure.AI.Language.Text.Authoring Samples
+
+Azure Text Authoring is part of the Azure Cognitive Service for Language, a cloud-based service that enables creating, managing, and deploying text analysis solutions. This client library provides the following features:
+
+## Common Scenarios Samples
+
+* [Create a New Project (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample3_TextAuthoring_CreateProject.md)
+* [Create a New Project (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample3_TextAuthoring_CreateProjectAsync.md)
+* [Import a Project (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample2_TextAuthoring_Import.md)
+* [Import a Project (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample2_TextAuthoring_ImportAsync.md)
+* [Get Project Details (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample1_TextAuthoring_GetProject.md)
+* [Get Project Details (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample1_TextAuthoring_GetProjectAsync.md)
+* [Delete a Project (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample4_TextAuthoring_DeleteProject.md)
+* [Delete a Project (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample4_TextAuthoring_DeleteProjectAsync.md)
+* [Train a Model (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample5_TextAuthoring_Train.md)
+* [Train a Model (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample5_TextAuthoring_TrainAsync.md)
+* [Cancel Training Job (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample6_TextAuthoring_CancelTrainingJob.md)
+* [Cancel Training Job (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample6_TextAuthoring_CancelTrainingJobAsync.md)
+* [Get Model Evaluation Summary (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample7_TextAuthoring_GetModelEvaluationSummary.md)
+* [Get Model Evaluation Summary (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample7_TextAuthoring_GetModelEvaluationSummaryAsync.md)
+* [Load Snapshot (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample8_TextAuthoring_LoadSnapshot.md)
+* [Load Snapshot (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample8_TextAuthoring_LoadSnapshotAsync.md)
+* [Delete a Trained Model (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample9_TextAuthoring_DeleteTrainedModel.md)
+* [Delete a Trained Model (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample9_TextAuthoring_DeleteTrainedModelAsync.md)
+* [Deploy a Project (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample10_TextAuthoring_DeployProject.md)
+* [Deploy a Project (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample10_TextAuthoring_DeployProjectAsync.md)
+* [Swap Deployments (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample11_TextAuthoring_SwapDeployments.md)
+* [Swap Deployments (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample11_TextAuthoring_SwapDeploymentsAsync.md)
+* [Delete a Deployment (Sync)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample12_TextAuthoring_DeleteDeployment.md)
+* [Delete a Deployment (Async)](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/cognitivelanguage/Azure.AI.Language.Text.Authoring/samples/Sample12_TextAuthoring_DeleteDeploymentAsync.md)

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

@@ -0,0 +1,36 @@
+# Deploying a Project Synchronously in Azure AI Language
+
+This sample demonstrates how to deploy a project synchronously using the `Azure.AI.Language.Text.Authoring` SDK.
+
+## Create an `AuthoringClient`
+
+To create an `AuthoringClient`, you will need the service endpoint and credentials of your Language resource. You can specify the service version by providing an `AuthoringClientOptions` instance.
+
+```C# Snippet:CreateTextAuthoringClientForSpecificApiVersion
+Uri endpoint = new Uri("https://myaccount.cognitiveservices.azure.com");
+AzureKeyCredential credential = new("your apikey");
+AuthoringClientOptions options = new AuthoringClientOptions(AuthoringClientOptions.ServiceVersion.V2024_11_15_Preview);
+AuthoringClient client = new AuthoringClient(endpoint, credential, options);
+TextAnalysisAuthoring authoringClient = client.GetTextAnalysisAuthoringClient();
+```
+
+## Deploy a Project Synchronously
+
+To deploy a project, call DeployProject on the TextAnalysisAuthoring client.
+
+```C# Snippet:Sample10_TextAuthoring_DeployProject
+string projectName = "LoanAgreements";
+string deploymentName = "DeploymentName";
+var deploymentDetails = new CreateDeploymentDetails(trainedModelLabel: "29886710a2ae49259d62cffca977db66");
+
+Operation operation = authoringClient.DeployProject(
+    waitUntil: WaitUntil.Completed,
+    projectName: projectName,
+    deploymentName: deploymentName,
+    body: deploymentDetails
+);
+
+Console.WriteLine($"Deployment operation status: {operation.GetRawResponse().Status}");
+```
+
+To deploy a project, the DeployProject method sends a request with the project name, deployment name, and deployment configuration. The method returns an Operation object indicating the deployment status.