From 72bc5d8f1e1790c28b0932945a44c3eaf70eb682 Mon Sep 17 00:00:00 2001 From: "Amber Chen (Centific Technologies Inc)" Date: Sun, 28 Sep 2025 16:19:36 -0700 Subject: [PATCH 1/9] added v2025_11_01 --- .../Language.AnalyzeConversations-authoring/main.tsp | 3 +++ 1 file changed, 3 insertions(+) diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp index a0f1ce5fc03b..4c19972c4f93 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp @@ -46,6 +46,9 @@ enum Versions { /** Version 2023-04-01 */ v2023_04_01: "2023-04-01", + /** Version 2025-11-01 */ + v2025_11_01: "2025-11-01", + /** * The 2024-11-15-preview API version. */ From df950322213b154cbac26f24b21f840b121f2849 Mon Sep 17 00:00:00 2001 From: "Amber Chen (Centific Technologies Inc)" Date: Mon, 29 Sep 2025 10:13:06 -0700 Subject: [PATCH 2/9] removed 2024-11-15-preview --- .../main.tsp | 11 +- .../models/common.tsp | 2 +- .../models/project.tsp | 36 +- .../routes.tsp | 36 +- .../analyzeconversations-authoring.json | 5486 +++++++++++++++++ 5 files changed, 5526 insertions(+), 45 deletions(-) create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/analyzeconversations-authoring.json diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp index 4c19972c4f93..bca840cce92f 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp @@ -46,16 +46,11 @@ enum Versions { /** Version 2023-04-01 */ v2023_04_01: "2023-04-01", - /** Version 2025-11-01 */ - v2025_11_01: "2025-11-01", - - /** - * The 2024-11-15-preview API version. - */ - v2024_11_15_preview: "2024-11-15-preview", - /** * The 2025-05-15-preview API version. */ v2025_05_15_preview: "2025-05-15-preview", + + /** Version 2025-11-01 */ + v2025_11_01: "2025-11-01", } diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/common.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/common.tsp index 4c077342fd52..2354b76c5e7f 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_05_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..cd40292b7f27 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_05_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_05_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_05_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_05_15_preview) model AnalyzeConversationAuthoringCopiedProjectOptions { /** * Represents the project kind. @@ -327,7 +327,7 @@ model AnalyzeConversationAuthoringEvaluationOptions { /** * Represents the state of a copy job. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) @resource("copy/jobs") @parentResource(AnalyzeConversationAuthoringProjectMetadata) model AnalyzeConversationAuthoringCopiedProjectJobState { @@ -432,7 +432,7 @@ model AnalyzeConversationAuthoringProjectDeployment { /** * Represents the metadata of the assigned Azure resources. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) assignedResources: AnalyzeConversationAuthoringDeploymentResource[]; } @@ -469,7 +469,7 @@ model AnalyzeConversationAuthoringCreateDeploymentOptions { /** * 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. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) @removed(Versions.v2025_05_15_preview) assignedResourceIds?: string[]; @@ -1000,7 +1000,7 @@ model AnalyzeConversationAuthoringLoadSnapshotJobState { /** * Represents the assigned deployment resources. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) model AnalyzeConversationAuthoringAssignedDeploymentResources { /** * The list of assigned deployment resources. @@ -1016,7 +1016,7 @@ model AnalyzeConversationAuthoringAssignedDeploymentResources { /** * Represents the assigned deployment resource. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) @resource("resources") @parentResource(AnalyzeConversationAuthoringProjectMetadata) model AnalyzeConversationAuthoringAssignedDeploymentResource { @@ -1036,7 +1036,7 @@ model AnalyzeConversationAuthoringAssignedDeploymentResource { /** * Represents the options for assigning Azure resources to a project. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) model AnalyzeConversationAuthoringAssignDeploymentResourcesOptions { /** * Represents the metadata for the resources to be assigned. @@ -1067,7 +1067,7 @@ model AnalyzeConversationAuthoringResourceMetadata { /** * Represents the options to unassign Azure resources from a project. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) model AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions { /** * Represents the assigned resource IDs to be unassigned. @@ -1078,7 +1078,7 @@ model AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions { /** * Represents the state of a deployment resources job. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) @resource("resources/assign/jobs") @parentResource(AnalyzeConversationAuthoringProjectMetadata) model AnalyzeConversationAuthoringDeploymentResourcesJobState { @@ -1190,7 +1190,7 @@ model AnalyzeConversationAuthoringProjectDeletionJobState { /** * Represents the metadata for deployments assigned to a resource. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) model AnalyzeConversationAuthoringAssignedResourceDeploymentsMetadata { /** * The list of retrieved assigned project deployments. @@ -1206,7 +1206,7 @@ model AnalyzeConversationAuthoringAssignedResourceDeploymentsMetadata { /** * Represents the metadata for assigned deployments for a project. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) @resource("authoring/analyze-conversations/projects/global/deployments/resources") model AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata { /** @@ -1225,7 +1225,7 @@ model AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata { /** * Represents the metadata for an assigned deployment */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) model AnalyzeConversationAuthoringAssignedProjectDeploymentMetadata { /** * Represents the deployment name. @@ -1834,7 +1834,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_05_15_preview) @resource("jobs") @parentResource(AnalyzeConversationAuthoringExportedTrainedModel) model AnalyzeConversationAuthoringExportedModelJobState { @@ -1843,7 +1843,7 @@ model AnalyzeConversationAuthoringExportedModelJobState { /** * Represents the properties for the model file. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) model AnalyzeConversationAuthoringModelFile { /** * The name of the file. @@ -1858,7 +1858,7 @@ model AnalyzeConversationAuthoringModelFile { /** * Represents the options for creating or replacing an exported model. */ -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) model ExportedModelOptions { /** * The trained model label. diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp index bb229906a122..c08462dfb4f5 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp @@ -56,7 +56,7 @@ 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_05_15_preview) op conversationAuthoringListAssignedResourceDeployments is languageOperations.ResourceList< AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata, ListQueryParametersTrait @@ -66,7 +66,7 @@ op conversationAuthoringListAssignedResourceDeployments is languageOperations.Re * Lists the deployments resources assigned to the project. */ #suppress "@azure-tools/typespec-azure-core/use-standard-names" -@added(Versions.v2024_11_15_preview) +@added(Versions.v2025_05_15_preview) op conversationAuthoringListDeploymentResources is languageOperations.ResourceList< AnalyzeConversationAuthoringAssignedDeploymentResource, ListQueryParametersTrait @@ -114,7 +114,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_05_15_preview) op conversationAuthoringListExportedModels is languageOperations.ResourceList< AnalyzeConversationAuthoringExportedTrainedModel, ListQueryParametersTrait @@ -200,7 +200,7 @@ interface ConversationAuthoringDeployment { ConversationAuthoringDeployment.getDeploymentDeleteFromResourcesStatus ) @access(Access.internal, "python") - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) deleteDeploymentFromResources is Foundations.LongRunningOperation< { /** @@ -231,7 +231,7 @@ interface ConversationAuthoringDeployment { /** * Gets the status of an existing delete deployment from specific resources job. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) getDeploymentDeleteFromResourcesStatus is languageOperations.ResourceRead; /** @@ -251,7 +251,7 @@ interface ConversationAuthoringProject { ConversationAuthoringProject.getAssignDeploymentResourcesStatus ) @access(Access.internal, "python") - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) assignDeploymentResources is Foundations.LongRunningOperation< { /** @@ -283,7 +283,7 @@ interface ConversationAuthoringProject { ConversationAuthoringProject.getUnassignDeploymentResourcesStatus ) @access(Access.internal, "python") - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) unassignDeploymentResources is Foundations.LongRunningOperation< { /** @@ -308,7 +308,7 @@ interface ConversationAuthoringProject { /** * Gets the status of an existing assign deployment resources job. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) getAssignDeploymentResourcesStatus is languageOperations.ResourceRead; /** @@ -317,7 +317,7 @@ interface ConversationAuthoringProject { #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_05_15_preview) getUnassignDeploymentResourcesStatus is Azure.Core.Foundations.Operation< { /** @@ -535,7 +535,7 @@ interface ConversationAuthoringProject { */ #suppress "@azure-tools/typespec-azure-core/casing-style" @post - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) @actionSeparator("/:") @action("authorize-copy") copyProjectAuthorization is languageOperations.ResourceAction< @@ -552,7 +552,7 @@ interface ConversationAuthoringProject { @post @pollingOperation(ConversationAuthoringProject.getCopyProjectStatus) @access(Access.internal, "python") - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) copyProject is Foundations.LongRunningOperation< { /** @@ -577,7 +577,7 @@ interface ConversationAuthoringProject { /** * Gets the status of an existing copy project job. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) getCopyProjectStatus is languageOperations.ResourceRead; /** @@ -645,7 +645,7 @@ interface ConversationAuthoringExportedModel { /** * Gets the details of an exported model. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) getExportedModel is languageOperations.ResourceRead; /** @@ -657,7 +657,7 @@ interface ConversationAuthoringExportedModel { @pollingOperation( ConversationAuthoringExportedModel.getExportedModelJobStatus ) - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) @access(Access.internal, "python") deleteExportedModel is Foundations.LongRunningOperation< { @@ -686,7 +686,7 @@ interface ConversationAuthoringExportedModel { @pollingOperation( ConversationAuthoringExportedModel.getExportedModelJobStatus ) - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) @access(Access.internal, "python") createOrUpdateExportedModel is Foundations.LongRunningOperation< { @@ -716,7 +716,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_05_15_preview) getExportedModelJobStatus is languageOperations.ResourceRead; } interface ConversationAuthoringTrainedModel { @@ -737,7 +737,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_05_15_preview) evaluateModel is Foundations.LongRunningOperation< { /** @@ -795,7 +795,7 @@ interface ConversationAuthoringTrainedModel { /** * Gets the status for an evaluation job. */ - @added(Versions.v2024_11_15_preview) + @added(Versions.v2025_05_15_preview) getEvaluationStatus is languageOperations.ResourceRead; /** 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..45e38250c7d1 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/analyzeconversations-authoring.json @@ -0,0 +1,5486 @@ +{ + "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-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." + } + } + } + } + }, + "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." + } + } + } + } + }, + "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-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/:authorize-copy": { + "post": { + "operationId": "ConversationAuthoringProject_CopyProjectAuthorization", + "description": "Generates a copy project operation authorization to the current target Azure resource.", + "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", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringCopyAuthorizationOptions" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringCopiedProjectOptions" + } + }, + "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." + } + } + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/:copy": { + "post": { + "operationId": "ConversationAuthoringProject_CopyProject", + "description": "Copies an existing project to another Azure resource.", + "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 copy project info.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringCopiedProjectOptions" + } + } + ], + "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-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-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-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-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/copy/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetCopyProjectStatus", + "description": "Gets the status of an existing copy project 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/AnalyzeConversationAuthoringCopiedProjectJobState" + } + }, + "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." + } + } + } + } + } + }, + "/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-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." + } + } + } + } + }, + "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-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-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}/:delete-from-resources": { + "post": { + "operationId": "ConversationAuthoringDeployment_DeleteDeploymentFromResources", + "description": "Deletes a project deployment from the specified 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 options for deleting the deployment.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDeleteDeploymentOptions" + } + } + ], + "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-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." + } + } + } + } + } + }, + "/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." + } + } + } + } + } + }, + "/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-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." + } + } + } + } + } + }, + "/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." + } + } + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/exported-models": { + "get": { + "operationId": "ConversationAuthoringListExportedModels", + "description": "Lists the exported 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/PagedAnalyzeConversationAuthoringExportedTrainedModel" + } + }, + "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}/exported-models/{exportedModelName}": { + "get": { + "operationId": "ConversationAuthoringExportedModel_GetExportedModel", + "description": "Gets the details of an exported model.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "exportedModelName", + "in": "path", + "description": "The exported model name.", + "required": true, + "type": "string" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedTrainedModel" + } + }, + "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." + } + } + } + } + }, + "put": { + "operationId": "ConversationAuthoringExportedModel_CreateOrUpdateExportedModel", + "description": "Creates a new exported model 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" + }, + { + "name": "exportedModelName", + "in": "path", + "description": "The exported model name.", + "required": true, + "type": "string" + }, + { + "name": "body", + "in": "body", + "description": "The exported model info.", + "required": true, + "schema": { + "$ref": "#/definitions/ExportedModelOptions" + } + } + ], + "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-long-running-operation": true + }, + "delete": { + "operationId": "ConversationAuthoringExportedModel_DeleteExportedModel", + "description": "Deletes an existing exported model.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The name of the project to use.", + "required": true, + "type": "string" + }, + { + "name": "exportedModelName", + "in": "path", + "description": "The exported model name.", + "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-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/exported-models/{exportedModelName}/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringExportedModel_GetExportedModelJobStatus", + "description": "Gets the status for an existing job to create or update an exported model.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "projectName", + "in": "path", + "description": "The new project name.", + "required": true, + "type": "string", + "maxLength": 100 + }, + { + "name": "exportedModelName", + "in": "path", + "description": "The exported model 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/AnalyzeConversationAuthoringExportedModelJobState" + } + }, + "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." + } + } + } + } + } + }, + "/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." + } + } + } + } + } + }, + "/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-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." + } + } + } + } + }, + "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." + } + } + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/:evaluate": { + "post": { + "operationId": "ConversationAuthoringTrainedModel_EvaluateModel", + "description": "Triggers evaluation operation on a trained model.", + "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" + }, + { + "name": "body", + "in": "body", + "description": "The training input parameters.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringEvaluationOptions" + } + } + ], + "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-long-running-operation": true + } + }, + "/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-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluate/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringTrainedModel_GetEvaluationStatus", + "description": "Gets the status for an evaluation job.", + "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/AnalyzeConversationAuthoringEvaluationJobState" + } + }, + "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." + } + } + } + } + } + }, + "/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-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." + } + } + } + } + } + }, + "/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." + } + } + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/resources": { + "get": { + "operationId": "ConversationAuthoringListDeploymentResources", + "description": "Lists the deployments 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/PagedAnalyzeConversationAuthoringAssignedDeploymentResource" + } + }, + "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_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", + "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 info.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringAssignDeploymentResourcesOptions" + } + } + ], + "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-long-running-operation": true + } + }, + "/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.", + "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 info for the deployment resources to be deleted.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions" + } + } + ], + "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-long-running-operation": true + } + }, + "/authoring/analyze-conversations/projects/{projectName}/resources/assign/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetAssignDeploymentResourcesStatus", + "description": "Gets the status of an existing assign deployment 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/AnalyzeConversationAuthoringDeploymentResourcesJobState" + } + }, + "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." + } + } + } + } + } + }, + "/authoring/analyze-conversations/projects/{projectName}/resources/unassign/jobs/{jobId}": { + "get": { + "operationId": "ConversationAuthoringProject_GetUnassignDeploymentResourcesStatus", + "description": "Gets the status of an existing unassign deployment 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/AnalyzeConversationAuthoringDeploymentResourcesJobState" + } + }, + "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." + } + } + } + } + } + }, + "/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-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." + } + } + } + } + } + }, + "/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-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." + } + } + } + } + } + }, + "/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-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-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-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-pageable": { + "nextLinkName": "nextLink" + } + } + } + }, + "definitions": { + "AnalyzeConversationAuthoringAssignDeploymentResourcesOptions": { + "type": "object", + "description": "Represents the options for assigning Azure resources to a project.", + "properties": { + "resourcesMetadata": { + "type": "array", + "description": "Represents the metadata for the resources to be assigned.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringResourceMetadata" + } + } + }, + "required": [ + "resourcesMetadata" + ] + }, + "AnalyzeConversationAuthoringAssignedDeploymentResource": { + "type": "object", + "description": "Represents the assigned deployment resource.", + "properties": { + "azureResourceId": { + "type": "string", + "description": "The resource ID.", + "readOnly": true + }, + "region": { + "type": "string", + "description": "The resource region." + } + }, + "required": [ + "azureResourceId", + "region" + ] + }, + "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." + }, + "description": { + "type": "string", + "description": "The entity description." + }, + "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." + }, + "description": { + "type": "string", + "description": "The intent description." + }, + "associatedEntities": { + "type": "array", + "description": "The list of associated entities.", + "items": { + "$ref": "#/definitions/AnalyzeConversationExportedAssociatedEntityLabel" + } + } + }, + "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" + ] + }, + "AnalyzeConversationAuthoringCopiedProjectJobState": { + "type": "object", + "description": "Represents the state of a copy 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" + ] + }, + "AnalyzeConversationAuthoringCopiedProjectOptions": { + "type": "object", + "description": "Represents the options for copying an existing project to another Azure resource.", + "properties": { + "projectKind": { + "$ref": "#/definitions/ProjectKind", + "description": "Represents the project kind." + }, + "targetProjectName": { + "type": "string", + "description": "The project name to be copied-into." + }, + "accessToken": { + "type": "string", + "description": "The access token." + }, + "expiresAt": { + "type": "string", + "format": "date-time", + "description": "The expiration of the access token." + }, + "targetResourceId": { + "type": "string", + "description": "Represents the target Azure resource ID." + }, + "targetResourceRegion": { + "type": "string", + "description": "Represents the target Azure resource region." + } + }, + "required": [ + "projectKind", + "targetProjectName", + "accessToken", + "expiresAt", + "targetResourceId", + "targetResourceRegion" + ] + }, + "AnalyzeConversationAuthoringCopyAuthorizationOptions": { + "type": "object", + "description": "Represents the options for authorizing a project copy to the current Azure resource.", + "properties": { + "projectKind": { + "$ref": "#/definitions/ProjectKind", + "description": "Represents the project kind." + }, + "storageInputContainerName": { + "type": "string", + "description": "The name of the storage container." + }, + "allowOverwrite": { + "type": "boolean", + "description": "Whether to allow an existing project to be overwritten using the resulting copy authorization." + } + }, + "required": [ + "projectKind" + ] + }, + "AnalyzeConversationAuthoringCreateDeploymentOptions": { + "type": "object", + "description": "Represents the options for creating or updating a project deployment.", + "properties": { + "trainedModelLabel": { + "type": "string", + "description": "Represents the trained model label." + }, + "assignedResources": { + "type": "array", + "description": "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.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResource" + } + } + }, + "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." + }, + "storageInputContainerName": { + "type": "string", + "description": "The storage container name in case of conversation summarization." + }, + "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" + ] + }, + "AnalyzeConversationAuthoringDataGenerationConnectionInfo": { + "type": "object", + "description": "Represents the connection info for the Azure resource to use during data generation.", + "properties": { + "kind": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDataGenerationConnectionKind", + "description": "Connection type for data generation settings. Currently only supports Azure OpenAI." + }, + "deploymentName": { + "type": "string", + "description": "Deployment name of model to be used for synthetic data generation." + }, + "resourceId": { + "type": "string", + "description": "Resource ID for the data generation resource. Looks something like\n\"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{resourceName}\"." + } + }, + "required": [ + "kind", + "deploymentName" + ] + }, + "AnalyzeConversationAuthoringDataGenerationConnectionKind": { + "type": "string", + "description": "Represents the connection kind for Azure OpenAI deployment.", + "enum": [ + "AzureOpenAI" + ], + "x-ms-enum": { + "name": "AnalyzeConversationAuthoringDataGenerationConnectionKind", + "modelAsString": true, + "values": [ + { + "name": "AzureOpenAI", + "value": "AzureOpenAI" + } + ] + } + }, + "AnalyzeConversationAuthoringDataGenerationSettings": { + "type": "object", + "description": "Settings to enable data generation for training augmentation.", + "properties": { + "enableDataGeneration": { + "type": "boolean", + "description": "Must be explicitly set to True to enable data generation to augment training data." + }, + "dataGenerationConnectionInfo": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDataGenerationConnectionInfo", + "description": "Must be filled out to enable data generation to augment training data." + } + }, + "required": [ + "enableDataGeneration", + "dataGenerationConnectionInfo" + ] + }, + "AnalyzeConversationAuthoringDeleteDeploymentOptions": { + "type": "object", + "description": "Represents the options 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.", + "items": { + "type": "string" + } + } + } + }, + "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" + ] + }, + "AnalyzeConversationAuthoringDeploymentResource": { + "type": "object", + "description": "Represents an Azure resource assigned to a deployment.", + "properties": { + "resourceId": { + "type": "string", + "description": "Represents the Azure resource Id." + }, + "region": { + "type": "string", + "description": "Represents the resource region." + }, + "assignedAoaiResource": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDataGenerationConnectionInfo", + "description": "Represents the AOAI resource assigned for data generation." + } + }, + "required": [ + "resourceId", + "region" + ] + }, + "AnalyzeConversationAuthoringDeploymentResourcesJobState": { + "type": "object", + "description": "Represents the state of a deployment 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" + ] + }, + "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" + ] + }, + "AnalyzeConversationAuthoringEvaluationJobResult": { + "type": "object", + "properties": { + "evaluationOptions": { + "$ref": "#/definitions/AnalyzeConversationAuthoringEvaluationOptions", + "description": "Represents the options used running the evaluation." + }, + "modelLabel": { + "type": "string", + "description": "Represents trained model label." + }, + "trainingConfigVersion": { + "type": "string", + "description": "Represents training config version." + }, + "percentComplete": { + "type": "integer", + "format": "int32", + "description": "Represents progress percentage." + } + }, + "required": [ + "evaluationOptions", + "modelLabel", + "trainingConfigVersion", + "percentComplete" + ] + }, + "AnalyzeConversationAuthoringEvaluationJobState": { + "type": "object", + "description": "Represents the state of a evaluation 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/AnalyzeConversationAuthoringEvaluationJobResult", + "description": "Represents evaluation task detailed result." + } + }, + "required": [ + "jobId", + "createdDateTime", + "lastUpdatedDateTime", + "status", + "result" + ] + }, + "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" + }, + "AnalyzeConversationAuthoringExportedModelJobState": { + "type": "object", + "description": "Represents the state of a job to create or updated an exported model.", + "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" + ] + }, + "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" + }, + "AnalyzeConversationAuthoringExportedTrainedModel": { + "type": "object", + "description": "Represents an exported trained model.", + "properties": { + "exportedModelName": { + "type": "string", + "description": "The exported model name.", + "readOnly": true + }, + "modelId": { + "type": "string", + "description": "The model ID." + }, + "lastTrainedDateTime": { + "type": "string", + "format": "date-time", + "description": "The last trained date time of the model." + }, + "lastExportedModelDateTime": { + "type": "string", + "format": "date-time", + "description": "The last exported date time of the model." + }, + "modelExpirationDate": { + "type": "string", + "format": "date", + "description": "The model expiration date." + }, + "modelTrainingConfigVersion": { + "type": "string", + "description": "The model training config version." + } + }, + "required": [ + "exportedModelName", + "modelId", + "lastTrainedDateTime", + "lastExportedModelDateTime", + "modelExpirationDate", + "modelTrainingConfigVersion" + ] + }, + "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." + }, + "description": { + "type": "string", + "description": "The intent description." + } + }, + "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" + ] + }, + "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": { + "type": "array", + "description": "Represents the metadata of the assigned Azure resources.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResource" + } + } + }, + "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" + ] + }, + "storageInputContainerName": { + "type": "string", + "description": "The storage container name in case of conversation summarization.", + "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" + ] + }, + "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" + ] + }, + "AnalyzeConversationAuthoringResourceMetadata": { + "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" + ] + }, + "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." + }, + "dataGenerationSettings": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDataGenerationSettings", + "description": "For customers to populate if they wish to use data generation for their model training job." + } + }, + "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." + }, + "dataGenerationStatus": { + "$ref": "#/definitions/AnalyzeConversationAuthoringSubTrainingJobState", + "description": "Represents the model data generation 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", + "dataGenerationStatus" + ] + }, + "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" + ] + }, + "AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions": { + "type": "object", + "description": "Represents the options to unassign Azure resources from a project.", + "properties": { + "assignedResourceIds": { + "type": "array", + "description": "Represents the assigned resource IDs to be unassigned.", + "items": { + "type": "string" + } + } + }, + "required": [ + "assignedResourceIds" + ] + }, + "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" + ] + }, + "AnalyzeConversationExportedAssociatedEntityLabel": { + "type": "object", + "description": "Represents an associated entity label for an intent.", + "properties": { + "category": { + "type": "string", + "description": "The category of the entity label." + } + }, + "required": [ + "category" + ] + }, + "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." + } + ] + } + }, + "ExportedModelOptions": { + "type": "object", + "description": "Represents the options for creating or replacing an exported model.", + "properties": { + "trainedModelLabel": { + "type": "string", + "description": "The trained model label." + } + }, + "required": [ + "trainedModelLabel" + ] + }, + "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" + } + ] + } + }, + "PagedAnalyzeConversationAuthoringAssignedDeploymentResource": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringAssignedDeploymentResource items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringAssignedDeploymentResource items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringAssignedDeploymentResource" + } + }, + "nextLink": { + "type": "string", + "format": "uri", + "description": "The link to the next page of items" + } + }, + "required": [ + "value" + ] + }, + "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" + ] + }, + "PagedAnalyzeConversationAuthoringExportedTrainedModel": { + "type": "object", + "description": "Paged collection of AnalyzeConversationAuthoringExportedTrainedModel items", + "properties": { + "value": { + "type": "array", + "description": "The AnalyzeConversationAuthoringExportedTrainedModel items on this page", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringExportedTrainedModel" + } + }, + "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" + ] + }, + "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", + "CustomConversationSummarization" + ], + "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." + }, + { + "name": "CustomConversationSummarization", + "value": "CustomConversationSummarization", + "description": "A project to build conversation summarization models which are able to summarize long conversations." + } + ] + } + }, + "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", + "CustomConversationSummarization" + ], + "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." + }, + { + "name": "CustomConversationSummarization", + "value": "CustomConversationSummarization", + "description": "A project to build conversation summarization models which are able to summarize long conversations." + } + ] + }, + "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" + } + } +} From 0176ed186c236791956d4ce9679731983f55f333 Mon Sep 17 00:00:00 2001 From: "Amber Chen (Centific Technologies Inc)" Date: Mon, 29 Sep 2025 14:23:10 -0700 Subject: [PATCH 3/9] added new apis and models for 2025-11-01 --- .../main.tsp | 6 +- .../models/project.tsp | 24 +- .../routes.tsp | 17 +- .../analyzeconversations-authoring.json | 1129 ++--------------- 4 files changed, 104 insertions(+), 1072 deletions(-) diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp index bca840cce92f..86b89b158181 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp @@ -46,11 +46,11 @@ enum Versions { /** Version 2023-04-01 */ v2023_04_01: "2023-04-01", + /** Version 2025-11-01 */ + v2025_11_01: "2025-11-01", + /** * The 2025-05-15-preview API version. */ v2025_05_15_preview: "2025-05-15-preview", - - /** Version 2025-11-01 */ - v2025_11_01: "2025-11-01", } diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp index cd40292b7f27..6a55e68c6991 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp @@ -432,7 +432,7 @@ model AnalyzeConversationAuthoringProjectDeployment { /** * Represents the metadata of the assigned Azure resources. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_01) assignedResources: AnalyzeConversationAuthoringDeploymentResource[]; } @@ -469,7 +469,7 @@ model AnalyzeConversationAuthoringCreateDeploymentOptions { /** * 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. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_01) @removed(Versions.v2025_05_15_preview) assignedResourceIds?: string[]; @@ -483,6 +483,7 @@ model AnalyzeConversationAuthoringCreateDeploymentOptions { /** * Represents the options for deleting a project deployment. */ +@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentAzureResourceIds") 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. @@ -1000,7 +1001,8 @@ model AnalyzeConversationAuthoringLoadSnapshotJobState { /** * Represents the assigned deployment resources. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_01) +@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentResourcesInfoList") model AnalyzeConversationAuthoringAssignedDeploymentResources { /** * The list of assigned deployment resources. @@ -1016,9 +1018,10 @@ model AnalyzeConversationAuthoringAssignedDeploymentResources { /** * Represents the assigned deployment resource. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_01) @resource("resources") @parentResource(AnalyzeConversationAuthoringProjectMetadata) +@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentResourceInfo") model AnalyzeConversationAuthoringAssignedDeploymentResource { /** * The resource ID. @@ -1036,17 +1039,20 @@ model AnalyzeConversationAuthoringAssignedDeploymentResource { /** * Represents the options for assigning Azure resources to a project. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_01) +@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentResourceAssignments") model AnalyzeConversationAuthoringAssignDeploymentResourcesOptions { /** * Represents the metadata for the resources to be assigned. */ + @renamedFrom(Versions.v2025_11_01, "deploymentResources") resourcesMetadata: AnalyzeConversationAuthoringResourceMetadata[]; } /** * Represents metadata for the Azure resource.. */ +@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentResourceAssignmentInfo") model AnalyzeConversationAuthoringResourceMetadata { /** * Represents the Azure resource ID. @@ -1078,7 +1084,7 @@ model AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions { /** * Represents the state of a deployment resources job. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_01) @resource("resources/assign/jobs") @parentResource(AnalyzeConversationAuthoringProjectMetadata) model AnalyzeConversationAuthoringDeploymentResourcesJobState { @@ -1190,7 +1196,7 @@ model AnalyzeConversationAuthoringProjectDeletionJobState { /** * Represents the metadata for deployments assigned to a resource. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_01) model AnalyzeConversationAuthoringAssignedResourceDeploymentsMetadata { /** * The list of retrieved assigned project deployments. @@ -1206,7 +1212,7 @@ model AnalyzeConversationAuthoringAssignedResourceDeploymentsMetadata { /** * Represents the metadata for assigned deployments for a project. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_01) @resource("authoring/analyze-conversations/projects/global/deployments/resources") model AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata { /** @@ -1225,7 +1231,7 @@ model AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata { /** * Represents the metadata for an assigned deployment */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_01) model AnalyzeConversationAuthoringAssignedProjectDeploymentMetadata { /** * Represents the deployment name. diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp index c08462dfb4f5..78b0ce3c6474 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp @@ -56,7 +56,7 @@ 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.v2025_05_15_preview) +@added(Versions.v2025_11_01) op conversationAuthoringListAssignedResourceDeployments is languageOperations.ResourceList< AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata, ListQueryParametersTrait @@ -66,7 +66,7 @@ op conversationAuthoringListAssignedResourceDeployments is languageOperations.Re * Lists the deployments resources assigned to the project. */ #suppress "@azure-tools/typespec-azure-core/use-standard-names" -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_01) op conversationAuthoringListDeploymentResources is languageOperations.ResourceList< AnalyzeConversationAuthoringAssignedDeploymentResource, ListQueryParametersTrait @@ -200,7 +200,7 @@ interface ConversationAuthoringDeployment { ConversationAuthoringDeployment.getDeploymentDeleteFromResourcesStatus ) @access(Access.internal, "python") - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_01) deleteDeploymentFromResources is Foundations.LongRunningOperation< { /** @@ -231,7 +231,7 @@ interface ConversationAuthoringDeployment { /** * Gets the status of an existing delete deployment from specific resources job. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_01) getDeploymentDeleteFromResourcesStatus is languageOperations.ResourceRead; /** @@ -251,7 +251,7 @@ interface ConversationAuthoringProject { ConversationAuthoringProject.getAssignDeploymentResourcesStatus ) @access(Access.internal, "python") - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_01) assignDeploymentResources is Foundations.LongRunningOperation< { /** @@ -283,7 +283,7 @@ interface ConversationAuthoringProject { ConversationAuthoringProject.getUnassignDeploymentResourcesStatus ) @access(Access.internal, "python") - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_01) unassignDeploymentResources is Foundations.LongRunningOperation< { /** @@ -298,6 +298,7 @@ interface ConversationAuthoringProject { */ @body @clientName("details", "csharp") + @typeChangedFrom(Versions.v2025_05_15_preview, AnalyzeConversationAuthoringDeleteDeploymentOptions) body: AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions; }, AcceptedResponse, @@ -308,7 +309,7 @@ interface ConversationAuthoringProject { /** * Gets the status of an existing assign deployment resources job. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_01) getAssignDeploymentResourcesStatus is languageOperations.ResourceRead; /** @@ -317,7 +318,7 @@ interface ConversationAuthoringProject { #suppress "@azure-tools/typespec-azure-core/use-standard-operations" @route("/authoring/analyze-conversations/projects/{projectName}/resources/unassign/jobs/{jobId}") @get - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_01) getUnassignDeploymentResourcesStatus is Azure.Core.Foundations.Operation< { /** 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 index 45e38250c7d1..17935c60a899 100644 --- 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 @@ -241,106 +241,6 @@ "x-ms-long-running-operation": true } }, - "/authoring/analyze-conversations/projects/{projectName}/:authorize-copy": { - "post": { - "operationId": "ConversationAuthoringProject_CopyProjectAuthorization", - "description": "Generates a copy project operation authorization to the current target Azure resource.", - "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", - "required": true, - "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringCopyAuthorizationOptions" - } - } - ], - "responses": { - "200": { - "description": "The request has succeeded.", - "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringCopiedProjectOptions" - } - }, - "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." - } - } - } - } - } - }, - "/authoring/analyze-conversations/projects/{projectName}/:copy": { - "post": { - "operationId": "ConversationAuthoringProject_CopyProject", - "description": "Copies an existing project to another Azure resource.", - "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 copy project info.", - "required": true, - "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringCopiedProjectOptions" - } - } - ], - "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-long-running-operation": true - } - }, "/authoring/analyze-conversations/projects/{projectName}/:export": { "post": { "operationId": "ConversationAuthoringProject_Export", @@ -592,52 +492,6 @@ "x-ms-long-running-operation": true } }, - "/authoring/analyze-conversations/projects/{projectName}/copy/jobs/{jobId}": { - "get": { - "operationId": "ConversationAuthoringProject_GetCopyProjectStatus", - "description": "Gets the status of an existing copy project 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/AnalyzeConversationAuthoringCopiedProjectJobState" - } - }, - "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." - } - } - } - } - } - }, "/authoring/analyze-conversations/projects/{projectName}/deployments": { "get": { "operationId": "ConversationAuthoringListDeployments", @@ -1153,261 +1007,6 @@ } } }, - "/authoring/analyze-conversations/projects/{projectName}/exported-models": { - "get": { - "operationId": "ConversationAuthoringListExportedModels", - "description": "Lists the exported 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/PagedAnalyzeConversationAuthoringExportedTrainedModel" - } - }, - "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}/exported-models/{exportedModelName}": { - "get": { - "operationId": "ConversationAuthoringExportedModel_GetExportedModel", - "description": "Gets the details of an exported model.", - "parameters": [ - { - "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" - }, - { - "name": "projectName", - "in": "path", - "description": "The new project name.", - "required": true, - "type": "string", - "maxLength": 100 - }, - { - "name": "exportedModelName", - "in": "path", - "description": "The exported model name.", - "required": true, - "type": "string" - } - ], - "responses": { - "200": { - "description": "The request has succeeded.", - "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringExportedTrainedModel" - } - }, - "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." - } - } - } - } - }, - "put": { - "operationId": "ConversationAuthoringExportedModel_CreateOrUpdateExportedModel", - "description": "Creates a new exported model 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" - }, - { - "name": "exportedModelName", - "in": "path", - "description": "The exported model name.", - "required": true, - "type": "string" - }, - { - "name": "body", - "in": "body", - "description": "The exported model info.", - "required": true, - "schema": { - "$ref": "#/definitions/ExportedModelOptions" - } - } - ], - "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-long-running-operation": true - }, - "delete": { - "operationId": "ConversationAuthoringExportedModel_DeleteExportedModel", - "description": "Deletes an existing exported model.", - "parameters": [ - { - "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" - }, - { - "name": "projectName", - "in": "path", - "description": "The name of the project to use.", - "required": true, - "type": "string" - }, - { - "name": "exportedModelName", - "in": "path", - "description": "The exported model name.", - "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-long-running-operation": true - } - }, - "/authoring/analyze-conversations/projects/{projectName}/exported-models/{exportedModelName}/jobs/{jobId}": { - "get": { - "operationId": "ConversationAuthoringExportedModel_GetExportedModelJobStatus", - "description": "Gets the status for an existing job to create or update an exported model.", - "parameters": [ - { - "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" - }, - { - "name": "projectName", - "in": "path", - "description": "The new project name.", - "required": true, - "type": "string", - "maxLength": 100 - }, - { - "name": "exportedModelName", - "in": "path", - "description": "The exported model 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/AnalyzeConversationAuthoringExportedModelJobState" - } - }, - "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." - } - } - } - } - } - }, "/authoring/analyze-conversations/projects/{projectName}/import/jobs/{jobId}": { "get": { "operationId": "ConversationAuthoringProject_GetImportStatus", @@ -1483,99 +1082,9 @@ "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-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." - } - } - } - } - }, - "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. " + "schema": { + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringProjectTrainedModel" + } }, "default": { "description": "An unexpected error response.", @@ -1589,13 +1098,16 @@ } } } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" } } }, - "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/:evaluate": { - "post": { - "operationId": "ConversationAuthoringTrainedModel_EvaluateModel", - "description": "Triggers evaluation operation on a trained model.", + "/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" @@ -1603,7 +1115,7 @@ { "name": "projectName", "in": "path", - "description": "The name of the project to use.", + "description": "The new project name.", "required": true, "type": "string", "maxLength": 100 @@ -1614,26 +1126,13 @@ "description": "The trained model label.", "required": true, "type": "string" - }, - { - "name": "body", - "in": "body", - "description": "The training input parameters.", - "required": true, - "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringEvaluationOptions" - } } ], "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." - } + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectTrainedModel" } }, "default": { @@ -1648,14 +1147,11 @@ } } } - }, - "x-ms-long-running-operation": true - } - }, - "/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.", + } + }, + "delete": { + "operationId": "ConversationAuthoringTrainedModel_DeleteTrainedModel", + "description": "Deletes an existing trained model.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -1663,7 +1159,7 @@ { "name": "projectName", "in": "path", - "description": "The name of the project to use.", + "description": "The new project name.", "required": true, "type": "string", "maxLength": 100 @@ -1677,15 +1173,8 @@ } ], "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." - } - } + "204": { + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { "description": "An unexpected error response.", @@ -1699,14 +1188,13 @@ } } } - }, - "x-ms-long-running-operation": true + } } }, - "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluate/jobs/{jobId}": { - "get": { - "operationId": "ConversationAuthoringTrainedModel_GetEvaluationStatus", - "description": "Gets the status for an evaluation job.", + "/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" @@ -1714,7 +1202,7 @@ { "name": "projectName", "in": "path", - "description": "The new project name.", + "description": "The name of the project to use.", "required": true, "type": "string", "maxLength": 100 @@ -1725,20 +1213,17 @@ "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/AnalyzeConversationAuthoringEvaluationJobState" + "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": { @@ -1753,7 +1238,8 @@ } } } - } + }, + "x-ms-long-running-operation": true } }, "/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/evaluation/result": { @@ -2042,7 +1528,7 @@ "description": "The info for the deployment resources to be deleted.", "required": true, "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions" + "$ref": "#/definitions/AnalyzeConversationAuthoringDeleteDeploymentOptions" } } ], @@ -2653,10 +2139,6 @@ "type": "string", "description": "The category of the entity." }, - "description": { - "type": "string", - "description": "The entity description." - }, "compositionSetting": { "$ref": "#/definitions/CompositionSetting", "description": "The behavior to follow when the entity's components overlap with each other." @@ -2695,17 +2177,6 @@ "category": { "type": "string", "description": "The intent category." - }, - "description": { - "type": "string", - "description": "The intent description." - }, - "associatedEntities": { - "type": "array", - "description": "The list of associated entities.", - "items": { - "$ref": "#/definitions/AnalyzeConversationExportedAssociatedEntityLabel" - } } }, "required": [ @@ -2778,116 +2249,6 @@ "intent" ] }, - "AnalyzeConversationAuthoringCopiedProjectJobState": { - "type": "object", - "description": "Represents the state of a copy 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" - ] - }, - "AnalyzeConversationAuthoringCopiedProjectOptions": { - "type": "object", - "description": "Represents the options for copying an existing project to another Azure resource.", - "properties": { - "projectKind": { - "$ref": "#/definitions/ProjectKind", - "description": "Represents the project kind." - }, - "targetProjectName": { - "type": "string", - "description": "The project name to be copied-into." - }, - "accessToken": { - "type": "string", - "description": "The access token." - }, - "expiresAt": { - "type": "string", - "format": "date-time", - "description": "The expiration of the access token." - }, - "targetResourceId": { - "type": "string", - "description": "Represents the target Azure resource ID." - }, - "targetResourceRegion": { - "type": "string", - "description": "Represents the target Azure resource region." - } - }, - "required": [ - "projectKind", - "targetProjectName", - "accessToken", - "expiresAt", - "targetResourceId", - "targetResourceRegion" - ] - }, - "AnalyzeConversationAuthoringCopyAuthorizationOptions": { - "type": "object", - "description": "Represents the options for authorizing a project copy to the current Azure resource.", - "properties": { - "projectKind": { - "$ref": "#/definitions/ProjectKind", - "description": "Represents the project kind." - }, - "storageInputContainerName": { - "type": "string", - "description": "The name of the storage container." - }, - "allowOverwrite": { - "type": "boolean", - "description": "Whether to allow an existing project to be overwritten using the resulting copy authorization." - } - }, - "required": [ - "projectKind" - ] - }, "AnalyzeConversationAuthoringCreateDeploymentOptions": { "type": "object", "description": "Represents the options for creating or updating a project deployment.", @@ -2896,112 +2257,51 @@ "type": "string", "description": "Represents the trained model label." }, - "assignedResources": { + "assignedResourceIds": { "type": "array", - "description": "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.", + "description": "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.", "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResource" - } - } - }, - "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." - }, - "storageInputContainerName": { - "type": "string", - "description": "The storage container name in case of conversation summarization." - }, - "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" - ] - }, - "AnalyzeConversationAuthoringDataGenerationConnectionInfo": { - "type": "object", - "description": "Represents the connection info for the Azure resource to use during data generation.", - "properties": { - "kind": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDataGenerationConnectionKind", - "description": "Connection type for data generation settings. Currently only supports Azure OpenAI." - }, - "deploymentName": { - "type": "string", - "description": "Deployment name of model to be used for synthetic data generation." - }, - "resourceId": { - "type": "string", - "description": "Resource ID for the data generation resource. Looks something like\n\"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{resourceName}\"." - } - }, - "required": [ - "kind", - "deploymentName" - ] - }, - "AnalyzeConversationAuthoringDataGenerationConnectionKind": { - "type": "string", - "description": "Represents the connection kind for Azure OpenAI deployment.", - "enum": [ - "AzureOpenAI" - ], - "x-ms-enum": { - "name": "AnalyzeConversationAuthoringDataGenerationConnectionKind", - "modelAsString": true, - "values": [ - { - "name": "AzureOpenAI", - "value": "AzureOpenAI" + "type": "string" } - ] - } + } + }, + "required": [ + "trainedModelLabel" + ] }, - "AnalyzeConversationAuthoringDataGenerationSettings": { + "AnalyzeConversationAuthoringCreateProjectOptions": { "type": "object", - "description": "Settings to enable data generation for training augmentation.", + "description": "Represents the options used to create or update a project.", "properties": { - "enableDataGeneration": { + "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": "Must be explicitly set to True to enable data generation to augment training data." + "description": "Whether the project would be used for multiple languages or not." + }, + "description": { + "type": "string", + "description": "The project description." }, - "dataGenerationConnectionInfo": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDataGenerationConnectionInfo", - "description": "Must be filled out to enable data generation to augment training data." + "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": [ - "enableDataGeneration", - "dataGenerationConnectionInfo" + "projectKind", + "projectName", + "language" ] }, "AnalyzeConversationAuthoringDeleteDeploymentOptions": { @@ -3128,10 +2428,6 @@ "region": { "type": "string", "description": "Represents the resource region." - }, - "assignedAoaiResource": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDataGenerationConnectionInfo", - "description": "Represents the AOAI resource assigned for data generation." } }, "required": [ @@ -3299,89 +2595,6 @@ "falseNegativeCount" ] }, - "AnalyzeConversationAuthoringEvaluationJobResult": { - "type": "object", - "properties": { - "evaluationOptions": { - "$ref": "#/definitions/AnalyzeConversationAuthoringEvaluationOptions", - "description": "Represents the options used running the evaluation." - }, - "modelLabel": { - "type": "string", - "description": "Represents trained model label." - }, - "trainingConfigVersion": { - "type": "string", - "description": "Represents training config version." - }, - "percentComplete": { - "type": "integer", - "format": "int32", - "description": "Represents progress percentage." - } - }, - "required": [ - "evaluationOptions", - "modelLabel", - "trainingConfigVersion", - "percentComplete" - ] - }, - "AnalyzeConversationAuthoringEvaluationJobState": { - "type": "object", - "description": "Represents the state of a evaluation 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/AnalyzeConversationAuthoringEvaluationJobResult", - "description": "Represents evaluation task detailed result." - } - }, - "required": [ - "jobId", - "createdDateTime", - "lastUpdatedDateTime", - "status", - "result" - ] - }, "AnalyzeConversationAuthoringEvaluationOptions": { "type": "object", "description": "Represents the options used running the evaluation.", @@ -3633,56 +2846,6 @@ ], "x-ms-discriminator-value": "Luis" }, - "AnalyzeConversationAuthoringExportedModelJobState": { - "type": "object", - "description": "Represents the state of a job to create or updated an exported model.", - "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" - ] - }, "AnalyzeConversationAuthoringExportedOrchestrationOptions": { "type": "object", "description": "Represents the options used to define the orchestration behavior of an intent.", @@ -3782,48 +2945,6 @@ ], "x-ms-discriminator-value": "QuestionAnswering" }, - "AnalyzeConversationAuthoringExportedTrainedModel": { - "type": "object", - "description": "Represents an exported trained model.", - "properties": { - "exportedModelName": { - "type": "string", - "description": "The exported model name.", - "readOnly": true - }, - "modelId": { - "type": "string", - "description": "The model ID." - }, - "lastTrainedDateTime": { - "type": "string", - "format": "date-time", - "description": "The last trained date time of the model." - }, - "lastExportedModelDateTime": { - "type": "string", - "format": "date-time", - "description": "The last exported date time of the model." - }, - "modelExpirationDate": { - "type": "string", - "format": "date", - "description": "The model expiration date." - }, - "modelTrainingConfigVersion": { - "type": "string", - "description": "The model training config version." - } - }, - "required": [ - "exportedModelName", - "modelId", - "lastTrainedDateTime", - "lastExportedModelDateTime", - "modelExpirationDate", - "modelTrainingConfigVersion" - ] - }, "AnalyzeConversationAuthoringExportedUtteranceEntityLabel": { "type": "object", "description": "Represents an entity label for an utterance.", @@ -4070,10 +3191,6 @@ "category": { "type": "string", "description": "The intent category." - }, - "description": { - "type": "string", - "description": "The intent description." } }, "required": [ @@ -4296,14 +3413,6 @@ "create" ] }, - "storageInputContainerName": { - "type": "string", - "description": "The storage container name in case of conversation summarization.", - "x-ms-mutability": [ - "read", - "create" - ] - }, "projectName": { "type": "string", "description": "The new project name.", @@ -4585,10 +3694,6 @@ "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." - }, - "dataGenerationSettings": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDataGenerationSettings", - "description": "For customers to populate if they wish to use data generation for their model training job." } }, "required": [ @@ -4616,10 +3721,6 @@ "$ref": "#/definitions/AnalyzeConversationAuthoringSubTrainingJobState", "description": "Represents the model training status." }, - "dataGenerationStatus": { - "$ref": "#/definitions/AnalyzeConversationAuthoringSubTrainingJobState", - "description": "Represents the model data generation status." - }, "evaluationStatus": { "$ref": "#/definitions/AnalyzeConversationAuthoringSubTrainingJobState", "description": "Represents model evaluation status." @@ -4633,8 +3734,7 @@ "required": [ "modelLabel", "trainingConfigVersion", - "trainingStatus", - "dataGenerationStatus" + "trainingStatus" ] }, "AnalyzeConversationAuthoringTrainingJobState": { @@ -4692,22 +3792,6 @@ "result" ] }, - "AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions": { - "type": "object", - "description": "Represents the options to unassign Azure resources from a project.", - "properties": { - "assignedResourceIds": { - "type": "array", - "description": "Represents the assigned resource IDs to be unassigned.", - "items": { - "type": "string" - } - } - }, - "required": [ - "assignedResourceIds" - ] - }, "AnalyzeConversationAuthoringUtteranceEntitiesEvaluationResult": { "type": "object", "description": "Represents the comparison between the expected and predicted entities for an utterance.", @@ -4804,19 +3888,6 @@ "predictedIntent" ] }, - "AnalyzeConversationExportedAssociatedEntityLabel": { - "type": "object", - "description": "Represents an associated entity label for an intent.", - "properties": { - "category": { - "type": "string", - "description": "The category of the entity label." - } - }, - "required": [ - "category" - ] - }, "Azure.Core.Foundations.Error": { "type": "object", "description": "The error object.", @@ -4964,19 +4035,6 @@ ] } }, - "ExportedModelOptions": { - "type": "object", - "description": "Represents the options for creating or replacing an exported model.", - "properties": { - "trainedModelLabel": { - "type": "string", - "description": "The trained model label." - } - }, - "required": [ - "trainedModelLabel" - ] - }, "JobStatus": { "type": "string", "enum": [ @@ -5091,27 +4149,6 @@ "value" ] }, - "PagedAnalyzeConversationAuthoringExportedTrainedModel": { - "type": "object", - "description": "Paged collection of AnalyzeConversationAuthoringExportedTrainedModel items", - "properties": { - "value": { - "type": "array", - "description": "The AnalyzeConversationAuthoringExportedTrainedModel items on this page", - "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringExportedTrainedModel" - } - }, - "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", @@ -5284,8 +4321,7 @@ "type": "string", "enum": [ "Conversation", - "Orchestration", - "CustomConversationSummarization" + "Orchestration" ], "x-ms-enum": { "name": "ProjectKind", @@ -5300,11 +4336,6 @@ "name": "Orchestration", "value": "Orchestration", "description": "A project to connect and orchestrate Conversation, Custom question answering and LUIS projects together in one single project." - }, - { - "name": "CustomConversationSummarization", - "value": "CustomConversationSummarization", - "description": "A project to build conversation summarization models which are able to summarize long conversations." } ] } @@ -5407,8 +4438,7 @@ "type": "string", "enum": [ "Conversation", - "Orchestration", - "CustomConversationSummarization" + "Orchestration" ], "x-ms-enum": { "name": "ProjectKind", @@ -5423,11 +4453,6 @@ "name": "Orchestration", "value": "Orchestration", "description": "A project to connect and orchestrate Conversation, Custom question answering and LUIS projects together in one single project." - }, - { - "name": "CustomConversationSummarization", - "value": "CustomConversationSummarization", - "description": "A project to build conversation summarization models which are able to summarize long conversations." } ] }, From df802561e20ff7acb6cc9b2c83f374bd0e8a84fe Mon Sep 17 00:00:00 2001 From: "Amber Chen (Centific Technologies Inc)" Date: Mon, 29 Sep 2025 14:45:32 -0700 Subject: [PATCH 4/9] modified @renamedFrom --- .../models/project.tsp | 10 +- .../analyzeconversations-authoring.json | 142 +++++++++--------- 2 files changed, 76 insertions(+), 76 deletions(-) diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp index 6a55e68c6991..66083cb32b2e 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp @@ -483,7 +483,7 @@ model AnalyzeConversationAuthoringCreateDeploymentOptions { /** * Represents the options for deleting a project deployment. */ -@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentAzureResourceIds") +@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentAzureResourceIds") 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. @@ -1002,7 +1002,7 @@ model AnalyzeConversationAuthoringLoadSnapshotJobState { * Represents the assigned deployment resources. */ @added(Versions.v2025_11_01) -@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentResourcesInfoList") +@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentResourcesInfoList") model AnalyzeConversationAuthoringAssignedDeploymentResources { /** * The list of assigned deployment resources. @@ -1021,7 +1021,7 @@ model AnalyzeConversationAuthoringAssignedDeploymentResources { @added(Versions.v2025_11_01) @resource("resources") @parentResource(AnalyzeConversationAuthoringProjectMetadata) -@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentResourceInfo") +@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentResourceInfo") model AnalyzeConversationAuthoringAssignedDeploymentResource { /** * The resource ID. @@ -1040,7 +1040,7 @@ model AnalyzeConversationAuthoringAssignedDeploymentResource { * Represents the options for assigning Azure resources to a project. */ @added(Versions.v2025_11_01) -@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentResourceAssignments") +@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentResourceAssignments") model AnalyzeConversationAuthoringAssignDeploymentResourcesOptions { /** * Represents the metadata for the resources to be assigned. @@ -1052,7 +1052,7 @@ model AnalyzeConversationAuthoringAssignDeploymentResourcesOptions { /** * Represents metadata for the Azure resource.. */ -@renamedFrom(Versions.v2025_11_01, "ConversationalAnalysisAuthoringDeploymentResourceAssignmentInfo") +@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentResourceAssignmentInfo") model AnalyzeConversationAuthoringResourceMetadata { /** * Represents the Azure resource ID. 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 index 17935c60a899..78c8e1f44e40 100644 --- 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 @@ -725,7 +725,7 @@ "description": "The options for deleting the deployment.", "required": true, "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeleteDeploymentOptions" + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentAzureResourceIds" } } ], @@ -1432,7 +1432,7 @@ "200": { "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/PagedAnalyzeConversationAuthoringAssignedDeploymentResource" + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringDeploymentResourceInfo" } }, "default": { @@ -1475,7 +1475,7 @@ "description": "The new project resources info.", "required": true, "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringAssignDeploymentResourcesOptions" + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourceAssignments" } } ], @@ -1528,7 +1528,7 @@ "description": "The info for the deployment resources to be deleted.", "required": true, "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeleteDeploymentOptions" + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentAzureResourceIds" } } ], @@ -2023,41 +2023,6 @@ } }, "definitions": { - "AnalyzeConversationAuthoringAssignDeploymentResourcesOptions": { - "type": "object", - "description": "Represents the options for assigning Azure resources to a project.", - "properties": { - "resourcesMetadata": { - "type": "array", - "description": "Represents the metadata for the resources to be assigned.", - "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringResourceMetadata" - } - } - }, - "required": [ - "resourcesMetadata" - ] - }, - "AnalyzeConversationAuthoringAssignedDeploymentResource": { - "type": "object", - "description": "Represents the assigned deployment resource.", - "properties": { - "azureResourceId": { - "type": "string", - "description": "The resource ID.", - "readOnly": true - }, - "region": { - "type": "string", - "description": "The resource region." - } - }, - "required": [ - "azureResourceId", - "region" - ] - }, "AnalyzeConversationAuthoringAssignedProjectDeploymentMetadata": { "type": "object", "description": "Represents the metadata for an assigned deployment", @@ -2304,7 +2269,7 @@ "language" ] }, - "AnalyzeConversationAuthoringDeleteDeploymentOptions": { + "AnalyzeConversationAuthoringDeploymentAzureResourceIds": { "type": "object", "description": "Represents the options for deleting a project deployment.", "properties": { @@ -2435,6 +2400,64 @@ "region" ] }, + "AnalyzeConversationAuthoringDeploymentResourceAssignmentInfo": { + "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" + ] + }, + "AnalyzeConversationAuthoringDeploymentResourceAssignments": { + "type": "object", + "description": "Represents the options for assigning Azure resources to a project.", + "properties": { + "resourcesMetadata": { + "type": "array", + "description": "Represents the metadata for the resources to be assigned.", + "items": { + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourceAssignmentInfo" + } + } + }, + "required": [ + "resourcesMetadata" + ] + }, + "AnalyzeConversationAuthoringDeploymentResourceInfo": { + "type": "object", + "description": "Represents the assigned deployment resource.", + "properties": { + "azureResourceId": { + "type": "string", + "description": "The resource ID.", + "readOnly": true + }, + "region": { + "type": "string", + "description": "The resource region." + } + }, + "required": [ + "azureResourceId", + "region" + ] + }, "AnalyzeConversationAuthoringDeploymentResourcesJobState": { "type": "object", "description": "Represents the state of a deployment resources job.", @@ -3516,29 +3539,6 @@ "hasSnapshot" ] }, - "AnalyzeConversationAuthoringResourceMetadata": { - "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" - ] - }, "AnalyzeConversationAuthoringSubTrainingJobState": { "type": "object", "description": "Represents the detailed state of a training sub-operation.", @@ -4107,15 +4107,15 @@ ] } }, - "PagedAnalyzeConversationAuthoringAssignedDeploymentResource": { + "PagedAnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata": { "type": "object", - "description": "Paged collection of AnalyzeConversationAuthoringAssignedDeploymentResource items", + "description": "Paged collection of AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata items", "properties": { "value": { "type": "array", - "description": "The AnalyzeConversationAuthoringAssignedDeploymentResource items on this page", + "description": "The AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata items on this page", "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringAssignedDeploymentResource" + "$ref": "#/definitions/AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata" } }, "nextLink": { @@ -4128,15 +4128,15 @@ "value" ] }, - "PagedAnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata": { + "PagedAnalyzeConversationAuthoringDeploymentResourceInfo": { "type": "object", - "description": "Paged collection of AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata items", + "description": "Paged collection of AnalyzeConversationAuthoringDeploymentResourceInfo items", "properties": { "value": { "type": "array", - "description": "The AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata items on this page", + "description": "The AnalyzeConversationAuthoringDeploymentResourceInfo items on this page", "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringAssignedProjectDeploymentsMetadata" + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourceInfo" } }, "nextLink": { From e93f514959e12f05a13dc7f6f737fccc763085af Mon Sep 17 00:00:00 2001 From: "Amber Chen (Centific Technologies Inc)" Date: Mon, 29 Sep 2025 16:23:46 -0700 Subject: [PATCH 5/9] removed DeploymentResource from 2025-11-01 --- .../models/project.tsp | 2 ++ .../analyzeconversations-authoring.json | 25 ++----------------- 2 files changed, 4 insertions(+), 23 deletions(-) diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp index 66083cb32b2e..b254f71d7a83 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp @@ -433,12 +433,14 @@ model AnalyzeConversationAuthoringProjectDeployment { * Represents the metadata of the assigned Azure resources. */ @added(Versions.v2025_11_01) + @typeChangedFrom(Versions.v2025_05_15_preview, AnalyzeConversationAuthoringAssignedDeploymentResource) assignedResources: AnalyzeConversationAuthoringDeploymentResource[]; } /** * Represents an Azure resource assigned to a deployment. */ +@added(Versions.v2025_05_15_preview) model AnalyzeConversationAuthoringDeploymentResource { /** * Represents the Azure resource Id. 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 index 78c8e1f44e40..77820620bd51 100644 --- 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 @@ -2382,24 +2382,6 @@ "status" ] }, - "AnalyzeConversationAuthoringDeploymentResource": { - "type": "object", - "description": "Represents an Azure resource assigned to a deployment.", - "properties": { - "resourceId": { - "type": "string", - "description": "Represents the Azure resource Id." - }, - "region": { - "type": "string", - "description": "Represents the resource region." - } - }, - "required": [ - "resourceId", - "region" - ] - }, "AnalyzeConversationAuthoringDeploymentResourceAssignmentInfo": { "type": "object", "description": "Represents metadata for the Azure resource..", @@ -3379,11 +3361,8 @@ "description": "Represents model training config version." }, "assignedResources": { - "type": "array", - "description": "Represents the metadata of the assigned Azure resources.", - "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResource" - } + "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourceInfo", + "description": "Represents the metadata of the assigned Azure resources." } }, "required": [ From cb53d6a082bc4439eb9c211b85f538598ceda1e8 Mon Sep 17 00:00:00 2001 From: "Amber Chen (Centific Technologies Inc)" Date: Tue, 30 Sep 2025 22:25:44 -0700 Subject: [PATCH 6/9] added samples and compile --- .../SuccessfulCancelTrainingJob.json | 18 + .../SuccessfulCreateProject.json | 46 ++ .../SuccessfulDeleteDeployment.json | 18 + .../SuccessfulDeleteModel.json | 14 + .../SuccessfulDeleteProject.json | 17 + .../SuccessfulDeployProject.json | 21 + .../SuccessfulExportProject.json | 18 + .../SuccessfulGetDeployment.json | 24 + .../SuccessfulGetDeploymentStatus.json | 24 + .../SuccessfulGetExportResult.json | 36 ++ .../SuccessfulGetExportStatus.json | 24 + .../SuccessfulGetImportStatus.json | 23 + .../SuccessfulGetLoadSnapshotStatus.json | 24 + .../SuccessfulGetModel.json | 25 + .../SuccessfulGetModelEvaluation.json | 286 ++++++++++ .../SuccessfulGetModelEvaluationSummary.json | 528 ++++++++++++++++++ .../SuccessfulGetProject.json | 26 + .../SuccessfulGetProjectDeletionStatus.json | 22 + .../SuccessfulGetSupportedLanguages.json | 400 +++++++++++++ ...uccessfulGetSupportedPrebuiltEntities.json | 100 ++++ ...fulGetSupportedTrainingConfigVersions.json | 24 + .../SuccessfulGetSwapDeploymentsStatus.json | 23 + .../SuccessfulGetTrainStatus.json | 38 ++ .../SuccessfulImportProject.json | 80 +++ .../SuccessfulListDeployments.json | 35 ++ .../SuccessfulListModels.json | 38 ++ .../SuccessfulListProjects.json | 37 ++ .../SuccessfulListTrainingJobs.json | 92 +++ .../SuccessfulLoadSnapshot.json | 18 + .../SuccessfulSwapDeployments.json | 21 + .../SuccessfulTrainProject.json | 27 + .../analyzeconversations-authoring.json | 150 +++++ .../SuccessfulCancelTrainingJob.json | 18 + .../SuccessfulCreateProject.json | 46 ++ .../SuccessfulDeleteDeployment.json | 18 + .../SuccessfulDeleteModel.json | 14 + .../SuccessfulDeleteProject.json | 17 + .../SuccessfulDeployProject.json | 21 + .../SuccessfulExportProject.json | 18 + .../SuccessfulGetDeployment.json | 24 + .../SuccessfulGetDeploymentStatus.json | 24 + .../SuccessfulGetExportStatus.json | 24 + .../SuccessfulGetImportStatus.json | 23 + .../SuccessfulGetLoadSnapshotStatus.json | 24 + .../SuccessfulGetModel.json | 25 + .../SuccessfulGetModelEvaluation.json | 286 ++++++++++ .../SuccessfulGetModelEvaluationSummary.json | 528 ++++++++++++++++++ .../SuccessfulGetProject.json | 26 + .../SuccessfulGetProjectDeletionStatus.json | 22 + .../SuccessfulGetSupportedLanguages.json | 400 +++++++++++++ ...uccessfulGetSupportedPrebuiltEntities.json | 100 ++++ ...fulGetSupportedTrainingConfigVersions.json | 24 + .../SuccessfulGetSwapDeploymentsStatus.json | 23 + .../SuccessfulGetTrainStatus.json | 38 ++ .../SuccessfulImportProject.json | 80 +++ .../SuccessfulListDeployments.json | 35 ++ .../SuccessfulListModels.json | 38 ++ .../SuccessfulListProjects.json | 37 ++ .../SuccessfulListTrainingJobs.json | 92 +++ .../SuccessfulLoadSnapshot.json | 18 + .../SuccessfulSwapDeployments.json | 21 + .../SuccessfulTrainProject.json | 27 + 62 files changed, 4368 insertions(+) create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulCreateProject.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteDeployment.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteModel.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteProject.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeployProject.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulExportProject.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeployment.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetExportResult.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetExportStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetImportStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModel.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetProject.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetTrainStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulImportProject.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListDeployments.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListModels.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjects.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListTrainingJobs.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulLoadSnapshot.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulSwapDeployments.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulTrainProject.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulCreateProject.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteDeployment.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteModel.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteProject.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeployProject.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulExportProject.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeployment.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetExportStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetImportStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModel.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetProject.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetTrainStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulImportProject.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListDeployments.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListModels.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListProjects.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListTrainingJobs.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulLoadSnapshot.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulSwapDeployments.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulTrainProject.json 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/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/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/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/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/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/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/data-plane/Language/stable/2025-11-01/analyzeconversations-authoring.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/analyzeconversations-authoring.json index 77820620bd51..b77d07a8cb19 100644 --- 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 @@ -100,6 +100,11 @@ } } }, + "x-ms-examples": { + "Successful List Projects": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListProjects.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } @@ -141,6 +146,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetProject.json" + } } }, "patch": { @@ -196,6 +206,11 @@ } } } + }, + "x-ms-examples": { + "Successful Create Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulCreateProject.json" + } } }, "delete": { @@ -238,6 +253,11 @@ } } }, + "x-ms-examples": { + "Successful Delete Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeleteProject.json" + } + }, "x-ms-long-running-operation": true } }, @@ -355,6 +375,11 @@ } } }, + "x-ms-examples": { + "Successful Export Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulExportProject.json" + } + }, "x-ms-long-running-operation": true } }, @@ -436,6 +461,11 @@ } } }, + "x-ms-examples": { + "Successful Import Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulImportProject.json" + } + }, "x-ms-long-running-operation": true } }, @@ -489,6 +519,11 @@ } } }, + "x-ms-examples": { + "Successful Train Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulTrainProject.json" + } + }, "x-ms-long-running-operation": true } }, @@ -538,6 +573,11 @@ } } }, + "x-ms-examples": { + "Successful List Deployments": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListDeployments.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } @@ -586,6 +626,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Deployment": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetDeployment.json" + } } }, "put": { @@ -644,6 +689,11 @@ } } }, + "x-ms-examples": { + "Successful Deploy Project": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeployProject.json" + } + }, "x-ms-long-running-operation": true }, "delete": { @@ -693,6 +743,11 @@ } } }, + "x-ms-examples": { + "Successful Delete Deployment": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeleteDeployment.json" + } + }, "x-ms-long-running-operation": true } }, @@ -859,6 +914,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Deployment Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetDeploymentStatus.json" + } } } }, @@ -912,6 +972,11 @@ } } }, + "x-ms-examples": { + "Successful Swap Deployments": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulSwapDeployments.json" + } + }, "x-ms-long-running-operation": true } }, @@ -958,6 +1023,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Swap Deployments Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetSwapDeploymentsStatus.json" + } } } }, @@ -1004,6 +1074,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Export Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetExportStatus.json" + } } } }, @@ -1050,6 +1125,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Import Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetImportStatus.json" + } } } }, @@ -1099,6 +1179,11 @@ } } }, + "x-ms-examples": { + "Successful List Models": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListModels.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } @@ -1147,6 +1232,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Model": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetModel.json" + } } }, "delete": { @@ -1188,6 +1278,11 @@ } } } + }, + "x-ms-examples": { + "Successful Delete Model": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeleteModel.json" + } } } }, @@ -1239,6 +1334,11 @@ } } }, + "x-ms-examples": { + "Successful Load Snapshot": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulLoadSnapshot.json" + } + }, "x-ms-long-running-operation": true } }, @@ -1298,6 +1398,11 @@ } } }, + "x-ms-examples": { + "Successful Get Model Evaluation": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetModelEvaluation.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } @@ -1346,6 +1451,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Model Evaluation Summary": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetModelEvaluationSummary.json" + } } } }, @@ -1399,6 +1509,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Load Snapshot Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetLoadSnapshotStatus.json" + } } } }, @@ -1697,6 +1812,11 @@ } } }, + "x-ms-examples": { + "Successful List Training Jobs": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListTrainingJobs.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } @@ -1745,6 +1865,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Train Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetTrainStatus.json" + } } } }, @@ -1796,6 +1921,11 @@ } } }, + "x-ms-examples": { + "Successful Cancel Training Job": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulCancelTrainingJob.json" + } + }, "x-ms-long-running-operation": true } }, @@ -1834,6 +1964,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Project Deletion Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetProjectDeletionStatus.json" + } } } }, @@ -1921,6 +2056,11 @@ } } }, + "x-ms-examples": { + "Successful Get Supported Languages": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetSupportedLanguages.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } @@ -1970,6 +2110,11 @@ } } }, + "x-ms-examples": { + "Successful Get Supported Prebuilt Entities": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetSupportedPrebuiltEntities.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } @@ -2016,6 +2161,11 @@ } } }, + "x-ms-examples": { + "Successful Get Supported Training Config Versions": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetSupportedTrainingConfigVersions.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } 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/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/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/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/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/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" + } + } + } +} From 48b937bba59c1e81ecdfe816e9a1e86892d93ad7 Mon Sep 17 00:00:00 2001 From: "Amber Chen (Centific Technologies Inc)" Date: Tue, 30 Sep 2025 22:46:07 -0700 Subject: [PATCH 7/9] add additional samples and compile --- .../SuccessfulAssignDeploymentResources.json | 31 ++++++++++++++ ...ccessfulDeleteDeploymentFromResources.json | 23 +++++++++++ ...fulGetAssignDeploymentResourcesStatus.json | 23 +++++++++++ ...etDeploymentDeleteFromResourcesStatus.json | 24 +++++++++++ ...lGetUnassignDeploymentResourcesStatus.json | 23 +++++++++++ ...essfulListAssignedResourceDeployments.json | 28 +++++++++++++ .../SuccessfulListDeploymentResources.json | 27 +++++++++++++ ...SuccessfulUnassignDeploymentResources.json | 23 +++++++++++ .../analyzeconversations-authoring.json | 40 +++++++++++++++++++ .../SuccessfulAssignDeploymentResources.json | 31 ++++++++++++++ ...ccessfulDeleteDeploymentFromResources.json | 23 +++++++++++ ...fulGetAssignDeploymentResourcesStatus.json | 23 +++++++++++ ...etDeploymentDeleteFromResourcesStatus.json | 24 +++++++++++ ...lGetUnassignDeploymentResourcesStatus.json | 23 +++++++++++ ...essfulListAssignedResourceDeployments.json | 28 +++++++++++++ .../SuccessfulListDeploymentResources.json | 27 +++++++++++++ ...SuccessfulUnassignDeploymentResources.json | 23 +++++++++++ 17 files changed, 444 insertions(+) create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListDeploymentResources.json create mode 100644 specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulListDeploymentResources.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json new file mode 100644 index 000000000000..3621e9a4772e --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/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/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/SuccessfulGetAssignDeploymentResourcesStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json new file mode 100644 index 000000000000..8e745940ac21 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/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/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..fe2c5e6d87e1 --- /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 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/SuccessfulGetUnassignDeploymentResourcesStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json new file mode 100644 index 000000000000..6fdb262e129a --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/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/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/SuccessfulListDeploymentResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListDeploymentResources.json new file mode 100644 index 000000000000..25efc9786690 --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/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/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json new file mode 100644 index 000000000000..8356d353898b --- /dev/null +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/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/analyzeconversations-authoring.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/analyzeconversations-authoring.json index b77d07a8cb19..b1abed8affb6 100644 --- 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 @@ -808,6 +808,11 @@ } } }, + "x-ms-examples": { + "Successful Delete Deployment From Resources": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulDeleteDeploymentFromResources.json" + } + }, "x-ms-long-running-operation": true } }, @@ -861,6 +866,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Deployment Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json" + } } } }, @@ -1563,6 +1573,11 @@ } } }, + "x-ms-examples": { + "Successful List Deployment Resources": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListDeploymentResources.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } @@ -1618,6 +1633,11 @@ } } }, + "x-ms-examples": { + "Successful Assign Deployment Resources": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json" + } + }, "x-ms-long-running-operation": true } }, @@ -1671,6 +1691,11 @@ } } }, + "x-ms-examples": { + "Successful Unassign Deployment Resources": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json" + } + }, "x-ms-long-running-operation": true } }, @@ -1717,6 +1742,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Assign Deployment Resources Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json" + } } } }, @@ -1763,6 +1793,11 @@ } } } + }, + "x-ms-examples": { + "Successful Get Unassign Deployment Resources Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json" + } } } }, @@ -2010,6 +2045,11 @@ } } }, + "x-ms-examples": { + "Successful List Assigned Resource Deployments": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulListAssignedResourceDeployments.json" + } + }, "x-ms-pageable": { "nextLinkName": "nextLink" } 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/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/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/SuccessfulGetDeploymentDeleteFromResourcesStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json new file mode 100644 index 000000000000..fe2c5e6d87e1 --- /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 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/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/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/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" + } + } + } +} From 48508b43e334c23cb5a9c6a592ee2c6f48d765da Mon Sep 17 00:00:00 2001 From: "Amber Chen (Centific Technologies Inc)" Date: Wed, 1 Oct 2025 21:38:40 -0700 Subject: [PATCH 8/9] udpate names and samples based on suggestions from dry-run --- ... => SuccessfulAssignProjectResources.json} | 6 +- ...ssfulGetAssignProjectResourcesStatus.json} | 4 +- ...etDeploymentDeleteFromResourcesStatus.json | 2 +- ...fulGetUnassignProjectResourcesStatus.json} | 4 +- ...on => SuccessfulListProjectResources.json} | 4 +- ...> SuccessfulUnassignProjectResources.json} | 4 +- .../models/project.tsp | 29 +- .../routes.tsp | 23 +- .../analyzeconversations-authoring.json | 34 +- .../analyzeconversations-authoring.json | 341 +++++++++--------- .../SuccessfulAssignProjectResources.json | 31 ++ ...essfulGetAssignProjectResourcesStatus.json | 23 ++ ...etDeploymentDeleteFromResourcesStatus.json | 2 +- ...sfulGetUnassignProjectResourcesStatus.json | 23 ++ .../SuccessfulUnassignProjectResources.json | 23 ++ 15 files changed, 327 insertions(+), 226 deletions(-) rename specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/{SuccessfulAssignDeploymentResources.json => SuccessfulAssignProjectResources.json} (86%) rename specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/{SuccessfulGetAssignDeploymentResourcesStatus.json => SuccessfulGetAssignProjectResourcesStatus.json} (79%) rename specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/{SuccessfulGetUnassignDeploymentResourcesStatus.json => SuccessfulGetUnassignProjectResourcesStatus.json} (79%) rename specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/{SuccessfulListDeploymentResources.json => SuccessfulListProjectResources.json} (86%) rename specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/{SuccessfulUnassignDeploymentResources.json => SuccessfulUnassignProjectResources.json} (83%) create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulAssignProjectResources.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignProjectResources.json similarity index 86% rename from specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json rename to specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignProjectResources.json index 3621e9a4772e..72f6df0ebc06 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulAssignProjectResources.json @@ -1,13 +1,13 @@ { - "operationId": "ConversationAuthoringProject_AssignDeploymentResources", - "title": "Successful Assign Deployment Resources", + "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": { - "resourcesMetadata": [ + "projectResources": [ { "azureResourceId": "/subscriptions/8ff19748-59ed-4e8a-af4b-7ce285849735/resourceGroups/test-rg/providers/Microsoft.CognitiveServices/accounts/LangTestWeu", "customDomain": "lang-test-weu.cognitiveservices.azure.com", diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json similarity index 79% rename from specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json rename to specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json index 8e745940ac21..2414a2305167 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json @@ -1,6 +1,6 @@ { - "operationId": "ConversationAuthoringProject_GetAssignDeploymentResourcesStatus", - "title": "Successful Get Assign Deployment Resources Status", + "operationId": "ConversationAuthoringProject_GetAssignProjectResourcesStatus", + "title": "Successful Get Assign Project Resources Status", "parameters": { "Endpoint": "{Endpoint}", "Ocp-Apim-Subscription-Key": "{API key}", 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 index fe2c5e6d87e1..2bc8cfe264a7 100644 --- 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 @@ -1,6 +1,6 @@ { "operationId": "ConversationAuthoringDeployment_GetDeploymentDeleteFromResourcesStatus", - "title": "Successful Get Deployment Status", + "title": "Successful Get Deployment Delete From Resources Status", "parameters": { "Endpoint": "{Endpoint}", "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json similarity index 79% rename from specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json rename to specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json index 6fdb262e129a..fe3d562e321f 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json @@ -1,6 +1,6 @@ { - "operationId": "ConversationAuthoringProject_GetUnassignDeploymentResourcesStatus", - "title": "Successful Get Unassign Deployment Resources Status", + "operationId": "ConversationAuthoringProject_GetUnassignProjectResourcesStatus", + "title": "Successful Get Unassign Project Resources Status", "parameters": { "Endpoint": "{Endpoint}", "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListDeploymentResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjectResources.json similarity index 86% rename from specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListDeploymentResources.json rename to specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjectResources.json index 25efc9786690..cc1542d0c6eb 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListDeploymentResources.json +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulListProjectResources.json @@ -1,6 +1,6 @@ { - "operationId": "ConversationAuthoringListDeploymentResources", - "title": "Successful List Deployment Resources", + "operationId": "conversationAuthoringListProjectResources", + "title": "Successful List Project Resources", "parameters": { "Endpoint": "{Endpoint}", "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json similarity index 83% rename from specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json rename to specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json index 8356d353898b..8187ad4c4bfe 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/examples/2025-11-01/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json @@ -1,6 +1,6 @@ { - "operationId": "ConversationAuthoringProject_UnassignDeploymentResources", - "title": "Successful Unassign Deployment Resources", + "operationId": "ConversationAuthoringProject_UnassignProjectResources", + "title": "Successful Unassign Project Resources", "parameters": { "Endpoint": "{Endpoint}", "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp index b254f71d7a83..fb246d9af5bf 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/models/project.tsp @@ -469,7 +469,7 @@ 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.v2025_11_01) @removed(Versions.v2025_05_15_preview) @@ -483,12 +483,12 @@ model AnalyzeConversationAuthoringCreateDeploymentOptions { } /** - * Represents the options for deleting a project deployment. + * Represents the payload for deleting a project deployment. */ -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentAzureResourceIds") +@renamedFrom(Versions.v2025_05_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[]; } @@ -1018,43 +1018,43 @@ model AnalyzeConversationAuthoringAssignedDeploymentResources { } /** - * Represents the assigned deployment resource. + * Represents the assigned project resource. */ @added(Versions.v2025_11_01) @resource("resources") @parentResource(AnalyzeConversationAuthoringProjectMetadata) -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentResourceInfo") +@renamedFrom(Versions.v2025_05_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.v2025_11_01) -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentResourceAssignments") +@renamedFrom(Versions.v2025_05_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_01, "deploymentResources") + @renamedFrom(Versions.v2025_05_15_preview, "projectResources") resourcesMetadata: AnalyzeConversationAuthoringResourceMetadata[]; } /** * Represents metadata for the Azure resource.. */ -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentResourceAssignmentInfo") +@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringProjectResourceAssignmentInfo") model AnalyzeConversationAuthoringResourceMetadata { /** * Represents the Azure resource ID. @@ -1084,11 +1084,12 @@ model AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions { } /** - * Represents the state of a deployment resources job. + * Represents the state of a project resources job. */ @added(Versions.v2025_11_01) @resource("resources/assign/jobs") @parentResource(AnalyzeConversationAuthoringProjectMetadata) +@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringProjectResourcesJobState") model AnalyzeConversationAuthoringDeploymentResourcesJobState { ...AnalyzeConversationAuthoringJobState; } diff --git a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp index 78b0ce3c6474..7b0b30b57532 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp @@ -63,10 +63,11 @@ op conversationAuthoringListAssignedResourceDeployments is languageOperations.Re >; /** - * 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.v2025_11_01) +@renamedFrom(Versions.v2025_05_15_preview, "conversationAuthoringListProjectResources") op conversationAuthoringListDeploymentResources is languageOperations.ResourceList< AnalyzeConversationAuthoringAssignedDeploymentResource, 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") @@ -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") @@ -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") @@ -252,6 +253,7 @@ interface ConversationAuthoringProject { ) @access(Access.internal, "python") @added(Versions.v2025_11_01) + @renamedFrom(Versions.v2025_05_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") @@ -284,6 +286,7 @@ interface ConversationAuthoringProject { ) @access(Access.internal, "python") @added(Versions.v2025_11_01) + @renamedFrom(Versions.v2025_05_15_preview, "unassignProjectResources") unassignDeploymentResources is Foundations.LongRunningOperation< { /** @@ -294,7 +297,7 @@ 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") @@ -307,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.v2025_11_01) + @renamedFrom(Versions.v2025_05_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.v2025_11_01) + @renamedFrom(Versions.v2025_05_15_preview, "getUnassignProjectResourcesStatus") getUnassignDeploymentResourcesStatus is Azure.Core.Foundations.Operation< { /** 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 index b1abed8affb6..d64ee4cffdcd 100644 --- 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 @@ -754,7 +754,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" @@ -777,10 +777,10 @@ { "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/AnalyzeConversationAuthoringDeploymentAzureResourceIds" + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectAzureResourceIds" } } ], @@ -868,7 +868,7 @@ } }, "x-ms-examples": { - "Successful Get Deployment Status": { + "Successful Get Deployment Delete From Resources Status": { "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json" } } @@ -1529,8 +1529,8 @@ }, "/authoring/analyze-conversations/projects/{projectName}/resources": { "get": { - "operationId": "ConversationAuthoringListDeploymentResources", - "description": "Lists the deployments resources assigned to the project.", + "operationId": "ConversationAuthoringListProjectResources", + "description": "Lists the Language or AIService resources assigned to the project.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -1557,7 +1557,7 @@ "200": { "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/PagedAnalyzeConversationAuthoringDeploymentResourceInfo" + "$ref": "#/definitions/PagedAnalyzeConversationAuthoringProjectResourceInfo" } }, "default": { @@ -1573,11 +1573,6 @@ } } }, - "x-ms-examples": { - "Successful List Deployment Resources": { - "$ref": "./examples/analyzeconversations-authoring/SuccessfulListDeploymentResources.json" - } - }, "x-ms-pageable": { "nextLinkName": "nextLink" } @@ -1585,8 +1580,8 @@ }, "/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", + "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" @@ -1602,10 +1597,10 @@ { "name": "body", "in": "body", - "description": "The new project resources info.", + "description": "The new project resources to be assigned.", "required": true, "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourceAssignments" + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourceAssignments" } } ], @@ -1634,8 +1629,8 @@ } }, "x-ms-examples": { - "Successful Assign Deployment Resources": { - "$ref": "./examples/analyzeconversations-authoring/SuccessfulAssignDeploymentResources.json" + "Successful Assign Project Resources": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulAssignProjectResources.json" } }, "x-ms-long-running-operation": true @@ -1643,8 +1638,8 @@ }, "/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.", + "operationId": "ConversationAuthoringProject_UnassignProjectResources", + "description": "Unassign resources from a project. This disallows deployment to these resources.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -1660,10 +1655,10 @@ { "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/AnalyzeConversationAuthoringDeploymentAzureResourceIds" + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectAzureResourceIds" } } ], @@ -1692,8 +1687,8 @@ } }, "x-ms-examples": { - "Successful Unassign Deployment Resources": { - "$ref": "./examples/analyzeconversations-authoring/SuccessfulUnassignDeploymentResources.json" + "Successful Unassign Project Resources": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulUnassignProjectResources.json" } }, "x-ms-long-running-operation": true @@ -1701,8 +1696,8 @@ }, "/authoring/analyze-conversations/projects/{projectName}/resources/assign/jobs/{jobId}": { "get": { - "operationId": "ConversationAuthoringProject_GetAssignDeploymentResourcesStatus", - "description": "Gets the status of an existing assign deployment resources job.", + "operationId": "ConversationAuthoringProject_GetAssignProjectResourcesStatus", + "description": "Gets the status of an existing assign project resources job.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -1727,7 +1722,7 @@ "200": { "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourcesJobState" + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourcesJobState" } }, "default": { @@ -1744,16 +1739,16 @@ } }, "x-ms-examples": { - "Successful Get Assign Deployment Resources Status": { - "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json" + "Successful Get Assign Project Resources Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetAssignProjectResourcesStatus.json" } } } }, "/authoring/analyze-conversations/projects/{projectName}/resources/unassign/jobs/{jobId}": { "get": { - "operationId": "ConversationAuthoringProject_GetUnassignDeploymentResourcesStatus", - "description": "Gets the status of an existing unassign deployment resources job.", + "operationId": "ConversationAuthoringProject_GetUnassignProjectResourcesStatus", + "description": "Gets the status of an existing unassign project resources job.", "parameters": [ { "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" @@ -1778,7 +1773,7 @@ "200": { "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourcesJobState" + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourcesJobState" } }, "default": { @@ -1795,8 +1790,8 @@ } }, "x-ms-examples": { - "Successful Get Unassign Deployment Resources Status": { - "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json" + "Successful Get Unassign Project Resources Status": { + "$ref": "./examples/analyzeconversations-authoring/SuccessfulGetUnassignProjectResourcesStatus.json" } } } @@ -2414,7 +2409,7 @@ }, "assignedResourceIds": { "type": "array", - "description": "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.", + "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" } @@ -2459,19 +2454,6 @@ "language" ] }, - "AnalyzeConversationAuthoringDeploymentAzureResourceIds": { - "type": "object", - "description": "Represents the options 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.", - "items": { - "type": "string" - } - } - } - }, "AnalyzeConversationAuthoringDeploymentDeleteFromResourcesJobState": { "type": "object", "description": "Represents the state of an existing delete deployment from specific resources job.", @@ -2572,114 +2554,6 @@ "status" ] }, - "AnalyzeConversationAuthoringDeploymentResourceAssignmentInfo": { - "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" - ] - }, - "AnalyzeConversationAuthoringDeploymentResourceAssignments": { - "type": "object", - "description": "Represents the options for assigning Azure resources to a project.", - "properties": { - "resourcesMetadata": { - "type": "array", - "description": "Represents the metadata for the resources to be assigned.", - "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourceAssignmentInfo" - } - } - }, - "required": [ - "resourcesMetadata" - ] - }, - "AnalyzeConversationAuthoringDeploymentResourceInfo": { - "type": "object", - "description": "Represents the assigned deployment resource.", - "properties": { - "azureResourceId": { - "type": "string", - "description": "The resource ID.", - "readOnly": true - }, - "region": { - "type": "string", - "description": "The resource region." - } - }, - "required": [ - "azureResourceId", - "region" - ] - }, - "AnalyzeConversationAuthoringDeploymentResourcesJobState": { - "type": "object", - "description": "Represents the state of a deployment 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" - ] - }, "AnalyzeConversationAuthoringEntitiesEvaluationSummary": { "type": "object", "description": "Represents the evaluation result summary for the project's entities.", @@ -3468,6 +3342,19 @@ "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.", @@ -3551,7 +3438,7 @@ "description": "Represents model training config version." }, "assignedResources": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourceInfo", + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourceInfo", "description": "Represents the metadata of the assigned Azure resources." } }, @@ -3647,6 +3534,114 @@ "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.", @@ -4297,15 +4292,15 @@ "value" ] }, - "PagedAnalyzeConversationAuthoringDeploymentResourceInfo": { + "PagedAnalyzeConversationAuthoringPrebuiltEntity": { "type": "object", - "description": "Paged collection of AnalyzeConversationAuthoringDeploymentResourceInfo items", + "description": "Paged collection of AnalyzeConversationAuthoringPrebuiltEntity items", "properties": { "value": { "type": "array", - "description": "The AnalyzeConversationAuthoringDeploymentResourceInfo items on this page", + "description": "The AnalyzeConversationAuthoringPrebuiltEntity items on this page", "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringDeploymentResourceInfo" + "$ref": "#/definitions/AnalyzeConversationAuthoringPrebuiltEntity" } }, "nextLink": { @@ -4318,15 +4313,15 @@ "value" ] }, - "PagedAnalyzeConversationAuthoringPrebuiltEntity": { + "PagedAnalyzeConversationAuthoringProjectDeployment": { "type": "object", - "description": "Paged collection of AnalyzeConversationAuthoringPrebuiltEntity items", + "description": "Paged collection of AnalyzeConversationAuthoringProjectDeployment items", "properties": { "value": { "type": "array", - "description": "The AnalyzeConversationAuthoringPrebuiltEntity items on this page", + "description": "The AnalyzeConversationAuthoringProjectDeployment items on this page", "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringPrebuiltEntity" + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectDeployment" } }, "nextLink": { @@ -4339,15 +4334,15 @@ "value" ] }, - "PagedAnalyzeConversationAuthoringProjectDeployment": { + "PagedAnalyzeConversationAuthoringProjectMetadata": { "type": "object", - "description": "Paged collection of AnalyzeConversationAuthoringProjectDeployment items", + "description": "Paged collection of AnalyzeConversationAuthoringProjectMetadata items", "properties": { "value": { "type": "array", - "description": "The AnalyzeConversationAuthoringProjectDeployment items on this page", + "description": "The AnalyzeConversationAuthoringProjectMetadata items on this page", "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringProjectDeployment" + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectMetadata" } }, "nextLink": { @@ -4360,15 +4355,15 @@ "value" ] }, - "PagedAnalyzeConversationAuthoringProjectMetadata": { + "PagedAnalyzeConversationAuthoringProjectResourceInfo": { "type": "object", - "description": "Paged collection of AnalyzeConversationAuthoringProjectMetadata items", + "description": "Paged collection of AnalyzeConversationAuthoringProjectResourceInfo items", "properties": { "value": { "type": "array", - "description": "The AnalyzeConversationAuthoringProjectMetadata items on this page", + "description": "The AnalyzeConversationAuthoringProjectResourceInfo items on this page", "items": { - "$ref": "#/definitions/AnalyzeConversationAuthoringProjectMetadata" + "$ref": "#/definitions/AnalyzeConversationAuthoringProjectResourceInfo" } }, "nextLink": { 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/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/SuccessfulGetDeploymentDeleteFromResourcesStatus.json b/specification/cognitiveservices/data-plane/Language/stable/2025-11-01/examples/analyzeconversations-authoring/SuccessfulGetDeploymentDeleteFromResourcesStatus.json index fe2c5e6d87e1..2bc8cfe264a7 100644 --- 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 @@ -1,6 +1,6 @@ { "operationId": "ConversationAuthoringDeployment_GetDeploymentDeleteFromResourcesStatus", - "title": "Successful Get Deployment Status", + "title": "Successful Get Deployment Delete From Resources Status", "parameters": { "Endpoint": "{Endpoint}", "Ocp-Apim-Subscription-Key": "{API key}", 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/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" + } + } + } +} From a57e34ef030b3ccece6d9494da9728f374a33b34 Mon Sep 17 00:00:00 2001 From: "Amber Chen (Centific Technologies Inc)" Date: Mon, 6 Oct 2025 11:53:19 -0700 Subject: [PATCH 9/9] changed all v2025_05_15_preview to v2025_11_15_preview --- .../client.tsp | 2 +- .../main.tsp | 4 +- .../models/common.tsp | 2 +- .../models/project.tsp | 62 +++++++++---------- .../routes.tsp | 32 +++++----- 5 files changed, 51 insertions(+), 51 deletions(-) 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/main.tsp b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp index 86b89b158181..186ac0e30467 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/main.tsp @@ -50,7 +50,7 @@ enum Versions { 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 2354b76c5e7f..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.v2025_05_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 fb246d9af5bf..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.v2025_05_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.v2025_05_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.v2025_05_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.v2025_05_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.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) @resource("copy/jobs") @parentResource(AnalyzeConversationAuthoringProjectMetadata) model AnalyzeConversationAuthoringCopiedProjectJobState { @@ -433,14 +433,14 @@ model AnalyzeConversationAuthoringProjectDeployment { * Represents the metadata of the assigned Azure resources. */ @added(Versions.v2025_11_01) - @typeChangedFrom(Versions.v2025_05_15_preview, AnalyzeConversationAuthoringAssignedDeploymentResource) + @typeChangedFrom(Versions.v2025_11_15_preview, AnalyzeConversationAuthoringAssignedDeploymentResource) assignedResources: AnalyzeConversationAuthoringDeploymentResource[]; } /** * Represents an Azure resource assigned to a deployment. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringDeploymentResource { /** * Represents the Azure resource Id. @@ -455,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; } @@ -472,20 +472,20 @@ model AnalyzeConversationAuthoringCreateDeploymentOptions { * 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.v2025_11_01) - @removed(Versions.v2025_05_15_preview) + @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 payload for deleting a project deployment. */ -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringProjectAzureResourceIds") +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectAzureResourceIds") model AnalyzeConversationAuthoringDeleteDeploymentOptions { /** * Represents the Language or AIService resource IDs to unassign from the project or delete the deployment from. @@ -1004,7 +1004,7 @@ model AnalyzeConversationAuthoringLoadSnapshotJobState { * Represents the assigned deployment resources. */ @added(Versions.v2025_11_01) -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringDeploymentResourcesInfoList") +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringDeploymentResourcesInfoList") model AnalyzeConversationAuthoringAssignedDeploymentResources { /** * The list of assigned deployment resources. @@ -1023,7 +1023,7 @@ model AnalyzeConversationAuthoringAssignedDeploymentResources { @added(Versions.v2025_11_01) @resource("resources") @parentResource(AnalyzeConversationAuthoringProjectMetadata) -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringProjectResourceInfo") +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectResourceInfo") model AnalyzeConversationAuthoringAssignedDeploymentResource { /** * The Azure resource ID of the language or AI resource. @@ -1042,19 +1042,19 @@ model AnalyzeConversationAuthoringAssignedDeploymentResource { * Represents the payload for assigning Azure resources to a project. */ @added(Versions.v2025_11_01) -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringProjectResourceAssignments") +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectResourceAssignments") model AnalyzeConversationAuthoringAssignDeploymentResourcesOptions { /** * Represents the metadata for the project resources to be assigned. */ - @renamedFrom(Versions.v2025_05_15_preview, "projectResources") + @renamedFrom(Versions.v2025_11_15_preview, "projectResources") resourcesMetadata: AnalyzeConversationAuthoringResourceMetadata[]; } /** * Represents metadata for the Azure resource.. */ -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringProjectResourceAssignmentInfo") +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectResourceAssignmentInfo") model AnalyzeConversationAuthoringResourceMetadata { /** * Represents the Azure resource ID. @@ -1075,7 +1075,7 @@ model AnalyzeConversationAuthoringResourceMetadata { /** * Represents the options to unassign Azure resources from a project. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions { /** * Represents the assigned resource IDs to be unassigned. @@ -1089,7 +1089,7 @@ model AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions { @added(Versions.v2025_11_01) @resource("resources/assign/jobs") @parentResource(AnalyzeConversationAuthoringProjectMetadata) -@renamedFrom(Versions.v2025_05_15_preview, "AnalyzeConversationAuthoringProjectResourcesJobState") +@renamedFrom(Versions.v2025_11_15_preview, "AnalyzeConversationAuthoringProjectResourcesJobState") model AnalyzeConversationAuthoringDeploymentResourcesJobState { ...AnalyzeConversationAuthoringJobState; } @@ -1150,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; /** @@ -1368,7 +1368,7 @@ model AnalyzeConversationAuthoringConversationExportedEntity { /** * The entity description. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) description?: string; /** @@ -1489,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. @@ -1752,7 +1752,7 @@ model AnalyzeConversationAuthoringOrchestrationExportedIntent { /** * The intent description. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) description?: string; } @@ -1843,7 +1843,7 @@ model AnalyzeConversationAuthoringExportedTrainedModel { /** * Represents the state of a job to create or updated an exported model. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) @resource("jobs") @parentResource(AnalyzeConversationAuthoringExportedTrainedModel) model AnalyzeConversationAuthoringExportedModelJobState { @@ -1852,7 +1852,7 @@ model AnalyzeConversationAuthoringExportedModelJobState { /** * Represents the properties for the model file. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) model AnalyzeConversationAuthoringModelFile { /** * The name of the file. @@ -1867,7 +1867,7 @@ model AnalyzeConversationAuthoringModelFile { /** * Represents the options for creating or replacing an exported model. */ -@added(Versions.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) model ExportedModelOptions { /** * The trained model label. @@ -1879,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", @@ -1888,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. @@ -1910,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 7b0b30b57532..9a470a2f2062 100644 --- a/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp +++ b/specification/cognitiveservices/Language.AnalyzeConversations-authoring/routes.tsp @@ -67,7 +67,7 @@ op conversationAuthoringListAssignedResourceDeployments is languageOperations.Re */ #suppress "@azure-tools/typespec-azure-core/use-standard-names" @added(Versions.v2025_11_01) -@renamedFrom(Versions.v2025_05_15_preview, "conversationAuthoringListProjectResources") +@renamedFrom(Versions.v2025_11_15_preview, "conversationAuthoringListProjectResources") op conversationAuthoringListDeploymentResources is languageOperations.ResourceList< AnalyzeConversationAuthoringAssignedDeploymentResource, ListQueryParametersTrait @@ -115,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.v2025_05_15_preview) +@added(Versions.v2025_11_15_preview) op conversationAuthoringListExportedModels is languageOperations.ResourceList< AnalyzeConversationAuthoringExportedTrainedModel, ListQueryParametersTrait @@ -253,7 +253,7 @@ interface ConversationAuthoringProject { ) @access(Access.internal, "python") @added(Versions.v2025_11_01) - @renamedFrom(Versions.v2025_05_15_preview, "assignProjectResources") + @renamedFrom(Versions.v2025_11_15_preview, "assignProjectResources") assignDeploymentResources is Foundations.LongRunningOperation< { /** @@ -286,7 +286,7 @@ interface ConversationAuthoringProject { ) @access(Access.internal, "python") @added(Versions.v2025_11_01) - @renamedFrom(Versions.v2025_05_15_preview, "unassignProjectResources") + @renamedFrom(Versions.v2025_11_15_preview, "unassignProjectResources") unassignDeploymentResources is Foundations.LongRunningOperation< { /** @@ -301,7 +301,7 @@ interface ConversationAuthoringProject { */ @body @clientName("details", "csharp") - @typeChangedFrom(Versions.v2025_05_15_preview, AnalyzeConversationAuthoringDeleteDeploymentOptions) + @typeChangedFrom(Versions.v2025_11_15_preview, AnalyzeConversationAuthoringDeleteDeploymentOptions) body: AnalyzeConversationAuthoringUnassignDeploymentResourcesOptions; }, AcceptedResponse, @@ -313,7 +313,7 @@ interface ConversationAuthoringProject { * Gets the status of an existing assign project resources job. */ @added(Versions.v2025_11_01) - @renamedFrom(Versions.v2025_05_15_preview, "getAssignProjectResourcesStatus") + @renamedFrom(Versions.v2025_11_15_preview, "getAssignProjectResourcesStatus") getAssignDeploymentResourcesStatus is languageOperations.ResourceRead; /** @@ -323,7 +323,7 @@ interface ConversationAuthoringProject { @route("/authoring/analyze-conversations/projects/{projectName}/resources/unassign/jobs/{jobId}") @get @added(Versions.v2025_11_01) - @renamedFrom(Versions.v2025_05_15_preview, "getUnassignProjectResourcesStatus") + @renamedFrom(Versions.v2025_11_15_preview, "getUnassignProjectResourcesStatus") getUnassignDeploymentResourcesStatus is Azure.Core.Foundations.Operation< { /** @@ -541,7 +541,7 @@ interface ConversationAuthoringProject { */ #suppress "@azure-tools/typespec-azure-core/casing-style" @post - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) @actionSeparator("/:") @action("authorize-copy") copyProjectAuthorization is languageOperations.ResourceAction< @@ -558,7 +558,7 @@ interface ConversationAuthoringProject { @post @pollingOperation(ConversationAuthoringProject.getCopyProjectStatus) @access(Access.internal, "python") - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) copyProject is Foundations.LongRunningOperation< { /** @@ -583,7 +583,7 @@ interface ConversationAuthoringProject { /** * Gets the status of an existing copy project job. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) getCopyProjectStatus is languageOperations.ResourceRead; /** @@ -651,7 +651,7 @@ interface ConversationAuthoringExportedModel { /** * Gets the details of an exported model. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) getExportedModel is languageOperations.ResourceRead; /** @@ -663,7 +663,7 @@ interface ConversationAuthoringExportedModel { @pollingOperation( ConversationAuthoringExportedModel.getExportedModelJobStatus ) - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) @access(Access.internal, "python") deleteExportedModel is Foundations.LongRunningOperation< { @@ -692,7 +692,7 @@ interface ConversationAuthoringExportedModel { @pollingOperation( ConversationAuthoringExportedModel.getExportedModelJobStatus ) - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) @access(Access.internal, "python") createOrUpdateExportedModel is Foundations.LongRunningOperation< { @@ -722,7 +722,7 @@ interface ConversationAuthoringExportedModel { /** * Gets the status for an existing job to create or update an exported model. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) getExportedModelJobStatus is languageOperations.ResourceRead; } interface ConversationAuthoringTrainedModel { @@ -743,7 +743,7 @@ interface ConversationAuthoringTrainedModel { @route("/authoring/analyze-conversations/projects/{projectName}/models/{trainedModelLabel}/:evaluate") @post @pollingOperation(ConversationAuthoringTrainedModel.getEvaluationStatus) - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) evaluateModel is Foundations.LongRunningOperation< { /** @@ -801,7 +801,7 @@ interface ConversationAuthoringTrainedModel { /** * Gets the status for an evaluation job. */ - @added(Versions.v2025_05_15_preview) + @added(Versions.v2025_11_15_preview) getEvaluationStatus is languageOperations.ResourceRead; /**