diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/client.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/client.tsp index f62955fcf575..e302a32887a2 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/client.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/client.tsp @@ -6,7 +6,7 @@ using Language.Conversations.Authoring; using Azure.ClientGenerator.Core; using Versioning; -@useDependency(Language.Conversations.Authoring.Versions.v2025_05_15_preview) +@useDependency(Language.Conversations.Authoring.Versions.v2025_11_15_preview) namespace Language.ConversationsAuthoringClientCustomizations; @@clientName(conversationAuthoringListDeployments, "listDeployments"); diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignProjectResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignProjectResources.json new file mode 100644 index 000000000000..72f6df0ebc06 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignProjectResources.json @@ -0,0 +1,31 @@ +{ + "operationId": "ConversationAuthoringProject_AssignProjectResources", + "title": "Successful Assign Project Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "body": { + "projectResources": [ + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu", + "customDomain": "lang-test-weu.cognitiveservices.azure.com", + "region": "westeurope" + }, + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestEus", + "customDomain": "lang-test-eus.cognitiveservices.azure.com", + "region": "eastus" + } + ] + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/resources/assign/jobs/66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json new file mode 100644 index 000000000000..dd1c1c14d8a2 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json @@ -0,0 +1,18 @@ +{ + "operationId": "ConversationAuthoringProject_CancelTrainingJob", + "title": "Successful Cancel Training Job", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/train/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulCreateProject.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulCreateProject.json new file mode 100644 index 000000000000..a1867970de6b --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulCreateProject.json @@ -0,0 +1,46 @@ +{ + "operationId": "ConversationAuthoringProject_CreateProject", + "title": "Successful Create Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/merge-patch+json", + "api-version": "2025-11-01", + "projectName": "myproject", + "body": { + "projectName": "myproject", + "language": "en", + "projectKind": "Conversation", + "description": "This is a sample conversation project.", + "multilingual": false + } + }, + "responses": { + "201": { + "headers": {}, + "body": { + "createdDateTime": "2022-04-18T13:53:03Z", + "lastModifiedDateTime": "2022-04-18T13:53:03Z", + "projectKind": "Conversation", + "projectName": "myproject", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + } + }, + "200": { + "headers": {}, + "body": { + "createdDateTime": "2022-04-18T13:53:03Z", + "lastModifiedDateTime": "2022-04-18T13:53:03Z", + "lastTrainedDateTime": "2022-04-18T14:14:28Z", + "lastDeployedDateTime": "2022-04-18T14:49:01Z", + "projectKind": "Conversation", + "projectName": "myproject", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteDeployment.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteDeployment.json new file mode 100644 index 000000000000..1a223bcd8e67 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteDeployment.json @@ -0,0 +1,18 @@ +{ + "operationId": "ConversationAuthoringDeployment_DeleteDeployment", + "title": "Successful Delete Deployment", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "staging" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/staging/jobs/61ebb7ef-a207-40d2-82b9-5285440ae579_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json new file mode 100644 index 000000000000..6cf9c84902c9 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringDeployment_DeleteDeploymentFromResources", + "title": "Successful Delete Deployment From Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "staging", + "body": { + "assignedResourceIds": [ + "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu" + ] + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/staging/delete-from-resources/jobs/61ebb7ef-a207-40d2-82b9-5285440ae579_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteModel.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteModel.json new file mode 100644 index 000000000000..5e69241ea538 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteModel.json @@ -0,0 +1,14 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_DeleteTrainedModel", + "title": "Successful Delete Model", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model2" + }, + "responses": { + "204": {} + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteProject.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteProject.json new file mode 100644 index 000000000000..0d407e36e991 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteProject.json @@ -0,0 +1,17 @@ +{ + "operationId": "ConversationAuthoringProject_DeleteProject", + "title": "Successful Delete Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "myproject" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/global/deletion-jobs/129d3182-625d-496c-bcf9-43686e85160b_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeployProject.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeployProject.json new file mode 100644 index 000000000000..597f1e8c5d99 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeployProject.json @@ -0,0 +1,21 @@ +{ + "operationId": "ConversationAuthoringDeployment_DeployProject", + "title": "Successful Deploy Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "production", + "body": { + "trainedModelLabel": "29886710a2ae49259d62cffca977db66" + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/production/jobs/66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulExportProject.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulExportProject.json new file mode 100644 index 000000000000..78a5bf27c858 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulExportProject.json @@ -0,0 +1,18 @@ +{ + "operationId": "ConversationAuthoringProject_Export", + "title": "Successful Export Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "stringIndexType": "Utf16CodeUnit" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/export/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json new file mode 100644 index 000000000000..2414a2305167 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetAssignProjectResourcesStatus", + "title": "Successful Get Assign Project Resources Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeployment.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeployment.json new file mode 100644 index 000000000000..c0e39d7e8e04 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeployment.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringDeployment_GetDeployment", + "title": "Successful Get Deployment", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "staging" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "deploymentName": "staging", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49.4334381Z", + "lastDeployedDateTime": "2022-04-18T15:53:04Z", + "deploymentExpirationDate": "2023-10-28", + "modelTrainingConfigVersion": "2022-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json new file mode 100644 index 000000000000..2bc8cfe264a7 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringDeployment_GetDeploymentDeleteFromResourcesStatus", + "title": "Successful Get Deployment Delete From Resources Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "production", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json new file mode 100644 index 000000000000..1fcb21994199 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringDeployment_GetDeploymentStatus", + "title": "Successful Get Deployment Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "production", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetExportResult.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetExportResult.json new file mode 100644 index 000000000000..6c268fcbb452 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetExportResult.json @@ -0,0 +1,36 @@ +{ + "operationId": "ConversationAuthoringProject_GetExportResult", + "title": "Successful Get Export Result", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "SampleProject", + "jobId": "job12345" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "projectFileVersion": "1.0.0", + "stringIndexType": "Utf16CodeUnit", + "metadata": { + "projectKind": "Conversation", + "projectName": "SampleProject", + "language": "en", + "settings": { + "confidenceThreshold": 0.8, + "normalizeCasing": true, + "augmentDiacritics": false + }, + "storageInputContainerName": "project-container", + "multilingual": false, + "description": "Sample project description" + }, + "assets": { + "projectKind": "Conversation" + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetExportStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetExportStatus.json new file mode 100644 index 000000000000..d25abbf34851 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetExportStatus.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringProject_GetExportStatus", + "title": "Successful Get Export Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "c95efa2a-44e8-461e-8aa5-04b4677bfa84_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "resultUrl": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/export/jobs/c4946bfa-4fbf-493b-bfcf-2d232eb9de69_637858368000000000/result?api-version=2025-11-01", + "jobId": "c4946bfa-4fbf-493b-bfcf-2d232eb9de69_637858368000000000", + "createdDateTime": "2022-04-18T15:23:07Z", + "lastUpdatedDateTime": "2022-04-18T15:23:08Z", + "expirationDateTime": "2022-04-25T15:23:07Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetImportStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetImportStatus.json new file mode 100644 index 000000000000..b7fd54686a1b --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetImportStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetImportStatus", + "title": "Successful Get Import Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "c95efa2a-44e8-461e-8aa5-04b4677bfa84_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "c95efa2a-44e8-461e-8aa5-04b4677bfa84_637858368000000000", + "createdDateTime": "2022-04-18T15:17:20Z", + "lastUpdatedDateTime": "2022-04-18T15:17:22Z", + "expirationDateTime": "2022-04-25T15:17:20Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json new file mode 100644 index 000000000000..c4ed63bac0c5 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_GetLoadSnapshotStatus", + "title": "Successful Get Load Snapshot Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1", + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000", + "createdDateTime": "2022-04-18T15:44:44Z", + "lastUpdatedDateTime": "2022-04-18T15:45:48Z", + "expirationDateTime": "2022-04-25T15:44:44Z", + "status": "running" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModel.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModel.json new file mode 100644 index 000000000000..d41989fcaef2 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModel.json @@ -0,0 +1,25 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_GetTrainedModel", + "title": "Successful Get Model", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "label": "model1", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49Z", + "lastTrainingDurationInSeconds": 186, + "modelExpirationDate": "2022-10-28", + "modelTrainingConfigVersion": "2022-05-01", + "hasSnapshot": true + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json new file mode 100644 index 000000000000..0d66e21fe2f9 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json @@ -0,0 +1,286 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_GetModelEvaluationResults", + "title": "Successful Get Model Evaluation", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1", + "stringIndexType": "Utf16CodeUnit", + "maxpagesize": 10 + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "text": "send the email", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [], + "predictedEntities": [] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "send a mail to daniel", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 15, + "length": 6 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 15, + "length": 6 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "i forgot to add an important part to that email to james . please set it up to edit", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 51, + "length": 5 + } + ], + "predictedEntities": [ + { + "category": "Category", + "offset": 19, + "length": 9 + }, + { + "category": "ContactName", + "offset": 51, + "length": 5 + } + ] + }, + "intentsResult": { + "expectedIntent": "AddMore", + "predictedIntent": "AddMore" + } + }, + { + "text": "send email to a and tian", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 14, + "length": 1 + }, + { + "category": "ContactName", + "offset": 20, + "length": 4 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 14, + "length": 1 + }, + { + "category": "ContactName", + "offset": 20, + "length": 4 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "send thomas an email", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 5, + "length": 6 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 5, + "length": 6 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "i need to add more to the email message i am sending to vincent", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 56, + "length": 7 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 56, + "length": 7 + } + ] + }, + "intentsResult": { + "expectedIntent": "AddMore", + "predictedIntent": "AddMore" + } + }, + { + "text": "send an email to lily roth and abc123@microsoft.com", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 17, + "length": 9 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 17, + "length": 9 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "i need to add something else to my email to cheryl", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 44, + "length": 6 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 44, + "length": 6 + } + ] + }, + "intentsResult": { + "expectedIntent": "AddMore", + "predictedIntent": "AddMore" + } + }, + { + "text": "send an email to larry , joseph and billy larkson", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 17, + "length": 5 + }, + { + "category": "ContactName", + "offset": 25, + "length": 6 + }, + { + "category": "ContactName", + "offset": 36, + "length": 13 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 17, + "length": 5 + }, + { + "category": "ContactName", + "offset": 25, + "length": 6 + }, + { + "category": "ContactName", + "offset": 36, + "length": 13 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "send mail to dorothy", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 13, + "length": 7 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 13, + "length": 7 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + } + ], + "nextLink": "https://api.example.com/language/authoring/analyze-conversations/projects/EmailApp/models/model1/evaluation/result/?api-version=2025-11-01&top=2147483637&skip=100&maxpagesize=100" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json new file mode 100644 index 000000000000..7ecd98943231 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json @@ -0,0 +1,528 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_GetModelEvaluationSummary", + "title": "Successful Get Model Evaluation Summary", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "entitiesEvaluation": { + "confusionMatrix": { + "Attachment": { + "Attachment": { + "normalizedValue": 100.0, + "rawValue": 3.0 + } + }, + "Category": { + "Category": { + "normalizedValue": 91.666664, + "rawValue": 11.0 + }, + "$none": { + "normalizedValue": 8.333333, + "rawValue": 1.0 + } + }, + "ContactName": { + "ContactName": { + "normalizedValue": 91.666664, + "rawValue": 22.0 + }, + "SenderName": { + "normalizedValue": 4.1666665, + "rawValue": 1.0 + }, + "$none": { + "normalizedValue": 4.1666665, + "rawValue": 1.0 + } + }, + "Date": { + "Date": { + "normalizedValue": 100.0, + "rawValue": 2.0 + } + }, + "EmailSubject": { + "EmailSubject": { + "normalizedValue": 93.33333, + "rawValue": 9.333334 + }, + "$none": { + "normalizedValue": 6.6666665, + "rawValue": 0.6666667 + } + }, + "FromRelationshipName": { + "FromRelationshipName": { + "normalizedValue": 100.0, + "rawValue": 1.0 + } + }, + "Line": { + "Line": { + "normalizedValue": 100.0, + "rawValue": 2.0 + } + }, + "Message": { + "Message": { + "normalizedValue": 81.2063, + "rawValue": 6.496504 + }, + "EmailSubject": { + "normalizedValue": 7.43007, + "rawValue": 0.5944056 + }, + "$none": { + "normalizedValue": 9.120047, + "rawValue": 0.7296037 + }, + "Date": { + "normalizedValue": 2.2435899, + "rawValue": 0.17948718 + } + }, + "OrderReference": { + "OrderReference": { + "normalizedValue": 100.0, + "rawValue": 17.0 + } + }, + "PositionReference": { + "$none": { + "normalizedValue": 100.0, + "rawValue": 1.0 + } + }, + "RelationshipName": { + "RelationshipName": { + "normalizedValue": 66.666664, + "rawValue": 2.0 + }, + "$none": { + "normalizedValue": 33.333332, + "rawValue": 1.0 + } + }, + "SearchTexts": { + "SearchTexts": { + "normalizedValue": 100.0, + "rawValue": 4.0 + } + }, + "SenderName": { + "SenderName": { + "normalizedValue": 88.888885, + "rawValue": 8.0 + }, + "ContactName": { + "normalizedValue": 11.111111, + "rawValue": 1.0 + } + }, + "Time": { + "$none": { + "normalizedValue": 100.0, + "rawValue": 2.0 + } + }, + "$none": { + "$none": { + "normalizedValue": 99.739265, + "rawValue": 162.575 + }, + "Category": { + "normalizedValue": 0.2607362, + "rawValue": 0.425 + } + } + }, + "entities": { + "ContactName": { + "f1": 0.9361702799797058, + "precision": 0.95652174949646, + "recall": 0.9166666865348816, + "truePositiveCount": 22, + "trueNegativeCount": 0, + "falsePositiveCount": 1, + "falseNegativeCount": 2 + }, + "Category": { + "f1": 0.8799999952316284, + "precision": 0.8461538553237915, + "recall": 0.9166666865348816, + "truePositiveCount": 11, + "trueNegativeCount": 0, + "falsePositiveCount": 2, + "falseNegativeCount": 1 + }, + "SenderName": { + "f1": 0.8888888955116272, + "precision": 0.8888888955116272, + "recall": 0.8888888955116272, + "truePositiveCount": 8, + "trueNegativeCount": 0, + "falsePositiveCount": 1, + "falseNegativeCount": 1 + }, + "EmailSubject": { + "f1": 0.8181817531585693, + "precision": 0.75, + "recall": 0.8999999761581421, + "truePositiveCount": 9, + "trueNegativeCount": 0, + "falsePositiveCount": 3, + "falseNegativeCount": 1 + }, + "Message": { + "f1": 0.75, + "precision": 0.75, + "recall": 0.75, + "truePositiveCount": 6, + "trueNegativeCount": 0, + "falsePositiveCount": 2, + "falseNegativeCount": 2 + }, + "Date": { + "f1": 0.800000011920929, + "precision": 0.6666666865348816, + "recall": 1.0, + "truePositiveCount": 2, + "trueNegativeCount": 0, + "falsePositiveCount": 1, + "falseNegativeCount": 0 + }, + "OrderReference": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 17, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "SearchTexts": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 4, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Attachment": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 3, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "RelationshipName": { + "f1": 0.800000011920929, + "precision": 1.0, + "recall": 0.6666666865348816, + "truePositiveCount": 2, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 1 + }, + "Line": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 2, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Time": { + "f1": 0.0, + "precision": 0.0, + "recall": 0.0, + "truePositiveCount": 0, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 2 + }, + "FromRelationshipName": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 1, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "PositionReference": { + "f1": 0.0, + "precision": 0.0, + "recall": 0.0, + "truePositiveCount": 0, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 1 + } + }, + "microF1": 0.8923077, + "microPrecision": 0.8969072, + "microRecall": 0.8877551, + "macroF1": 0.7766601, + "macroPrecision": 0.7755879, + "macroRecall": 0.78849214 + }, + "intentsEvaluation": { + "confusionMatrix": { + "AddFlag": { + "AddFlag": { + "normalizedValue": 100.0, + "rawValue": 6.0 + } + }, + "AddMore": { + "AddMore": { + "normalizedValue": 100.0, + "rawValue": 17.0 + } + }, + "Cancel": { + "Cancel": { + "normalizedValue": 100.0, + "rawValue": 9.0 + } + }, + "CheckMessages": { + "CheckMessages": { + "normalizedValue": 100.0, + "rawValue": 9.0 + } + }, + "Confirm": { + "Confirm": { + "normalizedValue": 100.0, + "rawValue": 4.0 + } + }, + "Delete": { + "Delete": { + "normalizedValue": 100.0, + "rawValue": 5.0 + } + }, + "Forward": { + "Forward": { + "normalizedValue": 100.0, + "rawValue": 6.0 + } + }, + "None": { + "None": { + "normalizedValue": 100.0, + "rawValue": 1.0 + } + }, + "QueryLastText": { + "QueryLastText": { + "normalizedValue": 100.0, + "rawValue": 6.0 + } + }, + "ReadAloud": { + "ReadAloud": { + "normalizedValue": 100.0, + "rawValue": 16.0 + } + }, + "Reply": { + "Reply": { + "normalizedValue": 100.0, + "rawValue": 6.0 + } + }, + "SearchMessages": { + "SearchMessages": { + "normalizedValue": 100.0, + "rawValue": 9.0 + } + }, + "SendEmail": { + "SendEmail": { + "normalizedValue": 100.0, + "rawValue": 20.0 + } + }, + "ShowNext": { + "ShowNext": { + "normalizedValue": 100.0, + "rawValue": 4.0 + } + }, + "ShowPrevious": { + "ShowPrevious": { + "normalizedValue": 100.0, + "rawValue": 3.0 + } + } + }, + "intents": { + "AddMore": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 17, + "trueNegativeCount": 104, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Cancel": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 9, + "trueNegativeCount": 112, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "SendEmail": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 20, + "trueNegativeCount": 101, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "CheckMessages": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 9, + "trueNegativeCount": 112, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "AddFlag": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 6, + "trueNegativeCount": 115, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Reply": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 6, + "trueNegativeCount": 115, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "ReadAloud": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 16, + "trueNegativeCount": 105, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "QueryLastText": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 6, + "trueNegativeCount": 115, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "SearchMessages": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 9, + "trueNegativeCount": 112, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Delete": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 5, + "trueNegativeCount": 116, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Forward": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 6, + "trueNegativeCount": 115, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Confirm": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 4, + "trueNegativeCount": 117, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "ShowNext": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 4, + "trueNegativeCount": 117, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "ShowPrevious": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 3, + "trueNegativeCount": 118, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "None": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 1, + "trueNegativeCount": 120, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + } + }, + "microF1": 1.0, + "microPrecision": 1.0, + "microRecall": 1.0, + "macroF1": 1.0, + "macroPrecision": 1.0, + "macroRecall": 1.0 + }, + "evaluationOptions": { + "kind": "percentage", + "trainingSplitPercentage": 80, + "testingSplitPercentage": 20 + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetProject.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetProject.json new file mode 100644 index 000000000000..4b57f8b28acc --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetProject.json @@ -0,0 +1,26 @@ +{ + "operationId": "ConversationAuthoringProject_GetProject", + "title": "Successful Get Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "myproject" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2022-04-18T13:53:03Z", + "lastModifiedDateTime": "2022-04-18T13:53:03Z", + "lastTrainedDateTime": "2022-04-18T14:14:28Z", + "lastDeployedDateTime": "2022-04-18T14:49:01Z", + "projectKind": "Conversation", + "projectName": "myproject", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json new file mode 100644 index 000000000000..69c2fb79ca2f --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json @@ -0,0 +1,22 @@ +{ + "operationId": "ConversationAuthoringProject_GetProjectDeletionStatus", + "title": "Successful Get Project Deletion Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "jobId": "129d3182-625d-496c-bcf9-43686e85160b_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "129d3182-625d-496c-bcf9-43686e85160b_637858368000000000", + "createdDateTime": "2022-04-18T14:02:34Z", + "lastUpdatedDateTime": "2022-04-18T14:02:34Z", + "expirationDateTime": "2022-04-25T14:02:34Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json new file mode 100644 index 000000000000..1a13627eebf0 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json @@ -0,0 +1,400 @@ +{ + "operationId": "ConversationAuthoringListSupportedLanguages", + "title": "Successful Get Supported Languages", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectKind": "Conversation" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "languageName": "English", + "languageCode": "en" + }, + { + "languageName": "English", + "languageCode": "en-us" + }, + { + "languageName": "English (UK)", + "languageCode": "en-gb" + }, + { + "languageName": "French", + "languageCode": "fr" + }, + { + "languageName": "Italian", + "languageCode": "it" + }, + { + "languageName": "Spanish", + "languageCode": "es" + }, + { + "languageName": "German", + "languageCode": "de" + }, + { + "languageName": "Portuguese (Brazil)", + "languageCode": "pt-br" + }, + { + "languageName": "Portuguese (Portugal)", + "languageCode": "pt-pt" + }, + { + "languageName": "Chinese (Simplified)", + "languageCode": "zh-hans" + }, + { + "languageName": "Japanese", + "languageCode": "ja" + }, + { + "languageName": "Korean", + "languageCode": "ko" + }, + { + "languageName": "Dutch", + "languageCode": "nl" + }, + { + "languageName": "Hindi", + "languageCode": "hi" + }, + { + "languageName": "Turkish", + "languageCode": "tr" + }, + { + "languageName": "Gujarati", + "languageCode": "gu" + }, + { + "languageName": "Marathi", + "languageCode": "mr" + }, + { + "languageName": "Tamil", + "languageCode": "ta" + }, + { + "languageName": "Telugu", + "languageCode": "te" + }, + { + "languageName": "Zulu", + "languageCode": "zu" + }, + { + "languageName": "Afrikaans", + "languageCode": "af" + }, + { + "languageName": "Amharic", + "languageCode": "am" + }, + { + "languageName": "Arabic", + "languageCode": "ar" + }, + { + "languageName": "Assamese", + "languageCode": "as" + }, + { + "languageName": "Azerbaijani", + "languageCode": "az" + }, + { + "languageName": "Belarusian", + "languageCode": "be" + }, + { + "languageName": "Bulgarian", + "languageCode": "bg" + }, + { + "languageName": "Breton", + "languageCode": "br" + }, + { + "languageName": "Bosnian", + "languageCode": "bs" + }, + { + "languageName": "Catalan", + "languageCode": "ca" + }, + { + "languageName": "Czech", + "languageCode": "cs" + }, + { + "languageName": "Welsh", + "languageCode": "cy" + }, + { + "languageName": "Danish", + "languageCode": "da" + }, + { + "languageName": "Greek", + "languageCode": "el" + }, + { + "languageName": "Esperanto", + "languageCode": "eo" + }, + { + "languageName": "Estonian", + "languageCode": "et" + }, + { + "languageName": "Basque", + "languageCode": "eu" + }, + { + "languageName": "Persian", + "languageCode": "fa" + }, + { + "languageName": "Finnish", + "languageCode": "fi" + }, + { + "languageName": "Western Frisian", + "languageCode": "fy" + }, + { + "languageName": "Irish", + "languageCode": "ga" + }, + { + "languageName": "Scottish Gaelic", + "languageCode": "gd" + }, + { + "languageName": "Galician", + "languageCode": "gl" + }, + { + "languageName": "Hausa", + "languageCode": "ha" + }, + { + "languageName": "Hebrew", + "languageCode": "he" + }, + { + "languageName": "Croatian", + "languageCode": "hr" + }, + { + "languageName": "Hungarian", + "languageCode": "hu" + }, + { + "languageName": "Armenian", + "languageCode": "hy" + }, + { + "languageName": "Indonesian", + "languageCode": "id" + }, + { + "languageName": "Javanese", + "languageCode": "jv" + }, + { + "languageName": "Georgian", + "languageCode": "ka" + }, + { + "languageName": "Kazakh", + "languageCode": "kk" + }, + { + "languageName": "Khmer", + "languageCode": "km" + }, + { + "languageName": "Kannada", + "languageCode": "kn" + }, + { + "languageName": "Kurdish (Kurmanji)", + "languageCode": "ku" + }, + { + "languageName": "Kyrgyz", + "languageCode": "ky" + }, + { + "languageName": "Latin", + "languageCode": "la" + }, + { + "languageName": "Lao", + "languageCode": "lo" + }, + { + "languageName": "Lithuanian", + "languageCode": "lt" + }, + { + "languageName": "Latvian", + "languageCode": "lv" + }, + { + "languageName": "Malagasy", + "languageCode": "mg" + }, + { + "languageName": "Macedonian", + "languageCode": "mk" + }, + { + "languageName": "Malayalam", + "languageCode": "ml" + }, + { + "languageName": "Mongolian", + "languageCode": "mn" + }, + { + "languageName": "Malay", + "languageCode": "ms" + }, + { + "languageName": "Burmese", + "languageCode": "my" + }, + { + "languageName": "Nepali", + "languageCode": "ne" + }, + { + "languageName": "Norwegian (Bokmal)", + "languageCode": "nb" + }, + { + "languageName": "Odia", + "languageCode": "or" + }, + { + "languageName": "Punjabi", + "languageCode": "pa" + }, + { + "languageName": "Polish", + "languageCode": "pl" + }, + { + "languageName": "Pashto", + "languageCode": "ps" + }, + { + "languageName": "Romanian", + "languageCode": "ro" + }, + { + "languageName": "Russian", + "languageCode": "ru" + }, + { + "languageName": "Sanskrit", + "languageCode": "sa" + }, + { + "languageName": "Sindhi", + "languageCode": "sd" + }, + { + "languageName": "Sinhala", + "languageCode": "si" + }, + { + "languageName": "Slovak", + "languageCode": "sk" + }, + { + "languageName": "Slovenian", + "languageCode": "sl" + }, + { + "languageName": "Somali", + "languageCode": "so" + }, + { + "languageName": "Albanian", + "languageCode": "sq" + }, + { + "languageName": "Serbian", + "languageCode": "sr" + }, + { + "languageName": "Sundanese", + "languageCode": "su" + }, + { + "languageName": "Swedish", + "languageCode": "sv" + }, + { + "languageName": "Swahili", + "languageCode": "sw" + }, + { + "languageName": "Thai", + "languageCode": "th" + }, + { + "languageName": "Filipino", + "languageCode": "tl" + }, + { + "languageName": "Uyghur", + "languageCode": "ug" + }, + { + "languageName": "Ukrainian", + "languageCode": "uk" + }, + { + "languageName": "Urdu", + "languageCode": "ur" + }, + { + "languageName": "Uzbek", + "languageCode": "uz" + }, + { + "languageName": "Vietnamese", + "languageCode": "vi" + }, + { + "languageName": "Xhosa", + "languageCode": "xh" + }, + { + "languageName": "Yiddish", + "languageCode": "yi" + }, + { + "languageName": "Chinese (Traditional)", + "languageCode": "zh-hant" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json new file mode 100644 index 000000000000..bf9840c730c0 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json @@ -0,0 +1,100 @@ +{ + "operationId": "ConversationAuthoringListSupportedPrebuiltEntities", + "title": "Successful Get Supported Prebuilt Entities", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "language": "en" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "category": "Person.Name", + "description": "Name of an individual", + "examples": "john, Sam, Lisa" + }, + { + "category": "General.Event", + "description": "Important events", + "examples": "World War two, Covid 19" + }, + { + "category": "General.Organization", + "description": "Companies and corporations", + "examples": "Microsoft, Amazon" + }, + { + "category": "Choice.Boolean", + "description": "boolean choice", + "examples": "yes, no, agreed" + }, + { + "category": "Quantity.Age", + "description": "Age of a person or thing", + "examples": "10-month-old, 19 years old, 58 year-old" + }, + { + "category": "Quantity.NumberRange", + "description": "a numeric interval", + "examples": "between 25 and 35, 25-35" + }, + { + "category": "Quantity.Number", + "description": "A cardinal number in numeric or text form", + "examples": "ten, forty two, 3.141, 10K" + }, + { + "category": "Quantity.Percentage", + "description": "A percentage, using the symbol % or the word \"percent\"", + "examples": "10%, 5.6 percent" + }, + { + "category": "Quantity.Ordinal", + "description": "An ordinal number in numeric or text form", + "examples": "first, second, tenth, 1st, 2nd, 10th" + }, + { + "category": "Quantity.Dimension", + "description": "Spacial dimensions, including length, distance, area, and volume", + "examples": "2 miles, 650 square kilometres, 9,350 feet" + }, + { + "category": "Quantity.Temperature", + "description": "A temperature in celsius or fahrenheit", + "examples": "32F, 34 degrees celsius, 2 deg C" + }, + { + "category": "Quantity.Currency", + "description": "Monetary amounts, including currency", + "examples": "1000.00 US dollars, £20.00, $ 67.5 B" + }, + { + "category": "DateTime", + "description": "exact date values", + "examples": "May 11th" + }, + { + "category": "Email", + "description": "Email addresses", + "examples": "user@example.net, user_name@example.com, user.Name12@example.net" + }, + { + "category": "Phone Number", + "description": "US phone numbers", + "examples": "123-456-7890, +1 123 456 789, (123)456-789" + }, + { + "category": "URL", + "description": "Websites URLs and links", + "examples": "www.example.com, http://example.net?name=my_name&age=10" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json new file mode 100644 index 000000000000..f1e28809e584 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringListTrainingConfigVersions", + "title": "Successful Get Supported Training Config Versions", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectKind": "Conversation" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "trainingConfigVersion": "2022-05-01", + "modelExpirationDate": "2022-10-28" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json new file mode 100644 index 000000000000..1fae33370983 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetSwapDeploymentsStatus", + "title": "Successful Get Swap Deployments Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "c36a8775-35b9-4cb5-a8db-665e7d91aafe_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "c36a8775-35b9-4cb5-a8db-665e7d91aafe_637858368000000000", + "createdDateTime": "2022-04-18T16:09:50Z", + "lastUpdatedDateTime": "2022-04-18T16:09:58Z", + "expirationDateTime": "2022-04-25T16:09:50Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetTrainStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetTrainStatus.json new file mode 100644 index 000000000000..e18f641e8ad7 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetTrainStatus.json @@ -0,0 +1,38 @@ +{ + "operationId": "ConversationAuthoringProject_GetTrainingStatus", + "title": "Successful Get Train Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "result": { + "modelLabel": "model1", + "trainingConfigVersion": "2022-05-01", + "trainingMode": "standard", + "estimatedEndDateTime": "2022-04-18T15:47:58.8190649Z", + "trainingStatus": { + "percentComplete": 3, + "startDateTime": "2022-04-18T15:45:06.8190649Z", + "status": "running" + }, + "evaluationStatus": { + "percentComplete": 0, + "status": "notStarted" + } + }, + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000", + "createdDateTime": "2022-04-18T15:44:44Z", + "lastUpdatedDateTime": "2022-04-18T15:45:48Z", + "expirationDateTime": "2022-04-25T15:44:44Z", + "status": "running" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json new file mode 100644 index 000000000000..fe3d562e321f --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetUnassignProjectResourcesStatus", + "title": "Successful Get Unassign Project Resources Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulImportProject.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulImportProject.json new file mode 100644 index 000000000000..2454757151f1 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulImportProject.json @@ -0,0 +1,80 @@ +{ + "operationId": "ConversationAuthoringProject_Import", + "title": "Successful Import Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "body": { + "projectFileVersion": "2022-05-01", + "stringIndexType": "Utf16CodeUnit", + "metadata": { + "projectKind": "Conversation", + "settings": { + "confidenceThreshold": 0.7 + }, + "projectName": "EmailApp", + "multilingual": true, + "description": "Trying out CLU", + "language": "en-us" + }, + "assets": { + "projectKind": "Conversation", + "intents": [ + { + "category": "Read" + }, + { + "category": "Delete" + } + ], + "entities": [ + { + "category": "Sender" + }, + { + "category": "Number", + "regex": { + "expressions": [ + { + "regexKey": "UK Phone numbers", + "language": "en-us", + "regexPattern": "/^\\(?([0-9]{3})\\)?[-.\\s]?([0-9]{3})[-.\\s]?([0-9]{4})$/" + } + ] + } + } + ], + "utterances": [ + { + "text": "Open Blake's email", + "dataset": "Train", + "intent": "Read", + "entities": [ + { + "category": "Sender", + "offset": 5, + "length": 5 + } + ] + }, + { + "text": "Delete last email", + "language": "en-gb", + "dataset": "Test", + "intent": "Delete", + "entities": [] + } + ] + } + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/import/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json new file mode 100644 index 000000000000..295f12525388 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json @@ -0,0 +1,28 @@ +{ + "operationId": "ConversationAuthoringListAssignedResourceDeployments", + "title": "Successful List Assigned Resource Deployments", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "projectName": "Booking", + "deploymentsMetadata": [ + { + "deploymentName": "staging", + "lastDeployedDateTime": "2022-04-18T14:49:01Z", + "deploymentExpirationDate": "2023-10-28" + } + ] + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListDeployments.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListDeployments.json new file mode 100644 index 000000000000..36ab3ea6bd98 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListDeployments.json @@ -0,0 +1,35 @@ +{ + "operationId": "ConversationAuthoringListDeployments", + "title": "Successful List Deployments", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "deploymentName": "production", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49.4334381Z", + "lastDeployedDateTime": "2022-04-18T16:03:51Z", + "deploymentExpirationDate": "2023-10-28", + "modelTrainingConfigVersion": "2022-05-01" + }, + { + "deploymentName": "staging", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49.4334381Z", + "lastDeployedDateTime": "2022-04-18T15:53:04Z", + "deploymentExpirationDate": "2023-10-28", + "modelTrainingConfigVersion": "2022-05-01" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListModels.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListModels.json new file mode 100644 index 000000000000..dd0202a881a8 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListModels.json @@ -0,0 +1,38 @@ +{ + "operationId": "ConversationAuthoringListTrainedModels", + "title": "Successful List Models", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "label": "model1", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49Z", + "lastTrainingDurationInSeconds": 186, + "modelExpirationDate": "2022-10-28", + "modelTrainingConfigVersion": "2022-05-01", + "hasSnapshot": true + }, + { + "label": "model2", + "modelId": "model2-20220418T052522-c63bd244dd9e4bf8adec1a7129968c99", + "lastTrainedDateTime": "2022-04-18T17:25:22Z", + "lastTrainingDurationInSeconds": 192, + "modelExpirationDate": "2022-10-28", + "modelTrainingConfigVersion": "2022-05-01", + "hasSnapshot": true + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjectResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjectResources.json new file mode 100644 index 000000000000..cc1542d0c6eb --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjectResources.json @@ -0,0 +1,27 @@ +{ + "operationId": "conversationAuthoringListProjectResources", + "title": "Successful List Project Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu", + "region": "westeurope" + }, + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestEus", + "region": "eastus" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjects.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjects.json new file mode 100644 index 000000000000..7e1a5e10ee56 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjects.json @@ -0,0 +1,37 @@ +{ + "operationId": "ConversationAuthoringListProjects", + "title": "Successful List Projects", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "createdDateTime": "2022-04-18T14:03:16Z", + "lastModifiedDateTime": "2022-04-18T14:03:16Z", + "projectKind": "Conversation", + "projectName": "myproject1", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + }, + { + "createdDateTime": "2022-04-18T14:03:12Z", + "lastModifiedDateTime": "2022-04-18T14:03:12Z", + "projectKind": "Conversation", + "projectName": "myproject", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListTrainingJobs.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListTrainingJobs.json new file mode 100644 index 000000000000..d69991b7a1a2 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListTrainingJobs.json @@ -0,0 +1,92 @@ +{ + "operationId": "ConversationAuthoringListTrainingJobs", + "title": "Successful List Training Jobs", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "result": { + "modelLabel": "model1", + "trainingConfigVersion": "2022-05-01", + "trainingMode": "advanced", + "trainingStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T15:45:06.8190649Z", + "endDateTime": "2022-04-18T15:47:19.2639682Z", + "status": "succeeded" + }, + "evaluationStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T15:47:19.2734976Z", + "endDateTime": "2022-04-18T15:47:23.8378892Z", + "status": "succeeded" + } + }, + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000", + "createdDateTime": "2022-04-18T15:44:44Z", + "lastUpdatedDateTime": "2022-04-18T15:47:50Z", + "expirationDateTime": "2022-04-25T15:44:44Z", + "status": "succeeded" + }, + { + "result": { + "modelLabel": "model2", + "trainingConfigVersion": "2022-05-01", + "trainingMode": "standard", + "trainingStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T17:22:39.3663023Z", + "endDateTime": "2022-04-18T17:24:51.9440947Z", + "status": "succeeded" + }, + "evaluationStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T17:24:51.9571747Z", + "endDateTime": "2022-04-18T17:24:58.1427823Z", + "status": "succeeded" + } + }, + "jobId": "9145f93f-6f37-418c-8527-d2ded84cece0_637858368000000000", + "createdDateTime": "2022-04-18T17:22:11Z", + "lastUpdatedDateTime": "2022-04-18T17:25:23Z", + "expirationDateTime": "2022-04-25T17:22:11Z", + "status": "succeeded" + }, + { + "result": { + "modelLabel": "model2", + "trainingConfigVersion": "2022-05-01", + "trainingMode": "standard", + "trainingStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T17:44:41.388358Z", + "endDateTime": "2022-04-18T17:50:29.5675101Z", + "status": "succeeded" + }, + "evaluationStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T17:50:29.5808461Z", + "endDateTime": "2022-04-18T17:50:35.3482185Z", + "status": "succeeded" + } + }, + "jobId": "ee23c900-354d-4b6d-96e1-8197db2bd5f7_637858368000000000", + "createdDateTime": "2022-04-18T17:44:04Z", + "lastUpdatedDateTime": "2022-04-18T17:51:11Z", + "expirationDateTime": "2022-04-25T17:44:04Z", + "status": "succeeded" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulLoadSnapshot.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulLoadSnapshot.json new file mode 100644 index 000000000000..7a4f210b2265 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulLoadSnapshot.json @@ -0,0 +1,18 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_LoadSnapshot", + "title": "Successful Load Snapshot", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/models/model1/load-snapshot/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulSwapDeployments.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulSwapDeployments.json new file mode 100644 index 000000000000..132fd936af1c --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulSwapDeployments.json @@ -0,0 +1,21 @@ +{ + "operationId": "ConversationAuthoringProject_SwapDeployments", + "title": "Successful Swap Deployments", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "body": { + "firstDeploymentName": "production", + "secondDeploymentName": "staging" + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/swap/jobs/c36a8775-35b9-4cb5-a8db-665e7d91aafe_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulTrainProject.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulTrainProject.json new file mode 100644 index 000000000000..e9dbf067416b --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulTrainProject.json @@ -0,0 +1,27 @@ +{ + "operationId": "ConversationAuthoringProject_Train", + "title": "Successful Train Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "body": { + "modelLabel": "model1", + "trainingMode": "standard", + "trainingConfigVersion": "latest", + "evaluationOptions": { + "kind": "percentage", + "testingSplitPercentage": 20, + "trainingSplitPercentage": 80 + } + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/train/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json new file mode 100644 index 000000000000..8187ad4c4bfe --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_UnassignProjectResources", + "title": "Successful Unassign Project Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "production", + "body": { + "assignedResourceIds": [ + "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu" + ] + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/resources/unassign/jobs/66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp index a0f1ce5fc03b..186ac0e30467 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp @@ -46,13 +46,11 @@ enum Versions { /** Version 2023-04-01 */ v2023_04_01: "2023-04-01", - /** - * The 2024-11-15-preview API version. - */ - v2024_11_15_preview: "2024-11-15-preview", + /** Version 2025-11-01 */ + v2025_11_01: "2025-11-01", /** - * The 2025-05-15-preview API version. + * The 2025-11-15-preview API version. */ - v2025_05_15_preview: "2025-05-15-preview", + v2025_11_15_preview: "2025-11-15-preview", } diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/common.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/common.tsp index 4c077342fd52..0156a5817f15 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/common.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/common.tsp @@ -30,7 +30,7 @@ union ProjectKind { /** * A project to build conversation summarization models which are able to summarize long conversations. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) CustomConversationSummarization: "CustomConversationSummarization", } diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp index b036d10e311c..5dabec5cd567 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp @@ -69,7 +69,7 @@ model AnalyzeConversationAuthoringProjectMetadata { * The storage container name in case of conversation summarization. */ @visibility(Lifecycle.Create, Lifecycle.Read) - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) storageInputContainerName?: string; /** @@ -156,7 +156,7 @@ model AnalyzeConversationAuthoringCreateProjectOptions { /** * The storage container name in case of conversation summarization. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) storageInputContainerName?: string; /** @@ -183,7 +183,7 @@ model AnalyzeConversationAuthoringCreateProjectOptions { /** * Represents the options for authorizing a project copy to the current Azure resource. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringCopyAuthorizationOptions { /** * Represents the project kind. @@ -204,7 +204,7 @@ model AnalyzeConversationAuthoringCopyAuthorizationOptions { /** * Represents the options for copying an existing project to another Azure resource. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringCopiedProjectOptions { /** * Represents the project kind. @@ -300,7 +300,7 @@ model AnalyzeConversationAuthoringTrainingJobOptions { /** * For customers to populate if they wish to use data generation for their model training job. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) dataGenerationSettings?: AnalyzeConversationAuthoringDataGenerationSettings; } @@ -327,7 +327,7 @@ model AnalyzeConversationAuthoringEvaluationOptions { /** * Represents the state of a copy job. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_15_preview) @resource("copy/jobs") @parentResource(AnalyzeConversationAuthoringProjectMetadata) model AnalyzeConversationAuthoringCopiedProjectJobState { @@ -432,13 +432,15 @@ model AnalyzeConversationAuthoringProjectDeployment { /** * Represents the metadata of the assigned Azure resources. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_01) + @typeChangedFrom(Versions.v2025_11_15_preview, AnalyzeConversationAuthoringAssignedDeploymentResource) assignedResources: AnalyzeConversationAuthoringDeploymentResource[]; } /** * Represents an Azure resource assigned to a deployment. */ +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringDeploymentResource { /** * Represents the Azure resource Id. @@ -453,7 +455,7 @@ model AnalyzeConversationAuthoringDeploymentResource { /** * Represents the AOAI resource assigned for data generation. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) assignedAoaiResource?: AnalyzeConversationAuthoringDataGenerationConnectionInfo; } @@ -467,25 +469,26 @@ model AnalyzeConversationAuthoringCreateDeploymentOptions { trainedModelLabel: string; /** - * Represents the resource IDs to be assigned to the deployment. If provided, the deployment will be rolled out to the resources provided here as well as the original resource in which the project is created. + * Represents the Language or AIService resource IDs that if provided,\n the deployment will be rolled out to the resources provided here as well as the original resource in which the project is created. */ - @added(Versions.v2024_11_15_preview) - @removed(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_01) + @removed(Versions.v2025_11_15_preview) assignedResourceIds?: string[]; /** * Represents the resources to be assigned to the deployment. If provided, the deployment will be rolled out to the resources provided here as well as the original resource in which the project is created. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) assignedResources?: AnalyzeConversationAuthoringDeploymentResource[]; } /** - * Represents the options for deleting a project deployment. + * Represents the payload for deleting a project deployment. */ +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectAzureResourceIds") model AnalyzeConversationAuthoringDeleteDeploymentOptions { /** - * Represents the resource IDs to delete the deployment from. If not provided, the deployment will be rolled out from all the resources it is deployed to. If provided, it will delete the deployment only from the specified assigned resources, and leave it for the rest. + * Represents the Language or AIService resource IDs to unassign from the project or delete the deployment from. */ assignedResourceIds?: string[]; } @@ -1000,7 +1003,8 @@ model AnalyzeConversationAuthoringLoadSnapshotJobState { /** * Represents the assigned deployment resources. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_01) +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringDeploymentResourcesInfoList") model AnalyzeConversationAuthoringAssignedDeploymentResources { /** * The list of assigned deployment resources. @@ -1014,39 +1018,43 @@ model AnalyzeConversationAuthoringAssignedDeploymentResources { } /** - * Represents the assigned deployment resource. + * Represents the assigned project resource. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_01) @resource("resources") @parentResource(AnalyzeConversationAuthoringProjectMetadata) +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectResourceInfo") model AnalyzeConversationAuthoringAssignedDeploymentResource { /** - * The resource ID. + * The Azure resource ID of the language or AI resource. */ @key @visibility(Lifecycle.Read) azureResourceId: string; /** - * The resource region. + * The Azure resource region. */ region: string; } /** - * Represents the options for assigning Azure resources to a project. + * Represents the payload for assigning Azure resources to a project. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_01) +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectResourceAssignments") model AnalyzeConversationAuthoringAssignDeploymentResourcesOptions { /** - * Represents the metadata for the resources to be assigned. + * Represents the metadata for the project resources to be assigned. */ + @renamedFrom(Versions.v2025_11_15_preview, "projectResources") resourcesMetadata: AnalyzeConversationAuthoringResourceMetadata[]; } /** * Represents metadata for the Azure resource.. */ +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectResourceAssignmentInfo") model AnalyzeConversationAuthoringResourceMetadata { /** * Represents the Azure resource ID. @@ -1067,7 +1075,7 @@ model AnalyzeConversationAuthoringResourceMetadata { /** * Represents the options to unassign Azure resources from a project. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions { /** * Represents the assigned resource IDs to be unassigned. @@ -1076,11 +1084,12 @@ model AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions { } /** - * Represents the state of a deployment resources job. + * Represents the state of a project resources job. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_01) @resource("resources/assign/jobs") @parentResource(AnalyzeConversationAuthoringProjectMetadata) +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectResourcesJobState") model AnalyzeConversationAuthoringDeploymentResourcesJobState { ...AnalyzeConversationAuthoringJobState; } @@ -1141,7 +1150,7 @@ model AnalyzeConversationAuthoringTrainingJobResult { /** * Represents the model data generation status. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) dataGenerationStatus: AnalyzeConversationAuthoringSubTrainingJobState; /** @@ -1190,7 +1199,7 @@ model AnalyzeConversationAuthoringProjectDeletionJobState { /** * Represents the metadata for deployments assigned to a resource. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_01) model AnalyzeConversationAuthoringAssignedResourceDeploymentsMetadata { /** * The list of retrieved assigned project deployments. @@ -1206,7 +1215,7 @@ model AnalyzeConversationAuthoringAssignedResourceDeploymentsMetadata { /** * Represents the metadata for assigned deployments for a project. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_01) @resource("authoring/analyze-conversations/projects/global/deployments/resources") model AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata { /** @@ -1225,7 +1234,7 @@ model AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata { /** * Represents the metadata for an assigned deployment */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_01) model AnalyzeConversationAuthoringAssignedProjectDeploymentMetadata { /** * Represents the deployment name. @@ -1359,7 +1368,7 @@ model AnalyzeConversationAuthoringConversationExportedEntity { /** * The entity description. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) description?: string; /** @@ -1480,20 +1489,20 @@ model AnalyzeConversationAuthoringConversationExportedIntent { /** * The intent description. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) description?: string; /** * The list of associated entities. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) associatedEntities?: AnalyzeConversationExportedAssociatedEntityLabel[]; } /** * Represents an associated entity label for an intent. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationExportedAssociatedEntityLabel { /** * The category of the entity label. @@ -1743,7 +1752,7 @@ model AnalyzeConversationAuthoringOrchestrationExportedIntent { /** * The intent description. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) description?: string; } @@ -1834,7 +1843,7 @@ model AnalyzeConversationAuthoringExportedTrainedModel { /** * Represents the state of a job to create or updated an exported model. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_15_preview) @resource("jobs") @parentResource(AnalyzeConversationAuthoringExportedTrainedModel) model AnalyzeConversationAuthoringExportedModelJobState { @@ -1843,7 +1852,7 @@ model AnalyzeConversationAuthoringExportedModelJobState { /** * Represents the properties for the model file. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringModelFile { /** * The name of the file. @@ -1858,7 +1867,7 @@ model AnalyzeConversationAuthoringModelFile { /** * Represents the options for creating or replacing an exported model. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_15_preview) model ExportedModelOptions { /** * The trained model label. @@ -1870,7 +1879,7 @@ model ExportedModelOptions { * Represents the connection kind for Azure OpenAI deployment. */ #suppress "@azure-tools/typespec-azure-core/documentation-required" -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) union AnalyzeConversationAuthoringDataGenerationConnectionKind { string, AzureOpenAI: "AzureOpenAI", @@ -1879,7 +1888,7 @@ union AnalyzeConversationAuthoringDataGenerationConnectionKind { /** * Represents the connection info for the Azure resource to use during data generation. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringDataGenerationConnectionInfo { /** * Connection type for data generation settings. Currently only supports Azure OpenAI. @@ -1901,7 +1910,7 @@ model AnalyzeConversationAuthoringDataGenerationConnectionInfo { /** * Settings to enable data generation for training augmentation. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringDataGenerationSettings { /** * Must be explicitly set to True to enable data generation to augment training data. diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp index bb229906a122..9a470a2f2062 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp @@ -56,17 +56,18 @@ op conversationAuthoringListSupportedLanguages is languageOperations.ResourceLis * Lists the deployments to which an Azure resource is assigned. This doesn't return deployments belonging to projects owned by this resource. It only returns deployments belonging to projects owned by other resources. */ #suppress "@azure-tools/typespec-azure-core/use-standard-names" -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_01) op conversationAuthoringListAssignedResourceDeployments is languageOperations.ResourceList< AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata, ListQueryParametersTrait >; /** - * Lists the deployments resources assigned to the project. + * Lists the Language or AIService resources assigned to the project. */ #suppress "@azure-tools/typespec-azure-core/use-standard-names" -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_01) +@renamedFrom(Versions.v2025_11_15_preview, "conversationAuthoringListProjectResources") op conversationAuthoringListDeploymentResources is languageOperations.ResourceList< AnalyzeConversationAuthoringAssignedDeploymentResource, ListQueryParametersTrait @@ -114,7 +115,7 @@ op conversationAuthoringListTrainedModels is languageOperations.ResourceList< * Lists the exported models belonging to a project. */ #suppress "@azure-tools/typespec-azure-core/use-standard-names" -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_11_15_preview) op conversationAuthoringListExportedModels is languageOperations.ResourceList< AnalyzeConversationAuthoringExportedTrainedModel, ListQueryParametersTrait @@ -191,7 +192,7 @@ interface ConversationAuthoringDeployment { >; /** - * Deletes a project deployment from the specified assigned resources. + * Deletes a deployment from the specified project-assigned resources. */ #suppress "@azure-tools/typespec-azure-core/use-standard-operations" @route("/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/:delete-from-resources") @@ -200,7 +201,7 @@ interface ConversationAuthoringDeployment { ConversationAuthoringDeployment.getDeploymentDeleteFromResourcesStatus ) @access(Access.internal, "python") - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_01) deleteDeploymentFromResources is Foundations.LongRunningOperation< { /** @@ -217,7 +218,7 @@ interface ConversationAuthoringDeployment { deploymentName: string; /** - * The options for deleting the deployment. + * The Language or AIService resource list for deleting the deployment.\r\n The deployment will only be deleted from the specified resources, and will remain for the rest. */ @body @clientName("details", "csharp") @@ -231,7 +232,7 @@ interface ConversationAuthoringDeployment { /** * Gets the status of an existing delete deployment from specific resources job. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_01) getDeploymentDeleteFromResourcesStatus is languageOperations.ResourceRead; /** @@ -242,7 +243,7 @@ interface ConversationAuthoringDeployment { interface ConversationAuthoringProject { /** - * Assign new Azure resources to a project to allow deploying new deployments to them. This API is available only via AAD authentication and not supported via subscription key authentication. For more details about AAD authentication, check here: https://learn.microsoft.com/en-us/azure/cognitive-services/authentication?tabs=powershell#authenticate-with-azure-active-directory + * Assign new Language or AIService Azure resources to a project to allowing deployment to them. This API is available only via AAD authentication and not supported via subscription key authentication. For more details about AAD authentication, check here: https://learn.microsoft.com/en-us/azure/cognitive-services/authentication?tabs=powershell#authenticate-with-azure-active-directory */ #suppress "@azure-tools/typespec-azure-core/use-standard-operations" @route("/authoring/analyze-conversations/projects/{projectName}/resources/:assign") @@ -251,7 +252,8 @@ interface ConversationAuthoringProject { ConversationAuthoringProject.getAssignDeploymentResourcesStatus ) @access(Access.internal, "python") - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_01) + @renamedFrom(Versions.v2025_11_15_preview, "assignProjectResources") assignDeploymentResources is Foundations.LongRunningOperation< { /** @@ -262,7 +264,7 @@ interface ConversationAuthoringProject { projectName: string; /** - * The new project resources info. + * The new project resources to be assigned. */ @body @clientName("details", "csharp") @@ -274,7 +276,7 @@ interface ConversationAuthoringProject { >; /** - * Unassign resources from a project. This disallows deploying new deployments to these resources, and deletes existing deployments assigned to them. + * Unassign resources from a project. This disallows deployment to these resources. */ #suppress "@azure-tools/typespec-azure-core/use-standard-operations" @route("/authoring/analyze-conversations/projects/{projectName}/resources/:unassign") @@ -283,7 +285,8 @@ interface ConversationAuthoringProject { ConversationAuthoringProject.getUnassignDeploymentResourcesStatus ) @access(Access.internal, "python") - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_01) + @renamedFrom(Versions.v2025_11_15_preview, "unassignProjectResources") unassignDeploymentResources is Foundations.LongRunningOperation< { /** @@ -294,10 +297,11 @@ interface ConversationAuthoringProject { projectName: string; /** - * The info for the deployment resources to be deleted. + * The list of Language or AIService Azure resource IDs to be unassigned. */ @body @clientName("details", "csharp") + @typeChangedFrom(Versions.v2025_11_15_preview, AnalyzeConversationAuthoringDeleteDeploymentOptions) body: AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions; }, AcceptedResponse, @@ -306,18 +310,20 @@ interface ConversationAuthoringProject { >; /** - * Gets the status of an existing assign deployment resources job. + * Gets the status of an existing assign project resources job. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_01) + @renamedFrom(Versions.v2025_11_15_preview, "getAssignProjectResourcesStatus") getAssignDeploymentResourcesStatus is languageOperations.ResourceRead; /** - * Gets the status of an existing unassign deployment resources job. + * Gets the status of an existing unassign project resources job. */ #suppress "@azure-tools/typespec-azure-core/use-standard-operations" @route("/authoring/analyze-conversations/projects/{projectName}/resources/unassign/jobs/{jobId}") @get - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_01) + @renamedFrom(Versions.v2025_11_15_preview, "getUnassignProjectResourcesStatus") getUnassignDeploymentResourcesStatus is Azure.Core.Foundations.Operation< { /** @@ -535,7 +541,7 @@ interface ConversationAuthoringProject { */ #suppress "@azure-tools/typespec-azure-core/casing-style" @post - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) @actionSeparator("/:") @action("authorize-copy") copyProjectAuthorization is languageOperations.ResourceAction< @@ -552,7 +558,7 @@ interface ConversationAuthoringProject { @post @pollingOperation(ConversationAuthoringProject.getCopyProjectStatus) @access(Access.internal, "python") - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) copyProject is Foundations.LongRunningOperation< { /** @@ -577,7 +583,7 @@ interface ConversationAuthoringProject { /** * Gets the status of an existing copy project job. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) getCopyProjectStatus is languageOperations.ResourceRead; /** @@ -645,7 +651,7 @@ interface ConversationAuthoringExportedModel { /** * Gets the details of an exported model. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) getExportedModel is languageOperations.ResourceRead; /** @@ -657,7 +663,7 @@ interface ConversationAuthoringExportedModel { @pollingOperation( ConversationAuthoringExportedModel.getExportedModelJobStatus ) - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) @access(Access.internal, "python") deleteExportedModel is Foundations.LongRunningOperation< { @@ -686,7 +692,7 @@ interface ConversationAuthoringExportedModel { @pollingOperation( ConversationAuthoringExportedModel.getExportedModelJobStatus ) - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) @access(Access.internal, "python") createOrUpdateExportedModel is Foundations.LongRunningOperation< { @@ -716,7 +722,7 @@ interface ConversationAuthoringExportedModel { /** * Gets the status for an existing job to create or update an exported model. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) getExportedModelJobStatus is languageOperations.ResourceRead; } interface ConversationAuthoringTrainedModel { @@ -737,7 +743,7 @@ interface ConversationAuthoringTrainedModel { @route("/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/:evaluate") @post @pollingOperation(ConversationAuthoringTrainedModel.getEvaluationStatus) - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) evaluateModel is Foundations.LongRunningOperation< { /** @@ -795,7 +801,7 @@ interface ConversationAuthoringTrainedModel { /** * Gets the status for an evaluation job. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_11_15_preview) getEvaluationStatus is languageOperations.ResourceRead; /** diff --git a/specification/cognitiveservices/data-plane/Language/preview/2025-05-15-preview/analyzeconversations-authoring.json b/specification/cognitiveservices/data-plane/Language/preview/2025-05-15-preview/analyzeconversations-authoring.json index 806f790ea8c3..ac2484ac6dba 100644 --- a/specification/cognitiveservices/data-plane/Language/preview/2025-05-15-preview/analyzeconversations-authoring.json +++ b/specification/cognitiveservices/data-plane/Language/preview/2025-05-15-preview/analyzeconversations-authoring.json @@ -915,7 +915,7 @@ "/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/:delete-from-resources": { "post": { "operationId": "ConversationAuthoringDeployment_DeleteDeploymentFromResources", - "description": "Deletes a project deployment from the specified assigned resources.", + "description": "Deletes a deployment from the specified project-assigned resources.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -938,7 +938,7 @@ { "name": "body", "in": "body", - "description": "The options for deleting the deployment.", + "description": "The Language or AIService resource list for deleting the deployment.\\r\\n The deployment will only be deleted from the specified resources, and will remain for the rest.", "required": true, "schema": { "$ref": "#/definitions/AnalyzeConversationAuthoringDeleteDeploymentOptions" @@ -2094,7 +2094,7 @@ "/authoring/analyze-conversations/projects/{projectName}/resources": { "get": { "operationId": "ConversationAuthoringListDeploymentResources", - "description": "Lists the deployments resources assigned to the project.", + "description": "Lists the Language or AIService resources assigned to the project.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -2150,7 +2150,7 @@ "/authoring/analyze-conversations/projects/{projectName}/resources/:assign": { "post": { "operationId": "ConversationAuthoringProject_AssignDeploymentResources", - "description": "Assign new Azure resources to a project to allow deploying new deployments to them. This API is available only via AAD authentication and not supported via subscription key authentication. For more details about AAD authentication, check here: https://learn.microsoft.com/en-us/azure/cognitive-services/authentication?tabs=powershell#authenticate-with-azure-active-directory", + "description": "Assign new Language or AIService Azure resources to a project to allowing deployment to them. This API is available only via AAD authentication and not supported via subscription key authentication. For more details about AAD authentication, check here: https://learn.microsoft.com/en-us/azure/cognitive-services/authentication?tabs=powershell#authenticate-with-azure-active-directory", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -2166,7 +2166,7 @@ { "name": "body", "in": "body", - "description": "The new project resources info.", + "description": "The new project resources to be assigned.", "required": true, "schema": { "$ref": "#/definitions/AnalyzeConversationAuthoringAssignDeploymentResourcesOptions" @@ -2208,7 +2208,7 @@ "/authoring/analyze-conversations/projects/{projectName}/resources/:unassign": { "post": { "operationId": "ConversationAuthoringProject_UnassignDeploymentResources", - "description": "Unassign resources from a project. This disallows deploying new deployments to these resources, and deletes existing deployments assigned to them.", + "description": "Unassign resources from a project. This disallows deployment to these resources.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -2224,7 +2224,7 @@ { "name": "body", "in": "body", - "description": "The info for the deployment resources to be deleted.", + "description": "The list of Language or AIService Azure resource IDs to be unassigned.", "required": true, "schema": { "$ref": "#/definitions/AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions" @@ -2266,7 +2266,7 @@ "/authoring/analyze-conversations/projects/{projectName}/resources/assign/jobs/{jobId}": { "get": { "operationId": "ConversationAuthoringProject_GetAssignDeploymentResourcesStatus", - "description": "Gets the status of an existing assign deployment resources job.", + "description": "Gets the status of an existing assign project resources job.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -2317,7 +2317,7 @@ "/authoring/analyze-conversations/projects/{projectName}/resources/unassign/jobs/{jobId}": { "get": { "operationId": "ConversationAuthoringProject_GetUnassignDeploymentResourcesStatus", - "description": "Gets the status of an existing unassign deployment resources job.", + "description": "Gets the status of an existing unassign project resources job.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -2779,11 +2779,11 @@ "definitions": { "AnalyzeConversationAuthoringAssignDeploymentResourcesOptions": { "type": "object", - "description": "Represents the options for assigning Azure resources to a project.", + "description": "Represents the payload for assigning Azure resources to a project.", "properties": { "resourcesMetadata": { "type": "array", - "description": "Represents the metadata for the resources to be assigned.", + "description": "Represents the metadata for the project resources to be assigned.", "items": { "$ref": "#/definitions/AnalyzeConversationAuthoringResourceMetadata" } @@ -2795,16 +2795,16 @@ }, "AnalyzeConversationAuthoringAssignedDeploymentResource": { "type": "object", - "description": "Represents the assigned deployment resource.", + "description": "Represents the assigned project resource.", "properties": { "azureResourceId": { "type": "string", - "description": "The resource ID.", + "description": "The Azure resource ID of the language or AI resource.", "readOnly": true }, "region": { "type": "string", - "description": "The resource region." + "description": "The Azure resource region." } }, "required": [ @@ -3246,11 +3246,11 @@ }, "AnalyzeConversationAuthoringDeleteDeploymentOptions": { "type": "object", - "description": "Represents the options for deleting a project deployment.", + "description": "Represents the payload for deleting a project deployment.", "properties": { "assignedResourceIds": { "type": "array", - "description": "Represents the resource IDs to delete the deployment from. If not provided, the deployment will be rolled out from all the resources it is deployed to. If provided, it will delete the deployment only from the specified assigned resources, and leave it for the rest.", + "description": "Represents the Language or AIService resource IDs to unassign from the project or delete the deployment from.", "items": { "type": "string" } @@ -3381,7 +3381,7 @@ }, "AnalyzeConversationAuthoringDeploymentResourcesJobState": { "type": "object", - "description": "Represents the state of a deployment resources job.", + "description": "Represents the state of a project resources job.", "properties": { "jobId": { "type": "string", diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/analyzeconversations-authoring.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/analyzeconversations-authoring.json new file mode 100644 index 000000000000..d64ee4cffdcd --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/analyzeconversations-authoring.json @@ -0,0 +1,4675 @@ +{ + "swagger": "2.0", + "info": { + "title": "Microsoft Cognitive Language Service - Analyze Conversations Authoring", + "version": "2025-11-01", + "description": "The language service API is a suite of natural language processing (NLP) skills built with best-in-class Microsoft machine learning algorithms. The API can be used to analyze unstructured text for tasks such as sentiment analysis, key phrase extraction, language detection and question answering. Further documentation can be found in https://learn.microsoft.com/en-us/azure/cognitive-services/language-service/overview.", + "x-typespec-generated": [ + { + "emitter": "@azure-tools/typespec-autorest" + } + ] + }, + "schemes": [ + "https" + ], + "x-ms-parameterized-host": { + "hostTemplate": "{Endpoint}/language", + "useSchemePrefix": false, + "parameters": [ + { + "name": "Endpoint", + "in": "path", + "description": "Supported Cognitive Services endpoint e.g., https://.api.cognitiveservices.azure.com.", + "required": true, + "type": "string", + "format": "uri", + "x-ms-skip-url-encoding": true + } + ] + }, + "produces": [ + "application/json" + ], + "consumes": [ + "application/json" + ], + "security": [ + { + "ApiKeyAuth": [] + }, + { + "OAuth2Auth": [ + "https://cognitiveservices.azure.com/.default" + ] + } + ], + "securityDefinitions": { + "ApiKeyAuth": { + "type": "apiKey", + "name": "Ocp-Apim-Subscription-Key", + "in": "header" + }, + "OAuth2Auth": { + "type": "oauth2", + "flow": "accessCode", + "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", + "scopes": { + "https://cognitiveservices.azure.com/.default": "" + }, + "tokenUrl": "https://login.microsoftonline.com/common/oauth2/token" + } + }, + "tags": [], + "paths": { + "/authoring/analyze-conversations/projects": { + "get": { + "operationId": "ConversationAuthoringListProjects", + "description": "Lists the existing projects.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringProjectMetadata" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful List Projects": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListProjects.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}": { + "get": { + "operationId": "ConversationAuthoringProject_GetProject", + "description": "Gets the details of a project.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectMetadata" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetProject.json" + } + } + }, + "patch": { + "operationId": "ConversationAuthoringProject_CreateProject", + "description": "Creates a new project or updates an existing one.", + "consumes": [ + "application/merge-patch+json" + ], + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "body", + "in": "body", + "description": "The request body", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringCreateProjectOptions" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectMetadata" + } + }, + "201": { + "description": "The request has succeeded and a new resource has been created as a result.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectMetadata" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Create Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulCreateProject.json" + } + } + }, + "delete": { + "operationId": "ConversationAuthoringProject_DeleteProject", + "description": "Deletes a project.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Delete Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeleteProject.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/:export": { + "post": { + "operationId": "ConversationAuthoringProject_Export", + "description": "Triggers a job to export a project's data.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "format", + "in": "query", + "description": "The format of the exported project file to use.", + "required": false, + "type": "string", + "enum": [ + "Conversation", + "Luis" + ], + "x-ms-enum": { + "name": "ExportedProjectFormat", + "modelAsString": true, + "values": [ + { + "name": "Conversation", + "value": "Conversation", + "description": "Specifies the format for a conversational project." + }, + { + "name": "Luis", + "value": "Luis", + "description": "Specifies the format for an application that was exported from LUIS." + } + ] + }, + "x-ms-client-name": "ExportedProjectFormat" + }, + { + "name": "stringIndexType", + "in": "query", + "description": "Specifies the method used to interpret string offsets. For additional information see https://aka.ms/text-analytics-offsets.", + "required": true, + "type": "string", + "enum": [ + "Utf16CodeUnit", + "Utf8CodeUnit", + "Utf32CodeUnit" + ], + "x-ms-enum": { + "name": "StringIndexType", + "modelAsString": true, + "values": [ + { + "name": "Utf16CodeUnit", + "value": "Utf16CodeUnit", + "description": "The offset and length values will correspond to UTF-16 code units. Use this option if your application is written in a language that support Unicode, for example Java, JavaScript." + }, + { + "name": "Utf8CodeUnit", + "value": "Utf8CodeUnit" + }, + { + "name": "Utf32CodeUnit", + "value": "Utf32CodeUnit" + } + ] + } + }, + { + "name": "assetKind", + "in": "query", + "description": "Kind of asset to export.", + "required": false, + "type": "string" + }, + { + "name": "trainedModelLabel", + "in": "query", + "description": "Trained model label to export. If the trainedModelLabel is null, the default behavior is to export the current working copy.", + "required": false, + "type": "string" + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Export Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulExportProject.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/:import": { + "post": { + "operationId": "ConversationAuthoringProject_Import", + "description": "Triggers a job to import a project. If a project with the same name already exists, the data of that project is replaced.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "format", + "in": "query", + "description": "The format of the exported project file to use.", + "required": false, + "type": "string", + "enum": [ + "Conversation", + "Luis" + ], + "x-ms-enum": { + "name": "ExportedProjectFormat", + "modelAsString": true, + "values": [ + { + "name": "Conversation", + "value": "Conversation", + "description": "Specifies the format for a conversational project." + }, + { + "name": "Luis", + "value": "Luis", + "description": "Specifies the format for an application that was exported from LUIS." + } + ] + }, + "x-ms-client-name": "ExportedProjectFormat" + }, + { + "name": "body", + "in": "body", + "description": "The project data to import.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedProject" + } + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Import Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulImportProject.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/:train": { + "post": { + "operationId": "ConversationAuthoringProject_Train", + "description": "Triggers a training job for a project.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "body", + "in": "body", + "description": "The training input parameters.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringTrainingJobOptions" + } + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Train Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulTrainProject.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/deployments": { + "get": { + "operationId": "ConversationAuthoringListDeployments", + "description": "Lists the deployments belonging to a project.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringProjectDeployment" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful List Deployments": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListDeployments.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}": { + "get": { + "operationId": "ConversationAuthoringDeployment_GetDeployment", + "description": "Gets the details of a deployment.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "deploymentName", + "in": "path", + "description": "Represents deployment name.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectDeployment" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Deployment": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetDeployment.json" + } + } + }, + "put": { + "operationId": "ConversationAuthoringDeployment_DeployProject", + "description": "Creates a new deployment or replaces an existing one.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "deploymentName", + "in": "path", + "description": "The name of the specific deployment of the project to use.", + "required": true, + "type": "string" + }, + { + "name": "body", + "in": "body", + "description": "The new deployment info.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringCreateDeploymentOptions" + } + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Deploy Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeployProject.json" + } + }, + "x-ms-long-running-operation": true + }, + "delete": { + "operationId": "ConversationAuthoringDeployment_DeleteDeployment", + "description": "Deletes a project deployment.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "deploymentName", + "in": "path", + "description": "The name of the specific deployment of the project to use.", + "required": true, + "type": "string" + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Delete Deployment": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeleteDeployment.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/:delete-from-resources": { + "post": { + "operationId": "ConversationAuthoringDeployment_DeleteDeploymentFromResources", + "description": "Deletes a deployment from the specified project-assigned resources.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "deploymentName", + "in": "path", + "description": "The name of the specific deployment of the project to use.", + "required": true, + "type": "string" + }, + { + "name": "body", + "in": "body", + "description": "The Language or AIService resource list for deleting the deployment.\\r\\n The deployment will only be deleted from the specified resources, and will remain for the rest.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectAzureResourceIds" + } + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Delete Deployment From Resources": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/delete-from-resources/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringDeployment_GetDeploymentDeleteFromResourcesStatus", + "description": "Gets the status of an existing delete deployment from specific resources job.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "deploymentName", + "in": "path", + "description": "Represents deployment name.", + "required": true, + "type": "string" + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentDeleteFromResourcesJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Deployment Delete From Resources Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringDeployment_GetDeploymentStatus", + "description": "Gets the status of an existing deployment job.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "deploymentName", + "in": "path", + "description": "Represents deployment name.", + "required": true, + "type": "string" + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Deployment Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/deployments/:swap": { + "post": { + "operationId": "ConversationAuthoringProject_SwapDeployments", + "description": "Swaps two existing deployments with each other.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "body", + "in": "body", + "description": "The job object to swap two deployments.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringSwapDeploymentsOptions" + } + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Swap Deployments": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulSwapDeployments.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/deployments/swap/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetSwapDeploymentsStatus", + "description": "Gets the status of an existing swap deployment job.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringSwapDeploymentsJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Swap Deployments Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/export/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetExportStatus", + "description": "Gets the status of an export job. Once job completes, returns the project metadata, and assets.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportProjectJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Export Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetExportStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/import/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetImportStatus", + "description": "Gets the status for an import.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringImportProjectJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Import Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetImportStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/models": { + "get": { + "operationId": "ConversationAuthoringListTrainedModels", + "description": "Lists the trained models belonging to a project.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringProjectTrainedModel" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful List Models": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListModels.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}": { + "get": { + "operationId": "ConversationAuthoringTrainedModel_GetTrainedModel", + "description": "Gets the details of a trained model.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "trainedModelLabel", + "in": "path", + "description": "The trained model label.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectTrainedModel" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Model": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetModel.json" + } + } + }, + "delete": { + "operationId": "ConversationAuthoringTrainedModel_DeleteTrainedModel", + "description": "Deletes an existing trained model.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "trainedModelLabel", + "in": "path", + "description": "The trained model label.", + "required": true, + "type": "string" + } + ], + "responses": { + "204": { + "description": "There is no content to send for this request, but the headers may be useful. " + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Delete Model": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeleteModel.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/:load-snapshot": { + "post": { + "operationId": "ConversationAuthoringTrainedModel_LoadSnapshot", + "description": "Restores the snapshot of this trained model to be the current working directory of the project.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "trainedModelLabel", + "in": "path", + "description": "The trained model label.", + "required": true, + "type": "string" + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Load Snapshot": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulLoadSnapshot.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluation/result": { + "get": { + "operationId": "ConversationAuthoringTrainedModel_GetModelEvaluationResults", + "description": "Gets the detailed results of the evaluation for a trained model. This includes the raw inference results for the data included in the evaluation process.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "trainedModelLabel", + "in": "path", + "description": "The trained model label.", + "required": true, + "type": "string" + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + }, + { + "$ref": "#/parameters/StringIndexTypeQueryParameter" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringUtteranceEvaluationResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Model Evaluation": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluation/summary-result": { + "get": { + "operationId": "ConversationAuthoringTrainedModel_GetModelEvaluationSummary", + "description": "Gets the evaluation summary of a trained model. The summary includes high level performance measurements of the model e.g., F1, Precision, Recall, etc.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "trainedModelLabel", + "in": "path", + "description": "The trained model label.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringEvaluationSummary" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Model Evaluation Summary": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/load-snapshot/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringTrainedModel_GetLoadSnapshotStatus", + "description": "Gets the status for loading a snapshot.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "trainedModelLabel", + "in": "path", + "description": "The trained model label.", + "required": true, + "type": "string" + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringLoadSnapshotJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Load Snapshot Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/resources": { + "get": { + "operationId": "ConversationAuthoringListProjectResources", + "description": "Lists the Language or AIService resources assigned to the project.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringProjectResourceInfo" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/resources/:assign": { + "post": { + "operationId": "ConversationAuthoringProject_AssignProjectResources", + "description": "Assign new Language or AIService Azure resources to a project to allowing deployment to them. This API is available only via AAD authentication and not supported via subscription key authentication. For more details about AAD authentication, check here: https://learn.microsoft.com/en-us/azure/cognitive-services/authentication?tabs=powershell#authenticate-with-azure-active-directory", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "body", + "in": "body", + "description": "The new project resources to be assigned.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourceAssignments" + } + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Assign Project Resources": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulAssignProjectResources.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/resources/:unassign": { + "post": { + "operationId": "ConversationAuthoringProject_UnassignProjectResources", + "description": "Unassign resources from a project. This disallows deployment to these resources.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "body", + "in": "body", + "description": "The list of Language or AIService Azure resource IDs to be unassigned.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectAzureResourceIds" + } + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Unassign Project Resources": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/resources/assign/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetAssignProjectResourcesStatus", + "description": "Gets the status of an existing assign project resources job.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourcesJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Assign Project Resources Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/resources/unassign/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetUnassignProjectResourcesStatus", + "description": "Gets the status of an existing unassign project resources job.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourcesJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Unassign Project Resources Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/train/jobs": { + "get": { + "operationId": "ConversationAuthoringListTrainingJobs", + "description": "Lists the non-expired training jobs created for a project.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringTrainingJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful List Training Jobs": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListTrainingJobs.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/train/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetTrainingStatus", + "description": "Gets the status for a training job.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringTrainingJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Train Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetTrainStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/train/jobs/{jobId}/:cancel": { + "post": { + "operationId": "ConversationAuthoringProject_CancelTrainingJob", + "description": "Triggers a cancellation for a running training job.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "202": { + "description": "The request has been accepted for processing, but processing has not yet completed.", + "headers": { + "Operation-Location": { + "type": "string", + "format": "uri", + "description": "The location for monitoring the operation state." + } + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Cancel Training Job": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json" + } + }, + "x-ms-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/global/deletion-jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetProjectDeletionStatus", + "description": "Gets the status for a project deletion job.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "jobId", + "in": "path", + "description": "The job ID.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectDeletionJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Project Deletion Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json" + } + } + } + }, + "/authoring/analyze-conversations/projects/global/deployments/resources": { + "get": { + "operationId": "ConversationAuthoringListAssignedResourceDeployments", + "description": "Lists the deployments to which an Azure resource is assigned. This doesn't return deployments belonging to projects owned by this resource. It only returns deployments belonging to projects owned by other resources.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful List Assigned Resource Deployments": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/authoring/analyze-conversations/projects/global/languages": { + "get": { + "operationId": "ConversationAuthoringListSupportedLanguages", + "description": "Lists the supported languages for the given project type.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + }, + { + "$ref": "#/parameters/ProjectKindQueryParameter" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringSupportedLanguage" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Supported Languages": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/authoring/analyze-conversations/projects/global/prebuilt-entities": { + "get": { + "operationId": "ConversationAuthoringListSupportedPrebuiltEntities", + "description": "Lists the supported prebuilt entities that can be used while creating composed entities.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + }, + { + "$ref": "#/parameters/SupportedPrebuiltEntitiesQueryParameter.language" + }, + { + "$ref": "#/parameters/SupportedPrebuiltEntitiesQueryParameter.multilingual" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringPrebuiltEntity" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Supported Prebuilt Entities": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + }, + "/authoring/analyze-conversations/projects/global/training-config-versions": { + "get": { + "operationId": "ConversationAuthoringListTrainingConfigVersions", + "description": "Lists the support training config version for a given project type.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "$ref": "#/parameters/Azure.Core.TopQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.SkipQueryParameter" + }, + { + "$ref": "#/parameters/Azure.Core.MaxPageSizeQueryParameter" + }, + { + "$ref": "#/parameters/ProjectKindQueryParameter" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringTrainingConfigVersion" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/Azure.Core.Foundations.ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } + } + } + }, + "x-ms-examples": { + "Successful Get Supported Training Config Versions": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json" + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + } + } + } + }, + "definitions": { + "AnalyzeConversationAuthoringAssignedProjectDeploymentMetadata": { + "type": "object", + "description": "Represents the metadata for an assigned deployment", + "properties": { + "deploymentName": { + "type": "string", + "description": "Represents the deployment name." + }, + "lastDeployedDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents deployment last deployed time." + }, + "deploymentExpirationDate": { + "type": "string", + "format": "date", + "description": "Represents deployment expiration date in the runtime." + } + }, + "required": [ + "deploymentName", + "lastDeployedDateTime", + "deploymentExpirationDate" + ] + }, + "AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata": { + "type": "object", + "description": "Represents the metadata for assigned deployments for a project.", + "properties": { + "projectName": { + "type": "string", + "description": "Represents the project name.", + "readOnly": true + }, + "deploymentsMetadata": { + "type": "array", + "description": "Represents the resource region.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringAssignedProjectDeploymentMetadata" + } + } + }, + "required": [ + "projectName", + "deploymentsMetadata" + ] + }, + "AnalyzeConversationAuthoringConfusionMatrixCell": { + "type": "object", + "description": "Represents a cell in a confusion matrix.", + "properties": { + "normalizedValue": { + "type": "number", + "format": "float", + "description": "Represents normalized value in percentages." + }, + "rawValue": { + "type": "number", + "format": "float", + "description": "Represents raw value." + } + }, + "required": [ + "normalizedValue", + "rawValue" + ] + }, + "AnalyzeConversationAuthoringConfusionMatrixRow": { + "type": "object", + "additionalProperties": { + "$ref": "#/definitions/AnalyzeConversationAuthoringConfusionMatrixCell" + } + }, + "AnalyzeConversationAuthoringConversationExportedEntity": { + "type": "object", + "description": "Represents an entity with its components.", + "properties": { + "category": { + "type": "string", + "description": "The category of the entity." + }, + "compositionSetting": { + "$ref": "#/definitions/CompositionSetting", + "description": "The behavior to follow when the entity's components overlap with each other." + }, + "entities": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedEntityList", + "description": "The list component of the entity." + }, + "prebuilts": { + "type": "array", + "description": "The prebuilt entities components.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedPrebuiltEntity" + } + }, + "regex": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedEntityRegex", + "description": "The regex component of the entity." + }, + "requiredComponents": { + "type": "array", + "description": "The required components. Allowed values are 'learned', 'list', 'prebuilts' and 'regex'.", + "items": { + "type": "string" + } + } + }, + "required": [ + "category" + ] + }, + "AnalyzeConversationAuthoringConversationExportedIntent": { + "type": "object", + "description": "Represents an exported intent of a conversational project.", + "properties": { + "category": { + "type": "string", + "description": "The intent category." + } + }, + "required": [ + "category" + ] + }, + "AnalyzeConversationAuthoringConversationExportedProjectAsset": { + "type": "object", + "description": "Represents the exported assets of a conversational project.", + "properties": { + "intents": { + "type": "array", + "description": "The intents defined in the project.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringConversationExportedIntent" + } + }, + "entities": { + "type": "array", + "description": "The entities defined in the project.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringConversationExportedEntity" + } + }, + "utterances": { + "type": "array", + "description": "The utterances defined in the project.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringConversationExportedUtterance" + } + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedProjectAssets" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "AnalyzeConversationAuthoringConversationExportedUtterance": { + "type": "object", + "description": "Represents an exported utterance for a conversational project.", + "properties": { + "entities": { + "type": "array", + "description": "Represents the entity labels of the utterance.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedUtteranceEntityLabel" + } + }, + "text": { + "type": "string", + "description": "The utterance text." + }, + "language": { + "type": "string", + "description": "Represents the utterance's language. This is BCP-47 representation of a language. For example, use \"en\" for English, \"en-gb\" for English (UK), \"es\" for Spanish etc." + }, + "intent": { + "type": "string", + "description": "The intent of the utterance." + }, + "dataset": { + "$ref": "#/definitions/DatasetType", + "description": "The dataset for this utterance. Allowed values are 'Train' and 'Test'." + } + }, + "required": [ + "text", + "intent" + ] + }, + "AnalyzeConversationAuthoringCreateDeploymentOptions": { + "type": "object", + "description": "Represents the options for creating or updating a project deployment.", + "properties": { + "trainedModelLabel": { + "type": "string", + "description": "Represents the trained model label." + }, + "assignedResourceIds": { + "type": "array", + "description": "Represents the Language or AIService resource IDs that if provided,\\n the deployment will be rolled out to the resources provided here as well as the original resource in which the project is created.", + "items": { + "type": "string" + } + } + }, + "required": [ + "trainedModelLabel" + ] + }, + "AnalyzeConversationAuthoringCreateProjectOptions": { + "type": "object", + "description": "Represents the options used to create or update a project.", + "properties": { + "projectKind": { + "$ref": "#/definitions/ProjectKind", + "description": "Represents the project kind." + }, + "settings": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectSettings", + "description": "The project settings." + }, + "projectName": { + "type": "string", + "description": "The new project name." + }, + "multilingual": { + "type": "boolean", + "description": "Whether the project would be used for multiple languages or not." + }, + "description": { + "type": "string", + "description": "The project description." + }, + "language": { + "type": "string", + "description": "The project language. This is BCP-47 representation of a language. For example, use \"en\" for English, \"en-gb\" for English (UK), \"es\" for Spanish etc." + } + }, + "required": [ + "projectKind", + "projectName", + "language" + ] + }, + "AnalyzeConversationAuthoringDeploymentDeleteFromResourcesJobState": { + "type": "object", + "description": "Represents the state of an existing delete deployment from specific resources job.", + "properties": { + "jobId": { + "type": "string", + "description": "The job ID.", + "readOnly": true + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "The creation date time of the job." + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last date time the job was updated." + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "The expiration date time of the job." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "The job status." + }, + "warnings": { + "type": "array", + "description": "The warnings that were encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "errors": { + "type": "array", + "description": "The errors encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status" + ] + }, + "AnalyzeConversationAuthoringDeploymentJobState": { + "type": "object", + "description": "Represents the state of a deployment job.", + "properties": { + "jobId": { + "type": "string", + "description": "The job ID.", + "readOnly": true + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "The creation date time of the job." + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last date time the job was updated." + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "The expiration date time of the job." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "The job status." + }, + "warnings": { + "type": "array", + "description": "The warnings that were encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "errors": { + "type": "array", + "description": "The errors encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status" + ] + }, + "AnalyzeConversationAuthoringEntitiesEvaluationSummary": { + "type": "object", + "description": "Represents the evaluation result summary for the project's entities.", + "properties": { + "confusionMatrix": { + "type": "object", + "description": "Represents the confusion matrix between two entities (the two entities can be the same). The matrix is between the entity that was labelled and the entity that was predicted.", + "additionalProperties": { + "$ref": "#/definitions/AnalyzeConversationAuthoringConfusionMatrixRow" + } + }, + "entities": { + "type": "object", + "description": "Represents the entities evaluation summary.", + "additionalProperties": { + "$ref": "#/definitions/AnalyzeConversationAuthoringEntityEvaluationSummary" + } + }, + "microF1": { + "type": "number", + "format": "float", + "description": "Represents the micro F1. Expected value is a float between 0 and 1 inclusive." + }, + "microPrecision": { + "type": "number", + "format": "float", + "description": "Represents the micro precision. Expected value is a float between 0 and 1 inclusive." + }, + "microRecall": { + "type": "number", + "format": "float", + "description": "Represents the micro recall. Expected value is a float between 0 and 1 inclusive." + }, + "macroF1": { + "type": "number", + "format": "float", + "description": "Represents the macro F1. Expected value is a float between 0 and 1 inclusive." + }, + "macroPrecision": { + "type": "number", + "format": "float", + "description": "Represents the macro precision. Expected value is a float between 0 and 1 inclusive." + }, + "macroRecall": { + "type": "number", + "format": "float", + "description": "Represents the macro recall. Expected value is a float between 0 and 1 inclusive." + } + }, + "required": [ + "confusionMatrix", + "entities", + "microF1", + "microPrecision", + "microRecall", + "macroF1", + "macroPrecision", + "macroRecall" + ] + }, + "AnalyzeConversationAuthoringEntityEvaluationSummary": { + "type": "object", + "description": "Represents the evaluation result for an entity.", + "properties": { + "f1": { + "type": "number", + "format": "double", + "description": "Represents the model F1 score" + }, + "precision": { + "type": "number", + "format": "double", + "description": "Represents the model precision" + }, + "recall": { + "type": "number", + "format": "double", + "description": "Represents the model precision" + }, + "truePositiveCount": { + "type": "integer", + "format": "int32", + "description": "Represents the count of true positive" + }, + "trueNegativeCount": { + "type": "integer", + "format": "int32", + "description": "Represents the count of true negative" + }, + "falsePositiveCount": { + "type": "integer", + "format": "int32", + "description": "Represents the count of false positive" + }, + "falseNegativeCount": { + "type": "integer", + "format": "int32", + "description": "Represents the count of false negative" + } + }, + "required": [ + "f1", + "precision", + "recall", + "truePositiveCount", + "trueNegativeCount", + "falsePositiveCount", + "falseNegativeCount" + ] + }, + "AnalyzeConversationAuthoringEvaluationOptions": { + "type": "object", + "description": "Represents the options used running the evaluation.", + "properties": { + "kind": { + "$ref": "#/definitions/EvaluationKind", + "description": "Represents the evaluation kind. By default, the evaluation kind is set to percentage." + }, + "trainingSplitPercentage": { + "type": "integer", + "format": "int32", + "description": "Represents the training dataset split percentage. Only needed in case the evaluation kind is percentage." + }, + "testingSplitPercentage": { + "type": "integer", + "format": "int32", + "description": "Represents the testing dataset split percentage. Only needed in case the evaluation kind is percentage." + } + } + }, + "AnalyzeConversationAuthoringEvaluationSummary": { + "type": "object", + "description": "Represents the evaluation result summary.", + "properties": { + "entitiesEvaluation": { + "$ref": "#/definitions/AnalyzeConversationAuthoringEntitiesEvaluationSummary", + "description": "Contains the data related to entities evaluation." + }, + "intentsEvaluation": { + "$ref": "#/definitions/AnalyzeConversationAuthoringIntentsEvaluationSummary", + "description": "Contains the data related to intents evaluation." + }, + "evaluationOptions": { + "$ref": "#/definitions/AnalyzeConversationAuthoringEvaluationOptions", + "description": "The options that were used while running the evaluation." + } + }, + "required": [ + "entitiesEvaluation", + "intentsEvaluation" + ] + }, + "AnalyzeConversationAuthoringExportProjectJobState": { + "type": "object", + "description": "Represents the state of an export job.", + "properties": { + "jobId": { + "type": "string", + "description": "The job ID.", + "readOnly": true + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "The creation date time of the job." + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last date time the job was updated." + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "The expiration date time of the job." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "The job status." + }, + "warnings": { + "type": "array", + "description": "The warnings that were encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "errors": { + "type": "array", + "description": "The errors encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "resultUrl": { + "type": "string", + "description": "The URL to use in order to download the exported project." + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status" + ] + }, + "AnalyzeConversationAuthoringExportedConversationOrchestration": { + "type": "object", + "description": "Defines the orchestration details for a Conversational project target.", + "properties": { + "projectName": { + "type": "string", + "description": "The name of the targeted project." + }, + "deploymentName": { + "type": "string", + "description": "The name of the targeted deployment." + } + }, + "required": [ + "projectName", + "deploymentName" + ] + }, + "AnalyzeConversationAuthoringExportedConversationOrchestrationOptions": { + "type": "object", + "description": "Represents the orchestration options for a Conversational project target.", + "properties": { + "conversationOrchestration": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedConversationOrchestration", + "description": "The Conversational project target details." + } + }, + "required": [ + "conversationOrchestration" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedOrchestrationOptions" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "AnalyzeConversationAuthoringExportedEntityList": { + "type": "object", + "description": "Represents a list component of an entity.", + "properties": { + "sublists": { + "type": "array", + "description": "The sub-lists of the list component.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedEntitySublist" + } + } + } + }, + "AnalyzeConversationAuthoringExportedEntityListSynonym": { + "type": "object", + "description": "Represents a list of synonyms inside a list component", + "properties": { + "language": { + "type": "string", + "description": "Represents the language of the synonyms. This is BCP-47 representation of a language. For example, use \"en\" for English, \"en-gb\" for English (UK), \"es\" for Spanish etc." + }, + "values": { + "type": "array", + "description": "The list of synonyms.", + "items": { + "type": "string" + } + } + } + }, + "AnalyzeConversationAuthoringExportedEntityRegex": { + "type": "object", + "description": "Represents a regex component of an entity.", + "properties": { + "expressions": { + "type": "array", + "description": "The regex expressions of the regex component. These expressions follow the .NET regex syntax. For reference, check here: https://learn.microsoft.com/dotnet/standard/base-types/regular-expressions", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedEntityRegexExpression" + } + } + } + }, + "AnalyzeConversationAuthoringExportedEntityRegexExpression": { + "type": "object", + "description": "Represents a regex expression inside a regex component. This expression follows the .NET regex syntax. For reference, check here: https://learn.microsoft.com/dotnet/standard/base-types/regular-expressions", + "properties": { + "regexKey": { + "type": "string", + "description": "The key of the regex expression." + }, + "language": { + "type": "string", + "description": "Represents the language of the regex expression. This is BCP-47 representation of a language. For example, use \"en\" for English, \"en-gb\" for English (UK), \"es\" for Spanish etc." + }, + "regexPattern": { + "type": "string", + "description": "The regex pattern." + } + } + }, + "AnalyzeConversationAuthoringExportedEntitySublist": { + "type": "object", + "description": "Represents a sub-list inside a list component.", + "properties": { + "listKey": { + "type": "string", + "description": "The key of the sub-list." + }, + "synonyms": { + "type": "array", + "description": "The phrases of that correspond to the sub-list.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedEntityListSynonym" + } + } + } + }, + "AnalyzeConversationAuthoringExportedLuisOrchestration": { + "type": "object", + "description": "Defines the orchestration details for a LUIS application target.", + "properties": { + "appId": { + "$ref": "#/definitions/Azure.Core.uuid", + "description": "The LUIS application ID." + }, + "appVersion": { + "type": "string", + "description": "The targeted version Id." + }, + "slotName": { + "type": "string", + "description": "The targeted slot name." + } + }, + "required": [ + "appId" + ] + }, + "AnalyzeConversationAuthoringExportedLuisOrchestrationOptions": { + "type": "object", + "description": "Represents the orchestration options for a LUIS application target.", + "properties": { + "luisOrchestration": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedLuisOrchestration", + "description": "The LUIS application target details." + } + }, + "required": [ + "luisOrchestration" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedOrchestrationOptions" + } + ], + "x-ms-discriminator-value": "Luis" + }, + "AnalyzeConversationAuthoringExportedOrchestrationOptions": { + "type": "object", + "description": "Represents the options used to define the orchestration behavior of an intent.", + "properties": { + "targetProjectKind": { + "$ref": "#/definitions/OrchestrationTargetProjectKind" + } + }, + "discriminator": "targetProjectKind", + "required": [ + "targetProjectKind" + ] + }, + "AnalyzeConversationAuthoringExportedPrebuiltEntity": { + "type": "object", + "description": "Represents an exported prebuilt entity component", + "properties": { + "category": { + "type": "string", + "description": "The prebuilt entity category." + } + }, + "required": [ + "category" + ] + }, + "AnalyzeConversationAuthoringExportedProject": { + "type": "object", + "description": "Represents an exported project.", + "properties": { + "projectFileVersion": { + "type": "string", + "description": "The version of the exported file." + }, + "stringIndexType": { + "$ref": "#/definitions/StringIndexType", + "description": "Specifies the method used to interpret string offsets. For additional information see https://aka.ms/text-analytics-offsets." + }, + "metadata": { + "$ref": "#/definitions/AnalyzeConversationAuthoringCreateProjectOptions", + "description": "Represents the project metadata." + }, + "assets": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedProjectAssets", + "description": "Represents the project assets." + } + }, + "required": [ + "projectFileVersion", + "stringIndexType", + "metadata" + ] + }, + "AnalyzeConversationAuthoringExportedProjectAssets": { + "type": "object", + "description": "Represents the assets of an exported project.", + "properties": { + "projectKind": { + "$ref": "#/definitions/ProjectKind", + "description": "The type of project containing the assets." + } + }, + "discriminator": "projectKind", + "required": [ + "projectKind" + ] + }, + "AnalyzeConversationAuthoringExportedQuestionAnsweringOrchestration": { + "type": "object", + "description": "Defines the orchestration details for a Question Answering project target.", + "properties": { + "projectName": { + "type": "string", + "description": "The name of the target project." + } + }, + "required": [ + "projectName" + ] + }, + "AnalyzeConversationAuthoringExportedQuestionAnsweringOrchestrationOptions": { + "type": "object", + "description": "Represents the orchestration options for a Question Answering project target.", + "properties": { + "questionAnsweringOrchestration": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedQuestionAnsweringOrchestration", + "description": "The Question Answering project details." + } + }, + "required": [ + "questionAnsweringOrchestration" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedOrchestrationOptions" + } + ], + "x-ms-discriminator-value": "QuestionAnswering" + }, + "AnalyzeConversationAuthoringExportedUtteranceEntityLabel": { + "type": "object", + "description": "Represents an entity label for an utterance.", + "properties": { + "category": { + "type": "string", + "description": "The category of the entity label." + }, + "offset": { + "type": "integer", + "format": "int32", + "description": "Start position for the entity text." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "Length for the entity text." + } + }, + "required": [ + "category", + "offset", + "length" + ] + }, + "AnalyzeConversationAuthoringImportProjectJobState": { + "type": "object", + "description": "Represents the state of an import job.", + "properties": { + "jobId": { + "type": "string", + "description": "The job ID.", + "readOnly": true + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "The creation date time of the job." + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last date time the job was updated." + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "The expiration date time of the job." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "The job status." + }, + "warnings": { + "type": "array", + "description": "The warnings that were encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "errors": { + "type": "array", + "description": "The errors encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status" + ] + }, + "AnalyzeConversationAuthoringIntentEvaluationSummary": { + "type": "object", + "description": "The evaluation summary for an intent.", + "properties": { + "f1": { + "type": "number", + "format": "double", + "description": "Represents the model precision" + }, + "precision": { + "type": "number", + "format": "double", + "description": "Represents the model recall" + }, + "recall": { + "type": "number", + "format": "double", + "description": "Represents the model F1 score" + }, + "truePositiveCount": { + "type": "integer", + "format": "int32", + "description": "Represents the count of true positive" + }, + "trueNegativeCount": { + "type": "integer", + "format": "int32", + "description": "Represents the count of true negative" + }, + "falsePositiveCount": { + "type": "integer", + "format": "int32", + "description": "Represents the count of false positive" + }, + "falseNegativeCount": { + "type": "integer", + "format": "int32", + "description": "Represents the count of false negative" + } + }, + "required": [ + "f1", + "precision", + "recall", + "truePositiveCount", + "trueNegativeCount", + "falsePositiveCount", + "falseNegativeCount" + ] + }, + "AnalyzeConversationAuthoringIntentsEvaluationSummary": { + "type": "object", + "description": "Represents the evaluation summary for the project's intents.", + "properties": { + "confusionMatrix": { + "type": "object", + "description": "Represents the confusion matrix between two intents (the two intents can be the same). The matrix is between the intent that was labelled and the intent that was predicted.", + "additionalProperties": { + "$ref": "#/definitions/AnalyzeConversationAuthoringConfusionMatrixRow" + } + }, + "intents": { + "type": "object", + "description": "Represents the intents evaluation summary.", + "additionalProperties": { + "$ref": "#/definitions/AnalyzeConversationAuthoringIntentEvaluationSummary" + } + }, + "microF1": { + "type": "number", + "format": "float", + "description": "Represents the micro F1. Expected value is a float between 0 and 1 inclusive." + }, + "microPrecision": { + "type": "number", + "format": "float", + "description": "Represents the micro precision. Expected value is a float between 0 and 1 inclusive." + }, + "microRecall": { + "type": "number", + "format": "float", + "description": "Represents the micro recall. Expected value is a float between 0 and 1 inclusive." + }, + "macroF1": { + "type": "number", + "format": "float", + "description": "Represents the macro F1. Expected value is a float between 0 and 1 inclusive." + }, + "macroPrecision": { + "type": "number", + "format": "float", + "description": "Represents the macro precision. Expected value is a float between 0 and 1 inclusive." + }, + "macroRecall": { + "type": "number", + "format": "float", + "description": "Represents the macro recall. Expected value is a float between 0 and 1 inclusive." + } + }, + "required": [ + "confusionMatrix", + "intents", + "microF1", + "microPrecision", + "microRecall", + "macroF1", + "macroPrecision", + "macroRecall" + ] + }, + "AnalyzeConversationAuthoringLoadSnapshotJobState": { + "type": "object", + "description": "Represents the state of loading a snapshot job.", + "properties": { + "jobId": { + "type": "string", + "description": "The job ID.", + "readOnly": true + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "The creation date time of the job." + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last date time the job was updated." + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "The expiration date time of the job." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "The job status." + }, + "warnings": { + "type": "array", + "description": "The warnings that were encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "errors": { + "type": "array", + "description": "The errors encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status" + ] + }, + "AnalyzeConversationAuthoringOrchestrationExportedIntent": { + "type": "object", + "description": "Represents an exported intent for an orchestration project.", + "properties": { + "orchestration": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedOrchestrationOptions", + "description": "Specifies the behavior of this intent in the orchestration flow." + }, + "category": { + "type": "string", + "description": "The intent category." + } + }, + "required": [ + "category" + ] + }, + "AnalyzeConversationAuthoringOrchestrationExportedProjectAsset": { + "type": "object", + "description": "Represents the assets of an orchestration project.", + "properties": { + "intents": { + "type": "array", + "description": "Represents the intents of the project.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringOrchestrationExportedIntent" + } + }, + "utterances": { + "type": "array", + "description": "Represents the utterances of the project.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringOrchestrationExportedUtterance" + } + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedProjectAssets" + } + ], + "x-ms-discriminator-value": "Orchestration" + }, + "AnalyzeConversationAuthoringOrchestrationExportedUtterance": { + "type": "object", + "description": "Represents an utterance of an orchestration project.", + "properties": { + "text": { + "type": "string", + "description": "The utterance text." + }, + "language": { + "type": "string", + "description": "Represents the utterance's language. This is BCP-47 representation of a language. For example, use \"en\" for English, \"en-gb\" for English (UK), \"es\" for Spanish etc." + }, + "intent": { + "type": "string", + "description": "The intent of the utterance." + }, + "dataset": { + "type": "string", + "description": "The dataset for this utterance. Allowed values are 'Train' and 'Test'." + } + }, + "required": [ + "text", + "intent" + ] + }, + "AnalyzeConversationAuthoringPrebuiltEntity": { + "type": "object", + "description": "Represents a supported prebuilt entity.", + "properties": { + "category": { + "type": "string", + "description": "The prebuilt entity category.", + "readOnly": true + }, + "description": { + "type": "string", + "description": "The description." + }, + "examples": { + "type": "string", + "description": "English examples for the entity." + } + }, + "required": [ + "category", + "description", + "examples" + ] + }, + "AnalyzeConversationAuthoringProjectAzureResourceIds": { + "type": "object", + "description": "Represents the payload for deleting a project deployment.", + "properties": { + "assignedResourceIds": { + "type": "array", + "description": "Represents the Language or AIService resource IDs to unassign from the project or delete the deployment from.", + "items": { + "type": "string" + } + } + } + }, + "AnalyzeConversationAuthoringProjectDeletionJobState": { + "type": "object", + "description": "Represents the state of a project deletion job.", + "properties": { + "jobId": { + "type": "string", + "description": "The job ID.", + "readOnly": true + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "The creation date time of the job." + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last date time the job was updated." + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "The expiration date time of the job." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "The job status." + }, + "warnings": { + "type": "array", + "description": "The warnings that were encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "errors": { + "type": "array", + "description": "The errors encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status" + ] + }, + "AnalyzeConversationAuthoringProjectDeployment": { + "type": "object", + "description": "Represents a project deployment.", + "properties": { + "deploymentName": { + "type": "string", + "description": "Represents deployment name.", + "readOnly": true + }, + "modelId": { + "type": "string", + "description": "Represents deployment modelId." + }, + "lastTrainedDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents deployment last trained time." + }, + "lastDeployedDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents deployment last deployed time." + }, + "deploymentExpirationDate": { + "type": "string", + "format": "date", + "description": "Represents deployment expiration date in the runtime." + }, + "modelTrainingConfigVersion": { + "type": "string", + "description": "Represents model training config version." + }, + "assignedResources": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourceInfo", + "description": "Represents the metadata of the assigned Azure resources." + } + }, + "required": [ + "deploymentName", + "modelId", + "lastTrainedDateTime", + "lastDeployedDateTime", + "deploymentExpirationDate", + "modelTrainingConfigVersion", + "assignedResources" + ] + }, + "AnalyzeConversationAuthoringProjectMetadata": { + "type": "object", + "description": "Represents the metadata of a project.", + "properties": { + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents the project creation datetime." + }, + "lastModifiedDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents the project creation datetime." + }, + "lastTrainedDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents the project last trained datetime." + }, + "lastDeployedDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents the project last deployed datetime." + }, + "projectKind": { + "$ref": "#/definitions/ProjectKind", + "description": "Represents the project kind.", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "settings": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectSettings", + "description": "The project settings.", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "projectName": { + "type": "string", + "description": "The new project name.", + "maxLength": 100, + "x-ms-mutability": [ + "read", + "create" + ] + }, + "multilingual": { + "type": "boolean", + "description": "Whether the project would be used for multiple languages or not.", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "description": { + "type": "string", + "description": "The project description.", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "language": { + "type": "string", + "description": "The project language. This is BCP-47 representation of a language. For example, use \"en\" for English, \"en-gb\" for English (UK), \"es\" for Spanish etc.", + "x-ms-mutability": [ + "read", + "create" + ] + } + }, + "required": [ + "createdDateTime", + "lastModifiedDateTime", + "projectKind", + "projectName", + "language" + ] + }, + "AnalyzeConversationAuthoringProjectResourceAssignmentInfo": { + "type": "object", + "description": "Represents metadata for the Azure resource..", + "properties": { + "azureResourceId": { + "type": "string", + "description": "Represents the Azure resource ID." + }, + "customDomain": { + "type": "string", + "description": "Represents the Azure resource custom domain." + }, + "region": { + "type": "string", + "description": "Represents the Azure resource region." + } + }, + "required": [ + "azureResourceId", + "customDomain", + "region" + ] + }, + "AnalyzeConversationAuthoringProjectResourceAssignments": { + "type": "object", + "description": "Represents the payload for assigning Azure resources to a project.", + "properties": { + "projectResources": { + "type": "array", + "description": "Represents the metadata for the project resources to be assigned.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourceAssignmentInfo" + } + } + }, + "required": [ + "projectResources" + ] + }, + "AnalyzeConversationAuthoringProjectResourceInfo": { + "type": "object", + "description": "Represents the assigned project resource.", + "properties": { + "azureResourceId": { + "type": "string", + "description": "The Azure resource ID of the language or AI resource.", + "readOnly": true + }, + "region": { + "type": "string", + "description": "The Azure resource region." + } + }, + "required": [ + "azureResourceId", + "region" + ] + }, + "AnalyzeConversationAuthoringProjectResourcesJobState": { + "type": "object", + "description": "Represents the state of a project resources job.", + "properties": { + "jobId": { + "type": "string", + "description": "The job ID.", + "readOnly": true + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "The creation date time of the job." + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last date time the job was updated." + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "The expiration date time of the job." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "The job status." + }, + "warnings": { + "type": "array", + "description": "The warnings that were encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "errors": { + "type": "array", + "description": "The errors encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status" + ] + }, + "AnalyzeConversationAuthoringProjectSettings": { + "type": "object", + "description": "Represents the settings used to define the project behavior.", + "properties": { + "confidenceThreshold": { + "type": "number", + "format": "float", + "description": "The threshold of the intent with the highest confidence, at which the prediction will automatically be changed to \"None\". The value of the threshold should be between 0 and 1 inclusive." + } + }, + "required": [ + "confidenceThreshold" + ] + }, + "AnalyzeConversationAuthoringProjectTrainedModel": { + "type": "object", + "description": "Represents a trained model.", + "properties": { + "label": { + "type": "string", + "description": "The trained model label.", + "readOnly": true + }, + "modelId": { + "type": "string", + "description": "The model ID." + }, + "lastTrainedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last trained date time of the model." + }, + "lastTrainingDurationInSeconds": { + "type": "integer", + "format": "int32", + "description": "The duration of the model's last training request in seconds." + }, + "modelExpirationDate": { + "type": "string", + "format": "date", + "description": "The model expiration date." + }, + "modelTrainingConfigVersion": { + "type": "string", + "description": "The model training config version." + }, + "hasSnapshot": { + "type": "boolean", + "description": "The flag to indicate if the trained model has a snapshot ready." + } + }, + "required": [ + "label", + "modelId", + "lastTrainedDateTime", + "lastTrainingDurationInSeconds", + "modelExpirationDate", + "modelTrainingConfigVersion", + "hasSnapshot" + ] + }, + "AnalyzeConversationAuthoringSubTrainingJobState": { + "type": "object", + "description": "Represents the detailed state of a training sub-operation.", + "properties": { + "percentComplete": { + "type": "integer", + "format": "int32", + "description": "Represents progress percentage." + }, + "startDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents the start date time." + }, + "endDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents the end date time." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "Represents the status of the sub-operation." + } + }, + "required": [ + "percentComplete", + "status" + ] + }, + "AnalyzeConversationAuthoringSupportedLanguage": { + "type": "object", + "description": "Represents a supported language.", + "properties": { + "languageName": { + "type": "string", + "description": "The language name.", + "readOnly": true + }, + "languageCode": { + "type": "string", + "description": "The language code. This is BCP-47 representation of a language. For example, \"en\" for English, \"en-gb\" for English (UK), \"es\" for Spanish etc." + } + }, + "required": [ + "languageName", + "languageCode" + ] + }, + "AnalyzeConversationAuthoringSwapDeploymentsJobState": { + "type": "object", + "description": "Represents the state of a deployment job.", + "properties": { + "jobId": { + "type": "string", + "description": "The job ID.", + "readOnly": true + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "The creation date time of the job." + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last date time the job was updated." + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "The expiration date time of the job." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "The job status." + }, + "warnings": { + "type": "array", + "description": "The warnings that were encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "errors": { + "type": "array", + "description": "The errors encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status" + ] + }, + "AnalyzeConversationAuthoringSwapDeploymentsOptions": { + "type": "object", + "description": "Represents the options for swapping two deployments together.", + "properties": { + "firstDeploymentName": { + "type": "string", + "description": "Represents the first deployment name." + }, + "secondDeploymentName": { + "type": "string", + "description": "Represents the second deployment name." + } + }, + "required": [ + "firstDeploymentName", + "secondDeploymentName" + ] + }, + "AnalyzeConversationAuthoringTrainingConfigVersion": { + "type": "object", + "description": "Represents a training config version.", + "properties": { + "trainingConfigVersion": { + "type": "string", + "description": "Represents the version of the config.", + "readOnly": true + }, + "modelExpirationDate": { + "type": "string", + "format": "date", + "description": "Represents the training config version expiration date." + } + }, + "required": [ + "trainingConfigVersion", + "modelExpirationDate" + ] + }, + "AnalyzeConversationAuthoringTrainingJobOptions": { + "type": "object", + "description": "Represents the options for starting a new training job.", + "properties": { + "modelLabel": { + "type": "string", + "description": "Represents the output model label." + }, + "trainingConfigVersion": { + "type": "string", + "description": "Represents training config version. By default, \"latest\" value is used which uses the latest released training config version." + }, + "trainingMode": { + "$ref": "#/definitions/TrainingMode", + "description": "Represents the mode of the training operation." + }, + "evaluationOptions": { + "$ref": "#/definitions/AnalyzeConversationAuthoringEvaluationOptions", + "description": "Represents the evaluation options. By default, the evaluation kind is percentage, with training split percentage as 80, and testing split percentage as 20." + } + }, + "required": [ + "modelLabel", + "trainingMode" + ] + }, + "AnalyzeConversationAuthoringTrainingJobResult": { + "type": "object", + "description": "Represents the output of a training job.", + "properties": { + "modelLabel": { + "type": "string", + "description": "Represents trained model label." + }, + "trainingConfigVersion": { + "type": "string", + "description": "Represents training config version." + }, + "trainingMode": { + "$ref": "#/definitions/TrainingMode", + "description": "Represents the mode of the training operation." + }, + "trainingStatus": { + "$ref": "#/definitions/AnalyzeConversationAuthoringSubTrainingJobState", + "description": "Represents the model training status." + }, + "evaluationStatus": { + "$ref": "#/definitions/AnalyzeConversationAuthoringSubTrainingJobState", + "description": "Represents model evaluation status." + }, + "estimatedEndDateTime": { + "type": "string", + "format": "date-time", + "description": "Represents the estimated end date time for training and evaluation." + } + }, + "required": [ + "modelLabel", + "trainingConfigVersion", + "trainingStatus" + ] + }, + "AnalyzeConversationAuthoringTrainingJobState": { + "type": "object", + "description": "Represents the state of a training job.", + "properties": { + "jobId": { + "type": "string", + "description": "The job ID.", + "readOnly": true + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "The creation date time of the job." + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last date time the job was updated." + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "The expiration date time of the job." + }, + "status": { + "$ref": "#/definitions/JobStatus", + "description": "The job status." + }, + "warnings": { + "type": "array", + "description": "The warnings that were encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "errors": { + "type": "array", + "description": "The errors encountered while executing the job.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "result": { + "$ref": "#/definitions/AnalyzeConversationAuthoringTrainingJobResult", + "description": "Represents training tasks detailed result." + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status", + "result" + ] + }, + "AnalyzeConversationAuthoringUtteranceEntitiesEvaluationResult": { + "type": "object", + "description": "Represents the comparison between the expected and predicted entities for an utterance.", + "properties": { + "expectedEntities": { + "type": "array", + "description": "Represents the expected entity labels.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringUtteranceEntityEvaluationResult" + } + }, + "predictedEntities": { + "type": "array", + "description": "Represents the predicted entity labels.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringUtteranceEntityEvaluationResult" + } + } + }, + "required": [ + "expectedEntities", + "predictedEntities" + ] + }, + "AnalyzeConversationAuthoringUtteranceEntityEvaluationResult": { + "type": "object", + "description": "Represents the evaluation output of an entity label or prediction.", + "properties": { + "category": { + "type": "string", + "description": "Represents the entity category." + }, + "offset": { + "type": "integer", + "format": "int32", + "description": "Represents the entity offset index relative to the original text." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "Represents the entity length." + } + }, + "required": [ + "category", + "offset", + "length" + ] + }, + "AnalyzeConversationAuthoringUtteranceEvaluationResult": { + "type": "object", + "description": "Represents the evaluation result for an utterance.", + "properties": { + "text": { + "type": "string", + "description": "Represents the utterance text.", + "readOnly": true + }, + "language": { + "type": "string", + "description": "Represents the utterance language. This is BCP-47 representation of a language. For example, use \"en\" for English, \"en-gb\" for English (UK), \"es\" for Spanish etc." + }, + "entitiesResult": { + "$ref": "#/definitions/AnalyzeConversationAuthoringUtteranceEntitiesEvaluationResult", + "description": "Represents the entities results for the utterance." + }, + "intentsResult": { + "$ref": "#/definitions/AnalyzeConversationAuthoringUtteranceIntentsEvaluationResult", + "description": "Represents the intents results for the utterance." + } + }, + "required": [ + "text", + "language", + "entitiesResult", + "intentsResult" + ] + }, + "AnalyzeConversationAuthoringUtteranceIntentsEvaluationResult": { + "type": "object", + "description": "Represents the comparison between the expected and the predicted intent for an utterance.", + "properties": { + "expectedIntent": { + "type": "string", + "description": "Represents the utterance's expected intent." + }, + "predictedIntent": { + "type": "string", + "description": "Represents the utterance's predicted intent." + } + }, + "required": [ + "expectedIntent", + "predictedIntent" + ] + }, + "Azure.Core.Foundations.Error": { + "type": "object", + "description": "The error object.", + "properties": { + "code": { + "type": "string", + "description": "One of a server-defined set of error codes." + }, + "message": { + "type": "string", + "description": "A human-readable representation of the error." + }, + "target": { + "type": "string", + "description": "The target of the error." + }, + "details": { + "type": "array", + "description": "An array of details about specific errors that led to this reported error.", + "items": { + "$ref": "#/definitions/Azure.Core.Foundations.Error" + } + }, + "innererror": { + "$ref": "#/definitions/Azure.Core.Foundations.InnerError", + "description": "An object containing more specific information than the current object about the error." + } + }, + "required": [ + "code", + "message" + ] + }, + "Azure.Core.Foundations.ErrorResponse": { + "type": "object", + "description": "A response containing error details.", + "properties": { + "error": { + "$ref": "#/definitions/Azure.Core.Foundations.Error", + "description": "The error object." + } + }, + "required": [ + "error" + ] + }, + "Azure.Core.Foundations.InnerError": { + "type": "object", + "description": "An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.", + "properties": { + "code": { + "type": "string", + "description": "One of a server-defined set of error codes." + }, + "innererror": { + "$ref": "#/definitions/Azure.Core.Foundations.InnerError", + "description": "Inner error." + } + } + }, + "Azure.Core.uuid": { + "type": "string", + "format": "uuid", + "description": "Universally Unique Identifier" + }, + "CompositionSetting": { + "type": "string", + "enum": [ + "returnLongestOverlap", + "requireExactOverlap", + "separateComponents", + "combineComponents" + ], + "x-ms-enum": { + "name": "CompositionSetting", + "modelAsString": true, + "values": [ + { + "name": "returnLongestOverlap", + "value": "returnLongestOverlap", + "description": "When two or more components are found in the text and overlap, the component with the longest set of characters is returned." + }, + { + "name": "requireExactOverlap", + "value": "requireExactOverlap", + "description": "All components must overlap at the exact same characters in the text for the entity to return. If one of the defined components is not matched or predicted, the entity will not return." + }, + { + "name": "separateComponents", + "value": "separateComponents", + "description": "Every component's match or prediction is returned as a separate instance of the entity." + }, + { + "name": "combineComponents", + "value": "combineComponents", + "description": "When two or more components are found in the text and overlap, the components' spans are merged together into one span combining all of them." + } + ] + } + }, + "DatasetType": { + "type": "string", + "description": "The dataset for this utterance. Allowed values are 'Train' and 'Test'.", + "enum": [ + "Train", + "Test" + ], + "x-ms-enum": { + "name": "DatasetType", + "modelAsString": true, + "values": [ + { + "name": "Train", + "value": "Train", + "description": "Split the data into training and test sets according to user-defined percentages." + }, + { + "name": "Test", + "value": "Test", + "description": "Split the data according to the chosen dataset for every example in the data." + } + ] + } + }, + "EvaluationKind": { + "type": "string", + "enum": [ + "percentage", + "manual" + ], + "x-ms-enum": { + "name": "EvaluationKind", + "modelAsString": true, + "values": [ + { + "name": "percentage", + "value": "percentage", + "description": "Split the data into training and test sets according to user-defined percentages." + }, + { + "name": "manual", + "value": "manual", + "description": "Split the data according to the chosen dataset for every example in the data." + } + ] + } + }, + "JobStatus": { + "type": "string", + "enum": [ + "notStarted", + "running", + "succeeded", + "failed", + "cancelled", + "cancelling", + "partiallyCompleted" + ], + "x-ms-enum": { + "name": "JobStatus", + "modelAsString": true, + "values": [ + { + "name": "notStarted", + "value": "notStarted" + }, + { + "name": "running", + "value": "running" + }, + { + "name": "succeeded", + "value": "succeeded" + }, + { + "name": "failed", + "value": "failed" + }, + { + "name": "cancelled", + "value": "cancelled" + }, + { + "name": "cancelling", + "value": "cancelling" + }, + { + "name": "partiallyCompleted", + "value": "partiallyCompleted" + } + ] + } + }, + "OrchestrationTargetProjectKind": { + "type": "string", + "enum": [ + "Luis", + "Conversation", + "QuestionAnswering" + ], + "x-ms-enum": { + "name": "OrchestrationTargetProjectKind", + "modelAsString": true, + "values": [ + { + "name": "Luis", + "value": "Luis" + }, + { + "name": "Conversation", + "value": "Conversation" + }, + { + "name": "QuestionAnswering", + "value": "QuestionAnswering" + } + ] + } + }, + "PagedAnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "PagedAnalyzeConversationAuthoringPrebuiltEntity": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringPrebuiltEntity items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringPrebuiltEntity items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringPrebuiltEntity" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "PagedAnalyzeConversationAuthoringProjectDeployment": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringProjectDeployment items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringProjectDeployment items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectDeployment" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "PagedAnalyzeConversationAuthoringProjectMetadata": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringProjectMetadata items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringProjectMetadata items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectMetadata" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "PagedAnalyzeConversationAuthoringProjectResourceInfo": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringProjectResourceInfo items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringProjectResourceInfo items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourceInfo" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "PagedAnalyzeConversationAuthoringProjectTrainedModel": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringProjectTrainedModel items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringProjectTrainedModel items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectTrainedModel" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "PagedAnalyzeConversationAuthoringSupportedLanguage": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringSupportedLanguage items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringSupportedLanguage items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringSupportedLanguage" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "PagedAnalyzeConversationAuthoringTrainingConfigVersion": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringTrainingConfigVersion items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringTrainingConfigVersion items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringTrainingConfigVersion" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "PagedAnalyzeConversationAuthoringTrainingJobState": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringTrainingJobState items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringTrainingJobState items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringTrainingJobState" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "PagedAnalyzeConversationAuthoringUtteranceEvaluationResult": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringUtteranceEvaluationResult items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringUtteranceEvaluationResult items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringUtteranceEvaluationResult" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "ProjectKind": { + "type": "string", + "enum": [ + "Conversation", + "Orchestration" + ], + "x-ms-enum": { + "name": "ProjectKind", + "modelAsString": true, + "values": [ + { + "name": "Conversation", + "value": "Conversation", + "description": "A project to build natural language into apps, bots, and IoT devices." + }, + { + "name": "Orchestration", + "value": "Orchestration", + "description": "A project to connect and orchestrate Conversation, Custom question answering and LUIS projects together in one single project." + } + ] + } + }, + "StringIndexType": { + "type": "string", + "enum": [ + "Utf16CodeUnit", + "Utf8CodeUnit", + "Utf32CodeUnit" + ], + "x-ms-enum": { + "name": "StringIndexType", + "modelAsString": true, + "values": [ + { + "name": "Utf16CodeUnit", + "value": "Utf16CodeUnit", + "description": "The offset and length values will correspond to UTF-16 code units. Use this option if your application is written in a language that support Unicode, for example Java, JavaScript." + }, + { + "name": "Utf8CodeUnit", + "value": "Utf8CodeUnit" + }, + { + "name": "Utf32CodeUnit", + "value": "Utf32CodeUnit" + } + ] + } + }, + "TrainingMode": { + "type": "string", + "enum": [ + "advanced", + "standard" + ], + "x-ms-enum": { + "name": "TrainingMode", + "modelAsString": true, + "values": [ + { + "name": "advanced", + "value": "advanced", + "description": "Trains using fine-tuned neural network transformer models. Can train multilingual projects." + }, + { + "name": "standard", + "value": "standard", + "description": "Faster training times for quicker iterations." + } + ] + } + } + }, + "parameters": { + "Azure.Core.Foundations.ApiVersionParameter": { + "name": "api-version", + "in": "query", + "description": "The API version to use for this operation.", + "required": true, + "type": "string", + "minLength": 1, + "x-ms-parameter-location": "method", + "x-ms-client-name": "apiVersion" + }, + "Azure.Core.MaxPageSizeQueryParameter": { + "name": "maxpagesize", + "in": "query", + "description": "The maximum number of result items per page.", + "required": false, + "type": "integer", + "format": "int32", + "x-ms-parameter-location": "method" + }, + "Azure.Core.SkipQueryParameter": { + "name": "skip", + "in": "query", + "description": "The number of result items to skip.", + "required": false, + "type": "integer", + "format": "int32", + "default": 0, + "x-ms-parameter-location": "method" + }, + "Azure.Core.TopQueryParameter": { + "name": "top", + "in": "query", + "description": "The number of result items to return.", + "required": false, + "type": "integer", + "format": "int32", + "x-ms-parameter-location": "method" + }, + "ProjectKindQueryParameter": { + "name": "projectKind", + "in": "query", + "description": "The project kind.", + "required": true, + "type": "string", + "enum": [ + "Conversation", + "Orchestration" + ], + "x-ms-enum": { + "name": "ProjectKind", + "modelAsString": true, + "values": [ + { + "name": "Conversation", + "value": "Conversation", + "description": "A project to build natural language into apps, bots, and IoT devices." + }, + { + "name": "Orchestration", + "value": "Orchestration", + "description": "A project to connect and orchestrate Conversation, Custom question answering and LUIS projects together in one single project." + } + ] + }, + "x-ms-parameter-location": "method", + "x-ms-client-name": "ProjectKind" + }, + "StringIndexTypeQueryParameter": { + "name": "stringIndexType", + "in": "query", + "description": "Specifies the method used to interpret string offsets. For additional information see https://aka.ms/text-analytics-offsets.", + "required": true, + "type": "string", + "enum": [ + "Utf16CodeUnit", + "Utf8CodeUnit", + "Utf32CodeUnit" + ], + "x-ms-enum": { + "name": "StringIndexType", + "modelAsString": true, + "values": [ + { + "name": "Utf16CodeUnit", + "value": "Utf16CodeUnit", + "description": "The offset and length values will correspond to UTF-16 code units. Use this option if your application is written in a language that support Unicode, for example Java, JavaScript." + }, + { + "name": "Utf8CodeUnit", + "value": "Utf8CodeUnit" + }, + { + "name": "Utf32CodeUnit", + "value": "Utf32CodeUnit" + } + ] + }, + "x-ms-parameter-location": "method" + }, + "SupportedPrebuiltEntitiesQueryParameter.language": { + "name": "language", + "in": "query", + "description": "The language to get supported prebuilt entities for. Required if multilingual is false. This is BCP-47 representation of a language. For example, use \"en\" for English, \"en-gb\" for English (UK), \"es\" for Spanish etc.", + "required": false, + "type": "string", + "x-ms-parameter-location": "method" + }, + "SupportedPrebuiltEntitiesQueryParameter.multilingual": { + "name": "multilingual", + "in": "query", + "description": "Whether to get the support prebuilt entities for multilingual or monolingual projects. If true, the language parameter is ignored.", + "required": false, + "type": "string", + "x-ms-parameter-location": "method" + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json new file mode 100644 index 000000000000..3621e9a4772e --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json @@ -0,0 +1,31 @@ +{ + "operationId": "ConversationAuthoringProject_AssignDeploymentResources", + "title": "Successful Assign Deployment Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "body": { + "resourcesMetadata": [ + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu", + "customDomain": "lang-test-weu.cognitiveservices.azure.com", + "region": "westeurope" + }, + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestEus", + "customDomain": "lang-test-eus.cognitiveservices.azure.com", + "region": "eastus" + } + ] + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/resources/assign/jobs/66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulAssignProjectResources.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulAssignProjectResources.json new file mode 100644 index 000000000000..72f6df0ebc06 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulAssignProjectResources.json @@ -0,0 +1,31 @@ +{ + "operationId": "ConversationAuthoringProject_AssignProjectResources", + "title": "Successful Assign Project Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "body": { + "projectResources": [ + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu", + "customDomain": "lang-test-weu.cognitiveservices.azure.com", + "region": "westeurope" + }, + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestEus", + "customDomain": "lang-test-eus.cognitiveservices.azure.com", + "region": "eastus" + } + ] + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/resources/assign/jobs/66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json new file mode 100644 index 000000000000..dd1c1c14d8a2 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json @@ -0,0 +1,18 @@ +{ + "operationId": "ConversationAuthoringProject_CancelTrainingJob", + "title": "Successful Cancel Training Job", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/train/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulCreateProject.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulCreateProject.json new file mode 100644 index 000000000000..a1867970de6b --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulCreateProject.json @@ -0,0 +1,46 @@ +{ + "operationId": "ConversationAuthoringProject_CreateProject", + "title": "Successful Create Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/merge-patch+json", + "api-version": "2025-11-01", + "projectName": "myproject", + "body": { + "projectName": "myproject", + "language": "en", + "projectKind": "Conversation", + "description": "This is a sample conversation project.", + "multilingual": false + } + }, + "responses": { + "201": { + "headers": {}, + "body": { + "createdDateTime": "2022-04-18T13:53:03Z", + "lastModifiedDateTime": "2022-04-18T13:53:03Z", + "projectKind": "Conversation", + "projectName": "myproject", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + } + }, + "200": { + "headers": {}, + "body": { + "createdDateTime": "2022-04-18T13:53:03Z", + "lastModifiedDateTime": "2022-04-18T13:53:03Z", + "lastTrainedDateTime": "2022-04-18T14:14:28Z", + "lastDeployedDateTime": "2022-04-18T14:49:01Z", + "projectKind": "Conversation", + "projectName": "myproject", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteDeployment.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteDeployment.json new file mode 100644 index 000000000000..1a223bcd8e67 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteDeployment.json @@ -0,0 +1,18 @@ +{ + "operationId": "ConversationAuthoringDeployment_DeleteDeployment", + "title": "Successful Delete Deployment", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "staging" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/staging/jobs/61ebb7ef-a207-40d2-82b9-5285440ae579_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json new file mode 100644 index 000000000000..6cf9c84902c9 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringDeployment_DeleteDeploymentFromResources", + "title": "Successful Delete Deployment From Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "staging", + "body": { + "assignedResourceIds": [ + "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu" + ] + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/staging/delete-from-resources/jobs/61ebb7ef-a207-40d2-82b9-5285440ae579_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteModel.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteModel.json new file mode 100644 index 000000000000..5e69241ea538 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteModel.json @@ -0,0 +1,14 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_DeleteTrainedModel", + "title": "Successful Delete Model", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model2" + }, + "responses": { + "204": {} + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteProject.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteProject.json new file mode 100644 index 000000000000..0d407e36e991 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteProject.json @@ -0,0 +1,17 @@ +{ + "operationId": "ConversationAuthoringProject_DeleteProject", + "title": "Successful Delete Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "myproject" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/global/deletion-jobs/129d3182-625d-496c-bcf9-43686e85160b_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeployProject.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeployProject.json new file mode 100644 index 000000000000..597f1e8c5d99 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeployProject.json @@ -0,0 +1,21 @@ +{ + "operationId": "ConversationAuthoringDeployment_DeployProject", + "title": "Successful Deploy Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "production", + "body": { + "trainedModelLabel": "29886710a2ae49259d62cffca977db66" + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/production/jobs/66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulExportProject.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulExportProject.json new file mode 100644 index 000000000000..78a5bf27c858 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulExportProject.json @@ -0,0 +1,18 @@ +{ + "operationId": "ConversationAuthoringProject_Export", + "title": "Successful Export Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "stringIndexType": "Utf16CodeUnit" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/export/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json new file mode 100644 index 000000000000..8e745940ac21 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetAssignDeploymentResourcesStatus", + "title": "Successful Get Assign Deployment Resources Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json new file mode 100644 index 000000000000..2414a2305167 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetAssignProjectResourcesStatus", + "title": "Successful Get Assign Project Resources Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeployment.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeployment.json new file mode 100644 index 000000000000..c0e39d7e8e04 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeployment.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringDeployment_GetDeployment", + "title": "Successful Get Deployment", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "staging" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "deploymentName": "staging", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49.4334381Z", + "lastDeployedDateTime": "2022-04-18T15:53:04Z", + "deploymentExpirationDate": "2023-10-28", + "modelTrainingConfigVersion": "2022-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json new file mode 100644 index 000000000000..2bc8cfe264a7 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringDeployment_GetDeploymentDeleteFromResourcesStatus", + "title": "Successful Get Deployment Delete From Resources Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "production", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json new file mode 100644 index 000000000000..1fcb21994199 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringDeployment_GetDeploymentStatus", + "title": "Successful Get Deployment Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "production", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetExportStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetExportStatus.json new file mode 100644 index 000000000000..d25abbf34851 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetExportStatus.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringProject_GetExportStatus", + "title": "Successful Get Export Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "c95efa2a-44e8-461e-8aa5-04b4677bfa84_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "resultUrl": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/export/jobs/c4946bfa-4fbf-493b-bfcf-2d232eb9de69_637858368000000000/result?api-version=2025-11-01", + "jobId": "c4946bfa-4fbf-493b-bfcf-2d232eb9de69_637858368000000000", + "createdDateTime": "2022-04-18T15:23:07Z", + "lastUpdatedDateTime": "2022-04-18T15:23:08Z", + "expirationDateTime": "2022-04-25T15:23:07Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetImportStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetImportStatus.json new file mode 100644 index 000000000000..b7fd54686a1b --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetImportStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetImportStatus", + "title": "Successful Get Import Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "c95efa2a-44e8-461e-8aa5-04b4677bfa84_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "c95efa2a-44e8-461e-8aa5-04b4677bfa84_637858368000000000", + "createdDateTime": "2022-04-18T15:17:20Z", + "lastUpdatedDateTime": "2022-04-18T15:17:22Z", + "expirationDateTime": "2022-04-25T15:17:20Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json new file mode 100644 index 000000000000..c4ed63bac0c5 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_GetLoadSnapshotStatus", + "title": "Successful Get Load Snapshot Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1", + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000", + "createdDateTime": "2022-04-18T15:44:44Z", + "lastUpdatedDateTime": "2022-04-18T15:45:48Z", + "expirationDateTime": "2022-04-25T15:44:44Z", + "status": "running" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModel.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModel.json new file mode 100644 index 000000000000..d41989fcaef2 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModel.json @@ -0,0 +1,25 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_GetTrainedModel", + "title": "Successful Get Model", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "label": "model1", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49Z", + "lastTrainingDurationInSeconds": 186, + "modelExpirationDate": "2022-10-28", + "modelTrainingConfigVersion": "2022-05-01", + "hasSnapshot": true + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json new file mode 100644 index 000000000000..0d66e21fe2f9 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json @@ -0,0 +1,286 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_GetModelEvaluationResults", + "title": "Successful Get Model Evaluation", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1", + "stringIndexType": "Utf16CodeUnit", + "maxpagesize": 10 + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "text": "send the email", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [], + "predictedEntities": [] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "send a mail to daniel", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 15, + "length": 6 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 15, + "length": 6 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "i forgot to add an important part to that email to james . please set it up to edit", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 51, + "length": 5 + } + ], + "predictedEntities": [ + { + "category": "Category", + "offset": 19, + "length": 9 + }, + { + "category": "ContactName", + "offset": 51, + "length": 5 + } + ] + }, + "intentsResult": { + "expectedIntent": "AddMore", + "predictedIntent": "AddMore" + } + }, + { + "text": "send email to a and tian", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 14, + "length": 1 + }, + { + "category": "ContactName", + "offset": 20, + "length": 4 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 14, + "length": 1 + }, + { + "category": "ContactName", + "offset": 20, + "length": 4 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "send thomas an email", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 5, + "length": 6 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 5, + "length": 6 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "i need to add more to the email message i am sending to vincent", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 56, + "length": 7 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 56, + "length": 7 + } + ] + }, + "intentsResult": { + "expectedIntent": "AddMore", + "predictedIntent": "AddMore" + } + }, + { + "text": "send an email to lily roth and abc123@microsoft.com", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 17, + "length": 9 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 17, + "length": 9 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "i need to add something else to my email to cheryl", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 44, + "length": 6 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 44, + "length": 6 + } + ] + }, + "intentsResult": { + "expectedIntent": "AddMore", + "predictedIntent": "AddMore" + } + }, + { + "text": "send an email to larry , joseph and billy larkson", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 17, + "length": 5 + }, + { + "category": "ContactName", + "offset": 25, + "length": 6 + }, + { + "category": "ContactName", + "offset": 36, + "length": 13 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 17, + "length": 5 + }, + { + "category": "ContactName", + "offset": 25, + "length": 6 + }, + { + "category": "ContactName", + "offset": 36, + "length": 13 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + }, + { + "text": "send mail to dorothy", + "language": "en-us", + "entitiesResult": { + "expectedEntities": [ + { + "category": "ContactName", + "offset": 13, + "length": 7 + } + ], + "predictedEntities": [ + { + "category": "ContactName", + "offset": 13, + "length": 7 + } + ] + }, + "intentsResult": { + "expectedIntent": "SendEmail", + "predictedIntent": "SendEmail" + } + } + ], + "nextLink": "https://api.example.com/language/authoring/analyze-conversations/projects/EmailApp/models/model1/evaluation/result/?api-version=2025-11-01&top=2147483637&skip=100&maxpagesize=100" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json new file mode 100644 index 000000000000..7ecd98943231 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json @@ -0,0 +1,528 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_GetModelEvaluationSummary", + "title": "Successful Get Model Evaluation Summary", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "entitiesEvaluation": { + "confusionMatrix": { + "Attachment": { + "Attachment": { + "normalizedValue": 100.0, + "rawValue": 3.0 + } + }, + "Category": { + "Category": { + "normalizedValue": 91.666664, + "rawValue": 11.0 + }, + "$none": { + "normalizedValue": 8.333333, + "rawValue": 1.0 + } + }, + "ContactName": { + "ContactName": { + "normalizedValue": 91.666664, + "rawValue": 22.0 + }, + "SenderName": { + "normalizedValue": 4.1666665, + "rawValue": 1.0 + }, + "$none": { + "normalizedValue": 4.1666665, + "rawValue": 1.0 + } + }, + "Date": { + "Date": { + "normalizedValue": 100.0, + "rawValue": 2.0 + } + }, + "EmailSubject": { + "EmailSubject": { + "normalizedValue": 93.33333, + "rawValue": 9.333334 + }, + "$none": { + "normalizedValue": 6.6666665, + "rawValue": 0.6666667 + } + }, + "FromRelationshipName": { + "FromRelationshipName": { + "normalizedValue": 100.0, + "rawValue": 1.0 + } + }, + "Line": { + "Line": { + "normalizedValue": 100.0, + "rawValue": 2.0 + } + }, + "Message": { + "Message": { + "normalizedValue": 81.2063, + "rawValue": 6.496504 + }, + "EmailSubject": { + "normalizedValue": 7.43007, + "rawValue": 0.5944056 + }, + "$none": { + "normalizedValue": 9.120047, + "rawValue": 0.7296037 + }, + "Date": { + "normalizedValue": 2.2435899, + "rawValue": 0.17948718 + } + }, + "OrderReference": { + "OrderReference": { + "normalizedValue": 100.0, + "rawValue": 17.0 + } + }, + "PositionReference": { + "$none": { + "normalizedValue": 100.0, + "rawValue": 1.0 + } + }, + "RelationshipName": { + "RelationshipName": { + "normalizedValue": 66.666664, + "rawValue": 2.0 + }, + "$none": { + "normalizedValue": 33.333332, + "rawValue": 1.0 + } + }, + "SearchTexts": { + "SearchTexts": { + "normalizedValue": 100.0, + "rawValue": 4.0 + } + }, + "SenderName": { + "SenderName": { + "normalizedValue": 88.888885, + "rawValue": 8.0 + }, + "ContactName": { + "normalizedValue": 11.111111, + "rawValue": 1.0 + } + }, + "Time": { + "$none": { + "normalizedValue": 100.0, + "rawValue": 2.0 + } + }, + "$none": { + "$none": { + "normalizedValue": 99.739265, + "rawValue": 162.575 + }, + "Category": { + "normalizedValue": 0.2607362, + "rawValue": 0.425 + } + } + }, + "entities": { + "ContactName": { + "f1": 0.9361702799797058, + "precision": 0.95652174949646, + "recall": 0.9166666865348816, + "truePositiveCount": 22, + "trueNegativeCount": 0, + "falsePositiveCount": 1, + "falseNegativeCount": 2 + }, + "Category": { + "f1": 0.8799999952316284, + "precision": 0.8461538553237915, + "recall": 0.9166666865348816, + "truePositiveCount": 11, + "trueNegativeCount": 0, + "falsePositiveCount": 2, + "falseNegativeCount": 1 + }, + "SenderName": { + "f1": 0.8888888955116272, + "precision": 0.8888888955116272, + "recall": 0.8888888955116272, + "truePositiveCount": 8, + "trueNegativeCount": 0, + "falsePositiveCount": 1, + "falseNegativeCount": 1 + }, + "EmailSubject": { + "f1": 0.8181817531585693, + "precision": 0.75, + "recall": 0.8999999761581421, + "truePositiveCount": 9, + "trueNegativeCount": 0, + "falsePositiveCount": 3, + "falseNegativeCount": 1 + }, + "Message": { + "f1": 0.75, + "precision": 0.75, + "recall": 0.75, + "truePositiveCount": 6, + "trueNegativeCount": 0, + "falsePositiveCount": 2, + "falseNegativeCount": 2 + }, + "Date": { + "f1": 0.800000011920929, + "precision": 0.6666666865348816, + "recall": 1.0, + "truePositiveCount": 2, + "trueNegativeCount": 0, + "falsePositiveCount": 1, + "falseNegativeCount": 0 + }, + "OrderReference": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 17, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "SearchTexts": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 4, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Attachment": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 3, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "RelationshipName": { + "f1": 0.800000011920929, + "precision": 1.0, + "recall": 0.6666666865348816, + "truePositiveCount": 2, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 1 + }, + "Line": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 2, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Time": { + "f1": 0.0, + "precision": 0.0, + "recall": 0.0, + "truePositiveCount": 0, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 2 + }, + "FromRelationshipName": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 1, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "PositionReference": { + "f1": 0.0, + "precision": 0.0, + "recall": 0.0, + "truePositiveCount": 0, + "trueNegativeCount": 0, + "falsePositiveCount": 0, + "falseNegativeCount": 1 + } + }, + "microF1": 0.8923077, + "microPrecision": 0.8969072, + "microRecall": 0.8877551, + "macroF1": 0.7766601, + "macroPrecision": 0.7755879, + "macroRecall": 0.78849214 + }, + "intentsEvaluation": { + "confusionMatrix": { + "AddFlag": { + "AddFlag": { + "normalizedValue": 100.0, + "rawValue": 6.0 + } + }, + "AddMore": { + "AddMore": { + "normalizedValue": 100.0, + "rawValue": 17.0 + } + }, + "Cancel": { + "Cancel": { + "normalizedValue": 100.0, + "rawValue": 9.0 + } + }, + "CheckMessages": { + "CheckMessages": { + "normalizedValue": 100.0, + "rawValue": 9.0 + } + }, + "Confirm": { + "Confirm": { + "normalizedValue": 100.0, + "rawValue": 4.0 + } + }, + "Delete": { + "Delete": { + "normalizedValue": 100.0, + "rawValue": 5.0 + } + }, + "Forward": { + "Forward": { + "normalizedValue": 100.0, + "rawValue": 6.0 + } + }, + "None": { + "None": { + "normalizedValue": 100.0, + "rawValue": 1.0 + } + }, + "QueryLastText": { + "QueryLastText": { + "normalizedValue": 100.0, + "rawValue": 6.0 + } + }, + "ReadAloud": { + "ReadAloud": { + "normalizedValue": 100.0, + "rawValue": 16.0 + } + }, + "Reply": { + "Reply": { + "normalizedValue": 100.0, + "rawValue": 6.0 + } + }, + "SearchMessages": { + "SearchMessages": { + "normalizedValue": 100.0, + "rawValue": 9.0 + } + }, + "SendEmail": { + "SendEmail": { + "normalizedValue": 100.0, + "rawValue": 20.0 + } + }, + "ShowNext": { + "ShowNext": { + "normalizedValue": 100.0, + "rawValue": 4.0 + } + }, + "ShowPrevious": { + "ShowPrevious": { + "normalizedValue": 100.0, + "rawValue": 3.0 + } + } + }, + "intents": { + "AddMore": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 17, + "trueNegativeCount": 104, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Cancel": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 9, + "trueNegativeCount": 112, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "SendEmail": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 20, + "trueNegativeCount": 101, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "CheckMessages": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 9, + "trueNegativeCount": 112, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "AddFlag": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 6, + "trueNegativeCount": 115, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Reply": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 6, + "trueNegativeCount": 115, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "ReadAloud": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 16, + "trueNegativeCount": 105, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "QueryLastText": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 6, + "trueNegativeCount": 115, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "SearchMessages": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 9, + "trueNegativeCount": 112, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Delete": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 5, + "trueNegativeCount": 116, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Forward": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 6, + "trueNegativeCount": 115, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "Confirm": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 4, + "trueNegativeCount": 117, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "ShowNext": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 4, + "trueNegativeCount": 117, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "ShowPrevious": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 3, + "trueNegativeCount": 118, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + }, + "None": { + "f1": 1.0, + "precision": 1.0, + "recall": 1.0, + "truePositiveCount": 1, + "trueNegativeCount": 120, + "falsePositiveCount": 0, + "falseNegativeCount": 0 + } + }, + "microF1": 1.0, + "microPrecision": 1.0, + "microRecall": 1.0, + "macroF1": 1.0, + "macroPrecision": 1.0, + "macroRecall": 1.0 + }, + "evaluationOptions": { + "kind": "percentage", + "trainingSplitPercentage": 80, + "testingSplitPercentage": 20 + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetProject.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetProject.json new file mode 100644 index 000000000000..4b57f8b28acc --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetProject.json @@ -0,0 +1,26 @@ +{ + "operationId": "ConversationAuthoringProject_GetProject", + "title": "Successful Get Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "myproject" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2022-04-18T13:53:03Z", + "lastModifiedDateTime": "2022-04-18T13:53:03Z", + "lastTrainedDateTime": "2022-04-18T14:14:28Z", + "lastDeployedDateTime": "2022-04-18T14:49:01Z", + "projectKind": "Conversation", + "projectName": "myproject", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json new file mode 100644 index 000000000000..69c2fb79ca2f --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json @@ -0,0 +1,22 @@ +{ + "operationId": "ConversationAuthoringProject_GetProjectDeletionStatus", + "title": "Successful Get Project Deletion Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "jobId": "129d3182-625d-496c-bcf9-43686e85160b_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "129d3182-625d-496c-bcf9-43686e85160b_637858368000000000", + "createdDateTime": "2022-04-18T14:02:34Z", + "lastUpdatedDateTime": "2022-04-18T14:02:34Z", + "expirationDateTime": "2022-04-25T14:02:34Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json new file mode 100644 index 000000000000..1a13627eebf0 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json @@ -0,0 +1,400 @@ +{ + "operationId": "ConversationAuthoringListSupportedLanguages", + "title": "Successful Get Supported Languages", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectKind": "Conversation" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "languageName": "English", + "languageCode": "en" + }, + { + "languageName": "English", + "languageCode": "en-us" + }, + { + "languageName": "English (UK)", + "languageCode": "en-gb" + }, + { + "languageName": "French", + "languageCode": "fr" + }, + { + "languageName": "Italian", + "languageCode": "it" + }, + { + "languageName": "Spanish", + "languageCode": "es" + }, + { + "languageName": "German", + "languageCode": "de" + }, + { + "languageName": "Portuguese (Brazil)", + "languageCode": "pt-br" + }, + { + "languageName": "Portuguese (Portugal)", + "languageCode": "pt-pt" + }, + { + "languageName": "Chinese (Simplified)", + "languageCode": "zh-hans" + }, + { + "languageName": "Japanese", + "languageCode": "ja" + }, + { + "languageName": "Korean", + "languageCode": "ko" + }, + { + "languageName": "Dutch", + "languageCode": "nl" + }, + { + "languageName": "Hindi", + "languageCode": "hi" + }, + { + "languageName": "Turkish", + "languageCode": "tr" + }, + { + "languageName": "Gujarati", + "languageCode": "gu" + }, + { + "languageName": "Marathi", + "languageCode": "mr" + }, + { + "languageName": "Tamil", + "languageCode": "ta" + }, + { + "languageName": "Telugu", + "languageCode": "te" + }, + { + "languageName": "Zulu", + "languageCode": "zu" + }, + { + "languageName": "Afrikaans", + "languageCode": "af" + }, + { + "languageName": "Amharic", + "languageCode": "am" + }, + { + "languageName": "Arabic", + "languageCode": "ar" + }, + { + "languageName": "Assamese", + "languageCode": "as" + }, + { + "languageName": "Azerbaijani", + "languageCode": "az" + }, + { + "languageName": "Belarusian", + "languageCode": "be" + }, + { + "languageName": "Bulgarian", + "languageCode": "bg" + }, + { + "languageName": "Breton", + "languageCode": "br" + }, + { + "languageName": "Bosnian", + "languageCode": "bs" + }, + { + "languageName": "Catalan", + "languageCode": "ca" + }, + { + "languageName": "Czech", + "languageCode": "cs" + }, + { + "languageName": "Welsh", + "languageCode": "cy" + }, + { + "languageName": "Danish", + "languageCode": "da" + }, + { + "languageName": "Greek", + "languageCode": "el" + }, + { + "languageName": "Esperanto", + "languageCode": "eo" + }, + { + "languageName": "Estonian", + "languageCode": "et" + }, + { + "languageName": "Basque", + "languageCode": "eu" + }, + { + "languageName": "Persian", + "languageCode": "fa" + }, + { + "languageName": "Finnish", + "languageCode": "fi" + }, + { + "languageName": "Western Frisian", + "languageCode": "fy" + }, + { + "languageName": "Irish", + "languageCode": "ga" + }, + { + "languageName": "Scottish Gaelic", + "languageCode": "gd" + }, + { + "languageName": "Galician", + "languageCode": "gl" + }, + { + "languageName": "Hausa", + "languageCode": "ha" + }, + { + "languageName": "Hebrew", + "languageCode": "he" + }, + { + "languageName": "Croatian", + "languageCode": "hr" + }, + { + "languageName": "Hungarian", + "languageCode": "hu" + }, + { + "languageName": "Armenian", + "languageCode": "hy" + }, + { + "languageName": "Indonesian", + "languageCode": "id" + }, + { + "languageName": "Javanese", + "languageCode": "jv" + }, + { + "languageName": "Georgian", + "languageCode": "ka" + }, + { + "languageName": "Kazakh", + "languageCode": "kk" + }, + { + "languageName": "Khmer", + "languageCode": "km" + }, + { + "languageName": "Kannada", + "languageCode": "kn" + }, + { + "languageName": "Kurdish (Kurmanji)", + "languageCode": "ku" + }, + { + "languageName": "Kyrgyz", + "languageCode": "ky" + }, + { + "languageName": "Latin", + "languageCode": "la" + }, + { + "languageName": "Lao", + "languageCode": "lo" + }, + { + "languageName": "Lithuanian", + "languageCode": "lt" + }, + { + "languageName": "Latvian", + "languageCode": "lv" + }, + { + "languageName": "Malagasy", + "languageCode": "mg" + }, + { + "languageName": "Macedonian", + "languageCode": "mk" + }, + { + "languageName": "Malayalam", + "languageCode": "ml" + }, + { + "languageName": "Mongolian", + "languageCode": "mn" + }, + { + "languageName": "Malay", + "languageCode": "ms" + }, + { + "languageName": "Burmese", + "languageCode": "my" + }, + { + "languageName": "Nepali", + "languageCode": "ne" + }, + { + "languageName": "Norwegian (Bokmal)", + "languageCode": "nb" + }, + { + "languageName": "Odia", + "languageCode": "or" + }, + { + "languageName": "Punjabi", + "languageCode": "pa" + }, + { + "languageName": "Polish", + "languageCode": "pl" + }, + { + "languageName": "Pashto", + "languageCode": "ps" + }, + { + "languageName": "Romanian", + "languageCode": "ro" + }, + { + "languageName": "Russian", + "languageCode": "ru" + }, + { + "languageName": "Sanskrit", + "languageCode": "sa" + }, + { + "languageName": "Sindhi", + "languageCode": "sd" + }, + { + "languageName": "Sinhala", + "languageCode": "si" + }, + { + "languageName": "Slovak", + "languageCode": "sk" + }, + { + "languageName": "Slovenian", + "languageCode": "sl" + }, + { + "languageName": "Somali", + "languageCode": "so" + }, + { + "languageName": "Albanian", + "languageCode": "sq" + }, + { + "languageName": "Serbian", + "languageCode": "sr" + }, + { + "languageName": "Sundanese", + "languageCode": "su" + }, + { + "languageName": "Swedish", + "languageCode": "sv" + }, + { + "languageName": "Swahili", + "languageCode": "sw" + }, + { + "languageName": "Thai", + "languageCode": "th" + }, + { + "languageName": "Filipino", + "languageCode": "tl" + }, + { + "languageName": "Uyghur", + "languageCode": "ug" + }, + { + "languageName": "Ukrainian", + "languageCode": "uk" + }, + { + "languageName": "Urdu", + "languageCode": "ur" + }, + { + "languageName": "Uzbek", + "languageCode": "uz" + }, + { + "languageName": "Vietnamese", + "languageCode": "vi" + }, + { + "languageName": "Xhosa", + "languageCode": "xh" + }, + { + "languageName": "Yiddish", + "languageCode": "yi" + }, + { + "languageName": "Chinese (Traditional)", + "languageCode": "zh-hant" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json new file mode 100644 index 000000000000..bf9840c730c0 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json @@ -0,0 +1,100 @@ +{ + "operationId": "ConversationAuthoringListSupportedPrebuiltEntities", + "title": "Successful Get Supported Prebuilt Entities", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "language": "en" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "category": "Person.Name", + "description": "Name of an individual", + "examples": "john, Sam, Lisa" + }, + { + "category": "General.Event", + "description": "Important events", + "examples": "World War two, Covid 19" + }, + { + "category": "General.Organization", + "description": "Companies and corporations", + "examples": "Microsoft, Amazon" + }, + { + "category": "Choice.Boolean", + "description": "boolean choice", + "examples": "yes, no, agreed" + }, + { + "category": "Quantity.Age", + "description": "Age of a person or thing", + "examples": "10-month-old, 19 years old, 58 year-old" + }, + { + "category": "Quantity.NumberRange", + "description": "a numeric interval", + "examples": "between 25 and 35, 25-35" + }, + { + "category": "Quantity.Number", + "description": "A cardinal number in numeric or text form", + "examples": "ten, forty two, 3.141, 10K" + }, + { + "category": "Quantity.Percentage", + "description": "A percentage, using the symbol % or the word \"percent\"", + "examples": "10%, 5.6 percent" + }, + { + "category": "Quantity.Ordinal", + "description": "An ordinal number in numeric or text form", + "examples": "first, second, tenth, 1st, 2nd, 10th" + }, + { + "category": "Quantity.Dimension", + "description": "Spacial dimensions, including length, distance, area, and volume", + "examples": "2 miles, 650 square kilometres, 9,350 feet" + }, + { + "category": "Quantity.Temperature", + "description": "A temperature in celsius or fahrenheit", + "examples": "32F, 34 degrees celsius, 2 deg C" + }, + { + "category": "Quantity.Currency", + "description": "Monetary amounts, including currency", + "examples": "1000.00 US dollars, £20.00, $ 67.5 B" + }, + { + "category": "DateTime", + "description": "exact date values", + "examples": "May 11th" + }, + { + "category": "Email", + "description": "Email addresses", + "examples": "user@example.net, user_name@example.com, user.Name12@example.net" + }, + { + "category": "Phone Number", + "description": "US phone numbers", + "examples": "123-456-7890, +1 123 456 789, (123)456-789" + }, + { + "category": "URL", + "description": "Websites URLs and links", + "examples": "www.example.com, http://example.net?name=my_name&age=10" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json new file mode 100644 index 000000000000..f1e28809e584 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json @@ -0,0 +1,24 @@ +{ + "operationId": "ConversationAuthoringListTrainingConfigVersions", + "title": "Successful Get Supported Training Config Versions", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectKind": "Conversation" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "trainingConfigVersion": "2022-05-01", + "modelExpirationDate": "2022-10-28" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json new file mode 100644 index 000000000000..1fae33370983 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetSwapDeploymentsStatus", + "title": "Successful Get Swap Deployments Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "c36a8775-35b9-4cb5-a8db-665e7d91aafe_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "c36a8775-35b9-4cb5-a8db-665e7d91aafe_637858368000000000", + "createdDateTime": "2022-04-18T16:09:50Z", + "lastUpdatedDateTime": "2022-04-18T16:09:58Z", + "expirationDateTime": "2022-04-25T16:09:50Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetTrainStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetTrainStatus.json new file mode 100644 index 000000000000..e18f641e8ad7 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetTrainStatus.json @@ -0,0 +1,38 @@ +{ + "operationId": "ConversationAuthoringProject_GetTrainingStatus", + "title": "Successful Get Train Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "result": { + "modelLabel": "model1", + "trainingConfigVersion": "2022-05-01", + "trainingMode": "standard", + "estimatedEndDateTime": "2022-04-18T15:47:58.8190649Z", + "trainingStatus": { + "percentComplete": 3, + "startDateTime": "2022-04-18T15:45:06.8190649Z", + "status": "running" + }, + "evaluationStatus": { + "percentComplete": 0, + "status": "notStarted" + } + }, + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000", + "createdDateTime": "2022-04-18T15:44:44Z", + "lastUpdatedDateTime": "2022-04-18T15:45:48Z", + "expirationDateTime": "2022-04-25T15:44:44Z", + "status": "running" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json new file mode 100644 index 000000000000..6fdb262e129a --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetUnassignDeploymentResourcesStatus", + "title": "Successful Get Unassign Deployment Resources Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json new file mode 100644 index 000000000000..fe3d562e321f --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_GetUnassignProjectResourcesStatus", + "title": "Successful Get Unassign Project Resources Status", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "jobId": "66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000", + "createdDateTime": "2022-04-18T15:52:48Z", + "lastUpdatedDateTime": "2022-04-18T15:53:04Z", + "expirationDateTime": "2022-04-25T15:52:48Z", + "status": "succeeded" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulImportProject.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulImportProject.json new file mode 100644 index 000000000000..2454757151f1 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulImportProject.json @@ -0,0 +1,80 @@ +{ + "operationId": "ConversationAuthoringProject_Import", + "title": "Successful Import Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "body": { + "projectFileVersion": "2022-05-01", + "stringIndexType": "Utf16CodeUnit", + "metadata": { + "projectKind": "Conversation", + "settings": { + "confidenceThreshold": 0.7 + }, + "projectName": "EmailApp", + "multilingual": true, + "description": "Trying out CLU", + "language": "en-us" + }, + "assets": { + "projectKind": "Conversation", + "intents": [ + { + "category": "Read" + }, + { + "category": "Delete" + } + ], + "entities": [ + { + "category": "Sender" + }, + { + "category": "Number", + "regex": { + "expressions": [ + { + "regexKey": "UK Phone numbers", + "language": "en-us", + "regexPattern": "/^\\(?([0-9]{3})\\)?[-.\\s]?([0-9]{3})[-.\\s]?([0-9]{4})$/" + } + ] + } + } + ], + "utterances": [ + { + "text": "Open Blake's email", + "dataset": "Train", + "intent": "Read", + "entities": [ + { + "category": "Sender", + "offset": 5, + "length": 5 + } + ] + }, + { + "text": "Delete last email", + "language": "en-gb", + "dataset": "Test", + "intent": "Delete", + "entities": [] + } + ] + } + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/import/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json new file mode 100644 index 000000000000..295f12525388 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json @@ -0,0 +1,28 @@ +{ + "operationId": "ConversationAuthoringListAssignedResourceDeployments", + "title": "Successful List Assigned Resource Deployments", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "projectName": "Booking", + "deploymentsMetadata": [ + { + "deploymentName": "staging", + "lastDeployedDateTime": "2022-04-18T14:49:01Z", + "deploymentExpirationDate": "2023-10-28" + } + ] + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListDeploymentResources.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListDeploymentResources.json new file mode 100644 index 000000000000..25efc9786690 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListDeploymentResources.json @@ -0,0 +1,27 @@ +{ + "operationId": "ConversationAuthoringListDeploymentResources", + "title": "Successful List Deployment Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu", + "region": "westeurope" + }, + { + "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestEus", + "region": "eastus" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListDeployments.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListDeployments.json new file mode 100644 index 000000000000..36ab3ea6bd98 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListDeployments.json @@ -0,0 +1,35 @@ +{ + "operationId": "ConversationAuthoringListDeployments", + "title": "Successful List Deployments", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "deploymentName": "production", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49.4334381Z", + "lastDeployedDateTime": "2022-04-18T16:03:51Z", + "deploymentExpirationDate": "2023-10-28", + "modelTrainingConfigVersion": "2022-05-01" + }, + { + "deploymentName": "staging", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49.4334381Z", + "lastDeployedDateTime": "2022-04-18T15:53:04Z", + "deploymentExpirationDate": "2023-10-28", + "modelTrainingConfigVersion": "2022-05-01" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListModels.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListModels.json new file mode 100644 index 000000000000..dd0202a881a8 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListModels.json @@ -0,0 +1,38 @@ +{ + "operationId": "ConversationAuthoringListTrainedModels", + "title": "Successful List Models", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "label": "model1", + "modelId": "model1-20220418T034749-299f45b8114849538c1a750b21b05a94", + "lastTrainedDateTime": "2022-04-18T15:47:49Z", + "lastTrainingDurationInSeconds": 186, + "modelExpirationDate": "2022-10-28", + "modelTrainingConfigVersion": "2022-05-01", + "hasSnapshot": true + }, + { + "label": "model2", + "modelId": "model2-20220418T052522-c63bd244dd9e4bf8adec1a7129968c99", + "lastTrainedDateTime": "2022-04-18T17:25:22Z", + "lastTrainingDurationInSeconds": 192, + "modelExpirationDate": "2022-10-28", + "modelTrainingConfigVersion": "2022-05-01", + "hasSnapshot": true + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListProjects.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListProjects.json new file mode 100644 index 000000000000..7e1a5e10ee56 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListProjects.json @@ -0,0 +1,37 @@ +{ + "operationId": "ConversationAuthoringListProjects", + "title": "Successful List Projects", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "createdDateTime": "2022-04-18T14:03:16Z", + "lastModifiedDateTime": "2022-04-18T14:03:16Z", + "projectKind": "Conversation", + "projectName": "myproject1", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + }, + { + "createdDateTime": "2022-04-18T14:03:12Z", + "lastModifiedDateTime": "2022-04-18T14:03:12Z", + "projectKind": "Conversation", + "projectName": "myproject", + "multilingual": false, + "description": "This is a sample conversation project.", + "language": "en" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListTrainingJobs.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListTrainingJobs.json new file mode 100644 index 000000000000..d69991b7a1a2 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListTrainingJobs.json @@ -0,0 +1,92 @@ +{ + "operationId": "ConversationAuthoringListTrainingJobs", + "title": "Successful List Training Jobs", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "value": [ + { + "result": { + "modelLabel": "model1", + "trainingConfigVersion": "2022-05-01", + "trainingMode": "advanced", + "trainingStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T15:45:06.8190649Z", + "endDateTime": "2022-04-18T15:47:19.2639682Z", + "status": "succeeded" + }, + "evaluationStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T15:47:19.2734976Z", + "endDateTime": "2022-04-18T15:47:23.8378892Z", + "status": "succeeded" + } + }, + "jobId": "8ccf2ffe-e758-4d04-a44a-31512918c7e8_637858368000000000", + "createdDateTime": "2022-04-18T15:44:44Z", + "lastUpdatedDateTime": "2022-04-18T15:47:50Z", + "expirationDateTime": "2022-04-25T15:44:44Z", + "status": "succeeded" + }, + { + "result": { + "modelLabel": "model2", + "trainingConfigVersion": "2022-05-01", + "trainingMode": "standard", + "trainingStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T17:22:39.3663023Z", + "endDateTime": "2022-04-18T17:24:51.9440947Z", + "status": "succeeded" + }, + "evaluationStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T17:24:51.9571747Z", + "endDateTime": "2022-04-18T17:24:58.1427823Z", + "status": "succeeded" + } + }, + "jobId": "9145f93f-6f37-418c-8527-d2ded84cece0_637858368000000000", + "createdDateTime": "2022-04-18T17:22:11Z", + "lastUpdatedDateTime": "2022-04-18T17:25:23Z", + "expirationDateTime": "2022-04-25T17:22:11Z", + "status": "succeeded" + }, + { + "result": { + "modelLabel": "model2", + "trainingConfigVersion": "2022-05-01", + "trainingMode": "standard", + "trainingStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T17:44:41.388358Z", + "endDateTime": "2022-04-18T17:50:29.5675101Z", + "status": "succeeded" + }, + "evaluationStatus": { + "percentComplete": 100, + "startDateTime": "2022-04-18T17:50:29.5808461Z", + "endDateTime": "2022-04-18T17:50:35.3482185Z", + "status": "succeeded" + } + }, + "jobId": "ee23c900-354d-4b6d-96e1-8197db2bd5f7_637858368000000000", + "createdDateTime": "2022-04-18T17:44:04Z", + "lastUpdatedDateTime": "2022-04-18T17:51:11Z", + "expirationDateTime": "2022-04-25T17:44:04Z", + "status": "succeeded" + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulLoadSnapshot.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulLoadSnapshot.json new file mode 100644 index 000000000000..7a4f210b2265 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulLoadSnapshot.json @@ -0,0 +1,18 @@ +{ + "operationId": "ConversationAuthoringTrainedModel_LoadSnapshot", + "title": "Successful Load Snapshot", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "trainedModelLabel": "model1" + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/models/model1/load-snapshot/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulSwapDeployments.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulSwapDeployments.json new file mode 100644 index 000000000000..132fd936af1c --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulSwapDeployments.json @@ -0,0 +1,21 @@ +{ + "operationId": "ConversationAuthoringProject_SwapDeployments", + "title": "Successful Swap Deployments", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "body": { + "firstDeploymentName": "production", + "secondDeploymentName": "staging" + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/swap/jobs/c36a8775-35b9-4cb5-a8db-665e7d91aafe_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulTrainProject.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulTrainProject.json new file mode 100644 index 000000000000..e9dbf067416b --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulTrainProject.json @@ -0,0 +1,27 @@ +{ + "operationId": "ConversationAuthoringProject_Train", + "title": "Successful Train Project", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "body": { + "modelLabel": "model1", + "trainingMode": "standard", + "trainingConfigVersion": "latest", + "evaluationOptions": { + "kind": "percentage", + "testingSplitPercentage": 20, + "trainingSplitPercentage": 80 + } + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/train/jobs/4d37982f-fded-4c2c-afe3-15953b5919b6_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json new file mode 100644 index 000000000000..8356d353898b --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_UnassignDeploymentResources", + "title": "Successful Unassign Deployment Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "production", + "body": { + "assignedResourceIds": [ + "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu" + ] + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/resources/unassign/jobs/66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000?api-version=2025-11-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json new file mode 100644 index 000000000000..8187ad4c4bfe --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json @@ -0,0 +1,23 @@ +{ + "operationId": "ConversationAuthoringProject_UnassignProjectResources", + "title": "Successful Unassign Project Resources", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2025-11-01", + "projectName": "EmailApp", + "deploymentName": "production", + "body": { + "assignedResourceIds": [ + "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu" + ] + } + }, + "responses": { + "202": { + "headers": { + "operation-location": "{Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/resources/unassign/jobs/66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000?api-version=2025-11-01" + } + } + } +}