From e28a393ed6edfbdf1d76b20f9ebf1bfdfb3a506b Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Tue, 19 Mar 2024 19:55:14 -0700 Subject: [PATCH 01/16] Add examples and api version for May GA and Preview --- .../SuccessfulAnalyzeConversations.json | 63 +++++++++++++++ ...essfulAnalyzeConversationsArbitration.json | 76 ++++++++++++++++++ ...eConversationsArbitrationDirectTarget.json | 77 ++++++++++++++++++ ...AnalyzeConversationsJobsCancelRequest.json | 17 ++++ ...cessfulConversationPIIExclusionSubmit.json | 76 ++++++++++++++++++ ...ersationPIIExclusionTaskStatusRequest.json | 68 ++++++++++++++++ ...fulConversationPIIRedactionCharSubmit.json | 77 ++++++++++++++++++ ...tionPIIRedactionCharTaskStatusRequest.json | 76 ++++++++++++++++++ .../SuccessfulConversationPIISubmit.json | 76 ++++++++++++++++++ ...ssfulConversationPIITaskStatusRequest.json | 76 ++++++++++++++++++ ...ulConversationSummarizationTaskResult.json | 77 ++++++++++++++++++ ...rsationSummarizationTaskStatusRequest.json | 61 ++++++++++++++ ...ulConversationSummarizationTaskSubmit.json | 79 ++++++++++++++++++ .../SuccessfulConversationSummarySubmit.json | 63 +++++++++++++++ ...omConversationSummarizationTaskResult.json | 66 +++++++++++++++ ...omConversationSummarizationTaskSubmit.json | 80 +++++++++++++++++++ .../SuccessfulAnalyzeConversations.json | 63 +++++++++++++++ ...essfulAnalyzeConversationsArbitration.json | 76 ++++++++++++++++++ ...eConversationsArbitrationDirectTarget.json | 77 ++++++++++++++++++ ...AnalyzeConversationsJobsCancelRequest.json | 17 ++++ ...cessfulConversationPIIExclusionSubmit.json | 76 ++++++++++++++++++ ...ersationPIIExclusionTaskStatusRequest.json | 68 ++++++++++++++++ ...fulConversationPIIRedactionCharSubmit.json | 77 ++++++++++++++++++ ...tionPIIRedactionCharTaskStatusRequest.json | 76 ++++++++++++++++++ .../SuccessfulConversationPIISubmit.json | 76 ++++++++++++++++++ ...ssfulConversationPIITaskStatusRequest.json | 76 ++++++++++++++++++ ...ulConversationSummarizationTaskResult.json | 77 ++++++++++++++++++ ...rsationSummarizationTaskStatusRequest.json | 61 ++++++++++++++ ...ulConversationSummarizationTaskSubmit.json | 79 ++++++++++++++++++ .../SuccessfulConversationSummarySubmit.json | 63 +++++++++++++++ ...omConversationSummarizationTaskResult.json | 66 +++++++++++++++ ...omConversationSummarizationTaskSubmit.json | 80 +++++++++++++++++++ .../Language.Conversations/main.tsp | 8 ++ 33 files changed, 2224 insertions(+) create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversations.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitration.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsJobsCancelRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionSubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionTaskStatusRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharSubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIISubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIITaskStatusRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskResult.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskStatusRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskSubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarySubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskResult.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskSubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitration.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsJobsCancelRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionTaskStatusRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharSubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIISubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIITaskStatusRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskResult.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskStatusRequest.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskSubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarySubmit.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskResult.json create mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskSubmit.json diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversations.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversations.json new file mode 100644 index 000000000000..da9487c20a5f --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversations.json @@ -0,0 +1,63 @@ +{ + "operationId": "Language_AnalyzeConversations", + "title": "SuccessfulAnalyzeConversations", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-01", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "id": "1", + "participantId": "1", + "text": "play In the air tonight from Phil Collins" + } + }, + "parameters": { + "projectName": "{project-name}", + "deploymentName": "{deployment-name}", + "stringIndexType": "TextElement_V8" + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "play In the air tonight from Phil Collins", + "prediction": { + "topIntent": "PlayMusic", + "projectKind": "Conversation", + "intents": [ + { + "category": "PlayMusic", + "confidenceScore": 1 + }, + { + "category": "SearchCreativeWork", + "confidenceScore": 0 + }, + { + "category": "AddToPlaylist", + "confidenceScore": 0 + } + ], + "entities": [ + { + "category": "Media.Artist", + "text": "Phil Collins", + "offset": 29, + "length": 12, + "confidenceScore": 1 + } + ] + } + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitration.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitration.json new file mode 100644 index 000000000000..90e6eb3c02fd --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitration.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversations", + "title": "SuccessfulAnalyzeConversationsArbitration", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-01", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "participantId": "1", + "id": "1", + "modality": "text", + "language": "en-GB", + "text": "How do I integrate QnA Maker and LUIS?" + } + }, + "parameters": { + "projectName": "{project-name}", + "deploymentName": "{deployment-name}", + "verbose": true, + "isLoggingEnabled": false, + "stringIndexType": "TextElement_V8" + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "trains from London", + "prediction": { + "topIntent": "Rail", + "projectKind": "Orchestration", + "intents": { + "Rail": { + "confidenceScore": 1, + "targetProjectKind": "Conversation", + "result": { + "query": "trains from London", + "prediction": { + "topIntent": "Timetable", + "projectKind": "Conversation", + "intents": [ + { + "category": "Timetable", + "confidenceScore": 0.99968535 + }, + { + "category": "Locomotive", + "confidenceScore": 0.000314623 + } + ], + "entities": [] + } + } + }, + "Tree": { + "confidenceScore": 0.2641529, + "targetProjectKind": "QuestionAnswering" + }, + "None": { + "confidenceScore": 0, + "targetProjectKind": "NonLinked" + } + } + } + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json new file mode 100644 index 000000000000..b8c6a81f17f3 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json @@ -0,0 +1,77 @@ +{ + "operationId": "Language_AnalyzeConversations", + "title": "SuccessfulAnalyzeConversationsArbitrationDirectTarget", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-01", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "text": "Ports and connectors", + "participantId": "1", + "id": "1" + } + }, + "parameters": { + "projectName": "prj1", + "deploymentName": "dep1", + "directTarget": "qnaProject", + "targetProjectParameters": { + "qnaProject": { + "targetProjectKind": "QuestionAnswering", + "callingOptions": { + "context": { + "previousUserQuery": "Meet Surface Pro 4", + "previousQnaId": 4 + }, + "top": 1, + "question": "App Service overview" + } + } + } + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "Ports and connectors", + "prediction": { + "projectKind": "Orchestration", + "topIntent": "qnaTargetApp", + "intents": { + "qnaTargetApp": { + "targetProjectKind": "QuestionAnswering", + "confidenceScore": 1, + "result": { + "answers": [ + { + "questions": [ + "App Service overview" + ], + "answer": "The compute resources you use are determined by the *App Service plan* that you run your apps on.", + "confidenceScore": 0.7384000000000001, + "id": 1, + "source": "https://docs.microsoft.com/en-us/azure/app-service/overview", + "metadata": {}, + "dialog": { + "isContextOnly": false, + "prompts": [] + } + } + ] + } + } + } + } + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsJobsCancelRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsJobsCancelRequest.json new file mode 100644 index 000000000000..78199017b77e --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsJobsCancelRequest.json @@ -0,0 +1,17 @@ +{ + "operationId": "Language_AnalyzeConversationsCancelJob", + "title": "SuccessfulAnalyzeConversationsJobsCancelRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversations/jobs/{jobId}?api-version=2023-11-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionSubmit.json new file mode 100644 index 000000000000..0f9060aab99d --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionSubmit.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIIExclusionSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "excludePiiCategories": [ + "Person" + ], + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionTaskStatusRequest.json new file mode 100644 index 000000000000..fba06d044267 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionTaskStatusRequest.json @@ -0,0 +1,68 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIIExclusionTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning *************.", + "itn": "good morning *************", + "maskedItn": "good morning *************", + "lexical": "good morning *************", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharSubmit.json new file mode 100644 index 000000000000..2199d97391d8 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharSubmit.json @@ -0,0 +1,77 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIIRedactionCharSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "piiCategories": [ + "All" + ], + "redactionCharacter": "-", + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json new file mode 100644 index 000000000000..5927e630c685 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIIRedactionCharTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning -------------.", + "itn": "good morning -------------", + "maskedItn": "good morning -------------", + "lexical": "good morning -------------", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [ + { + "category": "Person", + "confidenceScore": 0.91, + "length": 8, + "offset": 13, + "text": "john doe" + } + ] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIISubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIISubmit.json new file mode 100644 index 000000000000..d766438cf515 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIISubmit.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIISubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "piiCategories": [ + "All" + ], + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIITaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIITaskStatusRequest.json new file mode 100644 index 000000000000..08e24b6bd8e6 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIITaskStatusRequest.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIITaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning *************.", + "itn": "good morning *************", + "maskedItn": "good morning *************", + "lexical": "good morning *************", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [ + { + "category": "Person", + "confidenceScore": 0.91, + "length": 8, + "offset": 13, + "text": "john doe" + } + ] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskResult.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskResult.json new file mode 100644 index 000000000000..34e0998ff4c9 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskResult.json @@ -0,0 +1,77 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationSummarizationTaskResult", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Conversation Summarization Example", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "Conversation Summarization Task 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "summaries": [ + { + "aspect": "chapterTitle", + "text": "Bug Triage", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + } + ] + }, + { + "aspect": "narrative", + "text": "Speaker 3 believes there are 3 remaining bugs.", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + }, + { + "conversationItemId": "3", + "offset": 0, + "length": 7 + } + ] + } + ], + "warnings": [] + } + ], + "errors": [], + "modelVersion": "latest" + } + } + ] + }, + "nextLink": "/language/analyze-conversation/jobs/3e9e8518-492f-47f9-abd1-9a7468231086?$skip=10&$top=10" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskStatusRequest.json new file mode 100644 index 000000000000..d258b4ff4c07 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskStatusRequest.json @@ -0,0 +1,61 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationSummarizationTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Analyze chat", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "analyze 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "20220101meeting", + "summaries": [ + { + "aspect": "issue", + "text": "Customer wants to cancel his subscription. Customer doesn't know how" + }, + { + "aspect": "resolution", + "text": "pii Auto-Fortify. \npii Gamertag.\npii E-mail.\nCanceled customer's subscription" + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "latest" + } + } + ] + }, + "nextLink": "/language/analyze-conversation/jobs/3e9e8518-492f-47f9-abd1-9a7468231086?$skip=10&$top=10" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskSubmit.json new file mode 100644 index 000000000000..08aec4c3fcf4 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskSubmit.json @@ -0,0 +1,79 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationSummarizationTaskSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Conversation Summarization Example", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "conversationItems": [ + { + "participantId": "speaker 1", + "id": "1", + "text": "Let's get started.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 0, + "duration": 20000000 + } + }, + { + "participantId": "speaker 2", + "id": "2", + "text": "OK. How many remaining bugs do we have now?", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 20000000, + "duration": 50000000 + } + }, + { + "participantId": "speaker 3", + "id": "3", + "text": "Only 3.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 50000000, + "duration": 60000000 + } + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation Summarization Task 1", + "kind": "ConversationalSummarizationTask", + "parameters": { + "summaryAspects": [ + "chapterTitle", + "narrative" + ] + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarySubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarySubmit.json new file mode 100644 index 000000000000..2734b9e32ae2 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarySubmit.json @@ -0,0 +1,63 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationSummarySubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Analyze conversations from Contoso meeting", + "analysisInput": { + "conversations": [ + { + "id": "20220101meeting", + "language": "en", + "modality": "text", + "domain": "generic", + "conversationItems": [ + { + "participantId": "user", + "role": "customer", + "id": "1", + "text": "Hi!" + }, + { + "participantId": "agent", + "role": "agent", + "id": "2", + "text": "Hello, how can I help you?" + }, + { + "participantId": "user", + "role": "customer", + "id": "3", + "text": "I am having trouble issuing a return of a game on my xbox: call of duty" + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "analyze 1", + "kind": "ConversationalSummarizationTask", + "parameters": { + "modelVersion": "latest", + "summaryAspects": [ + "issue", + "resolution" + ] + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskResult.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskResult.json new file mode 100644 index 000000000000..c37fcbc0e6fa --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskResult.json @@ -0,0 +1,66 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulCustomConversationSummarizationTaskResult", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Custom Conversation Summarization Example", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "CustomConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "Custom Conversation Summarization Task 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "summaries": [ + { + "aspect": "narrative", + "text": "Speaker 3 believes there are 3 remaining bugs.", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + }, + { + "conversationItemId": "3", + "offset": 0, + "length": 7 + } + ] + } + ], + "warnings": [] + } + ], + "errors": [], + "projectName": "my_project", + "deploymentName": "my_deployment" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskSubmit.json new file mode 100644 index 000000000000..d5bfada8750c --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskSubmit.json @@ -0,0 +1,80 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulCustomConversationSummarizationTaskSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Custom Conversation Summarization Example", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "conversationItems": [ + { + "participantId": "speaker 1", + "id": "1", + "text": "Let's get started.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 0, + "duration": 20000000 + } + }, + { + "participantId": "speaker 2", + "id": "2", + "text": "OK. How many remaining bugs do we have now?", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 20000000, + "duration": 50000000 + } + }, + { + "participantId": "speaker 3", + "id": "3", + "text": "Only 3.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 50000000, + "duration": 60000000 + } + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Custom Conversation Summarization Task 1", + "kind": "CustomConversationalSummarizationTask", + "parameters": { + "summaryAspects": [ + "narrative" + ], + "projectName": "my_project", + "deploymentName": "my_deployment" + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json new file mode 100644 index 000000000000..3ad8903cc3a8 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json @@ -0,0 +1,63 @@ +{ + "operationId": "Language_AnalyzeConversations", + "title": "SuccessfulAnalyzeConversations", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-15-preview", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "id": "1", + "participantId": "1", + "text": "play In the air tonight from Phil Collins" + } + }, + "parameters": { + "projectName": "{project-name}", + "deploymentName": "{deployment-name}", + "stringIndexType": "TextElement_V8" + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "play In the air tonight from Phil Collins", + "prediction": { + "topIntent": "PlayMusic", + "projectKind": "Conversation", + "intents": [ + { + "category": "PlayMusic", + "confidenceScore": 1 + }, + { + "category": "SearchCreativeWork", + "confidenceScore": 0 + }, + { + "category": "AddToPlaylist", + "confidenceScore": 0 + } + ], + "entities": [ + { + "category": "Media.Artist", + "text": "Phil Collins", + "offset": 29, + "length": 12, + "confidenceScore": 1 + } + ] + } + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitration.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitration.json new file mode 100644 index 000000000000..fd3c6be889f3 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitration.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversations", + "title": "SuccessfulAnalyzeConversationsArbitration", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-15-preview", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "participantId": "1", + "id": "1", + "modality": "text", + "language": "en-GB", + "text": "How do I integrate QnA Maker and LUIS?" + } + }, + "parameters": { + "projectName": "{project-name}", + "deploymentName": "{deployment-name}", + "verbose": true, + "isLoggingEnabled": false, + "stringIndexType": "TextElement_V8" + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "trains from London", + "prediction": { + "topIntent": "Rail", + "projectKind": "Orchestration", + "intents": { + "Rail": { + "confidenceScore": 1, + "targetProjectKind": "Conversation", + "result": { + "query": "trains from London", + "prediction": { + "topIntent": "Timetable", + "projectKind": "Conversation", + "intents": [ + { + "category": "Timetable", + "confidenceScore": 0.99968535 + }, + { + "category": "Locomotive", + "confidenceScore": 0.000314623 + } + ], + "entities": [] + } + } + }, + "Tree": { + "confidenceScore": 0.2641529, + "targetProjectKind": "QuestionAnswering" + }, + "None": { + "confidenceScore": 0, + "targetProjectKind": "NonLinked" + } + } + } + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json new file mode 100644 index 000000000000..74240092c77e --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json @@ -0,0 +1,77 @@ +{ + "operationId": "Language_AnalyzeConversations", + "title": "SuccessfulAnalyzeConversationsArbitrationDirectTarget", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-15-preview", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "text": "Ports and connectors", + "participantId": "1", + "id": "1" + } + }, + "parameters": { + "projectName": "prj1", + "deploymentName": "dep1", + "directTarget": "qnaProject", + "targetProjectParameters": { + "qnaProject": { + "targetProjectKind": "QuestionAnswering", + "callingOptions": { + "context": { + "previousUserQuery": "Meet Surface Pro 4", + "previousQnaId": 4 + }, + "top": 1, + "question": "App Service overview" + } + } + } + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "Ports and connectors", + "prediction": { + "projectKind": "Orchestration", + "topIntent": "qnaTargetApp", + "intents": { + "qnaTargetApp": { + "targetProjectKind": "QuestionAnswering", + "confidenceScore": 1, + "result": { + "answers": [ + { + "questions": [ + "App Service overview" + ], + "answer": "The compute resources you use are determined by the *App Service plan* that you run your apps on.", + "confidenceScore": 0.7384000000000001, + "id": 1, + "source": "https://docs.microsoft.com/en-us/azure/app-service/overview", + "metadata": {}, + "dialog": { + "isContextOnly": false, + "prompts": [] + } + } + ] + } + } + } + } + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsJobsCancelRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsJobsCancelRequest.json new file mode 100644 index 000000000000..ff4e00df2436 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsJobsCancelRequest.json @@ -0,0 +1,17 @@ +{ + "operationId": "Language_AnalyzeConversationsCancelJob", + "title": "SuccessfulAnalyzeConversationsJobsCancelRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversations/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json new file mode 100644 index 000000000000..eba7d0d4007e --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIIExclusionSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2023-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "excludePiiCategories": [ + "Person" + ], + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2023-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionTaskStatusRequest.json new file mode 100644 index 000000000000..fd30d5b1ab49 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionTaskStatusRequest.json @@ -0,0 +1,68 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIIExclusionTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning *************.", + "itn": "good morning *************", + "maskedItn": "good morning *************", + "lexical": "good morning *************", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharSubmit.json new file mode 100644 index 000000000000..3a473402a1ec --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharSubmit.json @@ -0,0 +1,77 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIIRedactionCharSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "piiCategories": [ + "All" + ], + "redactionCharacter": "-", + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json new file mode 100644 index 000000000000..762e90e26238 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIIRedactionCharTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning -------------.", + "itn": "good morning -------------", + "maskedItn": "good morning -------------", + "lexical": "good morning -------------", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [ + { + "category": "Person", + "confidenceScore": 0.91, + "length": 8, + "offset": 13, + "text": "john doe" + } + ] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIISubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIISubmit.json new file mode 100644 index 000000000000..bccb3c2d08f3 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIISubmit.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIISubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "piiCategories": [ + "All" + ], + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIITaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIITaskStatusRequest.json new file mode 100644 index 000000000000..c89f99fa55d3 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIITaskStatusRequest.json @@ -0,0 +1,76 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIITaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning *************.", + "itn": "good morning *************", + "maskedItn": "good morning *************", + "lexical": "good morning *************", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [ + { + "category": "Person", + "confidenceScore": 0.91, + "length": 8, + "offset": 13, + "text": "john doe" + } + ] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskResult.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskResult.json new file mode 100644 index 000000000000..3026f289b5f7 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskResult.json @@ -0,0 +1,77 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationSummarizationTaskResult", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Conversation Summarization Example", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "Conversation Summarization Task 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "summaries": [ + { + "aspect": "chapterTitle", + "text": "Bug Triage", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + } + ] + }, + { + "aspect": "narrative", + "text": "Speaker 3 believes there are 3 remaining bugs.", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + }, + { + "conversationItemId": "3", + "offset": 0, + "length": 7 + } + ] + } + ], + "warnings": [] + } + ], + "errors": [], + "modelVersion": "latest" + } + } + ] + }, + "nextLink": "/language/analyze-conversation/jobs/3e9e8518-492f-47f9-abd1-9a7468231086?$skip=10&$top=10" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskStatusRequest.json new file mode 100644 index 000000000000..3ee1b6c4dcc2 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskStatusRequest.json @@ -0,0 +1,61 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationSummarizationTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Analyze chat", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "analyze 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "20220101meeting", + "summaries": [ + { + "aspect": "issue", + "text": "Customer wants to cancel his subscription. Customer doesn't know how" + }, + { + "aspect": "resolution", + "text": "pii Auto-Fortify. \npii Gamertag.\npii E-mail.\nCanceled customer's subscription" + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "latest" + } + } + ] + }, + "nextLink": "/language/analyze-conversation/jobs/3e9e8518-492f-47f9-abd1-9a7468231086?$skip=10&$top=10" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskSubmit.json new file mode 100644 index 000000000000..3c5489941be2 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskSubmit.json @@ -0,0 +1,79 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationSummarizationTaskSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Conversation Summarization Example", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "conversationItems": [ + { + "participantId": "speaker 1", + "id": "1", + "text": "Let's get started.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 0, + "duration": 20000000 + } + }, + { + "participantId": "speaker 2", + "id": "2", + "text": "OK. How many remaining bugs do we have now?", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 20000000, + "duration": 50000000 + } + }, + { + "participantId": "speaker 3", + "id": "3", + "text": "Only 3.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 50000000, + "duration": 60000000 + } + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation Summarization Task 1", + "kind": "ConversationalSummarizationTask", + "parameters": { + "summaryAspects": [ + "chapterTitle", + "narrative" + ] + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarySubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarySubmit.json new file mode 100644 index 000000000000..2298c15c8f4d --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarySubmit.json @@ -0,0 +1,63 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationSummarySubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Analyze conversations from Contoso meeting", + "analysisInput": { + "conversations": [ + { + "id": "20220101meeting", + "language": "en", + "modality": "text", + "domain": "generic", + "conversationItems": [ + { + "participantId": "user", + "role": "customer", + "id": "1", + "text": "Hi!" + }, + { + "participantId": "agent", + "role": "agent", + "id": "2", + "text": "Hello, how can I help you?" + }, + { + "participantId": "user", + "role": "customer", + "id": "3", + "text": "I am having trouble issuing a return of a game on my xbox: call of duty" + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "analyze 1", + "kind": "ConversationalSummarizationTask", + "parameters": { + "modelVersion": "latest", + "summaryAspects": [ + "issue", + "resolution" + ] + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskResult.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskResult.json new file mode 100644 index 000000000000..05c5df32bed6 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskResult.json @@ -0,0 +1,66 @@ +{ + "operationId": "Language_AnalyzeConversationsJobStatus", + "title": "SuccessfulCustomConversationSummarizationTaskResult", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Custom Conversation Summarization Example", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "CustomConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "Custom Conversation Summarization Task 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "summaries": [ + { + "aspect": "narrative", + "text": "Speaker 3 believes there are 3 remaining bugs.", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + }, + { + "conversationItemId": "3", + "offset": 0, + "length": 7 + } + ] + } + ], + "warnings": [] + } + ], + "errors": [], + "projectName": "my_project", + "deploymentName": "my_deployment" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskSubmit.json new file mode 100644 index 000000000000..53f5c31d9b34 --- /dev/null +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskSubmit.json @@ -0,0 +1,80 @@ +{ + "operationId": "Language_AnalyzeConversationsSubmitJob", + "title": "SuccessfulCustomConversationSummarizationTaskSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Custom Conversation Summarization Example", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "conversationItems": [ + { + "participantId": "speaker 1", + "id": "1", + "text": "Let's get started.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 0, + "duration": 20000000 + } + }, + { + "participantId": "speaker 2", + "id": "2", + "text": "OK. How many remaining bugs do we have now?", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 20000000, + "duration": 50000000 + } + }, + { + "participantId": "speaker 3", + "id": "3", + "text": "Only 3.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 50000000, + "duration": 60000000 + } + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Custom Conversation Summarization Task 1", + "kind": "CustomConversationalSummarizationTask", + "parameters": { + "summaryAspects": [ + "narrative" + ], + "projectName": "my_project", + "deploymentName": "my_deployment" + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index dce0f6939cf4..98c5d1cf2215 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -44,6 +44,14 @@ enum Versions { /** Version 2023-11-15-preview */ @useDependency(Azure.Core.Versions.v1_0_Preview_2) v2023_11_15_preview: "2023-11-15-preview", + + @doc("Version 2024-05-01") + @useDependency(Azure.Core.Versions.v1_0_Preview_2) + v2024_05_01: "2024-05-01", + + @doc("Version 2024-05-15-preview") + @useDependency(Azure.Core.Versions.v1_0_Preview_2) + 2024-05-15-preview: "2024-05-15-preview", } /** These are the [Azure Active Directory OAuth2](https://docs.microsoft.com/azure/active-directory/develop/v1-overview) Flows. When paired with [Azure role-based access](https://docs.microsoft.com/azure/role-based-access-control/overview) control it can be used to control access to Azure Maps REST APIs. Azure role-based access controls are used to designate access to one or more Azure Maps resource account or sub-resources. Any user, group, or service principal can be granted access via a built-in role or a custom role composed of one or more permissions to Azure Maps REST APIs.\n\nTo implement scenarios, we recommend viewing [authentication concepts](https://aka.ms/amauth). In summary, this security definition provides a solution for modeling application(s) via objects capable of access control on specific APIs and scopes.\n\n#### Notes\n* This security definition **requires** the use of the `x-ms-client-id` header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the [Maps management API](https://aka.ms/amauthdetails).\n* \nThe `Authorization URL` is specific to the Azure public cloud instance. Sovereign clouds have unique Authorization URLs and Azure Active directory configurations. \n* \nThe Azure role-based access control is configured from the [Azure management plane](https://aka.ms/amrbac) via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.\n* \nUsage of the [Azure Maps Web SDK](https://aka.ms/amaadmc) allows for configuration based setup of an application for multiple use cases.\n* Currently, Azure Active Directory [v1.0 or v2.0](https://docs.microsoft.com/azure/active-directory/develop/azure-ad-endpoint-comparison) supports Work, School, and Guests but does not support Personal accounts. */ From 97d3b24273dfea267eddba84826e8476de5adef6 Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Fri, 5 Apr 2024 16:48:11 -0700 Subject: [PATCH 02/16] Add Aspect related tsp changes --- .../cognitiveservices/Language.Conversations/main.tsp | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index 98c5d1cf2215..be32a5069f65 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -51,7 +51,7 @@ enum Versions { @doc("Version 2024-05-15-preview") @useDependency(Azure.Core.Versions.v1_0_Preview_2) - 2024-05-15-preview: "2024-05-15-preview", + v2024-05-15-preview: "2024-05-15-preview", } /** These are the [Azure Active Directory OAuth2](https://docs.microsoft.com/azure/active-directory/develop/v1-overview) Flows. When paired with [Azure role-based access](https://docs.microsoft.com/azure/role-based-access-control/overview) control it can be used to control access to Azure Maps REST APIs. Azure role-based access controls are used to designate access to one or more Azure Maps resource account or sub-resources. Any user, group, or service principal can be granted access via a built-in role or a custom role composed of one or more permissions to Azure Maps REST APIs.\n\nTo implement scenarios, we recommend viewing [authentication concepts](https://aka.ms/amauth). In summary, this security definition provides a solution for modeling application(s) via objects capable of access control on specific APIs and scopes.\n\n#### Notes\n* This security definition **requires** the use of the `x-ms-client-id` header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the [Maps management API](https://aka.ms/amauthdetails).\n* \nThe `Authorization URL` is specific to the Azure public cloud instance. Sovereign clouds have unique Authorization URLs and Azure Active directory configurations. \n* \nThe Azure role-based access control is configured from the [Azure management plane](https://aka.ms/amrbac) via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.\n* \nUsage of the [Azure Maps Web SDK](https://aka.ms/amaadmc) allows for configuration based setup of an application for multiple use cases.\n* Currently, Azure Active Directory [v1.0 or v2.0](https://docs.microsoft.com/azure/active-directory/develop/azure-ad-endpoint-comparison) supports Work, School, and Guests but does not support Personal accounts. */ @@ -1196,6 +1196,8 @@ union SummaryAspect { recap: "recap", /** Action items and tasks that arose during a meeting. */ + @added(Versions.v2024-05-15-preview) + @removed(Versions.v2024_05_01) @added(Versions.v2023_11_15_preview) followUpTasks: "follow-up tasks", } From 0d1d517efd470a7e4e3776085b7d67eace556de0 Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Mon, 8 Apr 2024 12:51:35 -0700 Subject: [PATCH 03/16] Some API version corrections --- specification/cognitiveservices/Language.Conversations/main.tsp | 2 -- 1 file changed, 2 deletions(-) diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index be32a5069f65..840949d2d4f5 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -1197,8 +1197,6 @@ union SummaryAspect { /** Action items and tasks that arose during a meeting. */ @added(Versions.v2024-05-15-preview) - @removed(Versions.v2024_05_01) - @added(Versions.v2023_11_15_preview) followUpTasks: "follow-up tasks", } From 8790070074a2334e1f872bf8f0e5efd917977d4a Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Mon, 8 Apr 2024 12:56:06 -0700 Subject: [PATCH 04/16] Remove Custom Conv Summarization examples from May GA examples --- ...omConversationSummarizationTaskResult.json | 66 --------------- ...omConversationSummarizationTaskSubmit.json | 80 ------------------- 2 files changed, 146 deletions(-) delete mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskResult.json delete mode 100644 specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskSubmit.json diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskResult.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskResult.json deleted file mode 100644 index c37fcbc0e6fa..000000000000 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskResult.json +++ /dev/null @@ -1,66 +0,0 @@ -{ - "operationId": "Language_AnalyzeConversationsJobStatus", - "title": "SuccessfulCustomConversationSummarizationTaskResult", - "parameters": { - "Ocp-Apim-Subscription-Key": "{API key}", - "api-version": "2024-05-01", - "Endpoint": "{Endpoint}", - "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086" - }, - "responses": { - "200": { - "headers": {}, - "body": { - "displayName": "Custom Conversation Summarization Example", - "createdDateTime": "2022-04-01T15:00:45Z", - "expirationDateTime": "2022-04-02T15:00:45Z", - "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", - "lastUpdatedDateTime": "2022-04-01T15:00:49Z", - "status": "succeeded", - "tasks": { - "completed": 1, - "failed": 0, - "inProgress": 0, - "total": 1, - "items": [ - { - "kind": "CustomConversationalSummarizationResults", - "lastUpdateDateTime": "2022-04-01T15:00:49Z", - "taskName": "Custom Conversation Summarization Task 1", - "status": "succeeded", - "results": { - "conversations": [ - { - "id": "1", - "summaries": [ - { - "aspect": "narrative", - "text": "Speaker 3 believes there are 3 remaining bugs.", - "contexts": [ - { - "conversationItemId": "2", - "offset": 4, - "length": 39 - }, - { - "conversationItemId": "3", - "offset": 0, - "length": 7 - } - ] - } - ], - "warnings": [] - } - ], - "errors": [], - "projectName": "my_project", - "deploymentName": "my_deployment" - } - } - ] - } - } - } - } -} diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskSubmit.json deleted file mode 100644 index d5bfada8750c..000000000000 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulCustomConversationSummarizationTaskSubmit.json +++ /dev/null @@ -1,80 +0,0 @@ -{ - "operationId": "Language_AnalyzeConversationsSubmitJob", - "title": "SuccessfulCustomConversationSummarizationTaskSubmit", - "parameters": { - "Ocp-Apim-Subscription-Key": "{API key}", - "api-version": "2024-05-01", - "Endpoint": "{Endpoint}", - "jobId": "{Job ID}", - "body": { - "displayName": "Custom Conversation Summarization Example", - "analysisInput": { - "conversations": [ - { - "id": "1", - "language": "en", - "modality": "transcript", - "conversationItems": [ - { - "participantId": "speaker 1", - "id": "1", - "text": "Let's get started.", - "lexical": "", - "itn": "", - "maskedItn": "", - "conversationItemLevelTiming": { - "offset": 0, - "duration": 20000000 - } - }, - { - "participantId": "speaker 2", - "id": "2", - "text": "OK. How many remaining bugs do we have now?", - "lexical": "", - "itn": "", - "maskedItn": "", - "conversationItemLevelTiming": { - "offset": 20000000, - "duration": 50000000 - } - }, - { - "participantId": "speaker 3", - "id": "3", - "text": "Only 3.", - "lexical": "", - "itn": "", - "maskedItn": "", - "conversationItemLevelTiming": { - "offset": 50000000, - "duration": 60000000 - } - } - ] - } - ] - }, - "tasks": [ - { - "taskName": "Custom Conversation Summarization Task 1", - "kind": "CustomConversationalSummarizationTask", - "parameters": { - "summaryAspects": [ - "narrative" - ], - "projectName": "my_project", - "deploymentName": "my_deployment" - } - } - ] - } - }, - "responses": { - "202": { - "headers": { - "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" - } - } - } -} From 6ab20b7031956ef3fe3ae669d30a65753379d7c6 Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Tue, 9 Apr 2024 10:25:01 -0700 Subject: [PATCH 05/16] minor api adjustments for other custom conv summarization attributes --- .../cognitiveservices/Language.Conversations/main.tsp | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index 840949d2d4f5..8f1065fcf90f 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -1134,7 +1134,10 @@ union TranscriptContentType { } /** Task definition for custom conversational summarization. */ +@added(Versions.v2024-05-15-preview) +@removed(Versions.v2024_05_01) @added(Versions.v2023_11_15_preview) +@doc("Task definition for custom conversational summarization.") model AnalyzeCustomConversationSummarizationTask extends AnalyzeConversationLROTask { /** discriminator kind */ @@ -1169,7 +1172,10 @@ model ConversationSummarizationTaskParameters is PreBuiltTaskParameters { } /** Supported parameters for a custom conversation summarization task. */ +@added(Versions.v2024_05_15_preview) +@removed(Versions.v2024_05_01) @added(Versions.v2023_11_15_preview) +@doc("Supported parameters for a custom conversation summarization task.") model CustomConversationSummarizationTaskParameters is CustomTaskParameters { ...ConversationSummarizationTaskParametersBase; } @@ -1212,7 +1218,10 @@ model AnalyzeConversationSummarizationResult } /** Result for the custom summarization task on the conversation. */ +@added(Versions.v2024_05_15_preview) +@removed(Versions.v2024_05_01) @added(Versions.v2023_11_15_preview) +@doc("Result for the custom summarization task on the conversation.") model AnalyzeCustomConversationSummarizationResult extends AnalyzeConversationJobResult { /** discriminator kind */ @@ -1237,6 +1246,8 @@ model SummaryResult { } /** Custom Summary Results */ +@added(Versions.v2024_05_15_preview) +@removed(Versions.v2024_05_01) @added(Versions.v2023_11_15_preview) model CustomSummaryResult { ...SummaryResultBase; From 783942b2e512fe4e95aeed20a1c2c1f07a669822 Mon Sep 17 00:00:00 2001 From: nithya4 <13850604+nithya4@users.noreply.github.com> Date: Wed, 10 Apr 2024 12:35:42 -0400 Subject: [PATCH 06/16] Add an example and specifications for entity tags (#1) --- .../SuccessfulAnalyzeConversations.json | 83 ++++++++++++++++--- .../Language.Conversations/main.tsp | 17 +++- 2 files changed, 86 insertions(+), 14 deletions(-) diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json index 3ad8903cc3a8..0b8ef196aa82 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json @@ -12,7 +12,7 @@ "conversationItem": { "id": "1", "participantId": "1", - "text": "play In the air tonight from Phil Collins" + "text": "Book a flight to Seattle on Oct 10th" } }, "parameters": { @@ -28,32 +28,89 @@ "body": { "kind": "ConversationResult", "result": { - "query": "play In the air tonight from Phil Collins", + "query": "Book a flight to Seattle on Oct 10th", "prediction": { - "topIntent": "PlayMusic", + "topIntent": "BookFlight", "projectKind": "Conversation", "intents": [ { - "category": "PlayMusic", + "category": "None", "confidenceScore": 1 }, { - "category": "SearchCreativeWork", + "category": "BookTrain", "confidenceScore": 0 }, { - "category": "AddToPlaylist", + "category": "BookFlight", "confidenceScore": 0 } ], "entities": [ - { - "category": "Media.Artist", - "text": "Phil Collins", - "offset": 29, - "length": 12, - "confidenceScore": 1 - } + { + "category": "Geography.Location", + "text": "seattle", + "offset": 17, + "length": 7, + "confidenceScore": 1, + "extraInformation": [ + { + "extraInformationKind": "EntitySubtype", + "value": "geography.location", + "tags": [ + { + "name": "City", + "confidenceScore": 1 + }, + { + "name": "GPE", + "confidenceScore": 1 + }, + { + "name": "Location", + "confidenceScore": 1 + } + ] + } + ] + }, + { + "category": "DateTime", + "text": "oct 10th", + "offset": 28, + "length": 8, + "confidenceScore": 1, + "resolutions": [ + { + "resolutionKind": "DateTimeResolution", + "dateTimeSubKind": "Date", + "timex": "XXXX-10-10", + "value": "2023-10-10" + }, + { + "resolutionKind": "DateTimeResolution", + "dateTimeSubKind": "Date", + "timex": "XXXX-10-10", + "value": "2024-10-10" + } + ], + "extraInformation": [ + { + "extraInformationKind": "EntitySubtype", + "value": "datetime.date", + "tags": [ + { + "name": "Date", + "confidenceScore": 1 + }, + { + "name": "Temporal", + "confidenceScore": 1 + } + ] + } + ] + } ] } } diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index 8f1065fcf90f..7549cb0faeb0 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -51,7 +51,7 @@ enum Versions { @doc("Version 2024-05-15-preview") @useDependency(Azure.Core.Versions.v1_0_Preview_2) - v2024-05-15-preview: "2024-05-15-preview", + v2024_05_15_preview: "2024-05-15-preview" } /** These are the [Azure Active Directory OAuth2](https://docs.microsoft.com/azure/active-directory/develop/v1-overview) Flows. When paired with [Azure role-based access](https://docs.microsoft.com/azure/role-based-access-control/overview) control it can be used to control access to Azure Maps REST APIs. Azure role-based access controls are used to designate access to one or more Azure Maps resource account or sub-resources. Any user, group, or service principal can be granted access via a built-in role or a custom role composed of one or more permissions to Azure Maps REST APIs.\n\nTo implement scenarios, we recommend viewing [authentication concepts](https://aka.ms/amauth). In summary, this security definition provides a solution for modeling application(s) via objects capable of access control on specific APIs and scopes.\n\n#### Notes\n* This security definition **requires** the use of the `x-ms-client-id` header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the [Maps management API](https://aka.ms/amauthdetails).\n* \nThe `Authorization URL` is specific to the Azure public cloud instance. Sovereign clouds have unique Authorization URLs and Azure Active directory configurations. \n* \nThe Azure role-based access control is configured from the [Azure management plane](https://aka.ms/amrbac) via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.\n* \nUsage of the [Azure Maps Web SDK](https://aka.ms/amaadmc) allows for configuration based setup of an application for multiple use cases.\n* Currently, Azure Active Directory [v1.0 or v2.0](https://docs.microsoft.com/azure/active-directory/develop/azure-ad-endpoint-comparison) supports Work, School, and Guests but does not support Personal accounts. */ @@ -357,6 +357,10 @@ model EntitySubtype extends BaseExtraInformation { /** The Subtype of an extracted entity type. */ value?: string; + + @doc("List of entity tags. Tags express similarities between entity categories for the extracted entity type.") + @added(Versions.v2024_05_15_preview) + tags?: Array; } /** The list key extra data kind. */ @@ -382,6 +386,17 @@ model RegexKey extends BaseExtraInformation { } /** The abstract base class for entity resolutions. */ +@doc("Tags express similarities between entity categories for the extracted entity type.") +@added(Versions.v2024_05_15_preview) +model EntityTag { + @doc("The name of the tag.") + name: string; + + @doc("The confidence score of the tag for the extracted entity between 0.0 and 1.0.") + confidenceScore?: float64; +} + +@doc("The abstract base class for entity resolutions.") @discriminator("resolutionKind") model BaseResolution { /** The entity resolution object kind. */ From 289e316fe9cd5cbd9b591b8955d03f69960b3328 Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Fri, 12 Apr 2024 10:46:59 -0700 Subject: [PATCH 07/16] compile fixes --- .../Language.Conversations/main.tsp | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index 7549cb0faeb0..33c75fb25344 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -686,10 +686,11 @@ union AnalyzeConversationResultsKind { ConversationalPIIResults: "ConversationalPIIResults", /** Custom Conversational Summarization Results */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_15_preview) CustomConversationalSummarizationResults: "CustomConversationalSummarizationResults", /** Conversational Sentiment Results */ + @removed(Versions.v2024_05_01) @added(Versions.v2023_11_15_preview) ConversationalSentimentResults: "ConversationalSentimentResults", } @@ -903,6 +904,7 @@ model ConversationRequestStatistics is RequestStatistics { model ConversationItemLevelTiming is AudioTiming; /** Task definition for conversational sentiment. */ +@removed(Versions.v2024_05_01) @added(Versions.v2023_11_15_preview) model AnalyzeConversationalSentimentTask extends AnalyzeConversationLROTask { /** discriminator kind */ @@ -1149,9 +1151,7 @@ union TranscriptContentType { } /** Task definition for custom conversational summarization. */ -@added(Versions.v2024-05-15-preview) -@removed(Versions.v2024_05_01) -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_15_preview) @doc("Task definition for custom conversational summarization.") model AnalyzeCustomConversationSummarizationTask extends AnalyzeConversationLROTask { @@ -1188,9 +1188,6 @@ model ConversationSummarizationTaskParameters is PreBuiltTaskParameters { /** Supported parameters for a custom conversation summarization task. */ @added(Versions.v2024_05_15_preview) -@removed(Versions.v2024_05_01) -@added(Versions.v2023_11_15_preview) -@doc("Supported parameters for a custom conversation summarization task.") model CustomConversationSummarizationTaskParameters is CustomTaskParameters { ...ConversationSummarizationTaskParametersBase; } @@ -1217,7 +1214,7 @@ union SummaryAspect { recap: "recap", /** Action items and tasks that arose during a meeting. */ - @added(Versions.v2024-05-15-preview) + @added(Versions.v2024_05_15_preview) followUpTasks: "follow-up tasks", } From dfea0b6cf10301d986cc893ae9452414e992a50c Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Fri, 12 Apr 2024 11:03:46 -0700 Subject: [PATCH 08/16] Add examples --- .../analyzeconversations.json | 4901 +++++++++++++++++ .../2024-05-01/analyzeconversations.json | 4713 ++++++++++++++++ 2 files changed, 9614 insertions(+) create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json new file mode 100644 index 000000000000..ee064d37641a --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json @@ -0,0 +1,4901 @@ +{ + "swagger": "2.0", + "info": { + "title": "Microsoft Cognitive Language Service - Analyze Conversations", + "version": "2024-05-15-preview", + "description": "The language service conversations API is a suite of natural language processing (NLP) skills that can be used to analyze structured conversations (textual or spoken). The synchronous API in this suite accepts a request and mediates among multiple language projects, such as LUIS Generally Available, Question Answering, Conversational Language Understanding, and then calls the best candidate service to handle the request. At last, it returns a response with the candidate service's response as a payload.\n\n In some cases, this API needs to forward requests and responses between the caller and an upstream service. The asynchronous APIs in this suite enable tasks like Conversation Summarization and Conversational PII detection.", + "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" + } + ] + }, + "produces": [ + "application/json" + ], + "consumes": [ + "application/json" + ], + "security": [ + { + "ApiKeyAuth": [] + } + ], + "securityDefinitions": { + "ApiKeyAuth": { + "type": "apiKey", + "name": "Ocp-Apim-Subscription-Key", + "in": "header" + } + }, + "tags": [], + "paths": { + "/:analyze-conversations": { + "post": { + "operationId": "AnalyzeConversations", + "description": "Analyzes the input conversation utterance.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "body", + "in": "body", + "description": "Collection of conversations to analyze and a single task to execute.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationTask" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationTaskResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/ErrorResponseWithHeader" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "The error code for specific error that occurred." + } + } + } + } + } + }, + "/analyze-conversations/jobs": { + "post": { + "operationId": "AnalyzeConversationsSubmitJob", + "description": "Analyzes the input conversation utterance.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationJobsInput" + } + } + ], + "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/ErrorResponse" + } + } + }, + "x-ms-long-running-operation": true + } + }, + "/analyze-conversations/jobs/{jobId}": { + "get": { + "operationId": "AnalyzeConversationsJobStatus", + "summary": "Get analysis status and results", + "description": "Get the status of an analysis job. A job can consist of one or more tasks. After all tasks succeed, the job transitions to the succeeded state and results are available for each task.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "jobId", + "in": "path", + "description": "job ID", + "required": true, + "type": "string", + "format": "uuid" + }, + { + "name": "showStats", + "in": "query", + "description": "(Optional) if set to true, response will contain request and document level statistics.", + "required": false, + "type": "boolean" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + } + }, + "/analyze-conversations/jobs/{jobId}:cancel": { + "post": { + "operationId": "AnalyzeConversationsCancelJob", + "summary": "Cancel a long-running Text Analysis conversations job", + "description": "Cancel a long-running job for text analysis of conversations.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "jobId", + "in": "path", + "description": "job ID", + "required": true, + "type": "string", + "format": "uuid" + } + ], + "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/ErrorResponse" + } + } + }, + "x-ms-long-running-operation": true + } + } + }, + "definitions": { + "AgeResolution": { + "type": "object", + "description": "Represents the Age entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/AgeUnit", + "description": "The Age Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "AgeResolution" + }, + "AgeUnit": { + "type": "string", + "description": "The Age Unit of measurement", + "enum": [ + "Unspecified", + "Year", + "Month", + "Week", + "Day" + ], + "x-ms-enum": { + "name": "AgeUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Year", + "value": "Year" + }, + { + "name": "Month", + "value": "Month" + }, + { + "name": "Week", + "value": "Week" + }, + { + "name": "Day", + "value": "Day" + } + ] + } + }, + "AnalysisParameters": { + "type": "object", + "description": "This is the parameter set of either the Orchestration project itself or one of the target services.", + "properties": { + "targetProjectKind": { + "$ref": "#/definitions/targetProjectKind", + "description": "The type of a target service" + }, + "apiVersion": { + "type": "string", + "description": "The API version to use when call a specific target service." + } + }, + "discriminator": "targetProjectKind", + "required": [ + "targetProjectKind" + ] + }, + "AnalyzeConversationConversationPiiResult": { + "type": "object", + "description": "Result from the personally identifiable information detection and redaction operation performed on a list of conversations.", + "properties": { + "results": { + "$ref": "#/definitions/ConversationPiiResults", + "description": "results" + } + }, + "required": [ + "results" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationJobResult" + } + ], + "x-ms-discriminator-value": "ConversationalPIIResults" + }, + "AnalyzeConversationJobResult": { + "type": "object", + "description": "Container for results of all tasks in the conversation job.", + "properties": { + "lastUpdateDateTime": { + "type": "string", + "format": "date-time", + "description": "The last updated time in UTC for the task." + }, + "status": { + "$ref": "#/definitions/State", + "description": "The status of the task at the mentioned last update time." + }, + "taskName": { + "type": "string", + "description": "task name" + }, + "kind": { + "$ref": "#/definitions/AnalyzeConversationResultsKind", + "description": "discriminator kind" + } + }, + "discriminator": "kind", + "required": [ + "lastUpdateDateTime", + "status", + "kind" + ] + }, + "AnalyzeConversationJobState": { + "type": "object", + "description": "Contains the status of the submitted job for analyzing a conversation, along with related statistics.", + "properties": { + "displayName": { + "type": "string", + "description": "display name" + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "Date and time job created" + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "Date and time job expires" + }, + "jobId": { + "$ref": "#/definitions/Azure.Core.uuid", + "description": "job ID", + "readOnly": true + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "last updated date and time" + }, + "status": { + "$ref": "#/definitions/State", + "description": "status" + }, + "errors": { + "type": "array", + "description": "errors", + "items": { + "$ref": "#/definitions/Error" + }, + "x-ms-identifiers": [] + }, + "nextLink": { + "type": "string", + "description": "next link" + }, + "tasks": { + "$ref": "#/definitions/Tasks", + "description": "Contains the state for the tasks that are being executed as part of the submitted job for analyzing a conversation." + }, + "statistics": { + "$ref": "#/definitions/ConversationRequestStatistics", + "description": "Contains the statistics for the submitted job." + } + }, + "required": [ + "createdDateTime", + "jobId", + "lastUpdatedDateTime", + "status", + "tasks" + ] + }, + "AnalyzeConversationJobsInput": { + "type": "object", + "description": "It is a wrap up a Question Answering KB response.", + "properties": { + "displayName": { + "type": "string", + "description": "Display name for the analysis job." + }, + "analysisInput": { + "$ref": "#/definitions/MultiLanguageConversationAnalysisInput", + "description": "Analysis Input", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "tasks": { + "type": "array", + "description": "Set of tasks to execute on the input conversation.", + "items": { + "$ref": "#/definitions/AnalyzeConversationLROTask" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "analysisInput", + "tasks" + ] + }, + "AnalyzeConversationLROTask": { + "type": "object", + "description": "Base class for a long-running conversation input task.", + "properties": { + "taskName": { + "type": "string", + "description": "task name" + }, + "kind": { + "$ref": "#/definitions/AnalyzeConversationLROTaskKind", + "description": "Enumeration of supported analysis tasks on a collection of conversations." + } + }, + "discriminator": "kind", + "required": [ + "kind" + ] + }, + "AnalyzeConversationLROTaskKind": { + "type": "string", + "description": "Enumeration of supported analysis tasks on a collection of conversations.", + "enum": [ + "ConversationalSummarizationTask", + "ConversationalPIITask", + "CustomConversationalSummarizationTask" + ], + "x-ms-enum": { + "name": "AnalyzeConversationLROTaskKind", + "modelAsString": true, + "values": [ + { + "name": "ConversationalSummarizationTask", + "value": "ConversationalSummarizationTask", + "description": "Conversational Summarization Task" + }, + { + "name": "ConversationalPIITask", + "value": "ConversationalPIITask", + "description": "Conversational PII Task" + }, + { + "name": "CustomConversationalSummarizationTask", + "value": "CustomConversationalSummarizationTask", + "description": "Custom Conversational Summarization Task" + } + ] + } + }, + "AnalyzeConversationPiiTask": { + "type": "object", + "description": "Task definition for a PII redaction in conversations.", + "properties": { + "parameters": { + "$ref": "#/definitions/ConversationPiiTaskParameters", + "description": "parameters" + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationLROTask" + } + ], + "x-ms-discriminator-value": "ConversationalPIITask" + }, + "AnalyzeConversationResult": { + "type": "object", + "description": "Represents a conversation analysis response.", + "properties": { + "query": { + "type": "string", + "description": "The conversation utterance given by the caller." + }, + "detectedLanguage": { + "type": "string", + "description": "The system detected language for the query in BCP 47 language representation.." + }, + "prediction": { + "$ref": "#/definitions/BasePrediction", + "description": "The prediction result of a conversation project." + } + }, + "required": [ + "query", + "prediction" + ] + }, + "AnalyzeConversationResultsKind": { + "type": "string", + "description": "Enumeration of results for supported conversation analysis Results.", + "enum": [ + "ConversationalSummarizationResults", + "ConversationalPIIResults", + "CustomConversationalSummarizationResults" + ], + "x-ms-enum": { + "name": "AnalyzeConversationResultsKind", + "modelAsString": true, + "values": [ + { + "name": "ConversationalSummarizationResults", + "value": "ConversationalSummarizationResults", + "description": "Conversational Summarization Results" + }, + { + "name": "ConversationalPIIResults", + "value": "ConversationalPIIResults", + "description": "Conversational PII Results" + }, + { + "name": "CustomConversationalSummarizationResults", + "value": "CustomConversationalSummarizationResults", + "description": "Custom Conversational Summarization Results" + } + ] + } + }, + "AnalyzeConversationSentimentResult": { + "type": "object", + "description": "Result from the sentiment analysis operation performed on a list of conversations.", + "properties": { + "results": { + "$ref": "#/definitions/ConversationSentimentResults", + "description": "The result from sentiment analysis operation for each conversation." + } + }, + "required": [ + "results" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationJobResult" + } + ] + }, + "AnalyzeConversationSummarizationResult": { + "type": "object", + "description": "Result for the summarization task on the conversation.", + "properties": { + "results": { + "$ref": "#/definitions/SummaryResult", + "description": "results" + } + }, + "required": [ + "results" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationJobResult" + } + ], + "x-ms-discriminator-value": "ConversationalSummarizationResults" + }, + "AnalyzeConversationSummarizationTask": { + "type": "object", + "description": "Task definition for conversational summarization.", + "properties": { + "parameters": { + "$ref": "#/definitions/ConversationSummarizationTaskParameters", + "description": "parameters" + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationLROTask" + } + ], + "x-ms-discriminator-value": "ConversationalSummarizationTask" + }, + "AnalyzeConversationTask": { + "type": "object", + "description": "The base class of a conversation input task.", + "properties": { + "kind": { + "$ref": "#/definitions/AnalyzeConversationTaskKind", + "description": "The base class of a conversation input task.", + "x-ms-mutability": [ + "read", + "create" + ] + } + }, + "discriminator": "kind", + "required": [ + "kind" + ] + }, + "AnalyzeConversationTaskKind": { + "type": "string", + "description": "Enumeration of supported Conversation tasks.", + "enum": [ + "Conversation" + ], + "x-ms-enum": { + "name": "AnalyzeConversationTaskKind", + "modelAsString": true, + "values": [ + { + "name": "Conversation", + "value": "Conversation" + } + ] + } + }, + "AnalyzeConversationTaskResult": { + "type": "object", + "description": "The base class of a conversation input task result.", + "properties": { + "kind": { + "$ref": "#/definitions/AnalyzeConversationTaskResultsKind", + "description": "The base class of a conversation input task result." + } + }, + "discriminator": "kind", + "required": [ + "kind" + ] + }, + "AnalyzeConversationTaskResultsKind": { + "type": "string", + "description": "Enumeration of supported conversational task results.", + "enum": [ + "ConversationResult" + ], + "x-ms-enum": { + "name": "AnalyzeConversationTaskResultsKind", + "modelAsString": true, + "values": [ + { + "name": "ConversationResult", + "value": "ConversationResult" + } + ] + } + }, + "AnalyzeCustomConversationSummarizationResult": { + "type": "object", + "description": "Result for the custom summarization task on the conversation.", + "properties": { + "results": { + "$ref": "#/definitions/CustomSummaryResult", + "description": "Custom Summary Result" + } + }, + "required": [ + "results" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationJobResult" + } + ], + "x-ms-discriminator-value": "CustomConversationalSummarizationResults" + }, + "AnalyzeCustomConversationSummarizationTask": { + "type": "object", + "description": "Task definition for custom conversational summarization.", + "properties": { + "parameters": { + "$ref": "#/definitions/CustomConversationSummarizationTaskParameters", + "description": "parameters" + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationLROTask" + } + ], + "x-ms-discriminator-value": "CustomConversationalSummarizationTask" + }, + "AnswerSpan": { + "type": "object", + "description": "Answer span object of QnA.", + "properties": { + "text": { + "type": "string", + "description": "Predicted text of answer span." + }, + "confidenceScore": { + "type": "number", + "format": "double", + "description": "Predicted score of answer span, value ranges from 0 to 1.", + "minimum": 0, + "maximum": 1 + }, + "offset": { + "type": "integer", + "format": "int32", + "description": "The answer span offset from the start of answer." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "The length of the answer span." + } + } + }, + "AnswersOptions": { + "type": "object", + "description": "Parameters to query a knowledge base.", + "properties": { + "qnaId": { + "type": "integer", + "format": "int32", + "description": "Exact QnA ID to fetch from the knowledge base, this field takes priority over question." + }, + "question": { + "type": "string", + "description": "User question to query against the knowledge base." + }, + "top": { + "type": "integer", + "format": "int32", + "description": "Max number of answers to be returned for the question." + }, + "userId": { + "type": "string", + "description": "Unique identifier for the user." + }, + "confidenceScoreThreshold": { + "type": "number", + "format": "double", + "description": "Minimum threshold score for answers, value ranges from 0 to 1.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidenceThreshold" + }, + "context": { + "$ref": "#/definitions/KnowledgeBaseAnswerContext", + "description": "Context object with previous QnA's information.", + "x-ms-client-name": "answerContext" + }, + "rankerType": { + "$ref": "#/definitions/RankerKind", + "description": "Type of ranker to be used.", + "x-ms-client-name": "rankerKind" + }, + "filters": { + "$ref": "#/definitions/QueryFilters", + "description": "Filter QnAs based on given metadata list and knowledge base sources." + }, + "answerSpanRequest": { + "$ref": "#/definitions/ShortAnswerOptions", + "description": "To configure Answer span prediction feature.", + "x-ms-client-name": "shortAnswerOptions" + }, + "includeUnstructuredSources": { + "type": "boolean", + "description": "(Optional) Flag to enable Query over Unstructured Sources." + } + } + }, + "AnswersResult": { + "type": "object", + "description": "Represents List of Question Answers.", + "properties": { + "answers": { + "type": "array", + "description": "Represents Answer Result list.", + "items": { + "$ref": "#/definitions/KnowledgeBaseAnswer" + } + } + } + }, + "AreaResolution": { + "type": "object", + "description": "Represents the area entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/AreaUnit", + "description": "The area Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "AreaResolution" + }, + "AreaUnit": { + "type": "string", + "description": "The area unit of measurement.", + "enum": [ + "Unspecified", + "SquareKilometer", + "SquareHectometer", + "SquareDecameter", + "SquareDecimeter", + "SquareMeter", + "SquareCentimeter", + "SquareMillimeter", + "SquareInch", + "SquareFoot", + "SquareMile", + "SquareYard", + "Acre" + ], + "x-ms-enum": { + "name": "AreaUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "SquareKilometer", + "value": "SquareKilometer" + }, + { + "name": "SquareHectometer", + "value": "SquareHectometer" + }, + { + "name": "SquareDecameter", + "value": "SquareDecameter" + }, + { + "name": "SquareDecimeter", + "value": "SquareDecimeter" + }, + { + "name": "SquareMeter", + "value": "SquareMeter" + }, + { + "name": "SquareCentimeter", + "value": "SquareCentimeter" + }, + { + "name": "SquareMillimeter", + "value": "SquareMillimeter" + }, + { + "name": "SquareInch", + "value": "SquareInch" + }, + { + "name": "SquareFoot", + "value": "SquareFoot" + }, + { + "name": "SquareMile", + "value": "SquareMile" + }, + { + "name": "SquareYard", + "value": "SquareYard" + }, + { + "name": "Acre", + "value": "Acre" + } + ] + } + }, + "AudioTiming": { + "type": "object", + "description": "Audio timing information.", + "properties": { + "offset": { + "type": "integer", + "format": "int64", + "description": "Offset from the start of speech audio, in ticks. 1 tick = 100 nanoseconds." + }, + "duration": { + "type": "integer", + "format": "int64", + "description": "Duration of word articulation, in ticks. 1 tick = 100 nanoseconds." + } + } + }, + "Azure.Core.uuid": { + "type": "string", + "format": "uuid", + "description": "Universally Unique Identifier" + }, + "BaseExtraInformation": { + "type": "object", + "description": "The abstract base object for entity extra information.", + "properties": { + "extraInformationKind": { + "$ref": "#/definitions/ExtraInformationKind", + "description": "The extra information object kind." + } + }, + "discriminator": "extraInformationKind", + "required": [ + "extraInformationKind" + ] + }, + "BasePrediction": { + "type": "object", + "description": "This is the base class of prediction", + "properties": { + "projectKind": { + "$ref": "#/definitions/projectKind", + "description": "The type of the project." + }, + "topIntent": { + "type": "string", + "description": "The intent with the highest score." + } + }, + "discriminator": "projectKind", + "required": [ + "projectKind" + ] + }, + "BaseResolution": { + "type": "object", + "description": "The abstract base class for entity resolutions.", + "properties": { + "resolutionKind": { + "$ref": "#/definitions/ResolutionKind", + "description": "The entity resolution object kind." + } + }, + "discriminator": "resolutionKind", + "required": [ + "resolutionKind" + ] + }, + "BooleanResolution": { + "type": "object", + "description": "A resolution for boolean expressions", + "properties": { + "value": { + "type": "boolean", + "description": "A resolution for boolean expressions" + } + }, + "required": [ + "value" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "BooleanResolution" + }, + "Conversation": { + "type": "object", + "description": "Complete ordered set of utterances (spoken or written) by one or more speakers to be used for analysis.", + "properties": { + "id": { + "type": "string", + "description": "Unique identifier for the conversation." + }, + "language": { + "type": "string", + "description": "Language of the conversation item in BCP-47 format." + }, + "modality": { + "$ref": "#/definitions/InputModality", + "description": "modality" + }, + "domain": { + "$ref": "#/definitions/ConversationDomain", + "description": "domain" + } + }, + "discriminator": "modality", + "required": [ + "id", + "language", + "modality" + ] + }, + "ConversationAnalysisOptions": { + "type": "object", + "description": "The input ConversationItem and its optional parameters", + "properties": { + "conversationItem": { + "$ref": "#/definitions/ConversationItemBase", + "description": "The abstract base for a user input formatted conversation (e.g., Text, Transcript)." + } + }, + "required": [ + "conversationItem" + ] + }, + "ConversationCallingOptions": { + "type": "object", + "description": "The option to set to call a Conversation project.", + "properties": { + "language": { + "type": "string", + "description": "The language of the query in BCP 47 language representation." + }, + "verbose": { + "type": "boolean", + "description": "If true, the service will return more detailed information." + }, + "isLoggingEnabled": { + "type": "boolean", + "description": "If true, the query will be saved for customers to further review in authoring, to improve the model quality." + } + } + }, + "ConversationDomain": { + "type": "string", + "description": "Enumeration of supported conversational domains.", + "enum": [ + "finance", + "healthcare", + "generic" + ], + "x-ms-enum": { + "name": "ConversationDomain", + "modelAsString": true, + "values": [ + { + "name": "finance", + "value": "finance", + "description": "Enumeration of supported conversational domains." + }, + { + "name": "healthcare", + "value": "healthcare", + "description": "Enumeration of supported conversational domains." + }, + { + "name": "generic", + "value": "generic", + "description": "Enumeration of supported conversational domains." + } + ] + } + }, + "ConversationEntity": { + "type": "object", + "description": "The entity extraction result of a Conversation project.", + "properties": { + "category": { + "type": "string", + "description": "The entity category." + }, + "text": { + "type": "string", + "description": "The predicted entity text." + }, + "offset": { + "type": "integer", + "format": "int32", + "description": "The starting index of this entity in the query." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "The length of the text." + }, + "confidenceScore": { + "type": "number", + "format": "float", + "description": "The entity confidence score.", + "x-ms-client-name": "confidence" + }, + "resolutions": { + "type": "array", + "description": "The collection of entity resolution objects.", + "items": { + "$ref": "#/definitions/BaseResolution" + }, + "x-ms-identifiers": [] + }, + "extraInformation": { + "type": "array", + "description": "The collection of entity extra information objects.", + "items": { + "$ref": "#/definitions/BaseExtraInformation" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "category", + "text", + "offset", + "length", + "confidenceScore" + ] + }, + "ConversationIntent": { + "type": "object", + "description": "The intent classification result of a Conversation project.", + "properties": { + "category": { + "type": "string", + "description": "A predicted class." + }, + "confidenceScore": { + "type": "number", + "format": "float", + "description": "The confidence score of the class from 0.0 to 1.0.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidence" + } + }, + "required": [ + "category", + "confidenceScore" + ] + }, + "ConversationItemBase": { + "type": "object", + "description": "The abstract base for a user input formatted conversation (e.g., Text, Transcript).", + "properties": { + "id": { + "type": "string", + "description": "The ID of a conversation item." + }, + "participantId": { + "type": "string", + "description": "The participant ID of a conversation item." + }, + "language": { + "type": "string", + "description": "The override language of a conversation item in BCP 47 language representation." + }, + "modality": { + "$ref": "#/definitions/InputModality", + "description": "Enumeration of supported conversational modalities." + }, + "role": { + "$ref": "#/definitions/role", + "description": "Role of the participant." + } + }, + "required": [ + "id", + "participantId" + ], + "additionalProperties": {} + }, + "ConversationItemLevelTiming": { + "type": "object", + "description": "Audio timing at the conversation item level.", + "properties": { + "offset": { + "type": "integer", + "format": "int64", + "description": "Offset from the start of speech audio, in ticks. 1 tick = 100 nanoseconds." + }, + "duration": { + "type": "integer", + "format": "int64", + "description": "Duration of word articulation, in ticks. 1 tick = 100 nanoseconds." + } + } + }, + "ConversationParameters": { + "type": "object", + "description": "This is a set of request parameters for Customized Conversation projects.", + "properties": { + "callingOptions": { + "$ref": "#/definitions/ConversationCallingOptions", + "description": "The option to set to call a Conversation project." + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalysisParameters" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "ConversationPiiCategories": { + "type": "string", + "description": "Describes the PII categories to return for detection. If not provided, 'default' categories will be returned which will vary with the language.", + "enum": [ + "Address", + "CreditCardNumber", + "Email", + "Person", + "NumericIdentifier", + "PhoneNumber", + "USSocialSecurityNumber", + "Miscellaneous", + "All", + "Default" + ], + "x-ms-enum": { + "name": "ConversationPiiCategories", + "modelAsString": true, + "values": [ + { + "name": "Address", + "value": "Address" + }, + { + "name": "CreditCardNumber", + "value": "CreditCardNumber" + }, + { + "name": "Email", + "value": "Email" + }, + { + "name": "Person", + "value": "Person" + }, + { + "name": "NumericIdentifier", + "value": "NumericIdentifier" + }, + { + "name": "PhoneNumber", + "value": "PhoneNumber" + }, + { + "name": "USSocialSecurityNumber", + "value": "USSocialSecurityNumber" + }, + { + "name": "Miscellaneous", + "value": "Miscellaneous" + }, + { + "name": "All", + "value": "All" + }, + { + "name": "Default", + "value": "Default" + } + ] + } + }, + "ConversationPiiCategoriesExclude": { + "type": "string", + "description": "Describes the PII categories to exclude for detection. If not provided, 'default' categories will be returned which will vary with the language.", + "enum": [ + "Address", + "CreditCardNumber", + "Email", + "Person", + "NumericIdentifier", + "PhoneNumber", + "USSocialSecurityNumber" + ], + "x-ms-enum": { + "name": "ConversationPiiCategoriesExclude", + "modelAsString": true, + "values": [ + { + "name": "Address", + "value": "Address" + }, + { + "name": "CreditCardNumber", + "value": "CreditCardNumber" + }, + { + "name": "Email", + "value": "Email" + }, + { + "name": "Person", + "value": "Person" + }, + { + "name": "NumericIdentifier", + "value": "NumericIdentifier" + }, + { + "name": "PhoneNumber", + "value": "PhoneNumber" + }, + { + "name": "USSocialSecurityNumber", + "value": "USSocialSecurityNumber" + } + ] + } + }, + "ConversationPiiItemResult": { + "type": "object", + "description": "The result from PII detection and redaction operation for each conversation.", + "properties": { + "id": { + "type": "string", + "description": "Id of the result" + }, + "redactedContent": { + "$ref": "#/definitions/RedactedTranscriptContent", + "description": "Transcript content response that the service generates, with all necessary personally identifiable information redacted." + }, + "entities": { + "type": "array", + "description": "Array of Entities", + "items": { + "$ref": "#/definitions/Entity" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "id", + "redactedContent", + "entities" + ] + }, + "ConversationPiiResults": { + "type": "object", + "description": "The result from PII detection and redaction operation for each conversation.", + "properties": { + "errors": { + "type": "array", + "description": "Errors by document id.", + "items": { + "$ref": "#/definitions/DocumentError" + } + }, + "statistics": { + "$ref": "#/definitions/RequestStatistics", + "description": "statistics" + }, + "modelVersion": { + "type": "string", + "description": "This field indicates which model is used for scoring." + }, + "conversations": { + "type": "array", + "description": "array of conversations", + "items": { + "$ref": "#/definitions/ConversationalPiiResultWithResultBase" + } + } + }, + "required": [ + "errors", + "modelVersion", + "conversations" + ] + }, + "ConversationPiiTaskParameters": { + "type": "object", + "description": "Supported parameters for a conversational pii task.", + "properties": { + "loggingOptOut": { + "type": "boolean", + "description": "logging opt out", + "default": false + }, + "modelVersion": { + "type": "string", + "description": "model version", + "default": "latest" + }, + "piiCategories": { + "type": "array", + "description": "Array of ConversationPIICategories", + "items": { + "$ref": "#/definitions/ConversationPiiCategories" + } + }, + "redactAudioTiming": { + "type": "boolean", + "description": "Flag to indicate if response should include audio stream offset and duration for any detected entities to be redacted. By default, audio timing of redacted entities are not included." + }, + "redactionSource": { + "$ref": "#/definitions/TranscriptContentType", + "description": "For transcript conversations, this parameter provides information regarding which content type (ITN, Text, Lexical, Masked ITN) should be used for entity detection. The details of the entities detected - like the offset, length and the text itself - will correspond to the text type selected here." + }, + "redactionCharacter": { + "type": "string", + "description": "Optional parameter to use a Custom Character to be used for redaction in PII responses. Default character will be * as before. We allow specific ascii characters for redaction.", + "default": "*", + "enum": [ + "!", + "#", + "$", + "%", + "&", + "*", + "+", + "-", + "=", + "?", + "@", + "^", + "_", + "~" + ], + "x-ms-enum": { + "name": "redactionCharacter", + "modelAsString": true, + "values": [ + { + "name": "exclamationPoint", + "value": "!" + }, + { + "name": "numberSign", + "value": "#" + }, + { + "name": "dollar", + "value": "$" + }, + { + "name": "percent", + "value": "%" + }, + { + "name": "ampersand", + "value": "&" + }, + { + "name": "asterisk", + "value": "*" + }, + { + "name": "plus", + "value": "+" + }, + { + "name": "minus", + "value": "-" + }, + { + "name": "equals", + "value": "=" + }, + { + "name": "questionMark", + "value": "?" + }, + { + "name": "atSign", + "value": "@" + }, + { + "name": "caret", + "value": "^" + }, + { + "name": "underscore", + "value": "_" + }, + { + "name": "tilde", + "value": "~" + } + ] + } + }, + "excludePiiCategories": { + "type": "array", + "description": "List of categories that need to be excluded instead of included.", + "items": { + "$ref": "#/definitions/ConversationPiiCategoriesExclude" + } + } + } + }, + "ConversationPrediction": { + "type": "object", + "description": "Represents the prediction section of a Conversation project.", + "properties": { + "intents": { + "type": "array", + "description": "The intent classification results.", + "items": { + "$ref": "#/definitions/ConversationIntent" + }, + "x-ms-identifiers": [] + }, + "entities": { + "type": "array", + "description": "The entity extraction results.", + "items": { + "$ref": "#/definitions/ConversationEntity" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "intents", + "entities" + ], + "allOf": [ + { + "$ref": "#/definitions/BasePrediction" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "ConversationRequestStatistics": { + "type": "object", + "description": "if showStats=true was specified in the request, this field contains information about the request payload.", + "properties": { + "documentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of documents submitted in the request." + }, + "validDocumentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of valid documents. This excludes empty, over-size limit or non-supported languages documents." + }, + "erroneousDocumentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of invalid documents. This includes empty, over-size limit or non-supported languages documents." + }, + "transactionsCount": { + "type": "integer", + "format": "int64", + "description": "Number of transactions for the request." + }, + "conversationsCount": { + "type": "integer", + "format": "int32", + "description": "Number of conversations submitted in the request." + }, + "validConversationsCount": { + "type": "integer", + "format": "int32", + "description": "Number of conversation documents. This excludes documents that are empty, over the size limit, or in unsupported languages." + }, + "erroneousConversationsCount": { + "type": "integer", + "format": "int32", + "description": "Number of invalid documents. This includes documents that are empty, over the size limit, or in unsupported languages." + } + }, + "required": [ + "documentsCount", + "validDocumentsCount", + "erroneousDocumentsCount", + "transactionsCount", + "conversationsCount", + "validConversationsCount", + "erroneousConversationsCount" + ] + }, + "ConversationResult": { + "type": "object", + "description": "The response returned by a Conversation project.", + "properties": { + "query": { + "type": "string", + "description": "The same query given in request." + }, + "detectedLanguage": { + "type": "string", + "description": "The detected language from the query in BCP 47 language representation." + }, + "prediction": { + "$ref": "#/definitions/ConversationPrediction", + "description": "The predicted result for the query." + } + }, + "required": [ + "query" + ] + }, + "ConversationSentimentItemResult": { + "type": "object", + "description": "Sentiment operation results for a conversation items", + "properties": { + "id": { + "type": "string", + "description": "The identifier for the conversation item" + }, + "participantId": { + "type": "string", + "description": "The identifier for the speaker" + }, + "sentiment": { + "$ref": "#/definitions/TextSentiment", + "description": "Predicted sentiment" + }, + "confidenceScores": { + "$ref": "#/definitions/SentimentConfidenceScores", + "description": "Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative." + } + }, + "required": [ + "id", + "participantId", + "sentiment", + "confidenceScores" + ] + }, + "ConversationSentimentResults": { + "type": "object", + "description": "The result from sentiment analysis operation for each conversation.", + "properties": { + "errors": { + "type": "array", + "description": "Errors by document id.", + "items": { + "$ref": "#/definitions/DocumentError" + } + }, + "statistics": { + "$ref": "#/definitions/RequestStatistics", + "description": "statistics" + }, + "modelVersion": { + "type": "string", + "description": "This field indicates which model is used for scoring." + }, + "conversations": { + "type": "array", + "description": "Array of ConversationSentimentResults", + "items": { + "$ref": "#/definitions/ConversationSentimentResultsConversation" + } + } + }, + "required": [ + "errors", + "modelVersion", + "conversations" + ] + }, + "ConversationSentimentResultsConversation": { + "type": "object", + "description": "The result from sentiment analysis operation for each conversation.", + "properties": { + "id": { + "type": "string", + "description": "Unique, non-empty conversation identifier." + }, + "warnings": { + "type": "array", + "description": "Warnings encountered in processing the document.", + "items": { + "$ref": "#/definitions/InputWarning" + }, + "x-ms-identifiers": [] + }, + "statistics": { + "$ref": "#/definitions/ConversationStatistics", + "description": "If showStats=true was specified in the request this field will contain information about the conversation payload." + }, + "conversationItems": { + "type": "array", + "description": "Enumeration of Sentiment operation results for all the conversation items in a conversation.", + "items": { + "$ref": "#/definitions/ConversationSentimentItemResult" + } + } + }, + "required": [ + "id", + "warnings", + "conversationItems" + ] + }, + "ConversationStatistics": { + "type": "object", + "description": "If showStats=true was specified in the request, this field contains information about the conversation payload.", + "properties": { + "transactionsCount": { + "type": "integer", + "format": "int32", + "description": "Number of text units for the request." + } + }, + "required": [ + "transactionsCount" + ] + }, + "ConversationSummarizationTaskParameters": { + "type": "object", + "description": "Supported parameters for pre-build conversational summarization task.", + "properties": { + "loggingOptOut": { + "type": "boolean", + "description": "logging opt out", + "default": false + }, + "modelVersion": { + "type": "string", + "description": "model version", + "default": "latest" + }, + "sentenceCount": { + "type": "integer", + "format": "int32", + "description": "It controls the approximate number of sentences in the output summaries." + }, + "stringIndexType": { + "type": "string", + "description": "String index type", + "default": "TextElements_v8", + "enum": [ + "TextElements_v8", + "UnicodeCodePoint", + "Utf16CodeUnit" + ], + "x-ms-enum": { + "name": "StringIndexType", + "modelAsString": true, + "values": [ + { + "name": "TextElements_v8", + "value": "TextElements_v8", + "description": "Returned offset and length values will correspond to TextElements (Graphemes and Grapheme clusters) confirming to the Unicode 8.0.0 standard. Use this option if your application is written in .Net Framework or .Net Core and you will be using StringInfo." + }, + { + "name": "UnicodeCodePoint", + "value": "UnicodeCodePoint", + "description": "Returned offset and length values will correspond to Unicode code points. Use this option if your application is written in a language that support Unicode, for example Python." + }, + { + "name": "Utf16CodeUnit", + "value": "Utf16CodeUnit", + "description": "Returned 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." + } + ] + } + }, + "summaryLength": { + "$ref": "#/definitions/SummaryLengthBucket", + "description": "(NOTE: Recommended to use summaryLength over sentenceCount) Controls the approximate length of the output summaries." + }, + "summaryAspects": { + "type": "array", + "description": "Array of Summary Aspects", + "items": { + "$ref": "#/definitions/SummaryAspect" + } + } + }, + "required": [ + "summaryAspects" + ] + }, + "ConversationTargetIntentResult": { + "type": "object", + "description": "A wrap up of Conversation project response.", + "properties": { + "result": { + "$ref": "#/definitions/ConversationResult", + "description": "The actual response from a Conversation project." + } + }, + "allOf": [ + { + "$ref": "#/definitions/TargetIntentResult" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "ConversationTaskParameters": { + "type": "object", + "description": "Input parameters necessary for a Conversation task.", + "properties": { + "projectName": { + "type": "string", + "description": "The name of the project to use." + }, + "deploymentName": { + "type": "string", + "description": "The name of the deployment to use." + }, + "verbose": { + "type": "boolean", + "description": "If true, the service will return more detailed information in the response." + }, + "isLoggingEnabled": { + "type": "boolean", + "description": "If true, the service will keep the query for further review." + }, + "stringIndexType": { + "type": "string", + "description": "Specifies the method used to interpret string offsets. Defaults to Text Elements (Graphemes) according to Unicode v8.0.0. For additional information see https://aka.ms/text-analytics-offsets.", + "default": "TextElements_v8", + "enum": [ + "TextElements_v8", + "UnicodeCodePoint", + "Utf16CodeUnit" + ], + "x-ms-enum": { + "name": "StringIndexType", + "modelAsString": true, + "values": [ + { + "name": "TextElements_v8", + "value": "TextElements_v8", + "description": "Returned offset and length values will correspond to TextElements (Graphemes and Grapheme clusters) confirming to the Unicode 8.0.0 standard. Use this option if your application is written in .Net Framework or .Net Core and you will be using StringInfo." + }, + { + "name": "UnicodeCodePoint", + "value": "UnicodeCodePoint", + "description": "Returned offset and length values will correspond to Unicode code points. Use this option if your application is written in a language that support Unicode, for example Python." + }, + { + "name": "Utf16CodeUnit", + "value": "Utf16CodeUnit", + "description": "Returned 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." + } + ] + } + }, + "directTarget": { + "type": "string", + "description": "The name of a target project to forward the request to." + }, + "targetProjectParameters": { + "type": "object", + "description": "A dictionary representing the parameters for each target project.", + "additionalProperties": { + "$ref": "#/definitions/AnalysisParameters" + } + } + }, + "required": [ + "projectName", + "deploymentName" + ] + }, + "ConversationalPiiResultWithResultBase": { + "type": "object", + "description": "Conversation PII result item", + "properties": { + "id": { + "type": "string", + "description": "Unique, non-empty conversation identifier." + }, + "warnings": { + "type": "array", + "description": "Warnings encountered in processing the document.", + "items": { + "$ref": "#/definitions/InputWarning" + }, + "x-ms-identifiers": [] + }, + "statistics": { + "$ref": "#/definitions/ConversationStatistics", + "description": "If showStats=true was specified in the request this field will contain information about the conversation payload." + }, + "conversationItems": { + "type": "array", + "description": "List of conversationItems", + "items": { + "$ref": "#/definitions/ConversationPiiItemResult" + } + } + }, + "required": [ + "id", + "warnings", + "conversationItems" + ] + }, + "ConversationalTask": { + "type": "object", + "description": "The input for a custom conversation task.", + "properties": { + "analysisInput": { + "$ref": "#/definitions/ConversationAnalysisOptions", + "description": "The input ConversationItem and its optional parameters" + }, + "parameters": { + "$ref": "#/definitions/ConversationTaskParameters", + "description": "Input parameters necessary for a Conversation task." + } + }, + "required": [ + "analysisInput", + "parameters" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationTask" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "ConversationalTaskResult": { + "type": "object", + "description": "The results of a Conversation task.", + "properties": { + "result": { + "$ref": "#/definitions/AnalyzeConversationResult", + "description": "Represents a conversation analysis response." + } + }, + "required": [ + "result" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationTaskResult" + } + ], + "x-ms-discriminator-value": "ConversationResult" + }, + "ConversationsSummaryResult": { + "type": "object", + "description": "Conversations Summary Result", + "properties": { + "id": { + "type": "string", + "description": "Unique, non-empty conversation identifier." + }, + "warnings": { + "type": "array", + "description": "Warnings encountered in processing the document.", + "items": { + "$ref": "#/definitions/InputWarning" + }, + "x-ms-identifiers": [] + }, + "statistics": { + "$ref": "#/definitions/ConversationStatistics", + "description": "If showStats=true was specified in the request this field will contain information about the conversation payload." + }, + "summaries": { + "type": "array", + "description": "array of summaries", + "items": { + "$ref": "#/definitions/SummaryResultItem" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "id", + "warnings", + "summaries" + ] + }, + "CurrencyResolution": { + "type": "object", + "description": "Represents the currency entity resolution model.", + "properties": { + "ISO4217": { + "type": "string", + "description": "The alphabetic code based on another ISO standard, ISO 3166, which lists the codes for country names. The first two letters of the ISO 4217 three-letter code are the same as the code for the country name, and, where possible, the third letter corresponds to the first letter of the currency name.", + "x-ms-client-name": "iso4217" + }, + "value": { + "type": "number", + "format": "double", + "description": "The money amount captured in the extracted entity" + }, + "unit": { + "type": "string", + "description": "The unit of the amount captured in the extracted entity" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "CurrencyResolution" + }, + "CustomConversationSummarizationTaskParameters": { + "type": "object", + "description": "Supported parameters for a custom conversation summarization task.", + "properties": { + "loggingOptOut": { + "type": "boolean", + "description": "logging opt out", + "default": false + }, + "projectName": { + "type": "string", + "description": "This field indicates the project name for the model." + }, + "deploymentName": { + "type": "string", + "description": "This field indicates the deployment name for the model." + }, + "sentenceCount": { + "type": "integer", + "format": "int32", + "description": "It controls the approximate number of sentences in the output summaries." + }, + "stringIndexType": { + "type": "string", + "description": "String index type", + "default": "TextElements_v8", + "enum": [ + "TextElements_v8", + "UnicodeCodePoint", + "Utf16CodeUnit" + ], + "x-ms-enum": { + "name": "StringIndexType", + "modelAsString": true, + "values": [ + { + "name": "TextElements_v8", + "value": "TextElements_v8", + "description": "Returned offset and length values will correspond to TextElements (Graphemes and Grapheme clusters) confirming to the Unicode 8.0.0 standard. Use this option if your application is written in .Net Framework or .Net Core and you will be using StringInfo." + }, + { + "name": "UnicodeCodePoint", + "value": "UnicodeCodePoint", + "description": "Returned offset and length values will correspond to Unicode code points. Use this option if your application is written in a language that support Unicode, for example Python." + }, + { + "name": "Utf16CodeUnit", + "value": "Utf16CodeUnit", + "description": "Returned 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." + } + ] + } + }, + "summaryLength": { + "$ref": "#/definitions/SummaryLengthBucket", + "description": "(NOTE: Recommended to use summaryLength over sentenceCount) Controls the approximate length of the output summaries." + }, + "summaryAspects": { + "type": "array", + "description": "Array of Summary Aspects", + "items": { + "$ref": "#/definitions/SummaryAspect" + } + } + }, + "required": [ + "projectName", + "deploymentName", + "summaryAspects" + ] + }, + "CustomSummaryResult": { + "type": "object", + "description": "Custom Summary Results", + "properties": { + "conversations": { + "type": "array", + "description": "array of conversations", + "items": { + "$ref": "#/definitions/ConversationsSummaryResult" + } + }, + "errors": { + "type": "array", + "description": "Errors by document id.", + "items": { + "$ref": "#/definitions/DocumentError" + } + }, + "statistics": { + "$ref": "#/definitions/RequestStatistics", + "description": "if showStats=true was specified in the request this field will contain information about the request payload." + }, + "projectName": { + "type": "string", + "description": "This field indicates the project name for the model." + }, + "deploymentName": { + "type": "string", + "description": "This field indicates the deployment name for the model." + } + }, + "required": [ + "conversations", + "errors", + "projectName", + "deploymentName" + ] + }, + "DateTimeResolution": { + "type": "object", + "description": "A resolution for datetime entity instances.", + "properties": { + "timex": { + "type": "string", + "description": "An extended ISO 8601 date/time representation as described in (https://github.com/Microsoft/Recognizers-Text/blob/master/Patterns/English/English-DateTime.yaml)" + }, + "dateTimeSubKind": { + "$ref": "#/definitions/DateTimeSubKind", + "description": "The DateTime SubKind" + }, + "value": { + "type": "string", + "description": "The actual time that the extracted text denote." + }, + "modifier": { + "$ref": "#/definitions/TemporalModifier", + "description": "An optional modifier of a date/time instance." + } + }, + "required": [ + "timex", + "dateTimeSubKind", + "value" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "DateTimeResolution" + }, + "DateTimeSubKind": { + "type": "string", + "description": "The Datetime SubKind.", + "enum": [ + "Time", + "Date", + "DateTime", + "Duration", + "Set" + ], + "x-ms-enum": { + "name": "DateTimeSubKind", + "modelAsString": true, + "values": [ + { + "name": "Time", + "value": "Time" + }, + { + "name": "Date", + "value": "Date" + }, + { + "name": "DateTime", + "value": "DateTime" + }, + { + "name": "Duration", + "value": "Duration" + }, + { + "name": "Set", + "value": "Set" + } + ] + } + }, + "DocumentError": { + "type": "object", + "description": "Contains details of errors encountered during a job execution.", + "properties": { + "id": { + "type": "string", + "description": "The ID of the input document." + }, + "error": { + "$ref": "#/definitions/Error", + "description": "Error encountered." + } + }, + "required": [ + "id", + "error" + ] + }, + "Entity": { + "type": "object", + "description": "Text that has been categorized into pre-defined classes or types such as: person, location, event, product, and organization.", + "properties": { + "text": { + "type": "string", + "description": "Entity text as appears in the request." + }, + "category": { + "type": "string", + "description": "Entity type." + }, + "subcategory": { + "type": "string", + "description": "(Optional) Entity sub type." + }, + "offset": { + "type": "integer", + "format": "int32", + "description": "Start position for the entity text. Use of different 'stringIndexType' values can affect the offset returned." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "Length for the entity text. Use of different 'stringIndexType' values can affect the length returned." + }, + "confidenceScore": { + "type": "number", + "format": "double", + "description": "Confidence score between 0 and 1 of the extracted entity." + } + }, + "required": [ + "text", + "category", + "offset", + "length", + "confidenceScore" + ] + }, + "EntitySubtype": { + "type": "object", + "description": "The concrete entity Subtype model of extra information.", + "properties": { + "value": { + "type": "string", + "description": "The Subtype of an extracted entity type." + }, + "tags": { + "type": "array", + "description": "List of entity tags. Tags express similarities between entity categories for the extracted entity type.", + "items": { + "$ref": "#/definitions/EntityTag" + }, + "x-ms-identifiers": [] + } + }, + "allOf": [ + { + "$ref": "#/definitions/BaseExtraInformation" + } + ], + "x-ms-discriminator-value": "EntitySubtype" + }, + "EntityTag": { + "type": "object", + "description": "Tags express similarities between entity categories for the extracted entity type.", + "properties": { + "name": { + "type": "string", + "description": "The name of the tag." + }, + "confidenceScore": { + "type": "number", + "format": "double", + "description": "The confidence score of the tag for the extracted entity between 0.0 and 1.0." + } + }, + "required": [ + "name" + ] + }, + "Error": { + "type": "object", + "description": "The error object.", + "properties": { + "code": { + "$ref": "#/definitions/ErrorCode", + "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/Error" + }, + "x-ms-identifiers": [] + }, + "innererror": { + "$ref": "#/definitions/InnerErrorModel", + "description": "An object containing more specific information than the current object about the error." + } + }, + "required": [ + "code", + "message" + ] + }, + "ErrorCode": { + "type": "string", + "description": "Human-readable error code.", + "enum": [ + "InvalidRequest", + "InvalidArgument", + "Unauthorized", + "Forbidden", + "NotFound", + "ProjectNotFound", + "OperationNotFound", + "AzureCognitiveSearchNotFound", + "AzureCognitiveSearchIndexNotFound", + "TooManyRequests", + "AzureCognitiveSearchThrottling", + "AzureCognitiveSearchIndexLimitReached", + "InternalServerError", + "ServiceUnavailable", + "Timeout", + "QuotaExceeded", + "Conflict", + "Warning" + ], + "x-ms-enum": { + "name": "ErrorCode", + "modelAsString": true, + "values": [ + { + "name": "InvalidRequest", + "value": "InvalidRequest" + }, + { + "name": "InvalidArgument", + "value": "InvalidArgument" + }, + { + "name": "Unauthorized", + "value": "Unauthorized" + }, + { + "name": "Forbidden", + "value": "Forbidden" + }, + { + "name": "NotFound", + "value": "NotFound" + }, + { + "name": "ProjectNotFound", + "value": "ProjectNotFound" + }, + { + "name": "OperationNotFound", + "value": "OperationNotFound" + }, + { + "name": "AzureCognitiveSearchNotFound", + "value": "AzureCognitiveSearchNotFound" + }, + { + "name": "AzureCognitiveSearchIndexNotFound", + "value": "AzureCognitiveSearchIndexNotFound" + }, + { + "name": "TooManyRequests", + "value": "TooManyRequests" + }, + { + "name": "AzureCognitiveSearchThrottling", + "value": "AzureCognitiveSearchThrottling" + }, + { + "name": "AzureCognitiveSearchIndexLimitReached", + "value": "AzureCognitiveSearchIndexLimitReached" + }, + { + "name": "InternalServerError", + "value": "InternalServerError" + }, + { + "name": "ServiceUnavailable", + "value": "ServiceUnavailable" + }, + { + "name": "Timeout", + "value": "Timeout" + }, + { + "name": "QuotaExceeded", + "value": "QuotaExceeded" + }, + { + "name": "Conflict", + "value": "Conflict" + }, + { + "name": "Warning", + "value": "Warning" + } + ] + } + }, + "ErrorResponse": { + "type": "object", + "description": "Error response.", + "properties": { + "error": { + "$ref": "#/definitions/Error", + "description": "The error object." + } + }, + "required": [ + "error" + ] + }, + "ErrorResponseWithHeader": { + "type": "object", + "description": "Error response.", + "properties": { + "error": { + "$ref": "#/definitions/Error", + "description": "The error object." + } + }, + "required": [ + "error" + ] + }, + "ExtraInformationKind": { + "type": "string", + "description": "The extra information object kind.", + "enum": [ + "EntitySubtype", + "ListKey", + "RegexKey" + ], + "x-ms-enum": { + "name": "ExtraInformationKind", + "modelAsString": true, + "values": [ + { + "name": "EntitySubtype", + "value": "EntitySubtype" + }, + { + "name": "ListKey", + "value": "ListKey" + }, + { + "name": "RegexKey", + "value": "RegexKey" + } + ] + } + }, + "InformationResolution": { + "type": "object", + "description": "Represents the information (data) entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/InformationUnit", + "description": "The information (data) Unit of measurement." + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "InformationResolution" + }, + "InformationUnit": { + "type": "string", + "description": "The information (data) Unit of measurement.", + "enum": [ + "Unspecified", + "Bit", + "Kilobit", + "Megabit", + "Gigabit", + "Terabit", + "Petabit", + "Byte", + "Kilobyte", + "Megabyte", + "Gigabyte", + "Terabyte", + "Petabyte" + ], + "x-ms-enum": { + "name": "InformationUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Bit", + "value": "Bit" + }, + { + "name": "Kilobit", + "value": "Kilobit" + }, + { + "name": "Megabit", + "value": "Megabit" + }, + { + "name": "Gigabit", + "value": "Gigabit" + }, + { + "name": "Terabit", + "value": "Terabit" + }, + { + "name": "Petabit", + "value": "Petabit" + }, + { + "name": "Byte", + "value": "Byte" + }, + { + "name": "Kilobyte", + "value": "Kilobyte" + }, + { + "name": "Megabyte", + "value": "Megabyte" + }, + { + "name": "Gigabyte", + "value": "Gigabyte" + }, + { + "name": "Terabyte", + "value": "Terabyte" + }, + { + "name": "Petabyte", + "value": "Petabyte" + } + ] + } + }, + "InnerErrorCode": { + "type": "string", + "description": "Human-readable error code.", + "enum": [ + "InvalidRequest", + "InvalidParameterValue", + "KnowledgeBaseNotFound", + "AzureCognitiveSearchNotFound", + "AzureCognitiveSearchThrottling", + "ExtractionFailure", + "InvalidRequestBodyFormat", + "EmptyRequest", + "MissingInputDocuments", + "InvalidDocument", + "ModelVersionIncorrect", + "InvalidDocumentBatch", + "UnsupportedLanguageCode", + "InvalidCountryHint" + ], + "x-ms-enum": { + "name": "InnerErrorCode", + "modelAsString": true, + "values": [ + { + "name": "InvalidRequest", + "value": "InvalidRequest" + }, + { + "name": "InvalidParameterValue", + "value": "InvalidParameterValue" + }, + { + "name": "KnowledgeBaseNotFound", + "value": "KnowledgeBaseNotFound" + }, + { + "name": "AzureCognitiveSearchNotFound", + "value": "AzureCognitiveSearchNotFound" + }, + { + "name": "AzureCognitiveSearchThrottling", + "value": "AzureCognitiveSearchThrottling" + }, + { + "name": "ExtractionFailure", + "value": "ExtractionFailure" + }, + { + "name": "InvalidRequestBodyFormat", + "value": "InvalidRequestBodyFormat" + }, + { + "name": "EmptyRequest", + "value": "EmptyRequest" + }, + { + "name": "MissingInputDocuments", + "value": "MissingInputDocuments" + }, + { + "name": "InvalidDocument", + "value": "InvalidDocument" + }, + { + "name": "ModelVersionIncorrect", + "value": "ModelVersionIncorrect" + }, + { + "name": "InvalidDocumentBatch", + "value": "InvalidDocumentBatch" + }, + { + "name": "UnsupportedLanguageCode", + "value": "UnsupportedLanguageCode" + }, + { + "name": "InvalidCountryHint", + "value": "InvalidCountryHint" + } + ] + } + }, + "InnerErrorModel": { + "type": "object", + "description": "An object containing more specific information about the error. As per Microsoft One API guidelines - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.", + "properties": { + "code": { + "$ref": "#/definitions/InnerErrorCode", + "description": "One of a server-defined set of error codes." + }, + "message": { + "type": "string", + "description": "Error message." + }, + "details": { + "type": "object", + "description": "Error details.", + "additionalProperties": { + "type": "string" + } + }, + "target": { + "type": "string", + "description": "Error target." + }, + "innererror": { + "$ref": "#/definitions/InnerErrorModel", + "description": "An object containing more specific information than the current object about the error." + } + }, + "required": [ + "code", + "message" + ] + }, + "InputModality": { + "type": "string", + "description": "Enumeration of supported conversational modalities.", + "enum": [ + "transcript", + "text" + ], + "x-ms-enum": { + "name": "InputModality", + "modelAsString": true, + "values": [ + { + "name": "transcript", + "value": "transcript" + }, + { + "name": "text", + "value": "text" + } + ] + } + }, + "InputWarning": { + "type": "object", + "description": "Contains details of warnings encountered during a job execution.", + "properties": { + "code": { + "type": "string", + "description": "Warning code." + }, + "message": { + "type": "string", + "description": "Warning message." + }, + "targetRef": { + "type": "string", + "description": "A JSON pointer reference indicating the target object." + } + }, + "required": [ + "code", + "message" + ] + }, + "ItemizedSummaryContext": { + "type": "object", + "description": "Context of the summary with a conversation item ID.", + "properties": { + "offset": { + "type": "integer", + "format": "int32", + "description": "Start position for the context. Use of different 'stringIndexType' values can affect the offset returned." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "The length of the context. Use of different 'stringIndexType' values can affect the length returned." + }, + "conversationItemId": { + "type": "string", + "description": "Reference to the ID of ConversationItem." + } + }, + "required": [ + "offset", + "length", + "conversationItemId" + ] + }, + "KnowledgeBaseAnswer": { + "type": "object", + "description": "Represents knowledge base answer.", + "properties": { + "questions": { + "type": "array", + "description": "List of questions associated with the answer.", + "items": { + "type": "string" + } + }, + "answer": { + "type": "string", + "description": "Answer text." + }, + "confidenceScore": { + "type": "number", + "format": "double", + "description": "Answer confidence score, value ranges from 0 to 1.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidence" + }, + "id": { + "type": "integer", + "format": "int32", + "description": "ID of the QnA result.", + "x-ms-client-name": "qnaId" + }, + "source": { + "type": "string", + "description": "Source of QnA result." + }, + "metadata": { + "type": "object", + "description": "Metadata associated with the answer, useful to categorize or filter question answers.", + "additionalProperties": { + "type": "string" + } + }, + "dialog": { + "$ref": "#/definitions/KnowledgeBaseAnswerDialog", + "description": "Dialog associated with Answer." + }, + "answerSpan": { + "$ref": "#/definitions/AnswerSpan", + "description": "Answer span object of QnA with respect to user's question.", + "x-ms-client-name": "shortAnswer" + } + } + }, + "KnowledgeBaseAnswerContext": { + "type": "object", + "description": "Context object with previous QnA's information.", + "properties": { + "previousQnaId": { + "type": "integer", + "format": "int32", + "description": "Previous turn top answer result QnA ID." + }, + "previousUserQuery": { + "type": "string", + "description": "Previous user query.", + "x-ms-client-name": "previousQuestion" + } + }, + "required": [ + "previousQnaId" + ] + }, + "KnowledgeBaseAnswerDialog": { + "type": "object", + "description": "Dialog associated with Answer.", + "properties": { + "isContextOnly": { + "type": "boolean", + "description": "To mark if a prompt is relevant only with a previous question or not. If true, do not include this QnA as search result for queries without context; otherwise, if false, ignores context and includes this QnA in search result." + }, + "prompts": { + "type": "array", + "description": "List of prompts associated with the answer.", + "maxItems": 20, + "items": { + "$ref": "#/definitions/KnowledgeBaseAnswerPrompt" + }, + "x-ms-identifiers": [] + } + } + }, + "KnowledgeBaseAnswerPrompt": { + "type": "object", + "description": "Prompt for an answer.", + "properties": { + "displayOrder": { + "type": "integer", + "format": "int32", + "description": "Index of the prompt - used in ordering of the prompts." + }, + "qnaId": { + "type": "integer", + "format": "int32", + "description": "QnA ID corresponding to the prompt." + }, + "displayText": { + "type": "string", + "description": "Text displayed to represent a follow up question prompt.", + "maxLength": 200 + } + } + }, + "LengthResolution": { + "type": "object", + "description": "Represents the length entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/LengthUnit", + "description": "The length Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "LengthResolution" + }, + "LengthUnit": { + "type": "string", + "description": "The length unit of measurement.", + "enum": [ + "Unspecified", + "Kilometer", + "Hectometer", + "Decameter", + "Meter", + "Decimeter", + "Centimeter", + "Millimeter", + "Micrometer", + "Nanometer", + "Picometer", + "Mile", + "Yard", + "Inch", + "Foot", + "LightYear", + "Pt" + ], + "x-ms-enum": { + "name": "LengthUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Kilometer", + "value": "Kilometer" + }, + { + "name": "Hectometer", + "value": "Hectometer" + }, + { + "name": "Decameter", + "value": "Decameter" + }, + { + "name": "Meter", + "value": "Meter" + }, + { + "name": "Decimeter", + "value": "Decimeter" + }, + { + "name": "Centimeter", + "value": "Centimeter" + }, + { + "name": "Millimeter", + "value": "Millimeter" + }, + { + "name": "Micrometer", + "value": "Micrometer" + }, + { + "name": "Nanometer", + "value": "Nanometer" + }, + { + "name": "Picometer", + "value": "Picometer" + }, + { + "name": "Mile", + "value": "Mile" + }, + { + "name": "Yard", + "value": "Yard" + }, + { + "name": "Inch", + "value": "Inch" + }, + { + "name": "Foot", + "value": "Foot" + }, + { + "name": "LightYear", + "value": "LightYear" + }, + { + "name": "Pt", + "value": "Pt" + } + ] + } + }, + "ListKey": { + "type": "object", + "description": "The list key extra data kind.", + "properties": { + "key": { + "type": "string", + "description": "The canonical form of the extracted entity." + } + }, + "allOf": [ + { + "$ref": "#/definitions/BaseExtraInformation" + } + ], + "x-ms-discriminator-value": "ListKey" + }, + "LuisCallingOptions": { + "type": "object", + "description": "This customizes how the service calls LUIS Generally Available projects.", + "properties": { + "verbose": { + "type": "boolean", + "description": "Enable verbose response." + }, + "log": { + "type": "boolean", + "description": "Save log to add in training utterances later." + }, + "show-all-intents": { + "type": "boolean", + "description": "Set true to show all intents." + }, + "timezoneOffset": { + "type": "integer", + "format": "int32", + "description": "The timezone offset for the location of the request." + }, + "spellCheck": { + "type": "boolean", + "description": "Enable spell checking." + }, + "bing-spell-check-subscription-key": { + "type": "string", + "description": "The subscription key to use when enabling Bing spell check" + } + } + }, + "LuisParameters": { + "type": "object", + "description": "This is a set of request parameters for LUIS Generally Available projects.", + "properties": { + "query": { + "type": "string", + "description": "The utterance to predict.", + "maxLength": 500 + }, + "callingOptions": { + "$ref": "#/definitions/LuisCallingOptions", + "description": "This customizes how the service calls LUIS Generally Available projects." + } + }, + "additionalProperties": {}, + "allOf": [ + { + "$ref": "#/definitions/AnalysisParameters" + } + ], + "x-ms-discriminator-value": "Luis" + }, + "LuisTargetIntentResult": { + "type": "object", + "description": "It is a wrap up of LUIS Generally Available response.", + "properties": { + "result": { + "type": "object", + "description": "The actual response from a LUIS Generally Available application." + } + }, + "allOf": [ + { + "$ref": "#/definitions/TargetIntentResult" + } + ], + "x-ms-discriminator-value": "Luis" + }, + "MetadataFilter": { + "type": "object", + "description": "Find QnAs that are associated with the given list of metadata.", + "properties": { + "metadata": { + "type": "array", + "description": "List of metadata.", + "items": { + "$ref": "#/definitions/MetadataRecord" + }, + "x-ms-identifiers": [] + }, + "logicalOperation": { + "type": "string", + "description": "Operation used to join metadata filters.", + "default": "AND", + "enum": [ + "AND", + "OR" + ], + "x-ms-enum": { + "name": "LogicalOperationKind", + "modelAsString": true, + "values": [ + { + "name": "AND", + "value": "AND" + }, + { + "name": "OR", + "value": "OR" + } + ] + } + } + } + }, + "MetadataRecord": { + "type": "object", + "description": "Object to provide the key value pair for each metadata.", + "properties": { + "key": { + "type": "string", + "description": "Metadata Key from Metadata dictionary used in the QnA." + }, + "value": { + "type": "string", + "description": "Metadata Value from Metadata dictionary used in the QnA." + } + }, + "required": [ + "key", + "value" + ] + }, + "MultiLanguageConversationAnalysisInput": { + "type": "object", + "description": "Multi Language Conversation Analysis Input", + "properties": { + "conversations": { + "type": "array", + "description": "Array of conversation items", + "items": { + "$ref": "#/definitions/Conversation" + } + } + }, + "required": [ + "conversations" + ] + }, + "NoneLinkedTargetIntentResult": { + "type": "object", + "description": "A wrap up of non-linked intent response.", + "properties": { + "result": { + "$ref": "#/definitions/ConversationResult", + "description": "The actual response from a Conversation project." + } + }, + "allOf": [ + { + "$ref": "#/definitions/TargetIntentResult" + } + ], + "x-ms-discriminator-value": "NonLinked" + }, + "NumberKind": { + "type": "string", + "description": "The type of the extracted number entity.", + "enum": [ + "Integer", + "Decimal", + "Power", + "Fraction", + "Percent", + "Unspecified" + ], + "x-ms-enum": { + "name": "NumberKind", + "modelAsString": true, + "values": [ + { + "name": "Integer", + "value": "Integer" + }, + { + "name": "Decimal", + "value": "Decimal" + }, + { + "name": "Power", + "value": "Power" + }, + { + "name": "Fraction", + "value": "Fraction" + }, + { + "name": "Percent", + "value": "Percent" + }, + { + "name": "Unspecified", + "value": "Unspecified" + } + ] + } + }, + "NumberResolution": { + "type": "object", + "description": "A resolution for numeric entity instances.", + "properties": { + "numberKind": { + "$ref": "#/definitions/NumberKind", + "description": "The type of the extracted number entity." + }, + "value": { + "type": "number", + "format": "double", + "description": "A numeric representation of what the extracted text denotes." + } + }, + "required": [ + "numberKind", + "value" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "NumberResolution" + }, + "NumericRangeResolution": { + "type": "object", + "description": "represents the resolution of numeric intervals.", + "properties": { + "rangeKind": { + "$ref": "#/definitions/RangeKind", + "description": "The kind of range that the resolution object represents." + }, + "minimum": { + "type": "number", + "format": "double", + "description": "The beginning value of the interval." + }, + "maximum": { + "type": "number", + "format": "double", + "description": "The ending value of the interval." + } + }, + "required": [ + "rangeKind", + "minimum", + "maximum" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "NumericRangeResolution" + }, + "OrchestrationPrediction": { + "type": "object", + "description": "This represents the prediction result of an Orchestration project.", + "properties": { + "intents": { + "type": "object", + "description": "A dictionary that contains all intents. A key is an intent name and a value is its confidence score and target type. The top intent's value also contains the actual response from the target project.", + "additionalProperties": { + "$ref": "#/definitions/TargetIntentResult" + } + } + }, + "required": [ + "intents" + ], + "allOf": [ + { + "$ref": "#/definitions/BasePrediction" + } + ], + "x-ms-discriminator-value": "Orchestration" + }, + "OrdinalResolution": { + "type": "object", + "description": "A resolution for ordinal numbers entity instances.", + "properties": { + "offset": { + "type": "string", + "description": "The offset With respect to the reference (e.g., offset = -1 in \"show me the second to last\"" + }, + "relativeTo": { + "$ref": "#/definitions/RelativeTo", + "description": "The reference point that the ordinal number denotes." + }, + "value": { + "type": "string", + "description": "A simple arithmetic expression that the ordinal denotes." + } + }, + "required": [ + "offset", + "relativeTo", + "value" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "OrdinalResolution" + }, + "QueryFilters": { + "type": "object", + "description": "filters over knowledge base.", + "properties": { + "metadataFilter": { + "$ref": "#/definitions/MetadataFilter", + "description": "filters over knowledge base." + }, + "sourceFilter": { + "$ref": "#/definitions/SourceFilter", + "description": "filters over knowledge base." + }, + "logicalOperation": { + "type": "string", + "description": "Logical operation used to join metadata filter with source filter.", + "default": "AND", + "enum": [ + "AND", + "OR" + ], + "x-ms-enum": { + "name": "LogicalOperationKind", + "modelAsString": true, + "values": [ + { + "name": "AND", + "value": "AND" + }, + { + "name": "OR", + "value": "OR" + } + ] + } + } + } + }, + "QuestionAnsweringParameters": { + "type": "object", + "description": "This is a set of request parameters for Question Answering knowledge bases.", + "properties": { + "callingOptions": { + "$ref": "#/definitions/AnswersOptions", + "description": "The options sent to a Question Answering KB." + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalysisParameters" + } + ], + "x-ms-discriminator-value": "QuestionAnswering" + }, + "QuestionAnsweringTargetIntentResult": { + "type": "object", + "description": "It is a wrap up a Question Answering KB response.", + "properties": { + "result": { + "$ref": "#/definitions/AnswersResult", + "description": "The generated answer by a Question Answering KB." + } + }, + "allOf": [ + { + "$ref": "#/definitions/TargetIntentResult" + } + ], + "x-ms-discriminator-value": "QuestionAnswering" + }, + "RangeKind": { + "type": "string", + "description": "The kind of range that the resolution object represents.", + "enum": [ + "Number", + "Speed", + "Weight", + "Length", + "Volume", + "Area", + "Age", + "Information", + "Temperature", + "Currency" + ], + "x-ms-enum": { + "name": "RangeKind", + "modelAsString": true, + "values": [ + { + "name": "Number", + "value": "Number" + }, + { + "name": "Speed", + "value": "Speed" + }, + { + "name": "Weight", + "value": "Weight" + }, + { + "name": "Length", + "value": "Length" + }, + { + "name": "Volume", + "value": "Volume" + }, + { + "name": "Area", + "value": "Area" + }, + { + "name": "Age", + "value": "Age" + }, + { + "name": "Information", + "value": "Information" + }, + { + "name": "Temperature", + "value": "Temperature" + }, + { + "name": "Currency", + "value": "Currency" + } + ] + } + }, + "RankerKind": { + "type": "string", + "description": "Type of ranker to be used", + "enum": [ + "Default", + "QuestionOnly" + ], + "x-ms-enum": { + "name": "RankerKind", + "modelAsString": true, + "values": [ + { + "name": "Default", + "value": "Default", + "description": "Default ranker." + }, + { + "name": "QuestionOnly", + "value": "QuestionOnly", + "description": "Question only ranker." + } + ] + } + }, + "RedactedTranscriptContent": { + "type": "object", + "description": "Transcript content response that the service generates, with all necessary personally identifiable information redacted.", + "properties": { + "itn": { + "type": "string", + "description": "Redacted output for input in inverse-text-normalized format." + }, + "maskedItn": { + "type": "string", + "description": "Redacted output for input in masked inverse-text-normalized format." + }, + "text": { + "type": "string", + "description": "Redacted output for input in text (Microsoft's speech-to-text 'display') format." + }, + "lexical": { + "type": "string", + "description": "Redacted output for input in lexical format." + }, + "audioTimings": { + "type": "array", + "description": "List of redacted audio segments.", + "items": { + "$ref": "#/definitions/AudioTiming" + }, + "x-ms-identifiers": [] + } + } + }, + "RegexKey": { + "type": "object", + "description": "The regex key extra data kind.", + "properties": { + "key": { + "type": "string", + "description": "The key of the regex pattern used in extracting the entity." + }, + "regexPattern": { + "type": "string", + "description": "The .NET regex pattern used in extracting the entity. Please visit https://docs.microsoft.com/dotnet/standard/base-types/regular-expressions for more information about .NET regular expressions." + } + }, + "allOf": [ + { + "$ref": "#/definitions/BaseExtraInformation" + } + ], + "x-ms-discriminator-value": "RegexKey" + }, + "RelativeTo": { + "type": "string", + "description": "The reference point that the ordinal number denotes.", + "enum": [ + "Current", + "End", + "Start" + ], + "x-ms-enum": { + "name": "RelativeTo", + "modelAsString": true, + "values": [ + { + "name": "Current", + "value": "Current" + }, + { + "name": "End", + "value": "End" + }, + { + "name": "Start", + "value": "Start" + } + ] + } + }, + "RequestStatistics": { + "type": "object", + "description": "if showStats=true was specified in the request this field will contain information about the request payload.", + "properties": { + "documentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of documents submitted in the request." + }, + "validDocumentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of valid documents. This excludes empty, over-size limit or non-supported languages documents." + }, + "erroneousDocumentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of invalid documents. This includes empty, over-size limit or non-supported languages documents." + }, + "transactionsCount": { + "type": "integer", + "format": "int64", + "description": "Number of transactions for the request." + } + }, + "required": [ + "documentsCount", + "validDocumentsCount", + "erroneousDocumentsCount", + "transactionsCount" + ] + }, + "ResolutionKind": { + "type": "string", + "description": "The entity resolution object kind.", + "enum": [ + "BooleanResolution", + "DateTimeResolution", + "NumberResolution", + "OrdinalResolution", + "SpeedResolution", + "WeightResolution", + "LengthResolution", + "VolumeResolution", + "AreaResolution", + "AgeResolution", + "InformationResolution", + "TemperatureResolution", + "CurrencyResolution", + "NumericRangeResolution", + "TemporalSpanResolution" + ], + "x-ms-enum": { + "name": "ResolutionKind", + "modelAsString": true, + "values": [ + { + "name": "BooleanResolution", + "value": "BooleanResolution" + }, + { + "name": "DateTimeResolution", + "value": "DateTimeResolution" + }, + { + "name": "NumberResolution", + "value": "NumberResolution" + }, + { + "name": "OrdinalResolution", + "value": "OrdinalResolution" + }, + { + "name": "SpeedResolution", + "value": "SpeedResolution" + }, + { + "name": "WeightResolution", + "value": "WeightResolution" + }, + { + "name": "LengthResolution", + "value": "LengthResolution" + }, + { + "name": "VolumeResolution", + "value": "VolumeResolution" + }, + { + "name": "AreaResolution", + "value": "AreaResolution" + }, + { + "name": "AgeResolution", + "value": "AgeResolution" + }, + { + "name": "InformationResolution", + "value": "InformationResolution" + }, + { + "name": "TemperatureResolution", + "value": "TemperatureResolution" + }, + { + "name": "CurrencyResolution", + "value": "CurrencyResolution" + }, + { + "name": "NumericRangeResolution", + "value": "NumericRangeResolution" + }, + { + "name": "TemporalSpanResolution", + "value": "TemporalSpanResolution" + } + ] + } + }, + "SentimentConfidenceScores": { + "type": "object", + "description": "Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative.", + "properties": { + "positive": { + "type": "number", + "format": "double", + "description": "Confidence score for positive sentiment" + }, + "neutral": { + "type": "number", + "format": "double", + "description": "Confidence score for neutral sentiment" + }, + "negative": { + "type": "number", + "format": "double", + "description": "Confidence score for negative sentiment" + } + }, + "required": [ + "positive", + "neutral", + "negative" + ] + }, + "ShortAnswerOptions": { + "type": "object", + "description": "To configure Answer span prediction feature.", + "properties": { + "enable": { + "type": "boolean", + "description": "Enable or disable Answer Span prediction.", + "enum": [ + true + ] + }, + "confidenceScoreThreshold": { + "type": "number", + "format": "double", + "description": "Minimum threshold score required to include an answer span, value ranges from 0 to 1.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidenceThreshold" + }, + "topAnswersWithSpan": { + "type": "integer", + "format": "int32", + "description": "Number of Top answers to be considered for span prediction from 1 to 10.", + "minimum": 1, + "maximum": 10, + "x-ms-client-name": "top" + } + }, + "required": [ + "enable" + ] + }, + "SourceFilter": { + "type": "array", + "description": "Find QnAs that are associated with any of the given list of sources in knowledge base.", + "items": { + "type": "string" + } + }, + "SpeedResolution": { + "type": "object", + "description": "Represents the speed entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/SpeedUnit", + "description": "The speed Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "SpeedResolution" + }, + "SpeedUnit": { + "type": "string", + "description": "The speed Unit of measurement", + "enum": [ + "Unspecified", + "MetersPerSecond", + "KilometersPerHour", + "KilometersPerMinute", + "KilometersPerSecond", + "MilesPerHour", + "Knot", + "FootPerSecond", + "FootPerMinute", + "YardsPerMinute", + "YardsPerSecond", + "MetersPerMillisecond", + "CentimetersPerMillisecond", + "KilometersPerMillisecond" + ], + "x-ms-enum": { + "name": "SpeedUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "MetersPerSecond", + "value": "MetersPerSecond" + }, + { + "name": "KilometersPerHour", + "value": "KilometersPerHour" + }, + { + "name": "KilometersPerMinute", + "value": "KilometersPerMinute" + }, + { + "name": "KilometersPerSecond", + "value": "KilometersPerSecond" + }, + { + "name": "MilesPerHour", + "value": "MilesPerHour" + }, + { + "name": "Knot", + "value": "Knot" + }, + { + "name": "FootPerSecond", + "value": "FootPerSecond" + }, + { + "name": "FootPerMinute", + "value": "FootPerMinute" + }, + { + "name": "YardsPerMinute", + "value": "YardsPerMinute" + }, + { + "name": "YardsPerSecond", + "value": "YardsPerSecond" + }, + { + "name": "MetersPerMillisecond", + "value": "MetersPerMillisecond" + }, + { + "name": "CentimetersPerMillisecond", + "value": "CentimetersPerMillisecond" + }, + { + "name": "KilometersPerMillisecond", + "value": "KilometersPerMillisecond" + } + ] + } + }, + "State": { + "type": "string", + "description": "The status of the task at the mentioned last update time.", + "enum": [ + "notStarted", + "running", + "succeeded", + "partiallyCompleted", + "failed", + "cancelled", + "cancelling" + ], + "x-ms-enum": { + "name": "State", + "modelAsString": true, + "values": [ + { + "name": "notStarted", + "value": "notStarted" + }, + { + "name": "running", + "value": "running" + }, + { + "name": "succeeded", + "value": "succeeded" + }, + { + "name": "partiallyCompleted", + "value": "partiallyCompleted" + }, + { + "name": "failed", + "value": "failed" + }, + { + "name": "cancelled", + "value": "cancelled" + }, + { + "name": "cancelling", + "value": "cancelling" + } + ] + } + }, + "SummaryAspect": { + "type": "string", + "description": "Supported parameters for a conversational summarization task.", + "enum": [ + "issue", + "resolution", + "chapterTitle", + "narrative", + "recap", + "follow-up tasks" + ], + "x-ms-enum": { + "name": "SummaryAspect", + "modelAsString": true, + "values": [ + { + "name": "issue", + "value": "issue", + "description": "Summary of issues in transcripts of web chats and service calls between customer-service agents and customers." + }, + { + "name": "resolution", + "value": "resolution", + "description": "Summary of resolutions in transcripts of web chats and service calls between customer-service agents and customers." + }, + { + "name": "chapterTitle", + "value": "chapterTitle", + "description": "Chapter title of any conversation. It's usually one phrase or several phrases naturally combined. Long conversations tend to have more chapters. You can find the chapter boundary from the summary context." + }, + { + "name": "narrative", + "value": "narrative", + "description": "Generic narrative summary of any conversation. It generally converts the conversational language into formal written language, compresses the text length, and keeps the salient information." + }, + { + "name": "recap", + "value": "recap", + "description": "A concise one-paragraph summary to provide a quick overview." + }, + { + "name": "follow-up tasks", + "value": "follow-up tasks", + "description": "Action items and tasks that arose during a meeting. " + } + ] + } + }, + "SummaryLengthBucket": { + "type": "string", + "description": "Enum that defines the length of the output summaries.", + "enum": [ + "short", + "medium", + "long" + ], + "x-ms-enum": { + "name": "SummaryLengthBucket", + "modelAsString": true, + "values": [ + { + "name": "short", + "value": "short", + "description": "Instructs model to generate shorter length summaries." + }, + { + "name": "medium", + "value": "medium", + "description": "Instructs model to generate medium length summaries." + }, + { + "name": "long", + "value": "long", + "description": "Instructs model to generate longer length summaries." + } + ] + } + }, + "SummaryResult": { + "type": "object", + "description": "Summary Results", + "properties": { + "conversations": { + "type": "array", + "description": "array of conversations", + "items": { + "$ref": "#/definitions/ConversationsSummaryResult" + } + }, + "errors": { + "type": "array", + "description": "Errors by document id.", + "items": { + "$ref": "#/definitions/DocumentError" + } + }, + "statistics": { + "$ref": "#/definitions/RequestStatistics", + "description": "statistics" + }, + "modelVersion": { + "type": "string", + "description": "This field indicates which model is used for scoring." + } + }, + "required": [ + "conversations", + "errors", + "modelVersion" + ] + }, + "SummaryResultItem": { + "type": "object", + "description": "Summary Result Item", + "properties": { + "aspect": { + "type": "string", + "description": "aspect" + }, + "text": { + "type": "string", + "description": "text" + }, + "contexts": { + "type": "array", + "description": "Context list of the summary.", + "items": { + "$ref": "#/definitions/ItemizedSummaryContext" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "aspect", + "text" + ] + }, + "TargetIntentResult": { + "type": "object", + "description": "This is the base class of an intent prediction", + "properties": { + "targetProjectKind": { + "$ref": "#/definitions/targetProjectKind", + "description": "This is the base class of an intent prediction" + }, + "apiVersion": { + "type": "string", + "description": "The API version used to call a target service." + }, + "confidenceScore": { + "type": "number", + "format": "double", + "description": "The prediction score and it ranges from 0.0 to 1.0.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidence" + } + }, + "discriminator": "targetProjectKind", + "required": [ + "targetProjectKind", + "confidenceScore" + ] + }, + "Tasks": { + "type": "object", + "description": "Contains the state for the tasks that are being executed as part of the submitted job for analyzing a conversation.", + "properties": { + "completed": { + "type": "integer", + "format": "int32", + "description": "Count of tasks that finished successfully." + }, + "failed": { + "type": "integer", + "format": "int32", + "description": "Count of tasks that failed." + }, + "inProgress": { + "type": "integer", + "format": "int32", + "description": "Count of tasks that are currently in progress." + }, + "total": { + "type": "integer", + "format": "int32", + "description": "Total count of tasks submitted as part of the job." + }, + "items": { + "type": "array", + "description": "List of results from tasks (if available).", + "items": { + "$ref": "#/definitions/AnalyzeConversationJobResult" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "completed", + "failed", + "inProgress", + "total" + ] + }, + "TemperatureResolution": { + "type": "object", + "description": "Represents the temperature entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/TemperatureUnit", + "description": "The temperature Unit of measurement." + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "TemperatureResolution" + }, + "TemperatureUnit": { + "type": "string", + "description": "The temperature Unit of measurement.", + "enum": [ + "Unspecified", + "Fahrenheit", + "Kelvin", + "Rankine", + "Celsius" + ], + "x-ms-enum": { + "name": "TemperatureUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Fahrenheit", + "value": "Fahrenheit" + }, + { + "name": "Kelvin", + "value": "Kelvin" + }, + { + "name": "Rankine", + "value": "Rankine" + }, + { + "name": "Celsius", + "value": "Celsius" + } + ] + } + }, + "TemporalModifier": { + "type": "string", + "description": "An optional modifier of a date/time instance.", + "enum": [ + "AfterApprox", + "Before", + "BeforeStart", + "Approx", + "ReferenceUndefined", + "SinceEnd", + "AfterMid", + "Start", + "After", + "BeforeEnd", + "Until", + "End", + "Less", + "Since", + "AfterStart", + "BeforeApprox", + "Mid", + "More" + ], + "x-ms-enum": { + "name": "TemporalModifier", + "modelAsString": true, + "values": [ + { + "name": "AfterApprox", + "value": "AfterApprox" + }, + { + "name": "Before", + "value": "Before" + }, + { + "name": "BeforeStart", + "value": "BeforeStart" + }, + { + "name": "Approx", + "value": "Approx" + }, + { + "name": "ReferenceUndefined", + "value": "ReferenceUndefined" + }, + { + "name": "SinceEnd", + "value": "SinceEnd" + }, + { + "name": "AfterMid", + "value": "AfterMid" + }, + { + "name": "Start", + "value": "Start" + }, + { + "name": "After", + "value": "After" + }, + { + "name": "BeforeEnd", + "value": "BeforeEnd" + }, + { + "name": "Until", + "value": "Until" + }, + { + "name": "End", + "value": "End" + }, + { + "name": "Less", + "value": "Less" + }, + { + "name": "Since", + "value": "Since" + }, + { + "name": "AfterStart", + "value": "AfterStart" + }, + { + "name": "BeforeApprox", + "value": "BeforeApprox" + }, + { + "name": "Mid", + "value": "Mid" + }, + { + "name": "More", + "value": "More" + } + ] + } + }, + "TemporalSpanResolution": { + "type": "object", + "description": "represents the resolution of a date and/or time span.", + "properties": { + "begin": { + "type": "string", + "description": "represents the resolution of a date and/or time span. An extended ISO 8601 date/time representation as described in (https://github.com/Microsoft/Recognizers-Text/blob/master/Patterns/English/English-DateTime.yaml)" + }, + "end": { + "type": "string", + "description": "represents the resolution of a date and/or time span. An extended ISO 8601 date/time representation as described in (https://github.com/Microsoft/Recognizers-Text/blob/master/Patterns/English/English-DateTime.yaml)" + }, + "duration": { + "type": "string", + "description": "An optional duration value formatted based on the ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601#Durations)" + }, + "modifier": { + "$ref": "#/definitions/TemporalModifier", + "description": "An optional modifier of a date/time instance." + }, + "timex": { + "type": "string", + "description": "An optional triplet containing the beginning, the end, and the duration all stated as ISO 8601 formatted strings." + } + }, + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "TemporalSpanResolution" + }, + "TextConversation": { + "type": "object", + "description": "model for text conversation", + "properties": { + "conversationItems": { + "type": "array", + "description": "Ordered list of text conversation items in the conversation.", + "items": { + "$ref": "#/definitions/TextConversationItem" + } + } + }, + "required": [ + "conversationItems" + ], + "allOf": [ + { + "$ref": "#/definitions/Conversation" + } + ], + "x-ms-discriminator-value": "text" + }, + "TextConversationItem": { + "type": "object", + "description": "The text modality of an input conversation.", + "properties": { + "id": { + "type": "string", + "description": "The ID of a conversation item." + }, + "participantId": { + "type": "string", + "description": "The participant ID of a conversation item." + }, + "language": { + "type": "string", + "description": "The override language of a conversation item in BCP 47 language representation." + }, + "modality": { + "$ref": "#/definitions/InputModality", + "description": "Enumeration of supported conversational modalities." + }, + "role": { + "$ref": "#/definitions/role", + "description": "Role of the participant." + }, + "text": { + "type": "string", + "description": "The text input" + } + }, + "required": [ + "id", + "participantId", + "text" + ], + "additionalProperties": {} + }, + "TextSentiment": { + "type": "string", + "description": "Predicted sentiment", + "enum": [ + "positive", + "neutral", + "negative", + "mixed" + ], + "x-ms-enum": { + "name": "TextSentiment", + "modelAsString": true, + "values": [ + { + "name": "positive", + "value": "positive", + "description": "Positive statement" + }, + { + "name": "neutral", + "value": "neutral", + "description": "Neutral statement" + }, + { + "name": "negative", + "value": "negative", + "description": "Negative statement" + }, + { + "name": "mixed", + "value": "mixed", + "description": "Mixed statement" + } + ] + } + }, + "TranscriptContentType": { + "type": "string", + "description": "Enumeration of supported transcript content types.", + "enum": [ + "lexical", + "itn", + "maskedItn", + "text" + ], + "x-ms-enum": { + "name": "TranscriptContentType", + "modelAsString": true, + "values": [ + { + "name": "lexical", + "value": "lexical" + }, + { + "name": "itn", + "value": "itn" + }, + { + "name": "maskedItn", + "value": "maskedItn" + }, + { + "name": "text", + "value": "text" + } + ] + } + }, + "TranscriptConversation": { + "type": "object", + "description": "model for transcript conversation", + "properties": { + "conversationItems": { + "type": "array", + "description": "Ordered list of transcript conversation items in the conversation.", + "items": { + "$ref": "#/definitions/TranscriptConversationItem" + } + } + }, + "required": [ + "conversationItems" + ], + "allOf": [ + { + "$ref": "#/definitions/Conversation" + } + ], + "x-ms-discriminator-value": "transcript" + }, + "TranscriptConversationItem": { + "type": "object", + "description": "Additional properties for supporting transcript conversation.", + "properties": { + "id": { + "type": "string", + "description": "The ID of a conversation item." + }, + "participantId": { + "type": "string", + "description": "The participant ID of a conversation item." + }, + "language": { + "type": "string", + "description": "The override language of a conversation item in BCP 47 language representation." + }, + "modality": { + "$ref": "#/definitions/InputModality", + "description": "Enumeration of supported conversational modalities." + }, + "role": { + "$ref": "#/definitions/role", + "description": "Role of the participant." + }, + "itn": { + "type": "string", + "description": "Inverse text normalization (ITN) representation of input. The inverse-text-normalized form is the recognized text from Microsoft's speech-to-text API, with phone numbers, numbers, abbreviations, and other transformations applied." + }, + "maskedItn": { + "type": "string", + "description": "Inverse-text-normalized format with profanity masking applied." + }, + "text": { + "type": "string", + "description": "Display form of the recognized text from the speech-to-text API, with punctuation and capitalization added." + }, + "lexical": { + "type": "string", + "description": "Lexical form of the recognized text from the speech-to-text API, with the actual words recognized." + }, + "wordLevelTimings": { + "type": "array", + "description": "List of word-level audio timing information.", + "items": { + "$ref": "#/definitions/WordLevelTiming" + }, + "x-ms-identifiers": [] + }, + "conversationItemLevelTiming": { + "$ref": "#/definitions/ConversationItemLevelTiming", + "description": "Audio timing at the conversation item level. This still can help with AI quality if word-level audio timings are not available." + } + }, + "required": [ + "id", + "participantId", + "itn", + "maskedItn", + "text", + "lexical" + ], + "additionalProperties": {} + }, + "VolumeResolution": { + "type": "object", + "description": "Represents the volume entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/VolumeUnit", + "description": "The Volume Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "VolumeResolution" + }, + "VolumeUnit": { + "type": "string", + "description": "The Volume Unit of measurement", + "enum": [ + "Unspecified", + "CubicMeter", + "CubicCentimeter", + "CubicMillimeter", + "Hectoliter", + "Decaliter", + "Liter", + "Centiliter", + "Milliliter", + "CubicYard", + "CubicInch", + "CubicFoot", + "CubicMile", + "FluidOunce", + "Teaspoon", + "Tablespoon", + "Pint", + "Quart", + "Cup", + "Gill", + "Pinch", + "FluidDram", + "Barrel", + "Minim", + "Cord", + "Peck", + "Bushel", + "Hogshead" + ], + "x-ms-enum": { + "name": "VolumeUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "CubicMeter", + "value": "CubicMeter" + }, + { + "name": "CubicCentimeter", + "value": "CubicCentimeter" + }, + { + "name": "CubicMillimeter", + "value": "CubicMillimeter" + }, + { + "name": "Hectoliter", + "value": "Hectoliter" + }, + { + "name": "Decaliter", + "value": "Decaliter" + }, + { + "name": "Liter", + "value": "Liter" + }, + { + "name": "Centiliter", + "value": "Centiliter" + }, + { + "name": "Milliliter", + "value": "Milliliter" + }, + { + "name": "CubicYard", + "value": "CubicYard" + }, + { + "name": "CubicInch", + "value": "CubicInch" + }, + { + "name": "CubicFoot", + "value": "CubicFoot" + }, + { + "name": "CubicMile", + "value": "CubicMile" + }, + { + "name": "FluidOunce", + "value": "FluidOunce" + }, + { + "name": "Teaspoon", + "value": "Teaspoon" + }, + { + "name": "Tablespoon", + "value": "Tablespoon" + }, + { + "name": "Pint", + "value": "Pint" + }, + { + "name": "Quart", + "value": "Quart" + }, + { + "name": "Cup", + "value": "Cup" + }, + { + "name": "Gill", + "value": "Gill" + }, + { + "name": "Pinch", + "value": "Pinch" + }, + { + "name": "FluidDram", + "value": "FluidDram" + }, + { + "name": "Barrel", + "value": "Barrel" + }, + { + "name": "Minim", + "value": "Minim" + }, + { + "name": "Cord", + "value": "Cord" + }, + { + "name": "Peck", + "value": "Peck" + }, + { + "name": "Bushel", + "value": "Bushel" + }, + { + "name": "Hogshead", + "value": "Hogshead" + } + ] + } + }, + "WeightResolution": { + "type": "object", + "description": "Represents the weight entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/WeightUnit", + "description": "The weight Unit of measurement." + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "WeightResolution" + }, + "WeightUnit": { + "type": "string", + "description": "The weight Unit of measurement.", + "enum": [ + "Unspecified", + "Kilogram", + "Gram", + "Milligram", + "Gallon", + "MetricTon", + "Ton", + "Pound", + "Ounce", + "Grain", + "PennyWeight", + "LongTonBritish", + "ShortTonUS", + "ShortHundredWeightUS", + "Stone", + "Dram" + ], + "x-ms-enum": { + "name": "WeightUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Kilogram", + "value": "Kilogram" + }, + { + "name": "Gram", + "value": "Gram" + }, + { + "name": "Milligram", + "value": "Milligram" + }, + { + "name": "Gallon", + "value": "Gallon" + }, + { + "name": "MetricTon", + "value": "MetricTon" + }, + { + "name": "Ton", + "value": "Ton" + }, + { + "name": "Pound", + "value": "Pound" + }, + { + "name": "Ounce", + "value": "Ounce" + }, + { + "name": "Grain", + "value": "Grain" + }, + { + "name": "PennyWeight", + "value": "PennyWeight" + }, + { + "name": "LongTonBritish", + "value": "LongTonBritish" + }, + { + "name": "ShortTonUS", + "value": "ShortTonUS" + }, + { + "name": "ShortHundredWeightUS", + "value": "ShortHundredWeightUS" + }, + { + "name": "Stone", + "value": "Stone" + }, + { + "name": "Dram", + "value": "Dram" + } + ] + } + }, + "WordLevelTiming": { + "type": "object", + "description": "Word-level timing information that the speech-to-text API generates. The words in this object should have 1:1 correspondence with the lexical input to allow for audio redaction.", + "properties": { + "offset": { + "type": "integer", + "format": "int64", + "description": "Offset from the start of speech audio, in ticks. 1 tick = 100 nanoseconds." + }, + "duration": { + "type": "integer", + "format": "int64", + "description": "Duration of word articulation, in ticks. 1 tick = 100 nanoseconds." + }, + "word": { + "type": "string", + "description": "Recognized word." + } + } + }, + "projectKind": { + "type": "string", + "description": "The type of the project.", + "enum": [ + "Conversation", + "Orchestration" + ], + "x-ms-enum": { + "name": "projectKind", + "modelAsString": true, + "values": [ + { + "name": "Conversation", + "value": "Conversation" + }, + { + "name": "Orchestration", + "value": "Orchestration" + } + ] + } + }, + "role": { + "type": "string", + "description": "Role of the participant.", + "enum": [ + "customer", + "agent", + "generic" + ], + "x-ms-enum": { + "name": "role", + "modelAsString": true, + "values": [ + { + "name": "customer", + "value": "customer", + "description": "The participant is a customer." + }, + { + "name": "agent", + "value": "agent", + "description": "The participant is an agent." + }, + { + "name": "generic", + "value": "generic", + "description": "The is a generic participant." + } + ] + } + }, + "targetProjectKind": { + "type": "string", + "description": "The type of a target service.", + "enum": [ + "Luis", + "Conversation", + "QuestionAnswering", + "NonLinked" + ], + "x-ms-enum": { + "name": "targetProjectKind", + "modelAsString": true, + "values": [ + { + "name": "Luis", + "value": "Luis" + }, + { + "name": "Conversation", + "value": "Conversation" + }, + { + "name": "QuestionAnswering", + "value": "QuestionAnswering" + }, + { + "name": "NonLinked", + "value": "NonLinked" + } + ] + } + } + }, + "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" + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json new file mode 100644 index 000000000000..5e5edfdfeb42 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json @@ -0,0 +1,4713 @@ +{ + "swagger": "2.0", + "info": { + "title": "Microsoft Cognitive Language Service - Analyze Conversations", + "version": "2024-05-01", + "description": "The language service conversations API is a suite of natural language processing (NLP) skills that can be used to analyze structured conversations (textual or spoken). The synchronous API in this suite accepts a request and mediates among multiple language projects, such as LUIS Generally Available, Question Answering, Conversational Language Understanding, and then calls the best candidate service to handle the request. At last, it returns a response with the candidate service's response as a payload.\n\n In some cases, this API needs to forward requests and responses between the caller and an upstream service. The asynchronous APIs in this suite enable tasks like Conversation Summarization and Conversational PII detection.", + "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" + } + ] + }, + "produces": [ + "application/json" + ], + "consumes": [ + "application/json" + ], + "security": [ + { + "ApiKeyAuth": [] + } + ], + "securityDefinitions": { + "ApiKeyAuth": { + "type": "apiKey", + "name": "Ocp-Apim-Subscription-Key", + "in": "header" + } + }, + "tags": [], + "paths": { + "/:analyze-conversations": { + "post": { + "operationId": "AnalyzeConversations", + "description": "Analyzes the input conversation utterance.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "body", + "in": "body", + "description": "Collection of conversations to analyze and a single task to execute.", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationTask" + } + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationTaskResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/ErrorResponseWithHeader" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "The error code for specific error that occurred." + } + } + } + } + } + }, + "/analyze-conversations/jobs": { + "post": { + "operationId": "AnalyzeConversationsSubmitJob", + "description": "Analyzes the input conversation utterance.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/AnalyzeConversationJobsInput" + } + } + ], + "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/ErrorResponse" + } + } + }, + "x-ms-long-running-operation": true + } + }, + "/analyze-conversations/jobs/{jobId}": { + "get": { + "operationId": "AnalyzeConversationsJobStatus", + "summary": "Get analysis status and results", + "description": "Get the status of an analysis job. A job can consist of one or more tasks. After all tasks succeed, the job transitions to the succeeded state and results are available for each task.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "jobId", + "in": "path", + "description": "job ID", + "required": true, + "type": "string", + "format": "uuid" + }, + { + "name": "showStats", + "in": "query", + "description": "(Optional) if set to true, response will contain request and document level statistics.", + "required": false, + "type": "boolean" + } + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AnalyzeConversationJobState" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/ErrorResponse" + } + } + } + } + }, + "/analyze-conversations/jobs/{jobId}:cancel": { + "post": { + "operationId": "AnalyzeConversationsCancelJob", + "summary": "Cancel a long-running Text Analysis conversations job", + "description": "Cancel a long-running job for text analysis of conversations.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "jobId", + "in": "path", + "description": "job ID", + "required": true, + "type": "string", + "format": "uuid" + } + ], + "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/ErrorResponse" + } + } + }, + "x-ms-long-running-operation": true + } + } + }, + "definitions": { + "AgeResolution": { + "type": "object", + "description": "Represents the Age entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/AgeUnit", + "description": "The Age Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "AgeResolution" + }, + "AgeUnit": { + "type": "string", + "description": "The Age Unit of measurement", + "enum": [ + "Unspecified", + "Year", + "Month", + "Week", + "Day" + ], + "x-ms-enum": { + "name": "AgeUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Year", + "value": "Year" + }, + { + "name": "Month", + "value": "Month" + }, + { + "name": "Week", + "value": "Week" + }, + { + "name": "Day", + "value": "Day" + } + ] + } + }, + "AnalysisParameters": { + "type": "object", + "description": "This is the parameter set of either the Orchestration project itself or one of the target services.", + "properties": { + "targetProjectKind": { + "$ref": "#/definitions/targetProjectKind", + "description": "The type of a target service" + }, + "apiVersion": { + "type": "string", + "description": "The API version to use when call a specific target service." + } + }, + "discriminator": "targetProjectKind", + "required": [ + "targetProjectKind" + ] + }, + "AnalyzeConversationConversationPiiResult": { + "type": "object", + "description": "Result from the personally identifiable information detection and redaction operation performed on a list of conversations.", + "properties": { + "results": { + "$ref": "#/definitions/ConversationPiiResults", + "description": "results" + } + }, + "required": [ + "results" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationJobResult" + } + ], + "x-ms-discriminator-value": "ConversationalPIIResults" + }, + "AnalyzeConversationJobResult": { + "type": "object", + "description": "Container for results of all tasks in the conversation job.", + "properties": { + "lastUpdateDateTime": { + "type": "string", + "format": "date-time", + "description": "The last updated time in UTC for the task." + }, + "status": { + "$ref": "#/definitions/State", + "description": "The status of the task at the mentioned last update time." + }, + "taskName": { + "type": "string", + "description": "task name" + }, + "kind": { + "$ref": "#/definitions/AnalyzeConversationResultsKind", + "description": "discriminator kind" + } + }, + "discriminator": "kind", + "required": [ + "lastUpdateDateTime", + "status", + "kind" + ] + }, + "AnalyzeConversationJobState": { + "type": "object", + "description": "Contains the status of the submitted job for analyzing a conversation, along with related statistics.", + "properties": { + "displayName": { + "type": "string", + "description": "display name" + }, + "createdDateTime": { + "type": "string", + "format": "date-time", + "description": "Date and time job created" + }, + "expirationDateTime": { + "type": "string", + "format": "date-time", + "description": "Date and time job expires" + }, + "jobId": { + "$ref": "#/definitions/Azure.Core.uuid", + "description": "job ID", + "readOnly": true + }, + "lastUpdatedDateTime": { + "type": "string", + "format": "date-time", + "description": "last updated date and time" + }, + "status": { + "$ref": "#/definitions/State", + "description": "status" + }, + "errors": { + "type": "array", + "description": "errors", + "items": { + "$ref": "#/definitions/Error" + }, + "x-ms-identifiers": [] + }, + "nextLink": { + "type": "string", + "description": "next link" + }, + "tasks": { + "$ref": "#/definitions/Tasks", + "description": "Contains the state for the tasks that are being executed as part of the submitted job for analyzing a conversation." + }, + "statistics": { + "$ref": "#/definitions/ConversationRequestStatistics", + "description": "Contains the statistics for the submitted job." + } + }, + "required": [ + "createdDateTime", + "jobId", + "lastUpdatedDateTime", + "status", + "tasks" + ] + }, + "AnalyzeConversationJobsInput": { + "type": "object", + "description": "It is a wrap up a Question Answering KB response.", + "properties": { + "displayName": { + "type": "string", + "description": "Display name for the analysis job." + }, + "analysisInput": { + "$ref": "#/definitions/MultiLanguageConversationAnalysisInput", + "description": "Analysis Input", + "x-ms-mutability": [ + "read", + "create" + ] + }, + "tasks": { + "type": "array", + "description": "Set of tasks to execute on the input conversation.", + "items": { + "$ref": "#/definitions/AnalyzeConversationLROTask" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "analysisInput", + "tasks" + ] + }, + "AnalyzeConversationLROTask": { + "type": "object", + "description": "Base class for a long-running conversation input task.", + "properties": { + "taskName": { + "type": "string", + "description": "task name" + }, + "kind": { + "$ref": "#/definitions/AnalyzeConversationLROTaskKind", + "description": "Enumeration of supported analysis tasks on a collection of conversations." + } + }, + "discriminator": "kind", + "required": [ + "kind" + ] + }, + "AnalyzeConversationLROTaskKind": { + "type": "string", + "description": "Enumeration of supported analysis tasks on a collection of conversations.", + "enum": [ + "ConversationalSummarizationTask", + "ConversationalPIITask" + ], + "x-ms-enum": { + "name": "AnalyzeConversationLROTaskKind", + "modelAsString": true, + "values": [ + { + "name": "ConversationalSummarizationTask", + "value": "ConversationalSummarizationTask", + "description": "Conversational Summarization Task" + }, + { + "name": "ConversationalPIITask", + "value": "ConversationalPIITask", + "description": "Conversational PII Task" + } + ] + } + }, + "AnalyzeConversationPiiTask": { + "type": "object", + "description": "Task definition for a PII redaction in conversations.", + "properties": { + "parameters": { + "$ref": "#/definitions/ConversationPiiTaskParameters", + "description": "parameters" + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationLROTask" + } + ], + "x-ms-discriminator-value": "ConversationalPIITask" + }, + "AnalyzeConversationResult": { + "type": "object", + "description": "Represents a conversation analysis response.", + "properties": { + "query": { + "type": "string", + "description": "The conversation utterance given by the caller." + }, + "detectedLanguage": { + "type": "string", + "description": "The system detected language for the query in BCP 47 language representation.." + }, + "prediction": { + "$ref": "#/definitions/BasePrediction", + "description": "The prediction result of a conversation project." + } + }, + "required": [ + "query", + "prediction" + ] + }, + "AnalyzeConversationResultsKind": { + "type": "string", + "description": "Enumeration of results for supported conversation analysis Results.", + "enum": [ + "ConversationalSummarizationResults", + "ConversationalPIIResults" + ], + "x-ms-enum": { + "name": "AnalyzeConversationResultsKind", + "modelAsString": true, + "values": [ + { + "name": "ConversationalSummarizationResults", + "value": "ConversationalSummarizationResults", + "description": "Conversational Summarization Results" + }, + { + "name": "ConversationalPIIResults", + "value": "ConversationalPIIResults", + "description": "Conversational PII Results" + } + ] + } + }, + "AnalyzeConversationSentimentResult": { + "type": "object", + "description": "Result from the sentiment analysis operation performed on a list of conversations.", + "properties": { + "results": { + "$ref": "#/definitions/ConversationSentimentResults", + "description": "The result from sentiment analysis operation for each conversation." + } + }, + "required": [ + "results" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationJobResult" + } + ] + }, + "AnalyzeConversationSummarizationResult": { + "type": "object", + "description": "Result for the summarization task on the conversation.", + "properties": { + "results": { + "$ref": "#/definitions/SummaryResult", + "description": "results" + } + }, + "required": [ + "results" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationJobResult" + } + ], + "x-ms-discriminator-value": "ConversationalSummarizationResults" + }, + "AnalyzeConversationSummarizationTask": { + "type": "object", + "description": "Task definition for conversational summarization.", + "properties": { + "parameters": { + "$ref": "#/definitions/ConversationSummarizationTaskParameters", + "description": "parameters" + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationLROTask" + } + ], + "x-ms-discriminator-value": "ConversationalSummarizationTask" + }, + "AnalyzeConversationTask": { + "type": "object", + "description": "The base class of a conversation input task.", + "properties": { + "kind": { + "$ref": "#/definitions/AnalyzeConversationTaskKind", + "description": "The base class of a conversation input task.", + "x-ms-mutability": [ + "read", + "create" + ] + } + }, + "discriminator": "kind", + "required": [ + "kind" + ] + }, + "AnalyzeConversationTaskKind": { + "type": "string", + "description": "Enumeration of supported Conversation tasks.", + "enum": [ + "Conversation" + ], + "x-ms-enum": { + "name": "AnalyzeConversationTaskKind", + "modelAsString": true, + "values": [ + { + "name": "Conversation", + "value": "Conversation" + } + ] + } + }, + "AnalyzeConversationTaskResult": { + "type": "object", + "description": "The base class of a conversation input task result.", + "properties": { + "kind": { + "$ref": "#/definitions/AnalyzeConversationTaskResultsKind", + "description": "The base class of a conversation input task result." + } + }, + "discriminator": "kind", + "required": [ + "kind" + ] + }, + "AnalyzeConversationTaskResultsKind": { + "type": "string", + "description": "Enumeration of supported conversational task results.", + "enum": [ + "ConversationResult" + ], + "x-ms-enum": { + "name": "AnalyzeConversationTaskResultsKind", + "modelAsString": true, + "values": [ + { + "name": "ConversationResult", + "value": "ConversationResult" + } + ] + } + }, + "AnswerSpan": { + "type": "object", + "description": "Answer span object of QnA.", + "properties": { + "text": { + "type": "string", + "description": "Predicted text of answer span." + }, + "confidenceScore": { + "type": "number", + "format": "double", + "description": "Predicted score of answer span, value ranges from 0 to 1.", + "minimum": 0, + "maximum": 1 + }, + "offset": { + "type": "integer", + "format": "int32", + "description": "The answer span offset from the start of answer." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "The length of the answer span." + } + } + }, + "AnswersOptions": { + "type": "object", + "description": "Parameters to query a knowledge base.", + "properties": { + "qnaId": { + "type": "integer", + "format": "int32", + "description": "Exact QnA ID to fetch from the knowledge base, this field takes priority over question." + }, + "question": { + "type": "string", + "description": "User question to query against the knowledge base." + }, + "top": { + "type": "integer", + "format": "int32", + "description": "Max number of answers to be returned for the question." + }, + "userId": { + "type": "string", + "description": "Unique identifier for the user." + }, + "confidenceScoreThreshold": { + "type": "number", + "format": "double", + "description": "Minimum threshold score for answers, value ranges from 0 to 1.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidenceThreshold" + }, + "context": { + "$ref": "#/definitions/KnowledgeBaseAnswerContext", + "description": "Context object with previous QnA's information.", + "x-ms-client-name": "answerContext" + }, + "rankerType": { + "$ref": "#/definitions/RankerKind", + "description": "Type of ranker to be used.", + "x-ms-client-name": "rankerKind" + }, + "filters": { + "$ref": "#/definitions/QueryFilters", + "description": "Filter QnAs based on given metadata list and knowledge base sources." + }, + "answerSpanRequest": { + "$ref": "#/definitions/ShortAnswerOptions", + "description": "To configure Answer span prediction feature.", + "x-ms-client-name": "shortAnswerOptions" + }, + "includeUnstructuredSources": { + "type": "boolean", + "description": "(Optional) Flag to enable Query over Unstructured Sources." + } + } + }, + "AnswersResult": { + "type": "object", + "description": "Represents List of Question Answers.", + "properties": { + "answers": { + "type": "array", + "description": "Represents Answer Result list.", + "items": { + "$ref": "#/definitions/KnowledgeBaseAnswer" + } + } + } + }, + "AreaResolution": { + "type": "object", + "description": "Represents the area entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/AreaUnit", + "description": "The area Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "AreaResolution" + }, + "AreaUnit": { + "type": "string", + "description": "The area unit of measurement.", + "enum": [ + "Unspecified", + "SquareKilometer", + "SquareHectometer", + "SquareDecameter", + "SquareDecimeter", + "SquareMeter", + "SquareCentimeter", + "SquareMillimeter", + "SquareInch", + "SquareFoot", + "SquareMile", + "SquareYard", + "Acre" + ], + "x-ms-enum": { + "name": "AreaUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "SquareKilometer", + "value": "SquareKilometer" + }, + { + "name": "SquareHectometer", + "value": "SquareHectometer" + }, + { + "name": "SquareDecameter", + "value": "SquareDecameter" + }, + { + "name": "SquareDecimeter", + "value": "SquareDecimeter" + }, + { + "name": "SquareMeter", + "value": "SquareMeter" + }, + { + "name": "SquareCentimeter", + "value": "SquareCentimeter" + }, + { + "name": "SquareMillimeter", + "value": "SquareMillimeter" + }, + { + "name": "SquareInch", + "value": "SquareInch" + }, + { + "name": "SquareFoot", + "value": "SquareFoot" + }, + { + "name": "SquareMile", + "value": "SquareMile" + }, + { + "name": "SquareYard", + "value": "SquareYard" + }, + { + "name": "Acre", + "value": "Acre" + } + ] + } + }, + "AudioTiming": { + "type": "object", + "description": "Audio timing information.", + "properties": { + "offset": { + "type": "integer", + "format": "int64", + "description": "Offset from the start of speech audio, in ticks. 1 tick = 100 nanoseconds." + }, + "duration": { + "type": "integer", + "format": "int64", + "description": "Duration of word articulation, in ticks. 1 tick = 100 nanoseconds." + } + } + }, + "Azure.Core.uuid": { + "type": "string", + "format": "uuid", + "description": "Universally Unique Identifier" + }, + "BaseExtraInformation": { + "type": "object", + "description": "The abstract base object for entity extra information.", + "properties": { + "extraInformationKind": { + "$ref": "#/definitions/ExtraInformationKind", + "description": "The extra information object kind." + } + }, + "discriminator": "extraInformationKind", + "required": [ + "extraInformationKind" + ] + }, + "BasePrediction": { + "type": "object", + "description": "This is the base class of prediction", + "properties": { + "projectKind": { + "$ref": "#/definitions/projectKind", + "description": "The type of the project." + }, + "topIntent": { + "type": "string", + "description": "The intent with the highest score." + } + }, + "discriminator": "projectKind", + "required": [ + "projectKind" + ] + }, + "BaseResolution": { + "type": "object", + "description": "The abstract base class for entity resolutions.", + "properties": { + "resolutionKind": { + "$ref": "#/definitions/ResolutionKind", + "description": "The entity resolution object kind." + } + }, + "discriminator": "resolutionKind", + "required": [ + "resolutionKind" + ] + }, + "BooleanResolution": { + "type": "object", + "description": "A resolution for boolean expressions", + "properties": { + "value": { + "type": "boolean", + "description": "A resolution for boolean expressions" + } + }, + "required": [ + "value" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "BooleanResolution" + }, + "Conversation": { + "type": "object", + "description": "Complete ordered set of utterances (spoken or written) by one or more speakers to be used for analysis.", + "properties": { + "id": { + "type": "string", + "description": "Unique identifier for the conversation." + }, + "language": { + "type": "string", + "description": "Language of the conversation item in BCP-47 format." + }, + "modality": { + "$ref": "#/definitions/InputModality", + "description": "modality" + }, + "domain": { + "$ref": "#/definitions/ConversationDomain", + "description": "domain" + } + }, + "discriminator": "modality", + "required": [ + "id", + "language", + "modality" + ] + }, + "ConversationAnalysisOptions": { + "type": "object", + "description": "The input ConversationItem and its optional parameters", + "properties": { + "conversationItem": { + "$ref": "#/definitions/ConversationItemBase", + "description": "The abstract base for a user input formatted conversation (e.g., Text, Transcript)." + } + }, + "required": [ + "conversationItem" + ] + }, + "ConversationCallingOptions": { + "type": "object", + "description": "The option to set to call a Conversation project.", + "properties": { + "language": { + "type": "string", + "description": "The language of the query in BCP 47 language representation." + }, + "verbose": { + "type": "boolean", + "description": "If true, the service will return more detailed information." + }, + "isLoggingEnabled": { + "type": "boolean", + "description": "If true, the query will be saved for customers to further review in authoring, to improve the model quality." + } + } + }, + "ConversationDomain": { + "type": "string", + "description": "Enumeration of supported conversational domains.", + "enum": [ + "finance", + "healthcare", + "generic" + ], + "x-ms-enum": { + "name": "ConversationDomain", + "modelAsString": true, + "values": [ + { + "name": "finance", + "value": "finance", + "description": "Enumeration of supported conversational domains." + }, + { + "name": "healthcare", + "value": "healthcare", + "description": "Enumeration of supported conversational domains." + }, + { + "name": "generic", + "value": "generic", + "description": "Enumeration of supported conversational domains." + } + ] + } + }, + "ConversationEntity": { + "type": "object", + "description": "The entity extraction result of a Conversation project.", + "properties": { + "category": { + "type": "string", + "description": "The entity category." + }, + "text": { + "type": "string", + "description": "The predicted entity text." + }, + "offset": { + "type": "integer", + "format": "int32", + "description": "The starting index of this entity in the query." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "The length of the text." + }, + "confidenceScore": { + "type": "number", + "format": "float", + "description": "The entity confidence score.", + "x-ms-client-name": "confidence" + }, + "resolutions": { + "type": "array", + "description": "The collection of entity resolution objects.", + "items": { + "$ref": "#/definitions/BaseResolution" + }, + "x-ms-identifiers": [] + }, + "extraInformation": { + "type": "array", + "description": "The collection of entity extra information objects.", + "items": { + "$ref": "#/definitions/BaseExtraInformation" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "category", + "text", + "offset", + "length", + "confidenceScore" + ] + }, + "ConversationIntent": { + "type": "object", + "description": "The intent classification result of a Conversation project.", + "properties": { + "category": { + "type": "string", + "description": "A predicted class." + }, + "confidenceScore": { + "type": "number", + "format": "float", + "description": "The confidence score of the class from 0.0 to 1.0.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidence" + } + }, + "required": [ + "category", + "confidenceScore" + ] + }, + "ConversationItemBase": { + "type": "object", + "description": "The abstract base for a user input formatted conversation (e.g., Text, Transcript).", + "properties": { + "id": { + "type": "string", + "description": "The ID of a conversation item." + }, + "participantId": { + "type": "string", + "description": "The participant ID of a conversation item." + }, + "language": { + "type": "string", + "description": "The override language of a conversation item in BCP 47 language representation." + }, + "modality": { + "$ref": "#/definitions/InputModality", + "description": "Enumeration of supported conversational modalities." + }, + "role": { + "$ref": "#/definitions/role", + "description": "Role of the participant." + } + }, + "required": [ + "id", + "participantId" + ], + "additionalProperties": {} + }, + "ConversationItemLevelTiming": { + "type": "object", + "description": "Audio timing at the conversation item level.", + "properties": { + "offset": { + "type": "integer", + "format": "int64", + "description": "Offset from the start of speech audio, in ticks. 1 tick = 100 nanoseconds." + }, + "duration": { + "type": "integer", + "format": "int64", + "description": "Duration of word articulation, in ticks. 1 tick = 100 nanoseconds." + } + } + }, + "ConversationParameters": { + "type": "object", + "description": "This is a set of request parameters for Customized Conversation projects.", + "properties": { + "callingOptions": { + "$ref": "#/definitions/ConversationCallingOptions", + "description": "The option to set to call a Conversation project." + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalysisParameters" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "ConversationPiiCategories": { + "type": "string", + "description": "Describes the PII categories to return for detection. If not provided, 'default' categories will be returned which will vary with the language.", + "enum": [ + "Address", + "CreditCardNumber", + "Email", + "Person", + "NumericIdentifier", + "PhoneNumber", + "USSocialSecurityNumber", + "Miscellaneous", + "All", + "Default" + ], + "x-ms-enum": { + "name": "ConversationPiiCategories", + "modelAsString": true, + "values": [ + { + "name": "Address", + "value": "Address" + }, + { + "name": "CreditCardNumber", + "value": "CreditCardNumber" + }, + { + "name": "Email", + "value": "Email" + }, + { + "name": "Person", + "value": "Person" + }, + { + "name": "NumericIdentifier", + "value": "NumericIdentifier" + }, + { + "name": "PhoneNumber", + "value": "PhoneNumber" + }, + { + "name": "USSocialSecurityNumber", + "value": "USSocialSecurityNumber" + }, + { + "name": "Miscellaneous", + "value": "Miscellaneous" + }, + { + "name": "All", + "value": "All" + }, + { + "name": "Default", + "value": "Default" + } + ] + } + }, + "ConversationPiiCategoriesExclude": { + "type": "string", + "description": "Describes the PII categories to exclude for detection. If not provided, 'default' categories will be returned which will vary with the language.", + "enum": [ + "Address", + "CreditCardNumber", + "Email", + "Person", + "NumericIdentifier", + "PhoneNumber", + "USSocialSecurityNumber" + ], + "x-ms-enum": { + "name": "ConversationPiiCategoriesExclude", + "modelAsString": true, + "values": [ + { + "name": "Address", + "value": "Address" + }, + { + "name": "CreditCardNumber", + "value": "CreditCardNumber" + }, + { + "name": "Email", + "value": "Email" + }, + { + "name": "Person", + "value": "Person" + }, + { + "name": "NumericIdentifier", + "value": "NumericIdentifier" + }, + { + "name": "PhoneNumber", + "value": "PhoneNumber" + }, + { + "name": "USSocialSecurityNumber", + "value": "USSocialSecurityNumber" + } + ] + } + }, + "ConversationPiiItemResult": { + "type": "object", + "description": "The result from PII detection and redaction operation for each conversation.", + "properties": { + "id": { + "type": "string", + "description": "Id of the result" + }, + "redactedContent": { + "$ref": "#/definitions/RedactedTranscriptContent", + "description": "Transcript content response that the service generates, with all necessary personally identifiable information redacted." + }, + "entities": { + "type": "array", + "description": "Array of Entities", + "items": { + "$ref": "#/definitions/Entity" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "id", + "redactedContent", + "entities" + ] + }, + "ConversationPiiResults": { + "type": "object", + "description": "The result from PII detection and redaction operation for each conversation.", + "properties": { + "errors": { + "type": "array", + "description": "Errors by document id.", + "items": { + "$ref": "#/definitions/DocumentError" + } + }, + "statistics": { + "$ref": "#/definitions/RequestStatistics", + "description": "statistics" + }, + "modelVersion": { + "type": "string", + "description": "This field indicates which model is used for scoring." + }, + "conversations": { + "type": "array", + "description": "array of conversations", + "items": { + "$ref": "#/definitions/ConversationalPiiResultWithResultBase" + } + } + }, + "required": [ + "errors", + "modelVersion", + "conversations" + ] + }, + "ConversationPiiTaskParameters": { + "type": "object", + "description": "Supported parameters for a conversational pii task.", + "properties": { + "loggingOptOut": { + "type": "boolean", + "description": "logging opt out", + "default": false + }, + "modelVersion": { + "type": "string", + "description": "model version", + "default": "latest" + }, + "piiCategories": { + "type": "array", + "description": "Array of ConversationPIICategories", + "items": { + "$ref": "#/definitions/ConversationPiiCategories" + } + }, + "redactAudioTiming": { + "type": "boolean", + "description": "Flag to indicate if response should include audio stream offset and duration for any detected entities to be redacted. By default, audio timing of redacted entities are not included." + }, + "redactionSource": { + "$ref": "#/definitions/TranscriptContentType", + "description": "For transcript conversations, this parameter provides information regarding which content type (ITN, Text, Lexical, Masked ITN) should be used for entity detection. The details of the entities detected - like the offset, length and the text itself - will correspond to the text type selected here." + }, + "redactionCharacter": { + "type": "string", + "description": "Optional parameter to use a Custom Character to be used for redaction in PII responses. Default character will be * as before. We allow specific ascii characters for redaction.", + "default": "*", + "enum": [ + "!", + "#", + "$", + "%", + "&", + "*", + "+", + "-", + "=", + "?", + "@", + "^", + "_", + "~" + ], + "x-ms-enum": { + "name": "redactionCharacter", + "modelAsString": true, + "values": [ + { + "name": "exclamationPoint", + "value": "!" + }, + { + "name": "numberSign", + "value": "#" + }, + { + "name": "dollar", + "value": "$" + }, + { + "name": "percent", + "value": "%" + }, + { + "name": "ampersand", + "value": "&" + }, + { + "name": "asterisk", + "value": "*" + }, + { + "name": "plus", + "value": "+" + }, + { + "name": "minus", + "value": "-" + }, + { + "name": "equals", + "value": "=" + }, + { + "name": "questionMark", + "value": "?" + }, + { + "name": "atSign", + "value": "@" + }, + { + "name": "caret", + "value": "^" + }, + { + "name": "underscore", + "value": "_" + }, + { + "name": "tilde", + "value": "~" + } + ] + } + }, + "excludePiiCategories": { + "type": "array", + "description": "List of categories that need to be excluded instead of included.", + "items": { + "$ref": "#/definitions/ConversationPiiCategoriesExclude" + } + } + } + }, + "ConversationPrediction": { + "type": "object", + "description": "Represents the prediction section of a Conversation project.", + "properties": { + "intents": { + "type": "array", + "description": "The intent classification results.", + "items": { + "$ref": "#/definitions/ConversationIntent" + }, + "x-ms-identifiers": [] + }, + "entities": { + "type": "array", + "description": "The entity extraction results.", + "items": { + "$ref": "#/definitions/ConversationEntity" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "intents", + "entities" + ], + "allOf": [ + { + "$ref": "#/definitions/BasePrediction" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "ConversationRequestStatistics": { + "type": "object", + "description": "if showStats=true was specified in the request, this field contains information about the request payload.", + "properties": { + "documentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of documents submitted in the request." + }, + "validDocumentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of valid documents. This excludes empty, over-size limit or non-supported languages documents." + }, + "erroneousDocumentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of invalid documents. This includes empty, over-size limit or non-supported languages documents." + }, + "transactionsCount": { + "type": "integer", + "format": "int64", + "description": "Number of transactions for the request." + }, + "conversationsCount": { + "type": "integer", + "format": "int32", + "description": "Number of conversations submitted in the request." + }, + "validConversationsCount": { + "type": "integer", + "format": "int32", + "description": "Number of conversation documents. This excludes documents that are empty, over the size limit, or in unsupported languages." + }, + "erroneousConversationsCount": { + "type": "integer", + "format": "int32", + "description": "Number of invalid documents. This includes documents that are empty, over the size limit, or in unsupported languages." + } + }, + "required": [ + "documentsCount", + "validDocumentsCount", + "erroneousDocumentsCount", + "transactionsCount", + "conversationsCount", + "validConversationsCount", + "erroneousConversationsCount" + ] + }, + "ConversationResult": { + "type": "object", + "description": "The response returned by a Conversation project.", + "properties": { + "query": { + "type": "string", + "description": "The same query given in request." + }, + "detectedLanguage": { + "type": "string", + "description": "The detected language from the query in BCP 47 language representation." + }, + "prediction": { + "$ref": "#/definitions/ConversationPrediction", + "description": "The predicted result for the query." + } + }, + "required": [ + "query" + ] + }, + "ConversationSentimentItemResult": { + "type": "object", + "description": "Sentiment operation results for a conversation items", + "properties": { + "id": { + "type": "string", + "description": "The identifier for the conversation item" + }, + "participantId": { + "type": "string", + "description": "The identifier for the speaker" + }, + "sentiment": { + "$ref": "#/definitions/TextSentiment", + "description": "Predicted sentiment" + }, + "confidenceScores": { + "$ref": "#/definitions/SentimentConfidenceScores", + "description": "Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative." + } + }, + "required": [ + "id", + "participantId", + "sentiment", + "confidenceScores" + ] + }, + "ConversationSentimentResults": { + "type": "object", + "description": "The result from sentiment analysis operation for each conversation.", + "properties": { + "errors": { + "type": "array", + "description": "Errors by document id.", + "items": { + "$ref": "#/definitions/DocumentError" + } + }, + "statistics": { + "$ref": "#/definitions/RequestStatistics", + "description": "statistics" + }, + "modelVersion": { + "type": "string", + "description": "This field indicates which model is used for scoring." + }, + "conversations": { + "type": "array", + "description": "Array of ConversationSentimentResults", + "items": { + "$ref": "#/definitions/ConversationSentimentResultsConversation" + } + } + }, + "required": [ + "errors", + "modelVersion", + "conversations" + ] + }, + "ConversationSentimentResultsConversation": { + "type": "object", + "description": "The result from sentiment analysis operation for each conversation.", + "properties": { + "id": { + "type": "string", + "description": "Unique, non-empty conversation identifier." + }, + "warnings": { + "type": "array", + "description": "Warnings encountered in processing the document.", + "items": { + "$ref": "#/definitions/InputWarning" + }, + "x-ms-identifiers": [] + }, + "statistics": { + "$ref": "#/definitions/ConversationStatistics", + "description": "If showStats=true was specified in the request this field will contain information about the conversation payload." + }, + "conversationItems": { + "type": "array", + "description": "Enumeration of Sentiment operation results for all the conversation items in a conversation.", + "items": { + "$ref": "#/definitions/ConversationSentimentItemResult" + } + } + }, + "required": [ + "id", + "warnings", + "conversationItems" + ] + }, + "ConversationStatistics": { + "type": "object", + "description": "If showStats=true was specified in the request, this field contains information about the conversation payload.", + "properties": { + "transactionsCount": { + "type": "integer", + "format": "int32", + "description": "Number of text units for the request." + } + }, + "required": [ + "transactionsCount" + ] + }, + "ConversationSummarizationTaskParameters": { + "type": "object", + "description": "Supported parameters for pre-build conversational summarization task.", + "properties": { + "loggingOptOut": { + "type": "boolean", + "description": "logging opt out", + "default": false + }, + "modelVersion": { + "type": "string", + "description": "model version", + "default": "latest" + }, + "sentenceCount": { + "type": "integer", + "format": "int32", + "description": "It controls the approximate number of sentences in the output summaries." + }, + "stringIndexType": { + "type": "string", + "description": "String index type", + "default": "TextElements_v8", + "enum": [ + "TextElements_v8", + "UnicodeCodePoint", + "Utf16CodeUnit" + ], + "x-ms-enum": { + "name": "StringIndexType", + "modelAsString": true, + "values": [ + { + "name": "TextElements_v8", + "value": "TextElements_v8", + "description": "Returned offset and length values will correspond to TextElements (Graphemes and Grapheme clusters) confirming to the Unicode 8.0.0 standard. Use this option if your application is written in .Net Framework or .Net Core and you will be using StringInfo." + }, + { + "name": "UnicodeCodePoint", + "value": "UnicodeCodePoint", + "description": "Returned offset and length values will correspond to Unicode code points. Use this option if your application is written in a language that support Unicode, for example Python." + }, + { + "name": "Utf16CodeUnit", + "value": "Utf16CodeUnit", + "description": "Returned 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." + } + ] + } + }, + "summaryLength": { + "$ref": "#/definitions/SummaryLengthBucket", + "description": "(NOTE: Recommended to use summaryLength over sentenceCount) Controls the approximate length of the output summaries." + }, + "summaryAspects": { + "type": "array", + "description": "Array of Summary Aspects", + "items": { + "$ref": "#/definitions/SummaryAspect" + } + } + }, + "required": [ + "summaryAspects" + ] + }, + "ConversationTargetIntentResult": { + "type": "object", + "description": "A wrap up of Conversation project response.", + "properties": { + "result": { + "$ref": "#/definitions/ConversationResult", + "description": "The actual response from a Conversation project." + } + }, + "allOf": [ + { + "$ref": "#/definitions/TargetIntentResult" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "ConversationTaskParameters": { + "type": "object", + "description": "Input parameters necessary for a Conversation task.", + "properties": { + "projectName": { + "type": "string", + "description": "The name of the project to use." + }, + "deploymentName": { + "type": "string", + "description": "The name of the deployment to use." + }, + "verbose": { + "type": "boolean", + "description": "If true, the service will return more detailed information in the response." + }, + "isLoggingEnabled": { + "type": "boolean", + "description": "If true, the service will keep the query for further review." + }, + "stringIndexType": { + "type": "string", + "description": "Specifies the method used to interpret string offsets. Defaults to Text Elements (Graphemes) according to Unicode v8.0.0. For additional information see https://aka.ms/text-analytics-offsets.", + "default": "TextElements_v8", + "enum": [ + "TextElements_v8", + "UnicodeCodePoint", + "Utf16CodeUnit" + ], + "x-ms-enum": { + "name": "StringIndexType", + "modelAsString": true, + "values": [ + { + "name": "TextElements_v8", + "value": "TextElements_v8", + "description": "Returned offset and length values will correspond to TextElements (Graphemes and Grapheme clusters) confirming to the Unicode 8.0.0 standard. Use this option if your application is written in .Net Framework or .Net Core and you will be using StringInfo." + }, + { + "name": "UnicodeCodePoint", + "value": "UnicodeCodePoint", + "description": "Returned offset and length values will correspond to Unicode code points. Use this option if your application is written in a language that support Unicode, for example Python." + }, + { + "name": "Utf16CodeUnit", + "value": "Utf16CodeUnit", + "description": "Returned 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." + } + ] + } + }, + "directTarget": { + "type": "string", + "description": "The name of a target project to forward the request to." + }, + "targetProjectParameters": { + "type": "object", + "description": "A dictionary representing the parameters for each target project.", + "additionalProperties": { + "$ref": "#/definitions/AnalysisParameters" + } + } + }, + "required": [ + "projectName", + "deploymentName" + ] + }, + "ConversationalPiiResultWithResultBase": { + "type": "object", + "description": "Conversation PII result item", + "properties": { + "id": { + "type": "string", + "description": "Unique, non-empty conversation identifier." + }, + "warnings": { + "type": "array", + "description": "Warnings encountered in processing the document.", + "items": { + "$ref": "#/definitions/InputWarning" + }, + "x-ms-identifiers": [] + }, + "statistics": { + "$ref": "#/definitions/ConversationStatistics", + "description": "If showStats=true was specified in the request this field will contain information about the conversation payload." + }, + "conversationItems": { + "type": "array", + "description": "List of conversationItems", + "items": { + "$ref": "#/definitions/ConversationPiiItemResult" + } + } + }, + "required": [ + "id", + "warnings", + "conversationItems" + ] + }, + "ConversationalTask": { + "type": "object", + "description": "The input for a custom conversation task.", + "properties": { + "analysisInput": { + "$ref": "#/definitions/ConversationAnalysisOptions", + "description": "The input ConversationItem and its optional parameters" + }, + "parameters": { + "$ref": "#/definitions/ConversationTaskParameters", + "description": "Input parameters necessary for a Conversation task." + } + }, + "required": [ + "analysisInput", + "parameters" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationTask" + } + ], + "x-ms-discriminator-value": "Conversation" + }, + "ConversationalTaskResult": { + "type": "object", + "description": "The results of a Conversation task.", + "properties": { + "result": { + "$ref": "#/definitions/AnalyzeConversationResult", + "description": "Represents a conversation analysis response." + } + }, + "required": [ + "result" + ], + "allOf": [ + { + "$ref": "#/definitions/AnalyzeConversationTaskResult" + } + ], + "x-ms-discriminator-value": "ConversationResult" + }, + "ConversationsSummaryResult": { + "type": "object", + "description": "Conversations Summary Result", + "properties": { + "id": { + "type": "string", + "description": "Unique, non-empty conversation identifier." + }, + "warnings": { + "type": "array", + "description": "Warnings encountered in processing the document.", + "items": { + "$ref": "#/definitions/InputWarning" + }, + "x-ms-identifiers": [] + }, + "statistics": { + "$ref": "#/definitions/ConversationStatistics", + "description": "If showStats=true was specified in the request this field will contain information about the conversation payload." + }, + "summaries": { + "type": "array", + "description": "array of summaries", + "items": { + "$ref": "#/definitions/SummaryResultItem" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "id", + "warnings", + "summaries" + ] + }, + "CurrencyResolution": { + "type": "object", + "description": "Represents the currency entity resolution model.", + "properties": { + "ISO4217": { + "type": "string", + "description": "The alphabetic code based on another ISO standard, ISO 3166, which lists the codes for country names. The first two letters of the ISO 4217 three-letter code are the same as the code for the country name, and, where possible, the third letter corresponds to the first letter of the currency name.", + "x-ms-client-name": "iso4217" + }, + "value": { + "type": "number", + "format": "double", + "description": "The money amount captured in the extracted entity" + }, + "unit": { + "type": "string", + "description": "The unit of the amount captured in the extracted entity" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "CurrencyResolution" + }, + "DateTimeResolution": { + "type": "object", + "description": "A resolution for datetime entity instances.", + "properties": { + "timex": { + "type": "string", + "description": "An extended ISO 8601 date/time representation as described in (https://github.com/Microsoft/Recognizers-Text/blob/master/Patterns/English/English-DateTime.yaml)" + }, + "dateTimeSubKind": { + "$ref": "#/definitions/DateTimeSubKind", + "description": "The DateTime SubKind" + }, + "value": { + "type": "string", + "description": "The actual time that the extracted text denote." + }, + "modifier": { + "$ref": "#/definitions/TemporalModifier", + "description": "An optional modifier of a date/time instance." + } + }, + "required": [ + "timex", + "dateTimeSubKind", + "value" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "DateTimeResolution" + }, + "DateTimeSubKind": { + "type": "string", + "description": "The Datetime SubKind.", + "enum": [ + "Time", + "Date", + "DateTime", + "Duration", + "Set" + ], + "x-ms-enum": { + "name": "DateTimeSubKind", + "modelAsString": true, + "values": [ + { + "name": "Time", + "value": "Time" + }, + { + "name": "Date", + "value": "Date" + }, + { + "name": "DateTime", + "value": "DateTime" + }, + { + "name": "Duration", + "value": "Duration" + }, + { + "name": "Set", + "value": "Set" + } + ] + } + }, + "DocumentError": { + "type": "object", + "description": "Contains details of errors encountered during a job execution.", + "properties": { + "id": { + "type": "string", + "description": "The ID of the input document." + }, + "error": { + "$ref": "#/definitions/Error", + "description": "Error encountered." + } + }, + "required": [ + "id", + "error" + ] + }, + "Entity": { + "type": "object", + "description": "Text that has been categorized into pre-defined classes or types such as: person, location, event, product, and organization.", + "properties": { + "text": { + "type": "string", + "description": "Entity text as appears in the request." + }, + "category": { + "type": "string", + "description": "Entity type." + }, + "subcategory": { + "type": "string", + "description": "(Optional) Entity sub type." + }, + "offset": { + "type": "integer", + "format": "int32", + "description": "Start position for the entity text. Use of different 'stringIndexType' values can affect the offset returned." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "Length for the entity text. Use of different 'stringIndexType' values can affect the length returned." + }, + "confidenceScore": { + "type": "number", + "format": "double", + "description": "Confidence score between 0 and 1 of the extracted entity." + } + }, + "required": [ + "text", + "category", + "offset", + "length", + "confidenceScore" + ] + }, + "EntitySubtype": { + "type": "object", + "description": "The concrete entity Subtype model of extra information.", + "properties": { + "value": { + "type": "string", + "description": "The Subtype of an extracted entity type." + } + }, + "allOf": [ + { + "$ref": "#/definitions/BaseExtraInformation" + } + ], + "x-ms-discriminator-value": "EntitySubtype" + }, + "Error": { + "type": "object", + "description": "The error object.", + "properties": { + "code": { + "$ref": "#/definitions/ErrorCode", + "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/Error" + }, + "x-ms-identifiers": [] + }, + "innererror": { + "$ref": "#/definitions/InnerErrorModel", + "description": "An object containing more specific information than the current object about the error." + } + }, + "required": [ + "code", + "message" + ] + }, + "ErrorCode": { + "type": "string", + "description": "Human-readable error code.", + "enum": [ + "InvalidRequest", + "InvalidArgument", + "Unauthorized", + "Forbidden", + "NotFound", + "ProjectNotFound", + "OperationNotFound", + "AzureCognitiveSearchNotFound", + "AzureCognitiveSearchIndexNotFound", + "TooManyRequests", + "AzureCognitiveSearchThrottling", + "AzureCognitiveSearchIndexLimitReached", + "InternalServerError", + "ServiceUnavailable", + "Timeout", + "QuotaExceeded", + "Conflict", + "Warning" + ], + "x-ms-enum": { + "name": "ErrorCode", + "modelAsString": true, + "values": [ + { + "name": "InvalidRequest", + "value": "InvalidRequest" + }, + { + "name": "InvalidArgument", + "value": "InvalidArgument" + }, + { + "name": "Unauthorized", + "value": "Unauthorized" + }, + { + "name": "Forbidden", + "value": "Forbidden" + }, + { + "name": "NotFound", + "value": "NotFound" + }, + { + "name": "ProjectNotFound", + "value": "ProjectNotFound" + }, + { + "name": "OperationNotFound", + "value": "OperationNotFound" + }, + { + "name": "AzureCognitiveSearchNotFound", + "value": "AzureCognitiveSearchNotFound" + }, + { + "name": "AzureCognitiveSearchIndexNotFound", + "value": "AzureCognitiveSearchIndexNotFound" + }, + { + "name": "TooManyRequests", + "value": "TooManyRequests" + }, + { + "name": "AzureCognitiveSearchThrottling", + "value": "AzureCognitiveSearchThrottling" + }, + { + "name": "AzureCognitiveSearchIndexLimitReached", + "value": "AzureCognitiveSearchIndexLimitReached" + }, + { + "name": "InternalServerError", + "value": "InternalServerError" + }, + { + "name": "ServiceUnavailable", + "value": "ServiceUnavailable" + }, + { + "name": "Timeout", + "value": "Timeout" + }, + { + "name": "QuotaExceeded", + "value": "QuotaExceeded" + }, + { + "name": "Conflict", + "value": "Conflict" + }, + { + "name": "Warning", + "value": "Warning" + } + ] + } + }, + "ErrorResponse": { + "type": "object", + "description": "Error response.", + "properties": { + "error": { + "$ref": "#/definitions/Error", + "description": "The error object." + } + }, + "required": [ + "error" + ] + }, + "ErrorResponseWithHeader": { + "type": "object", + "description": "Error response.", + "properties": { + "error": { + "$ref": "#/definitions/Error", + "description": "The error object." + } + }, + "required": [ + "error" + ] + }, + "ExtraInformationKind": { + "type": "string", + "description": "The extra information object kind.", + "enum": [ + "EntitySubtype", + "ListKey", + "RegexKey" + ], + "x-ms-enum": { + "name": "ExtraInformationKind", + "modelAsString": true, + "values": [ + { + "name": "EntitySubtype", + "value": "EntitySubtype" + }, + { + "name": "ListKey", + "value": "ListKey" + }, + { + "name": "RegexKey", + "value": "RegexKey" + } + ] + } + }, + "InformationResolution": { + "type": "object", + "description": "Represents the information (data) entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/InformationUnit", + "description": "The information (data) Unit of measurement." + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "InformationResolution" + }, + "InformationUnit": { + "type": "string", + "description": "The information (data) Unit of measurement.", + "enum": [ + "Unspecified", + "Bit", + "Kilobit", + "Megabit", + "Gigabit", + "Terabit", + "Petabit", + "Byte", + "Kilobyte", + "Megabyte", + "Gigabyte", + "Terabyte", + "Petabyte" + ], + "x-ms-enum": { + "name": "InformationUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Bit", + "value": "Bit" + }, + { + "name": "Kilobit", + "value": "Kilobit" + }, + { + "name": "Megabit", + "value": "Megabit" + }, + { + "name": "Gigabit", + "value": "Gigabit" + }, + { + "name": "Terabit", + "value": "Terabit" + }, + { + "name": "Petabit", + "value": "Petabit" + }, + { + "name": "Byte", + "value": "Byte" + }, + { + "name": "Kilobyte", + "value": "Kilobyte" + }, + { + "name": "Megabyte", + "value": "Megabyte" + }, + { + "name": "Gigabyte", + "value": "Gigabyte" + }, + { + "name": "Terabyte", + "value": "Terabyte" + }, + { + "name": "Petabyte", + "value": "Petabyte" + } + ] + } + }, + "InnerErrorCode": { + "type": "string", + "description": "Human-readable error code.", + "enum": [ + "InvalidRequest", + "InvalidParameterValue", + "KnowledgeBaseNotFound", + "AzureCognitiveSearchNotFound", + "AzureCognitiveSearchThrottling", + "ExtractionFailure", + "InvalidRequestBodyFormat", + "EmptyRequest", + "MissingInputDocuments", + "InvalidDocument", + "ModelVersionIncorrect", + "InvalidDocumentBatch", + "UnsupportedLanguageCode", + "InvalidCountryHint" + ], + "x-ms-enum": { + "name": "InnerErrorCode", + "modelAsString": true, + "values": [ + { + "name": "InvalidRequest", + "value": "InvalidRequest" + }, + { + "name": "InvalidParameterValue", + "value": "InvalidParameterValue" + }, + { + "name": "KnowledgeBaseNotFound", + "value": "KnowledgeBaseNotFound" + }, + { + "name": "AzureCognitiveSearchNotFound", + "value": "AzureCognitiveSearchNotFound" + }, + { + "name": "AzureCognitiveSearchThrottling", + "value": "AzureCognitiveSearchThrottling" + }, + { + "name": "ExtractionFailure", + "value": "ExtractionFailure" + }, + { + "name": "InvalidRequestBodyFormat", + "value": "InvalidRequestBodyFormat" + }, + { + "name": "EmptyRequest", + "value": "EmptyRequest" + }, + { + "name": "MissingInputDocuments", + "value": "MissingInputDocuments" + }, + { + "name": "InvalidDocument", + "value": "InvalidDocument" + }, + { + "name": "ModelVersionIncorrect", + "value": "ModelVersionIncorrect" + }, + { + "name": "InvalidDocumentBatch", + "value": "InvalidDocumentBatch" + }, + { + "name": "UnsupportedLanguageCode", + "value": "UnsupportedLanguageCode" + }, + { + "name": "InvalidCountryHint", + "value": "InvalidCountryHint" + } + ] + } + }, + "InnerErrorModel": { + "type": "object", + "description": "An object containing more specific information about the error. As per Microsoft One API guidelines - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.", + "properties": { + "code": { + "$ref": "#/definitions/InnerErrorCode", + "description": "One of a server-defined set of error codes." + }, + "message": { + "type": "string", + "description": "Error message." + }, + "details": { + "type": "object", + "description": "Error details.", + "additionalProperties": { + "type": "string" + } + }, + "target": { + "type": "string", + "description": "Error target." + }, + "innererror": { + "$ref": "#/definitions/InnerErrorModel", + "description": "An object containing more specific information than the current object about the error." + } + }, + "required": [ + "code", + "message" + ] + }, + "InputModality": { + "type": "string", + "description": "Enumeration of supported conversational modalities.", + "enum": [ + "transcript", + "text" + ], + "x-ms-enum": { + "name": "InputModality", + "modelAsString": true, + "values": [ + { + "name": "transcript", + "value": "transcript" + }, + { + "name": "text", + "value": "text" + } + ] + } + }, + "InputWarning": { + "type": "object", + "description": "Contains details of warnings encountered during a job execution.", + "properties": { + "code": { + "type": "string", + "description": "Warning code." + }, + "message": { + "type": "string", + "description": "Warning message." + }, + "targetRef": { + "type": "string", + "description": "A JSON pointer reference indicating the target object." + } + }, + "required": [ + "code", + "message" + ] + }, + "ItemizedSummaryContext": { + "type": "object", + "description": "Context of the summary with a conversation item ID.", + "properties": { + "offset": { + "type": "integer", + "format": "int32", + "description": "Start position for the context. Use of different 'stringIndexType' values can affect the offset returned." + }, + "length": { + "type": "integer", + "format": "int32", + "description": "The length of the context. Use of different 'stringIndexType' values can affect the length returned." + }, + "conversationItemId": { + "type": "string", + "description": "Reference to the ID of ConversationItem." + } + }, + "required": [ + "offset", + "length", + "conversationItemId" + ] + }, + "KnowledgeBaseAnswer": { + "type": "object", + "description": "Represents knowledge base answer.", + "properties": { + "questions": { + "type": "array", + "description": "List of questions associated with the answer.", + "items": { + "type": "string" + } + }, + "answer": { + "type": "string", + "description": "Answer text." + }, + "confidenceScore": { + "type": "number", + "format": "double", + "description": "Answer confidence score, value ranges from 0 to 1.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidence" + }, + "id": { + "type": "integer", + "format": "int32", + "description": "ID of the QnA result.", + "x-ms-client-name": "qnaId" + }, + "source": { + "type": "string", + "description": "Source of QnA result." + }, + "metadata": { + "type": "object", + "description": "Metadata associated with the answer, useful to categorize or filter question answers.", + "additionalProperties": { + "type": "string" + } + }, + "dialog": { + "$ref": "#/definitions/KnowledgeBaseAnswerDialog", + "description": "Dialog associated with Answer." + }, + "answerSpan": { + "$ref": "#/definitions/AnswerSpan", + "description": "Answer span object of QnA with respect to user's question.", + "x-ms-client-name": "shortAnswer" + } + } + }, + "KnowledgeBaseAnswerContext": { + "type": "object", + "description": "Context object with previous QnA's information.", + "properties": { + "previousQnaId": { + "type": "integer", + "format": "int32", + "description": "Previous turn top answer result QnA ID." + }, + "previousUserQuery": { + "type": "string", + "description": "Previous user query.", + "x-ms-client-name": "previousQuestion" + } + }, + "required": [ + "previousQnaId" + ] + }, + "KnowledgeBaseAnswerDialog": { + "type": "object", + "description": "Dialog associated with Answer.", + "properties": { + "isContextOnly": { + "type": "boolean", + "description": "To mark if a prompt is relevant only with a previous question or not. If true, do not include this QnA as search result for queries without context; otherwise, if false, ignores context and includes this QnA in search result." + }, + "prompts": { + "type": "array", + "description": "List of prompts associated with the answer.", + "maxItems": 20, + "items": { + "$ref": "#/definitions/KnowledgeBaseAnswerPrompt" + }, + "x-ms-identifiers": [] + } + } + }, + "KnowledgeBaseAnswerPrompt": { + "type": "object", + "description": "Prompt for an answer.", + "properties": { + "displayOrder": { + "type": "integer", + "format": "int32", + "description": "Index of the prompt - used in ordering of the prompts." + }, + "qnaId": { + "type": "integer", + "format": "int32", + "description": "QnA ID corresponding to the prompt." + }, + "displayText": { + "type": "string", + "description": "Text displayed to represent a follow up question prompt.", + "maxLength": 200 + } + } + }, + "LengthResolution": { + "type": "object", + "description": "Represents the length entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/LengthUnit", + "description": "The length Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "LengthResolution" + }, + "LengthUnit": { + "type": "string", + "description": "The length unit of measurement.", + "enum": [ + "Unspecified", + "Kilometer", + "Hectometer", + "Decameter", + "Meter", + "Decimeter", + "Centimeter", + "Millimeter", + "Micrometer", + "Nanometer", + "Picometer", + "Mile", + "Yard", + "Inch", + "Foot", + "LightYear", + "Pt" + ], + "x-ms-enum": { + "name": "LengthUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Kilometer", + "value": "Kilometer" + }, + { + "name": "Hectometer", + "value": "Hectometer" + }, + { + "name": "Decameter", + "value": "Decameter" + }, + { + "name": "Meter", + "value": "Meter" + }, + { + "name": "Decimeter", + "value": "Decimeter" + }, + { + "name": "Centimeter", + "value": "Centimeter" + }, + { + "name": "Millimeter", + "value": "Millimeter" + }, + { + "name": "Micrometer", + "value": "Micrometer" + }, + { + "name": "Nanometer", + "value": "Nanometer" + }, + { + "name": "Picometer", + "value": "Picometer" + }, + { + "name": "Mile", + "value": "Mile" + }, + { + "name": "Yard", + "value": "Yard" + }, + { + "name": "Inch", + "value": "Inch" + }, + { + "name": "Foot", + "value": "Foot" + }, + { + "name": "LightYear", + "value": "LightYear" + }, + { + "name": "Pt", + "value": "Pt" + } + ] + } + }, + "ListKey": { + "type": "object", + "description": "The list key extra data kind.", + "properties": { + "key": { + "type": "string", + "description": "The canonical form of the extracted entity." + } + }, + "allOf": [ + { + "$ref": "#/definitions/BaseExtraInformation" + } + ], + "x-ms-discriminator-value": "ListKey" + }, + "LuisCallingOptions": { + "type": "object", + "description": "This customizes how the service calls LUIS Generally Available projects.", + "properties": { + "verbose": { + "type": "boolean", + "description": "Enable verbose response." + }, + "log": { + "type": "boolean", + "description": "Save log to add in training utterances later." + }, + "show-all-intents": { + "type": "boolean", + "description": "Set true to show all intents." + }, + "timezoneOffset": { + "type": "integer", + "format": "int32", + "description": "The timezone offset for the location of the request." + }, + "spellCheck": { + "type": "boolean", + "description": "Enable spell checking." + }, + "bing-spell-check-subscription-key": { + "type": "string", + "description": "The subscription key to use when enabling Bing spell check" + } + } + }, + "LuisParameters": { + "type": "object", + "description": "This is a set of request parameters for LUIS Generally Available projects.", + "properties": { + "query": { + "type": "string", + "description": "The utterance to predict.", + "maxLength": 500 + }, + "callingOptions": { + "$ref": "#/definitions/LuisCallingOptions", + "description": "This customizes how the service calls LUIS Generally Available projects." + } + }, + "additionalProperties": {}, + "allOf": [ + { + "$ref": "#/definitions/AnalysisParameters" + } + ], + "x-ms-discriminator-value": "Luis" + }, + "LuisTargetIntentResult": { + "type": "object", + "description": "It is a wrap up of LUIS Generally Available response.", + "properties": { + "result": { + "type": "object", + "description": "The actual response from a LUIS Generally Available application." + } + }, + "allOf": [ + { + "$ref": "#/definitions/TargetIntentResult" + } + ], + "x-ms-discriminator-value": "Luis" + }, + "MetadataFilter": { + "type": "object", + "description": "Find QnAs that are associated with the given list of metadata.", + "properties": { + "metadata": { + "type": "array", + "description": "List of metadata.", + "items": { + "$ref": "#/definitions/MetadataRecord" + }, + "x-ms-identifiers": [] + }, + "logicalOperation": { + "type": "string", + "description": "Operation used to join metadata filters.", + "default": "AND", + "enum": [ + "AND", + "OR" + ], + "x-ms-enum": { + "name": "LogicalOperationKind", + "modelAsString": true, + "values": [ + { + "name": "AND", + "value": "AND" + }, + { + "name": "OR", + "value": "OR" + } + ] + } + } + } + }, + "MetadataRecord": { + "type": "object", + "description": "Object to provide the key value pair for each metadata.", + "properties": { + "key": { + "type": "string", + "description": "Metadata Key from Metadata dictionary used in the QnA." + }, + "value": { + "type": "string", + "description": "Metadata Value from Metadata dictionary used in the QnA." + } + }, + "required": [ + "key", + "value" + ] + }, + "MultiLanguageConversationAnalysisInput": { + "type": "object", + "description": "Multi Language Conversation Analysis Input", + "properties": { + "conversations": { + "type": "array", + "description": "Array of conversation items", + "items": { + "$ref": "#/definitions/Conversation" + } + } + }, + "required": [ + "conversations" + ] + }, + "NoneLinkedTargetIntentResult": { + "type": "object", + "description": "A wrap up of non-linked intent response.", + "properties": { + "result": { + "$ref": "#/definitions/ConversationResult", + "description": "The actual response from a Conversation project." + } + }, + "allOf": [ + { + "$ref": "#/definitions/TargetIntentResult" + } + ], + "x-ms-discriminator-value": "NonLinked" + }, + "NumberKind": { + "type": "string", + "description": "The type of the extracted number entity.", + "enum": [ + "Integer", + "Decimal", + "Power", + "Fraction", + "Percent", + "Unspecified" + ], + "x-ms-enum": { + "name": "NumberKind", + "modelAsString": true, + "values": [ + { + "name": "Integer", + "value": "Integer" + }, + { + "name": "Decimal", + "value": "Decimal" + }, + { + "name": "Power", + "value": "Power" + }, + { + "name": "Fraction", + "value": "Fraction" + }, + { + "name": "Percent", + "value": "Percent" + }, + { + "name": "Unspecified", + "value": "Unspecified" + } + ] + } + }, + "NumberResolution": { + "type": "object", + "description": "A resolution for numeric entity instances.", + "properties": { + "numberKind": { + "$ref": "#/definitions/NumberKind", + "description": "The type of the extracted number entity." + }, + "value": { + "type": "number", + "format": "double", + "description": "A numeric representation of what the extracted text denotes." + } + }, + "required": [ + "numberKind", + "value" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "NumberResolution" + }, + "NumericRangeResolution": { + "type": "object", + "description": "represents the resolution of numeric intervals.", + "properties": { + "rangeKind": { + "$ref": "#/definitions/RangeKind", + "description": "The kind of range that the resolution object represents." + }, + "minimum": { + "type": "number", + "format": "double", + "description": "The beginning value of the interval." + }, + "maximum": { + "type": "number", + "format": "double", + "description": "The ending value of the interval." + } + }, + "required": [ + "rangeKind", + "minimum", + "maximum" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "NumericRangeResolution" + }, + "OrchestrationPrediction": { + "type": "object", + "description": "This represents the prediction result of an Orchestration project.", + "properties": { + "intents": { + "type": "object", + "description": "A dictionary that contains all intents. A key is an intent name and a value is its confidence score and target type. The top intent's value also contains the actual response from the target project.", + "additionalProperties": { + "$ref": "#/definitions/TargetIntentResult" + } + } + }, + "required": [ + "intents" + ], + "allOf": [ + { + "$ref": "#/definitions/BasePrediction" + } + ], + "x-ms-discriminator-value": "Orchestration" + }, + "OrdinalResolution": { + "type": "object", + "description": "A resolution for ordinal numbers entity instances.", + "properties": { + "offset": { + "type": "string", + "description": "The offset With respect to the reference (e.g., offset = -1 in \"show me the second to last\"" + }, + "relativeTo": { + "$ref": "#/definitions/RelativeTo", + "description": "The reference point that the ordinal number denotes." + }, + "value": { + "type": "string", + "description": "A simple arithmetic expression that the ordinal denotes." + } + }, + "required": [ + "offset", + "relativeTo", + "value" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "OrdinalResolution" + }, + "QueryFilters": { + "type": "object", + "description": "filters over knowledge base.", + "properties": { + "metadataFilter": { + "$ref": "#/definitions/MetadataFilter", + "description": "filters over knowledge base." + }, + "sourceFilter": { + "$ref": "#/definitions/SourceFilter", + "description": "filters over knowledge base." + }, + "logicalOperation": { + "type": "string", + "description": "Logical operation used to join metadata filter with source filter.", + "default": "AND", + "enum": [ + "AND", + "OR" + ], + "x-ms-enum": { + "name": "LogicalOperationKind", + "modelAsString": true, + "values": [ + { + "name": "AND", + "value": "AND" + }, + { + "name": "OR", + "value": "OR" + } + ] + } + } + } + }, + "QuestionAnsweringParameters": { + "type": "object", + "description": "This is a set of request parameters for Question Answering knowledge bases.", + "properties": { + "callingOptions": { + "$ref": "#/definitions/AnswersOptions", + "description": "The options sent to a Question Answering KB." + } + }, + "allOf": [ + { + "$ref": "#/definitions/AnalysisParameters" + } + ], + "x-ms-discriminator-value": "QuestionAnswering" + }, + "QuestionAnsweringTargetIntentResult": { + "type": "object", + "description": "It is a wrap up a Question Answering KB response.", + "properties": { + "result": { + "$ref": "#/definitions/AnswersResult", + "description": "The generated answer by a Question Answering KB." + } + }, + "allOf": [ + { + "$ref": "#/definitions/TargetIntentResult" + } + ], + "x-ms-discriminator-value": "QuestionAnswering" + }, + "RangeKind": { + "type": "string", + "description": "The kind of range that the resolution object represents.", + "enum": [ + "Number", + "Speed", + "Weight", + "Length", + "Volume", + "Area", + "Age", + "Information", + "Temperature", + "Currency" + ], + "x-ms-enum": { + "name": "RangeKind", + "modelAsString": true, + "values": [ + { + "name": "Number", + "value": "Number" + }, + { + "name": "Speed", + "value": "Speed" + }, + { + "name": "Weight", + "value": "Weight" + }, + { + "name": "Length", + "value": "Length" + }, + { + "name": "Volume", + "value": "Volume" + }, + { + "name": "Area", + "value": "Area" + }, + { + "name": "Age", + "value": "Age" + }, + { + "name": "Information", + "value": "Information" + }, + { + "name": "Temperature", + "value": "Temperature" + }, + { + "name": "Currency", + "value": "Currency" + } + ] + } + }, + "RankerKind": { + "type": "string", + "description": "Type of ranker to be used", + "enum": [ + "Default", + "QuestionOnly" + ], + "x-ms-enum": { + "name": "RankerKind", + "modelAsString": true, + "values": [ + { + "name": "Default", + "value": "Default", + "description": "Default ranker." + }, + { + "name": "QuestionOnly", + "value": "QuestionOnly", + "description": "Question only ranker." + } + ] + } + }, + "RedactedTranscriptContent": { + "type": "object", + "description": "Transcript content response that the service generates, with all necessary personally identifiable information redacted.", + "properties": { + "itn": { + "type": "string", + "description": "Redacted output for input in inverse-text-normalized format." + }, + "maskedItn": { + "type": "string", + "description": "Redacted output for input in masked inverse-text-normalized format." + }, + "text": { + "type": "string", + "description": "Redacted output for input in text (Microsoft's speech-to-text 'display') format." + }, + "lexical": { + "type": "string", + "description": "Redacted output for input in lexical format." + }, + "audioTimings": { + "type": "array", + "description": "List of redacted audio segments.", + "items": { + "$ref": "#/definitions/AudioTiming" + }, + "x-ms-identifiers": [] + } + } + }, + "RegexKey": { + "type": "object", + "description": "The regex key extra data kind.", + "properties": { + "key": { + "type": "string", + "description": "The key of the regex pattern used in extracting the entity." + }, + "regexPattern": { + "type": "string", + "description": "The .NET regex pattern used in extracting the entity. Please visit https://docs.microsoft.com/dotnet/standard/base-types/regular-expressions for more information about .NET regular expressions." + } + }, + "allOf": [ + { + "$ref": "#/definitions/BaseExtraInformation" + } + ], + "x-ms-discriminator-value": "RegexKey" + }, + "RelativeTo": { + "type": "string", + "description": "The reference point that the ordinal number denotes.", + "enum": [ + "Current", + "End", + "Start" + ], + "x-ms-enum": { + "name": "RelativeTo", + "modelAsString": true, + "values": [ + { + "name": "Current", + "value": "Current" + }, + { + "name": "End", + "value": "End" + }, + { + "name": "Start", + "value": "Start" + } + ] + } + }, + "RequestStatistics": { + "type": "object", + "description": "if showStats=true was specified in the request this field will contain information about the request payload.", + "properties": { + "documentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of documents submitted in the request." + }, + "validDocumentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of valid documents. This excludes empty, over-size limit or non-supported languages documents." + }, + "erroneousDocumentsCount": { + "type": "integer", + "format": "int32", + "description": "Number of invalid documents. This includes empty, over-size limit or non-supported languages documents." + }, + "transactionsCount": { + "type": "integer", + "format": "int64", + "description": "Number of transactions for the request." + } + }, + "required": [ + "documentsCount", + "validDocumentsCount", + "erroneousDocumentsCount", + "transactionsCount" + ] + }, + "ResolutionKind": { + "type": "string", + "description": "The entity resolution object kind.", + "enum": [ + "BooleanResolution", + "DateTimeResolution", + "NumberResolution", + "OrdinalResolution", + "SpeedResolution", + "WeightResolution", + "LengthResolution", + "VolumeResolution", + "AreaResolution", + "AgeResolution", + "InformationResolution", + "TemperatureResolution", + "CurrencyResolution", + "NumericRangeResolution", + "TemporalSpanResolution" + ], + "x-ms-enum": { + "name": "ResolutionKind", + "modelAsString": true, + "values": [ + { + "name": "BooleanResolution", + "value": "BooleanResolution" + }, + { + "name": "DateTimeResolution", + "value": "DateTimeResolution" + }, + { + "name": "NumberResolution", + "value": "NumberResolution" + }, + { + "name": "OrdinalResolution", + "value": "OrdinalResolution" + }, + { + "name": "SpeedResolution", + "value": "SpeedResolution" + }, + { + "name": "WeightResolution", + "value": "WeightResolution" + }, + { + "name": "LengthResolution", + "value": "LengthResolution" + }, + { + "name": "VolumeResolution", + "value": "VolumeResolution" + }, + { + "name": "AreaResolution", + "value": "AreaResolution" + }, + { + "name": "AgeResolution", + "value": "AgeResolution" + }, + { + "name": "InformationResolution", + "value": "InformationResolution" + }, + { + "name": "TemperatureResolution", + "value": "TemperatureResolution" + }, + { + "name": "CurrencyResolution", + "value": "CurrencyResolution" + }, + { + "name": "NumericRangeResolution", + "value": "NumericRangeResolution" + }, + { + "name": "TemporalSpanResolution", + "value": "TemporalSpanResolution" + } + ] + } + }, + "SentimentConfidenceScores": { + "type": "object", + "description": "Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative.", + "properties": { + "positive": { + "type": "number", + "format": "double", + "description": "Confidence score for positive sentiment" + }, + "neutral": { + "type": "number", + "format": "double", + "description": "Confidence score for neutral sentiment" + }, + "negative": { + "type": "number", + "format": "double", + "description": "Confidence score for negative sentiment" + } + }, + "required": [ + "positive", + "neutral", + "negative" + ] + }, + "ShortAnswerOptions": { + "type": "object", + "description": "To configure Answer span prediction feature.", + "properties": { + "enable": { + "type": "boolean", + "description": "Enable or disable Answer Span prediction.", + "enum": [ + true + ] + }, + "confidenceScoreThreshold": { + "type": "number", + "format": "double", + "description": "Minimum threshold score required to include an answer span, value ranges from 0 to 1.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidenceThreshold" + }, + "topAnswersWithSpan": { + "type": "integer", + "format": "int32", + "description": "Number of Top answers to be considered for span prediction from 1 to 10.", + "minimum": 1, + "maximum": 10, + "x-ms-client-name": "top" + } + }, + "required": [ + "enable" + ] + }, + "SourceFilter": { + "type": "array", + "description": "Find QnAs that are associated with any of the given list of sources in knowledge base.", + "items": { + "type": "string" + } + }, + "SpeedResolution": { + "type": "object", + "description": "Represents the speed entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/SpeedUnit", + "description": "The speed Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "SpeedResolution" + }, + "SpeedUnit": { + "type": "string", + "description": "The speed Unit of measurement", + "enum": [ + "Unspecified", + "MetersPerSecond", + "KilometersPerHour", + "KilometersPerMinute", + "KilometersPerSecond", + "MilesPerHour", + "Knot", + "FootPerSecond", + "FootPerMinute", + "YardsPerMinute", + "YardsPerSecond", + "MetersPerMillisecond", + "CentimetersPerMillisecond", + "KilometersPerMillisecond" + ], + "x-ms-enum": { + "name": "SpeedUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "MetersPerSecond", + "value": "MetersPerSecond" + }, + { + "name": "KilometersPerHour", + "value": "KilometersPerHour" + }, + { + "name": "KilometersPerMinute", + "value": "KilometersPerMinute" + }, + { + "name": "KilometersPerSecond", + "value": "KilometersPerSecond" + }, + { + "name": "MilesPerHour", + "value": "MilesPerHour" + }, + { + "name": "Knot", + "value": "Knot" + }, + { + "name": "FootPerSecond", + "value": "FootPerSecond" + }, + { + "name": "FootPerMinute", + "value": "FootPerMinute" + }, + { + "name": "YardsPerMinute", + "value": "YardsPerMinute" + }, + { + "name": "YardsPerSecond", + "value": "YardsPerSecond" + }, + { + "name": "MetersPerMillisecond", + "value": "MetersPerMillisecond" + }, + { + "name": "CentimetersPerMillisecond", + "value": "CentimetersPerMillisecond" + }, + { + "name": "KilometersPerMillisecond", + "value": "KilometersPerMillisecond" + } + ] + } + }, + "State": { + "type": "string", + "description": "The status of the task at the mentioned last update time.", + "enum": [ + "notStarted", + "running", + "succeeded", + "partiallyCompleted", + "failed", + "cancelled", + "cancelling" + ], + "x-ms-enum": { + "name": "State", + "modelAsString": true, + "values": [ + { + "name": "notStarted", + "value": "notStarted" + }, + { + "name": "running", + "value": "running" + }, + { + "name": "succeeded", + "value": "succeeded" + }, + { + "name": "partiallyCompleted", + "value": "partiallyCompleted" + }, + { + "name": "failed", + "value": "failed" + }, + { + "name": "cancelled", + "value": "cancelled" + }, + { + "name": "cancelling", + "value": "cancelling" + } + ] + } + }, + "SummaryAspect": { + "type": "string", + "description": "Supported parameters for a conversational summarization task.", + "enum": [ + "issue", + "resolution", + "chapterTitle", + "narrative", + "recap" + ], + "x-ms-enum": { + "name": "SummaryAspect", + "modelAsString": true, + "values": [ + { + "name": "issue", + "value": "issue", + "description": "Summary of issues in transcripts of web chats and service calls between customer-service agents and customers." + }, + { + "name": "resolution", + "value": "resolution", + "description": "Summary of resolutions in transcripts of web chats and service calls between customer-service agents and customers." + }, + { + "name": "chapterTitle", + "value": "chapterTitle", + "description": "Chapter title of any conversation. It's usually one phrase or several phrases naturally combined. Long conversations tend to have more chapters. You can find the chapter boundary from the summary context." + }, + { + "name": "narrative", + "value": "narrative", + "description": "Generic narrative summary of any conversation. It generally converts the conversational language into formal written language, compresses the text length, and keeps the salient information." + }, + { + "name": "recap", + "value": "recap", + "description": "A concise one-paragraph summary to provide a quick overview." + } + ] + } + }, + "SummaryLengthBucket": { + "type": "string", + "description": "Enum that defines the length of the output summaries.", + "enum": [ + "short", + "medium", + "long" + ], + "x-ms-enum": { + "name": "SummaryLengthBucket", + "modelAsString": true, + "values": [ + { + "name": "short", + "value": "short", + "description": "Instructs model to generate shorter length summaries." + }, + { + "name": "medium", + "value": "medium", + "description": "Instructs model to generate medium length summaries." + }, + { + "name": "long", + "value": "long", + "description": "Instructs model to generate longer length summaries." + } + ] + } + }, + "SummaryResult": { + "type": "object", + "description": "Summary Results", + "properties": { + "conversations": { + "type": "array", + "description": "array of conversations", + "items": { + "$ref": "#/definitions/ConversationsSummaryResult" + } + }, + "errors": { + "type": "array", + "description": "Errors by document id.", + "items": { + "$ref": "#/definitions/DocumentError" + } + }, + "statistics": { + "$ref": "#/definitions/RequestStatistics", + "description": "statistics" + }, + "modelVersion": { + "type": "string", + "description": "This field indicates which model is used for scoring." + } + }, + "required": [ + "conversations", + "errors", + "modelVersion" + ] + }, + "SummaryResultItem": { + "type": "object", + "description": "Summary Result Item", + "properties": { + "aspect": { + "type": "string", + "description": "aspect" + }, + "text": { + "type": "string", + "description": "text" + }, + "contexts": { + "type": "array", + "description": "Context list of the summary.", + "items": { + "$ref": "#/definitions/ItemizedSummaryContext" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "aspect", + "text" + ] + }, + "TargetIntentResult": { + "type": "object", + "description": "This is the base class of an intent prediction", + "properties": { + "targetProjectKind": { + "$ref": "#/definitions/targetProjectKind", + "description": "This is the base class of an intent prediction" + }, + "apiVersion": { + "type": "string", + "description": "The API version used to call a target service." + }, + "confidenceScore": { + "type": "number", + "format": "double", + "description": "The prediction score and it ranges from 0.0 to 1.0.", + "minimum": 0, + "maximum": 1, + "x-ms-client-name": "confidence" + } + }, + "discriminator": "targetProjectKind", + "required": [ + "targetProjectKind", + "confidenceScore" + ] + }, + "Tasks": { + "type": "object", + "description": "Contains the state for the tasks that are being executed as part of the submitted job for analyzing a conversation.", + "properties": { + "completed": { + "type": "integer", + "format": "int32", + "description": "Count of tasks that finished successfully." + }, + "failed": { + "type": "integer", + "format": "int32", + "description": "Count of tasks that failed." + }, + "inProgress": { + "type": "integer", + "format": "int32", + "description": "Count of tasks that are currently in progress." + }, + "total": { + "type": "integer", + "format": "int32", + "description": "Total count of tasks submitted as part of the job." + }, + "items": { + "type": "array", + "description": "List of results from tasks (if available).", + "items": { + "$ref": "#/definitions/AnalyzeConversationJobResult" + }, + "x-ms-identifiers": [] + } + }, + "required": [ + "completed", + "failed", + "inProgress", + "total" + ] + }, + "TemperatureResolution": { + "type": "object", + "description": "Represents the temperature entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/TemperatureUnit", + "description": "The temperature Unit of measurement." + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "TemperatureResolution" + }, + "TemperatureUnit": { + "type": "string", + "description": "The temperature Unit of measurement.", + "enum": [ + "Unspecified", + "Fahrenheit", + "Kelvin", + "Rankine", + "Celsius" + ], + "x-ms-enum": { + "name": "TemperatureUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Fahrenheit", + "value": "Fahrenheit" + }, + { + "name": "Kelvin", + "value": "Kelvin" + }, + { + "name": "Rankine", + "value": "Rankine" + }, + { + "name": "Celsius", + "value": "Celsius" + } + ] + } + }, + "TemporalModifier": { + "type": "string", + "description": "An optional modifier of a date/time instance.", + "enum": [ + "AfterApprox", + "Before", + "BeforeStart", + "Approx", + "ReferenceUndefined", + "SinceEnd", + "AfterMid", + "Start", + "After", + "BeforeEnd", + "Until", + "End", + "Less", + "Since", + "AfterStart", + "BeforeApprox", + "Mid", + "More" + ], + "x-ms-enum": { + "name": "TemporalModifier", + "modelAsString": true, + "values": [ + { + "name": "AfterApprox", + "value": "AfterApprox" + }, + { + "name": "Before", + "value": "Before" + }, + { + "name": "BeforeStart", + "value": "BeforeStart" + }, + { + "name": "Approx", + "value": "Approx" + }, + { + "name": "ReferenceUndefined", + "value": "ReferenceUndefined" + }, + { + "name": "SinceEnd", + "value": "SinceEnd" + }, + { + "name": "AfterMid", + "value": "AfterMid" + }, + { + "name": "Start", + "value": "Start" + }, + { + "name": "After", + "value": "After" + }, + { + "name": "BeforeEnd", + "value": "BeforeEnd" + }, + { + "name": "Until", + "value": "Until" + }, + { + "name": "End", + "value": "End" + }, + { + "name": "Less", + "value": "Less" + }, + { + "name": "Since", + "value": "Since" + }, + { + "name": "AfterStart", + "value": "AfterStart" + }, + { + "name": "BeforeApprox", + "value": "BeforeApprox" + }, + { + "name": "Mid", + "value": "Mid" + }, + { + "name": "More", + "value": "More" + } + ] + } + }, + "TemporalSpanResolution": { + "type": "object", + "description": "represents the resolution of a date and/or time span.", + "properties": { + "begin": { + "type": "string", + "description": "represents the resolution of a date and/or time span. An extended ISO 8601 date/time representation as described in (https://github.com/Microsoft/Recognizers-Text/blob/master/Patterns/English/English-DateTime.yaml)" + }, + "end": { + "type": "string", + "description": "represents the resolution of a date and/or time span. An extended ISO 8601 date/time representation as described in (https://github.com/Microsoft/Recognizers-Text/blob/master/Patterns/English/English-DateTime.yaml)" + }, + "duration": { + "type": "string", + "description": "An optional duration value formatted based on the ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601#Durations)" + }, + "modifier": { + "$ref": "#/definitions/TemporalModifier", + "description": "An optional modifier of a date/time instance." + }, + "timex": { + "type": "string", + "description": "An optional triplet containing the beginning, the end, and the duration all stated as ISO 8601 formatted strings." + } + }, + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "TemporalSpanResolution" + }, + "TextConversation": { + "type": "object", + "description": "model for text conversation", + "properties": { + "conversationItems": { + "type": "array", + "description": "Ordered list of text conversation items in the conversation.", + "items": { + "$ref": "#/definitions/TextConversationItem" + } + } + }, + "required": [ + "conversationItems" + ], + "allOf": [ + { + "$ref": "#/definitions/Conversation" + } + ], + "x-ms-discriminator-value": "text" + }, + "TextConversationItem": { + "type": "object", + "description": "The text modality of an input conversation.", + "properties": { + "id": { + "type": "string", + "description": "The ID of a conversation item." + }, + "participantId": { + "type": "string", + "description": "The participant ID of a conversation item." + }, + "language": { + "type": "string", + "description": "The override language of a conversation item in BCP 47 language representation." + }, + "modality": { + "$ref": "#/definitions/InputModality", + "description": "Enumeration of supported conversational modalities." + }, + "role": { + "$ref": "#/definitions/role", + "description": "Role of the participant." + }, + "text": { + "type": "string", + "description": "The text input" + } + }, + "required": [ + "id", + "participantId", + "text" + ], + "additionalProperties": {} + }, + "TextSentiment": { + "type": "string", + "description": "Predicted sentiment", + "enum": [ + "positive", + "neutral", + "negative", + "mixed" + ], + "x-ms-enum": { + "name": "TextSentiment", + "modelAsString": true, + "values": [ + { + "name": "positive", + "value": "positive", + "description": "Positive statement" + }, + { + "name": "neutral", + "value": "neutral", + "description": "Neutral statement" + }, + { + "name": "negative", + "value": "negative", + "description": "Negative statement" + }, + { + "name": "mixed", + "value": "mixed", + "description": "Mixed statement" + } + ] + } + }, + "TranscriptContentType": { + "type": "string", + "description": "Enumeration of supported transcript content types.", + "enum": [ + "lexical", + "itn", + "maskedItn", + "text" + ], + "x-ms-enum": { + "name": "TranscriptContentType", + "modelAsString": true, + "values": [ + { + "name": "lexical", + "value": "lexical" + }, + { + "name": "itn", + "value": "itn" + }, + { + "name": "maskedItn", + "value": "maskedItn" + }, + { + "name": "text", + "value": "text" + } + ] + } + }, + "TranscriptConversation": { + "type": "object", + "description": "model for transcript conversation", + "properties": { + "conversationItems": { + "type": "array", + "description": "Ordered list of transcript conversation items in the conversation.", + "items": { + "$ref": "#/definitions/TranscriptConversationItem" + } + } + }, + "required": [ + "conversationItems" + ], + "allOf": [ + { + "$ref": "#/definitions/Conversation" + } + ], + "x-ms-discriminator-value": "transcript" + }, + "TranscriptConversationItem": { + "type": "object", + "description": "Additional properties for supporting transcript conversation.", + "properties": { + "id": { + "type": "string", + "description": "The ID of a conversation item." + }, + "participantId": { + "type": "string", + "description": "The participant ID of a conversation item." + }, + "language": { + "type": "string", + "description": "The override language of a conversation item in BCP 47 language representation." + }, + "modality": { + "$ref": "#/definitions/InputModality", + "description": "Enumeration of supported conversational modalities." + }, + "role": { + "$ref": "#/definitions/role", + "description": "Role of the participant." + }, + "itn": { + "type": "string", + "description": "Inverse text normalization (ITN) representation of input. The inverse-text-normalized form is the recognized text from Microsoft's speech-to-text API, with phone numbers, numbers, abbreviations, and other transformations applied." + }, + "maskedItn": { + "type": "string", + "description": "Inverse-text-normalized format with profanity masking applied." + }, + "text": { + "type": "string", + "description": "Display form of the recognized text from the speech-to-text API, with punctuation and capitalization added." + }, + "lexical": { + "type": "string", + "description": "Lexical form of the recognized text from the speech-to-text API, with the actual words recognized." + }, + "wordLevelTimings": { + "type": "array", + "description": "List of word-level audio timing information.", + "items": { + "$ref": "#/definitions/WordLevelTiming" + }, + "x-ms-identifiers": [] + }, + "conversationItemLevelTiming": { + "$ref": "#/definitions/ConversationItemLevelTiming", + "description": "Audio timing at the conversation item level. This still can help with AI quality if word-level audio timings are not available." + } + }, + "required": [ + "id", + "participantId", + "itn", + "maskedItn", + "text", + "lexical" + ], + "additionalProperties": {} + }, + "VolumeResolution": { + "type": "object", + "description": "Represents the volume entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/VolumeUnit", + "description": "The Volume Unit of measurement" + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "VolumeResolution" + }, + "VolumeUnit": { + "type": "string", + "description": "The Volume Unit of measurement", + "enum": [ + "Unspecified", + "CubicMeter", + "CubicCentimeter", + "CubicMillimeter", + "Hectoliter", + "Decaliter", + "Liter", + "Centiliter", + "Milliliter", + "CubicYard", + "CubicInch", + "CubicFoot", + "CubicMile", + "FluidOunce", + "Teaspoon", + "Tablespoon", + "Pint", + "Quart", + "Cup", + "Gill", + "Pinch", + "FluidDram", + "Barrel", + "Minim", + "Cord", + "Peck", + "Bushel", + "Hogshead" + ], + "x-ms-enum": { + "name": "VolumeUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "CubicMeter", + "value": "CubicMeter" + }, + { + "name": "CubicCentimeter", + "value": "CubicCentimeter" + }, + { + "name": "CubicMillimeter", + "value": "CubicMillimeter" + }, + { + "name": "Hectoliter", + "value": "Hectoliter" + }, + { + "name": "Decaliter", + "value": "Decaliter" + }, + { + "name": "Liter", + "value": "Liter" + }, + { + "name": "Centiliter", + "value": "Centiliter" + }, + { + "name": "Milliliter", + "value": "Milliliter" + }, + { + "name": "CubicYard", + "value": "CubicYard" + }, + { + "name": "CubicInch", + "value": "CubicInch" + }, + { + "name": "CubicFoot", + "value": "CubicFoot" + }, + { + "name": "CubicMile", + "value": "CubicMile" + }, + { + "name": "FluidOunce", + "value": "FluidOunce" + }, + { + "name": "Teaspoon", + "value": "Teaspoon" + }, + { + "name": "Tablespoon", + "value": "Tablespoon" + }, + { + "name": "Pint", + "value": "Pint" + }, + { + "name": "Quart", + "value": "Quart" + }, + { + "name": "Cup", + "value": "Cup" + }, + { + "name": "Gill", + "value": "Gill" + }, + { + "name": "Pinch", + "value": "Pinch" + }, + { + "name": "FluidDram", + "value": "FluidDram" + }, + { + "name": "Barrel", + "value": "Barrel" + }, + { + "name": "Minim", + "value": "Minim" + }, + { + "name": "Cord", + "value": "Cord" + }, + { + "name": "Peck", + "value": "Peck" + }, + { + "name": "Bushel", + "value": "Bushel" + }, + { + "name": "Hogshead", + "value": "Hogshead" + } + ] + } + }, + "WeightResolution": { + "type": "object", + "description": "Represents the weight entity resolution model.", + "properties": { + "value": { + "type": "number", + "format": "double", + "description": "The numeric value that the extracted text denotes." + }, + "unit": { + "$ref": "#/definitions/WeightUnit", + "description": "The weight Unit of measurement." + } + }, + "required": [ + "value", + "unit" + ], + "allOf": [ + { + "$ref": "#/definitions/BaseResolution" + } + ], + "x-ms-discriminator-value": "WeightResolution" + }, + "WeightUnit": { + "type": "string", + "description": "The weight Unit of measurement.", + "enum": [ + "Unspecified", + "Kilogram", + "Gram", + "Milligram", + "Gallon", + "MetricTon", + "Ton", + "Pound", + "Ounce", + "Grain", + "PennyWeight", + "LongTonBritish", + "ShortTonUS", + "ShortHundredWeightUS", + "Stone", + "Dram" + ], + "x-ms-enum": { + "name": "WeightUnit", + "modelAsString": true, + "values": [ + { + "name": "Unspecified", + "value": "Unspecified" + }, + { + "name": "Kilogram", + "value": "Kilogram" + }, + { + "name": "Gram", + "value": "Gram" + }, + { + "name": "Milligram", + "value": "Milligram" + }, + { + "name": "Gallon", + "value": "Gallon" + }, + { + "name": "MetricTon", + "value": "MetricTon" + }, + { + "name": "Ton", + "value": "Ton" + }, + { + "name": "Pound", + "value": "Pound" + }, + { + "name": "Ounce", + "value": "Ounce" + }, + { + "name": "Grain", + "value": "Grain" + }, + { + "name": "PennyWeight", + "value": "PennyWeight" + }, + { + "name": "LongTonBritish", + "value": "LongTonBritish" + }, + { + "name": "ShortTonUS", + "value": "ShortTonUS" + }, + { + "name": "ShortHundredWeightUS", + "value": "ShortHundredWeightUS" + }, + { + "name": "Stone", + "value": "Stone" + }, + { + "name": "Dram", + "value": "Dram" + } + ] + } + }, + "WordLevelTiming": { + "type": "object", + "description": "Word-level timing information that the speech-to-text API generates. The words in this object should have 1:1 correspondence with the lexical input to allow for audio redaction.", + "properties": { + "offset": { + "type": "integer", + "format": "int64", + "description": "Offset from the start of speech audio, in ticks. 1 tick = 100 nanoseconds." + }, + "duration": { + "type": "integer", + "format": "int64", + "description": "Duration of word articulation, in ticks. 1 tick = 100 nanoseconds." + }, + "word": { + "type": "string", + "description": "Recognized word." + } + } + }, + "projectKind": { + "type": "string", + "description": "The type of the project.", + "enum": [ + "Conversation", + "Orchestration" + ], + "x-ms-enum": { + "name": "projectKind", + "modelAsString": true, + "values": [ + { + "name": "Conversation", + "value": "Conversation" + }, + { + "name": "Orchestration", + "value": "Orchestration" + } + ] + } + }, + "role": { + "type": "string", + "description": "Role of the participant.", + "enum": [ + "customer", + "agent", + "generic" + ], + "x-ms-enum": { + "name": "role", + "modelAsString": true, + "values": [ + { + "name": "customer", + "value": "customer", + "description": "The participant is a customer." + }, + { + "name": "agent", + "value": "agent", + "description": "The participant is an agent." + }, + { + "name": "generic", + "value": "generic", + "description": "The is a generic participant." + } + ] + } + }, + "targetProjectKind": { + "type": "string", + "description": "The type of a target service.", + "enum": [ + "Luis", + "Conversation", + "QuestionAnswering", + "NonLinked" + ], + "x-ms-enum": { + "name": "targetProjectKind", + "modelAsString": true, + "values": [ + { + "name": "Luis", + "value": "Luis" + }, + { + "name": "Conversation", + "value": "Conversation" + }, + { + "name": "QuestionAnswering", + "value": "QuestionAnswering" + }, + { + "name": "NonLinked", + "value": "NonLinked" + } + ] + } + } + }, + "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" + } + } +} From 86bb67e189d736abf24308fe6e1960484bbf484d Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Fri, 12 Apr 2024 11:06:19 -0700 Subject: [PATCH 09/16] Examples changes --- .../SuccessfulAnalyzeConversations.json | 2 +- ...essfulAnalyzeConversationsArbitration.json | 2 +- ...eConversationsArbitrationDirectTarget.json | 2 +- ...AnalyzeConversationsJobsCancelRequest.json | 4 +- ...cessfulConversationPIIExclusionSubmit.json | 2 +- ...ersationPIIExclusionTaskStatusRequest.json | 2 +- ...fulConversationPIIRedactionCharSubmit.json | 2 +- ...tionPIIRedactionCharTaskStatusRequest.json | 2 +- .../SuccessfulConversationPIISubmit.json | 2 +- ...ssfulConversationPIITaskStatusRequest.json | 2 +- ...ulConversationSummarizationTaskResult.json | 2 +- ...rsationSummarizationTaskStatusRequest.json | 2 +- ...ulConversationSummarizationTaskSubmit.json | 2 +- .../SuccessfulConversationSummarySubmit.json | 2 +- .../SuccessfulAnalyzeConversations.json | 2 +- ...essfulAnalyzeConversationsArbitration.json | 2 +- ...eConversationsArbitrationDirectTarget.json | 2 +- ...AnalyzeConversationsJobsCancelRequest.json | 2 +- ...cessfulConversationPIIExclusionSubmit.json | 2 +- ...ersationPIIExclusionTaskStatusRequest.json | 2 +- ...fulConversationPIIRedactionCharSubmit.json | 2 +- ...tionPIIRedactionCharTaskStatusRequest.json | 2 +- .../SuccessfulConversationPIISubmit.json | 2 +- ...ssfulConversationPIITaskStatusRequest.json | 2 +- ...ulConversationSummarizationTaskResult.json | 2 +- ...rsationSummarizationTaskStatusRequest.json | 2 +- ...ulConversationSummarizationTaskSubmit.json | 2 +- .../SuccessfulConversationSummarySubmit.json | 2 +- ...omConversationSummarizationTaskResult.json | 2 +- ...omConversationSummarizationTaskSubmit.json | 2 +- .../analyzeconversations.json | 56 ++++++++ .../SuccessfulAnalyzeConversations.json | 120 ++++++++++++++++++ ...essfulAnalyzeConversationsArbitration.json | 76 +++++++++++ ...eConversationsArbitrationDirectTarget.json | 77 +++++++++++ ...AnalyzeConversationsJobsCancelRequest.json | 17 +++ ...cessfulConversationPIIExclusionSubmit.json | 76 +++++++++++ ...ersationPIIExclusionTaskStatusRequest.json | 68 ++++++++++ ...fulConversationPIIRedactionCharSubmit.json | 77 +++++++++++ ...tionPIIRedactionCharTaskStatusRequest.json | 76 +++++++++++ .../SuccessfulConversationPIISubmit.json | 76 +++++++++++ ...ssfulConversationPIITaskStatusRequest.json | 76 +++++++++++ ...ulConversationSummarizationTaskResult.json | 77 +++++++++++ ...rsationSummarizationTaskStatusRequest.json | 61 +++++++++ ...ulConversationSummarizationTaskSubmit.json | 79 ++++++++++++ .../SuccessfulConversationSummarySubmit.json | 63 +++++++++ ...omConversationSummarizationTaskResult.json | 66 ++++++++++ ...omConversationSummarizationTaskSubmit.json | 80 ++++++++++++ .../2024-05-01/analyzeconversations.json | 50 ++++++++ .../SuccessfulAnalyzeConversations.json | 63 +++++++++ ...essfulAnalyzeConversationsArbitration.json | 76 +++++++++++ ...eConversationsArbitrationDirectTarget.json | 77 +++++++++++ ...AnalyzeConversationsJobsCancelRequest.json | 17 +++ ...cessfulConversationPIIExclusionSubmit.json | 76 +++++++++++ ...ersationPIIExclusionTaskStatusRequest.json | 68 ++++++++++ ...fulConversationPIIRedactionCharSubmit.json | 77 +++++++++++ ...tionPIIRedactionCharTaskStatusRequest.json | 76 +++++++++++ .../SuccessfulConversationPIISubmit.json | 76 +++++++++++ ...ssfulConversationPIITaskStatusRequest.json | 76 +++++++++++ ...ulConversationSummarizationTaskResult.json | 77 +++++++++++ ...rsationSummarizationTaskStatusRequest.json | 61 +++++++++ ...ulConversationSummarizationTaskSubmit.json | 79 ++++++++++++ .../SuccessfulConversationSummarySubmit.json | 63 +++++++++ 62 files changed, 2264 insertions(+), 31 deletions(-) create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversations.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsArbitration.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionSubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIRedactionCharSubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIISubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIITaskStatusRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskResult.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskStatusRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskSubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarySubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulCustomConversationSummarizationTaskResult.json create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulCustomConversationSummarizationTaskSubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversations.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsArbitration.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIExclusionSubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIRedactionCharSubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIISubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIITaskStatusRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskResult.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskStatusRequest.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskSubmit.json create mode 100644 specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarySubmit.json diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversations.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversations.json index da9487c20a5f..552e0380429a 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversations.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversations.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversations", + "operationId": "AnalyzeConversations", "title": "SuccessfulAnalyzeConversations", "parameters": { "Endpoint": "{Endpoint}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitration.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitration.json index 90e6eb3c02fd..2b8e70670846 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitration.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitration.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversations", + "operationId": "AnalyzeConversations", "title": "SuccessfulAnalyzeConversationsArbitration", "parameters": { "Endpoint": "{Endpoint}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json index b8c6a81f17f3..8edc397b0509 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversations", + "operationId": "AnalyzeConversations", "title": "SuccessfulAnalyzeConversationsArbitrationDirectTarget", "parameters": { "Endpoint": "{Endpoint}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsJobsCancelRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsJobsCancelRequest.json index 78199017b77e..e3e8b9631cad 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsJobsCancelRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulAnalyzeConversationsJobsCancelRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsCancelJob", + "operationId": "AnalyzeConversationsCancelJob", "title": "SuccessfulAnalyzeConversationsJobsCancelRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", @@ -10,7 +10,7 @@ "responses": { "202": { "headers": { - "Operation-Location": "{Endpoint}/language/analyze-conversations/jobs/{jobId}?api-version=2023-11-15-preview" + "Operation-Location": "{Endpoint}/language/analyze-conversations/jobs/{jobId}?api-version=2024-05-01" } } } diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionSubmit.json index 0f9060aab99d..b06bb97ea9a1 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionSubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionSubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationPIIExclusionSubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionTaskStatusRequest.json index fba06d044267..965f6bc37663 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionTaskStatusRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIExclusionTaskStatusRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationPIIExclusionTaskStatusRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharSubmit.json index 2199d97391d8..27b80442a78d 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharSubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharSubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationPIIRedactionCharSubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json index 5927e630c685..8829600a5ebc 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationPIIRedactionCharTaskStatusRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIISubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIISubmit.json index d766438cf515..f0cc385ccb65 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIISubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIISubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationPIISubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIITaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIITaskStatusRequest.json index 08e24b6bd8e6..629b44ea467b 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIITaskStatusRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationPIITaskStatusRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationPIITaskStatusRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskResult.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskResult.json index 34e0998ff4c9..469ae6437583 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskResult.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskResult.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationSummarizationTaskResult", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskStatusRequest.json index d258b4ff4c07..7b318ae457aa 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskStatusRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskStatusRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationSummarizationTaskStatusRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskSubmit.json index 08aec4c3fcf4..2f302b3bc9da 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskSubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarizationTaskSubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationSummarizationTaskSubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarySubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarySubmit.json index 2734b9e32ae2..ecb7862e3e08 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarySubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-01/SuccessfulConversationSummarySubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationSummarySubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json index 0b8ef196aa82..078d8d307fc1 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversations", + "operationId": "AnalyzeConversations", "title": "SuccessfulAnalyzeConversations", "parameters": { "Endpoint": "{Endpoint}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitration.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitration.json index fd3c6be889f3..33018615d1b3 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitration.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitration.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversations", + "operationId": "AnalyzeConversations", "title": "SuccessfulAnalyzeConversationsArbitration", "parameters": { "Endpoint": "{Endpoint}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json index 74240092c77e..b0897595ecb7 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversations", + "operationId": "AnalyzeConversations", "title": "SuccessfulAnalyzeConversationsArbitrationDirectTarget", "parameters": { "Endpoint": "{Endpoint}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsJobsCancelRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsJobsCancelRequest.json index ff4e00df2436..ab8a77b27c0b 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsJobsCancelRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversationsJobsCancelRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsCancelJob", + "operationId": "AnalyzeConversationsCancelJob", "title": "SuccessfulAnalyzeConversationsJobsCancelRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json index eba7d0d4007e..50ed17c60db6 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationPIIExclusionSubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionTaskStatusRequest.json index fd30d5b1ab49..6efa2d3e5e67 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionTaskStatusRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionTaskStatusRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationPIIExclusionTaskStatusRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharSubmit.json index 3a473402a1ec..72097e81061c 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharSubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharSubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationPIIRedactionCharSubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json index 762e90e26238..87ce4feeeb1d 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationPIIRedactionCharTaskStatusRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIISubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIISubmit.json index bccb3c2d08f3..56c12df8d8b5 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIISubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIISubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationPIISubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIITaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIITaskStatusRequest.json index c89f99fa55d3..5ea42814aa8e 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIITaskStatusRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIITaskStatusRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationPIITaskStatusRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskResult.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskResult.json index 3026f289b5f7..b5a4c5368deb 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskResult.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskResult.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationSummarizationTaskResult", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskStatusRequest.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskStatusRequest.json index 3ee1b6c4dcc2..2fe8ec2c85cb 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskStatusRequest.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskStatusRequest.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulConversationSummarizationTaskStatusRequest", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskSubmit.json index 3c5489941be2..a9ae7d4dc2a4 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskSubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarizationTaskSubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationSummarizationTaskSubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarySubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarySubmit.json index 2298c15c8f4d..f7f06e6dcc67 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarySubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationSummarySubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulConversationSummarySubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskResult.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskResult.json index 05c5df32bed6..8f7c5b1ba52c 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskResult.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskResult.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsJobStatus", + "operationId": "AnalyzeConversationsJobStatus", "title": "SuccessfulCustomConversationSummarizationTaskResult", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskSubmit.json index 53f5c31d9b34..e8110f83f168 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskSubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulCustomConversationSummarizationTaskSubmit.json @@ -1,5 +1,5 @@ { - "operationId": "Language_AnalyzeConversationsSubmitJob", + "operationId": "AnalyzeConversationsSubmitJob", "title": "SuccessfulCustomConversationSummarizationTaskSubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json index ee064d37641a..7db288edf7b8 100644 --- a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json @@ -83,6 +83,17 @@ } } } + }, + "x-ms-examples": { + "SuccessfulAnalyzeConversations": { + "$ref": "./examples/SuccessfulAnalyzeConversations.json" + }, + "SuccessfulAnalyzeConversationsArbitration": { + "$ref": "./examples/SuccessfulAnalyzeConversationsArbitration.json" + }, + "SuccessfulAnalyzeConversationsArbitrationDirectTarget": { + "$ref": "./examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json" + } } } }, @@ -121,6 +132,26 @@ } } }, + "x-ms-examples": { + "SuccessfulConversationPIIExclusionSubmit": { + "$ref": "./examples/SuccessfulConversationPIIExclusionSubmit.json" + }, + "SuccessfulConversationPIIRedactionCharSubmit": { + "$ref": "./examples/SuccessfulConversationPIIRedactionCharSubmit.json" + }, + "SuccessfulConversationPIISubmit": { + "$ref": "./examples/SuccessfulConversationPIISubmit.json" + }, + "SuccessfulConversationSummarizationTaskSubmit": { + "$ref": "./examples/SuccessfulConversationSummarizationTaskSubmit.json" + }, + "SuccessfulConversationSummarySubmit": { + "$ref": "./examples/SuccessfulConversationSummarySubmit.json" + }, + "SuccessfulCustomConversationSummarizationTaskSubmit": { + "$ref": "./examples/SuccessfulCustomConversationSummarizationTaskSubmit.json" + } + }, "x-ms-long-running-operation": true } }, @@ -162,6 +193,26 @@ "$ref": "#/definitions/ErrorResponse" } } + }, + "x-ms-examples": { + "SuccessfulConversationPIIExclusionTaskStatusRequest": { + "$ref": "./examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json" + }, + "SuccessfulConversationPIIRedactionCharTaskStatusRequest": { + "$ref": "./examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json" + }, + "SuccessfulConversationPIITaskStatusRequest": { + "$ref": "./examples/SuccessfulConversationPIITaskStatusRequest.json" + }, + "SuccessfulConversationSummarizationTaskResult": { + "$ref": "./examples/SuccessfulConversationSummarizationTaskResult.json" + }, + "SuccessfulConversationSummarizationTaskStatusRequest": { + "$ref": "./examples/SuccessfulConversationSummarizationTaskStatusRequest.json" + }, + "SuccessfulCustomConversationSummarizationTaskResult": { + "$ref": "./examples/SuccessfulCustomConversationSummarizationTaskResult.json" + } } } }, @@ -201,6 +252,11 @@ } } }, + "x-ms-examples": { + "SuccessfulAnalyzeConversationsJobsCancelRequest": { + "$ref": "./examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json" + } + }, "x-ms-long-running-operation": true } } diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversations.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversations.json new file mode 100644 index 000000000000..078d8d307fc1 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversations.json @@ -0,0 +1,120 @@ +{ + "operationId": "AnalyzeConversations", + "title": "SuccessfulAnalyzeConversations", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-15-preview", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "id": "1", + "participantId": "1", + "text": "Book a flight to Seattle on Oct 10th" + } + }, + "parameters": { + "projectName": "{project-name}", + "deploymentName": "{deployment-name}", + "stringIndexType": "TextElement_V8" + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "Book a flight to Seattle on Oct 10th", + "prediction": { + "topIntent": "BookFlight", + "projectKind": "Conversation", + "intents": [ + { + "category": "None", + "confidenceScore": 1 + }, + { + "category": "BookTrain", + "confidenceScore": 0 + }, + { + "category": "BookFlight", + "confidenceScore": 0 + } + ], + "entities": [ + { + "category": "Geography.Location", + "text": "seattle", + "offset": 17, + "length": 7, + "confidenceScore": 1, + "extraInformation": [ + { + "extraInformationKind": "EntitySubtype", + "value": "geography.location", + "tags": [ + { + "name": "City", + "confidenceScore": 1 + }, + { + "name": "GPE", + "confidenceScore": 1 + }, + { + "name": "Location", + "confidenceScore": 1 + } + ] + } + ] + }, + { + "category": "DateTime", + "text": "oct 10th", + "offset": 28, + "length": 8, + "confidenceScore": 1, + "resolutions": [ + { + "resolutionKind": "DateTimeResolution", + "dateTimeSubKind": "Date", + "timex": "XXXX-10-10", + "value": "2023-10-10" + }, + { + "resolutionKind": "DateTimeResolution", + "dateTimeSubKind": "Date", + "timex": "XXXX-10-10", + "value": "2024-10-10" + } + ], + "extraInformation": [ + { + "extraInformationKind": "EntitySubtype", + "value": "datetime.date", + "tags": [ + { + "name": "Date", + "confidenceScore": 1 + }, + { + "name": "Temporal", + "confidenceScore": 1 + } + ] + } + ] + } + ] + } + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsArbitration.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsArbitration.json new file mode 100644 index 000000000000..33018615d1b3 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsArbitration.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversations", + "title": "SuccessfulAnalyzeConversationsArbitration", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-15-preview", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "participantId": "1", + "id": "1", + "modality": "text", + "language": "en-GB", + "text": "How do I integrate QnA Maker and LUIS?" + } + }, + "parameters": { + "projectName": "{project-name}", + "deploymentName": "{deployment-name}", + "verbose": true, + "isLoggingEnabled": false, + "stringIndexType": "TextElement_V8" + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "trains from London", + "prediction": { + "topIntent": "Rail", + "projectKind": "Orchestration", + "intents": { + "Rail": { + "confidenceScore": 1, + "targetProjectKind": "Conversation", + "result": { + "query": "trains from London", + "prediction": { + "topIntent": "Timetable", + "projectKind": "Conversation", + "intents": [ + { + "category": "Timetable", + "confidenceScore": 0.99968535 + }, + { + "category": "Locomotive", + "confidenceScore": 0.000314623 + } + ], + "entities": [] + } + } + }, + "Tree": { + "confidenceScore": 0.2641529, + "targetProjectKind": "QuestionAnswering" + }, + "None": { + "confidenceScore": 0, + "targetProjectKind": "NonLinked" + } + } + } + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json new file mode 100644 index 000000000000..b0897595ecb7 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json @@ -0,0 +1,77 @@ +{ + "operationId": "AnalyzeConversations", + "title": "SuccessfulAnalyzeConversationsArbitrationDirectTarget", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-15-preview", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "text": "Ports and connectors", + "participantId": "1", + "id": "1" + } + }, + "parameters": { + "projectName": "prj1", + "deploymentName": "dep1", + "directTarget": "qnaProject", + "targetProjectParameters": { + "qnaProject": { + "targetProjectKind": "QuestionAnswering", + "callingOptions": { + "context": { + "previousUserQuery": "Meet Surface Pro 4", + "previousQnaId": 4 + }, + "top": 1, + "question": "App Service overview" + } + } + } + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "Ports and connectors", + "prediction": { + "projectKind": "Orchestration", + "topIntent": "qnaTargetApp", + "intents": { + "qnaTargetApp": { + "targetProjectKind": "QuestionAnswering", + "confidenceScore": 1, + "result": { + "answers": [ + { + "questions": [ + "App Service overview" + ], + "answer": "The compute resources you use are determined by the *App Service plan* that you run your apps on.", + "confidenceScore": 0.7384000000000001, + "id": 1, + "source": "https://docs.microsoft.com/en-us/azure/app-service/overview", + "metadata": {}, + "dialog": { + "isContextOnly": false, + "prompts": [] + } + } + ] + } + } + } + } + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json new file mode 100644 index 000000000000..ab8a77b27c0b --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json @@ -0,0 +1,17 @@ +{ + "operationId": "AnalyzeConversationsCancelJob", + "title": "SuccessfulAnalyzeConversationsJobsCancelRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversations/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionSubmit.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionSubmit.json new file mode 100644 index 000000000000..50ed17c60db6 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionSubmit.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIIExclusionSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2023-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "excludePiiCategories": [ + "Person" + ], + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2023-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json new file mode 100644 index 000000000000..6efa2d3e5e67 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json @@ -0,0 +1,68 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIIExclusionTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning *************.", + "itn": "good morning *************", + "maskedItn": "good morning *************", + "lexical": "good morning *************", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIRedactionCharSubmit.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIRedactionCharSubmit.json new file mode 100644 index 000000000000..72097e81061c --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIRedactionCharSubmit.json @@ -0,0 +1,77 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIIRedactionCharSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "piiCategories": [ + "All" + ], + "redactionCharacter": "-", + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json new file mode 100644 index 000000000000..87ce4feeeb1d --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIIRedactionCharTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning -------------.", + "itn": "good morning -------------", + "maskedItn": "good morning -------------", + "lexical": "good morning -------------", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [ + { + "category": "Person", + "confidenceScore": 0.91, + "length": 8, + "offset": 13, + "text": "john doe" + } + ] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIISubmit.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIISubmit.json new file mode 100644 index 000000000000..56c12df8d8b5 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIISubmit.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIISubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "piiCategories": [ + "All" + ], + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIITaskStatusRequest.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIITaskStatusRequest.json new file mode 100644 index 000000000000..5ea42814aa8e --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIITaskStatusRequest.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIITaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning *************.", + "itn": "good morning *************", + "maskedItn": "good morning *************", + "lexical": "good morning *************", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [ + { + "category": "Person", + "confidenceScore": 0.91, + "length": 8, + "offset": 13, + "text": "john doe" + } + ] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskResult.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskResult.json new file mode 100644 index 000000000000..b5a4c5368deb --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskResult.json @@ -0,0 +1,77 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationSummarizationTaskResult", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Conversation Summarization Example", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "Conversation Summarization Task 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "summaries": [ + { + "aspect": "chapterTitle", + "text": "Bug Triage", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + } + ] + }, + { + "aspect": "narrative", + "text": "Speaker 3 believes there are 3 remaining bugs.", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + }, + { + "conversationItemId": "3", + "offset": 0, + "length": 7 + } + ] + } + ], + "warnings": [] + } + ], + "errors": [], + "modelVersion": "latest" + } + } + ] + }, + "nextLink": "/language/analyze-conversation/jobs/3e9e8518-492f-47f9-abd1-9a7468231086?$skip=10&$top=10" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskStatusRequest.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskStatusRequest.json new file mode 100644 index 000000000000..2fe8ec2c85cb --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskStatusRequest.json @@ -0,0 +1,61 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationSummarizationTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Analyze chat", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "analyze 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "20220101meeting", + "summaries": [ + { + "aspect": "issue", + "text": "Customer wants to cancel his subscription. Customer doesn't know how" + }, + { + "aspect": "resolution", + "text": "pii Auto-Fortify. \npii Gamertag.\npii E-mail.\nCanceled customer's subscription" + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "latest" + } + } + ] + }, + "nextLink": "/language/analyze-conversation/jobs/3e9e8518-492f-47f9-abd1-9a7468231086?$skip=10&$top=10" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskSubmit.json new file mode 100644 index 000000000000..a9ae7d4dc2a4 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarizationTaskSubmit.json @@ -0,0 +1,79 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationSummarizationTaskSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Conversation Summarization Example", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "conversationItems": [ + { + "participantId": "speaker 1", + "id": "1", + "text": "Let's get started.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 0, + "duration": 20000000 + } + }, + { + "participantId": "speaker 2", + "id": "2", + "text": "OK. How many remaining bugs do we have now?", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 20000000, + "duration": 50000000 + } + }, + { + "participantId": "speaker 3", + "id": "3", + "text": "Only 3.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 50000000, + "duration": 60000000 + } + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation Summarization Task 1", + "kind": "ConversationalSummarizationTask", + "parameters": { + "summaryAspects": [ + "chapterTitle", + "narrative" + ] + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarySubmit.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarySubmit.json new file mode 100644 index 000000000000..f7f06e6dcc67 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationSummarySubmit.json @@ -0,0 +1,63 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationSummarySubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Analyze conversations from Contoso meeting", + "analysisInput": { + "conversations": [ + { + "id": "20220101meeting", + "language": "en", + "modality": "text", + "domain": "generic", + "conversationItems": [ + { + "participantId": "user", + "role": "customer", + "id": "1", + "text": "Hi!" + }, + { + "participantId": "agent", + "role": "agent", + "id": "2", + "text": "Hello, how can I help you?" + }, + { + "participantId": "user", + "role": "customer", + "id": "3", + "text": "I am having trouble issuing a return of a game on my xbox: call of duty" + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "analyze 1", + "kind": "ConversationalSummarizationTask", + "parameters": { + "modelVersion": "latest", + "summaryAspects": [ + "issue", + "resolution" + ] + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulCustomConversationSummarizationTaskResult.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulCustomConversationSummarizationTaskResult.json new file mode 100644 index 000000000000..8f7c5b1ba52c --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulCustomConversationSummarizationTaskResult.json @@ -0,0 +1,66 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulCustomConversationSummarizationTaskResult", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Custom Conversation Summarization Example", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "CustomConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "Custom Conversation Summarization Task 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "summaries": [ + { + "aspect": "narrative", + "text": "Speaker 3 believes there are 3 remaining bugs.", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + }, + { + "conversationItemId": "3", + "offset": 0, + "length": 7 + } + ] + } + ], + "warnings": [] + } + ], + "errors": [], + "projectName": "my_project", + "deploymentName": "my_deployment" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulCustomConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulCustomConversationSummarizationTaskSubmit.json new file mode 100644 index 000000000000..e8110f83f168 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulCustomConversationSummarizationTaskSubmit.json @@ -0,0 +1,80 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulCustomConversationSummarizationTaskSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-15-preview", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Custom Conversation Summarization Example", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "conversationItems": [ + { + "participantId": "speaker 1", + "id": "1", + "text": "Let's get started.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 0, + "duration": 20000000 + } + }, + { + "participantId": "speaker 2", + "id": "2", + "text": "OK. How many remaining bugs do we have now?", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 20000000, + "duration": 50000000 + } + }, + { + "participantId": "speaker 3", + "id": "3", + "text": "Only 3.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 50000000, + "duration": 60000000 + } + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Custom Conversation Summarization Task 1", + "kind": "CustomConversationalSummarizationTask", + "parameters": { + "summaryAspects": [ + "narrative" + ], + "projectName": "my_project", + "deploymentName": "my_deployment" + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-15-preview" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json index 5e5edfdfeb42..c5c524165629 100644 --- a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json @@ -83,6 +83,17 @@ } } } + }, + "x-ms-examples": { + "SuccessfulAnalyzeConversations": { + "$ref": "./examples/SuccessfulAnalyzeConversations.json" + }, + "SuccessfulAnalyzeConversationsArbitration": { + "$ref": "./examples/SuccessfulAnalyzeConversationsArbitration.json" + }, + "SuccessfulAnalyzeConversationsArbitrationDirectTarget": { + "$ref": "./examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json" + } } } }, @@ -121,6 +132,23 @@ } } }, + "x-ms-examples": { + "SuccessfulConversationPIIExclusionSubmit": { + "$ref": "./examples/SuccessfulConversationPIIExclusionSubmit.json" + }, + "SuccessfulConversationPIIRedactionCharSubmit": { + "$ref": "./examples/SuccessfulConversationPIIRedactionCharSubmit.json" + }, + "SuccessfulConversationPIISubmit": { + "$ref": "./examples/SuccessfulConversationPIISubmit.json" + }, + "SuccessfulConversationSummarizationTaskSubmit": { + "$ref": "./examples/SuccessfulConversationSummarizationTaskSubmit.json" + }, + "SuccessfulConversationSummarySubmit": { + "$ref": "./examples/SuccessfulConversationSummarySubmit.json" + } + }, "x-ms-long-running-operation": true } }, @@ -162,6 +190,23 @@ "$ref": "#/definitions/ErrorResponse" } } + }, + "x-ms-examples": { + "SuccessfulConversationPIIExclusionTaskStatusRequest": { + "$ref": "./examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json" + }, + "SuccessfulConversationPIIRedactionCharTaskStatusRequest": { + "$ref": "./examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json" + }, + "SuccessfulConversationPIITaskStatusRequest": { + "$ref": "./examples/SuccessfulConversationPIITaskStatusRequest.json" + }, + "SuccessfulConversationSummarizationTaskResult": { + "$ref": "./examples/SuccessfulConversationSummarizationTaskResult.json" + }, + "SuccessfulConversationSummarizationTaskStatusRequest": { + "$ref": "./examples/SuccessfulConversationSummarizationTaskStatusRequest.json" + } } } }, @@ -201,6 +246,11 @@ } } }, + "x-ms-examples": { + "SuccessfulAnalyzeConversationsJobsCancelRequest": { + "$ref": "./examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json" + } + }, "x-ms-long-running-operation": true } } diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversations.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversations.json new file mode 100644 index 000000000000..552e0380429a --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversations.json @@ -0,0 +1,63 @@ +{ + "operationId": "AnalyzeConversations", + "title": "SuccessfulAnalyzeConversations", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-01", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "id": "1", + "participantId": "1", + "text": "play In the air tonight from Phil Collins" + } + }, + "parameters": { + "projectName": "{project-name}", + "deploymentName": "{deployment-name}", + "stringIndexType": "TextElement_V8" + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "play In the air tonight from Phil Collins", + "prediction": { + "topIntent": "PlayMusic", + "projectKind": "Conversation", + "intents": [ + { + "category": "PlayMusic", + "confidenceScore": 1 + }, + { + "category": "SearchCreativeWork", + "confidenceScore": 0 + }, + { + "category": "AddToPlaylist", + "confidenceScore": 0 + } + ], + "entities": [ + { + "category": "Media.Artist", + "text": "Phil Collins", + "offset": 29, + "length": 12, + "confidenceScore": 1 + } + ] + } + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsArbitration.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsArbitration.json new file mode 100644 index 000000000000..2b8e70670846 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsArbitration.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversations", + "title": "SuccessfulAnalyzeConversationsArbitration", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-01", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "participantId": "1", + "id": "1", + "modality": "text", + "language": "en-GB", + "text": "How do I integrate QnA Maker and LUIS?" + } + }, + "parameters": { + "projectName": "{project-name}", + "deploymentName": "{deployment-name}", + "verbose": true, + "isLoggingEnabled": false, + "stringIndexType": "TextElement_V8" + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "trains from London", + "prediction": { + "topIntent": "Rail", + "projectKind": "Orchestration", + "intents": { + "Rail": { + "confidenceScore": 1, + "targetProjectKind": "Conversation", + "result": { + "query": "trains from London", + "prediction": { + "topIntent": "Timetable", + "projectKind": "Conversation", + "intents": [ + { + "category": "Timetable", + "confidenceScore": 0.99968535 + }, + { + "category": "Locomotive", + "confidenceScore": 0.000314623 + } + ], + "entities": [] + } + } + }, + "Tree": { + "confidenceScore": 0.2641529, + "targetProjectKind": "QuestionAnswering" + }, + "None": { + "confidenceScore": 0, + "targetProjectKind": "NonLinked" + } + } + } + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json new file mode 100644 index 000000000000..8edc397b0509 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsArbitrationDirectTarget.json @@ -0,0 +1,77 @@ +{ + "operationId": "AnalyzeConversations", + "title": "SuccessfulAnalyzeConversationsArbitrationDirectTarget", + "parameters": { + "Endpoint": "{Endpoint}", + "Ocp-Apim-Subscription-Key": "{API key}", + "Content-Type": "application/json", + "api-version": "2024-05-01", + "body": { + "kind": "Conversation", + "analysisInput": { + "conversationItem": { + "text": "Ports and connectors", + "participantId": "1", + "id": "1" + } + }, + "parameters": { + "projectName": "prj1", + "deploymentName": "dep1", + "directTarget": "qnaProject", + "targetProjectParameters": { + "qnaProject": { + "targetProjectKind": "QuestionAnswering", + "callingOptions": { + "context": { + "previousUserQuery": "Meet Surface Pro 4", + "previousQnaId": 4 + }, + "top": 1, + "question": "App Service overview" + } + } + } + } + } + }, + "responses": { + "200": { + "headers": {}, + "body": { + "kind": "ConversationResult", + "result": { + "query": "Ports and connectors", + "prediction": { + "projectKind": "Orchestration", + "topIntent": "qnaTargetApp", + "intents": { + "qnaTargetApp": { + "targetProjectKind": "QuestionAnswering", + "confidenceScore": 1, + "result": { + "answers": [ + { + "questions": [ + "App Service overview" + ], + "answer": "The compute resources you use are determined by the *App Service plan* that you run your apps on.", + "confidenceScore": 0.7384000000000001, + "id": 1, + "source": "https://docs.microsoft.com/en-us/azure/app-service/overview", + "metadata": {}, + "dialog": { + "isContextOnly": false, + "prompts": [] + } + } + ] + } + } + } + } + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json new file mode 100644 index 000000000000..e3e8b9631cad --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulAnalyzeConversationsJobsCancelRequest.json @@ -0,0 +1,17 @@ +{ + "operationId": "AnalyzeConversationsCancelJob", + "title": "SuccessfulAnalyzeConversationsJobsCancelRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversations/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIExclusionSubmit.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIExclusionSubmit.json new file mode 100644 index 000000000000..b06bb97ea9a1 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIExclusionSubmit.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIIExclusionSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "excludePiiCategories": [ + "Person" + ], + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json new file mode 100644 index 000000000000..965f6bc37663 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIExclusionTaskStatusRequest.json @@ -0,0 +1,68 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIIExclusionTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning *************.", + "itn": "good morning *************", + "maskedItn": "good morning *************", + "lexical": "good morning *************", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIRedactionCharSubmit.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIRedactionCharSubmit.json new file mode 100644 index 000000000000..27b80442a78d --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIRedactionCharSubmit.json @@ -0,0 +1,77 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIIRedactionCharSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "piiCategories": [ + "All" + ], + "redactionCharacter": "-", + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json new file mode 100644 index 000000000000..8829600a5ebc --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIIRedactionCharTaskStatusRequest.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIIRedactionCharTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning -------------.", + "itn": "good morning -------------", + "maskedItn": "good morning -------------", + "lexical": "good morning -------------", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [ + { + "category": "Person", + "confidenceScore": 0.91, + "length": 8, + "offset": 13, + "text": "john doe" + } + ] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIISubmit.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIISubmit.json new file mode 100644 index 000000000000..f0cc385ccb65 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIISubmit.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationPIISubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Redacting PII data from transcribed audio", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "domain": "generic", + "conversationItems": [ + { + "participantId": "1", + "id": "1", + "text": "Good morning John Doe.", + "itn": "good morning john doe", + "maskedItn": "good morning john doe", + "lexical": "good morning john doe", + "wordLevelTimings": [ + { + "word": "good", + "offset": 390000, + "duration": 2700000 + }, + { + "word": "morning", + "offset": 4500000, + "duration": 920000 + }, + { + "word": "john", + "offset": 590000, + "duration": 2700000 + }, + { + "word": "doe", + "offset": 6300000, + "duration": 920000 + } + ] + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation PII", + "kind": "ConversationalPIITask", + "parameters": { + "modelVersion": "latest", + "piiCategories": [ + "All" + ], + "redactionSource": "lexical", + "redactAudioTiming": true + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIITaskStatusRequest.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIITaskStatusRequest.json new file mode 100644 index 000000000000..629b44ea467b --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationPIITaskStatusRequest.json @@ -0,0 +1,76 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationPIITaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "createdDateTime": "2020-10-01T15:00:45Z", + "displayName": "Redacting PII from transcribed audio", + "expirationDateTime": "2020-10-03T15:01:03Z", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18", + "lastUpdatedDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalPIIResults", + "taskName": "Conversation PII", + "lastUpdateDateTime": "2022-01-25T15:01:03Z", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "conversationItems": [ + { + "id": "1", + "redactedContent": { + "text": "Good morning *************.", + "itn": "good morning *************", + "maskedItn": "good morning *************", + "lexical": "good morning *************", + "audioTimings": [ + { + "offset": 590000, + "duration": 920000 + } + ] + }, + "entities": [ + { + "category": "Person", + "confidenceScore": 0.91, + "length": 8, + "offset": 13, + "text": "john doe" + } + ] + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "2022-05-15-preview" + } + } + ] + } + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskResult.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskResult.json new file mode 100644 index 000000000000..469ae6437583 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskResult.json @@ -0,0 +1,77 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationSummarizationTaskResult", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Conversation Summarization Example", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "Conversation Summarization Task 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "1", + "summaries": [ + { + "aspect": "chapterTitle", + "text": "Bug Triage", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + } + ] + }, + { + "aspect": "narrative", + "text": "Speaker 3 believes there are 3 remaining bugs.", + "contexts": [ + { + "conversationItemId": "2", + "offset": 4, + "length": 39 + }, + { + "conversationItemId": "3", + "offset": 0, + "length": 7 + } + ] + } + ], + "warnings": [] + } + ], + "errors": [], + "modelVersion": "latest" + } + } + ] + }, + "nextLink": "/language/analyze-conversation/jobs/3e9e8518-492f-47f9-abd1-9a7468231086?$skip=10&$top=10" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskStatusRequest.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskStatusRequest.json new file mode 100644 index 000000000000..7b318ae457aa --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskStatusRequest.json @@ -0,0 +1,61 @@ +{ + "operationId": "AnalyzeConversationsJobStatus", + "title": "SuccessfulConversationSummarizationTaskStatusRequest", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "c0f2a446-05d9-48fc-ba8f-3ef4af8d0b18" + }, + "responses": { + "200": { + "headers": {}, + "body": { + "displayName": "Analyze chat", + "createdDateTime": "2022-04-01T15:00:45Z", + "expirationDateTime": "2022-04-02T15:00:45Z", + "jobId": "3e9e8518-492f-47f9-abd1-9a7468231086", + "lastUpdatedDateTime": "2022-04-01T15:00:49Z", + "status": "succeeded", + "tasks": { + "completed": 1, + "failed": 0, + "inProgress": 0, + "total": 1, + "items": [ + { + "kind": "ConversationalSummarizationResults", + "lastUpdateDateTime": "2022-04-01T15:00:49Z", + "taskName": "analyze 1", + "status": "succeeded", + "results": { + "conversations": [ + { + "id": "20220101meeting", + "summaries": [ + { + "aspect": "issue", + "text": "Customer wants to cancel his subscription. Customer doesn't know how" + }, + { + "aspect": "resolution", + "text": "pii Auto-Fortify. \npii Gamertag.\npii E-mail.\nCanceled customer's subscription" + } + ], + "warnings": [], + "statistics": { + "transactionsCount": 1 + } + } + ], + "errors": [], + "modelVersion": "latest" + } + } + ] + }, + "nextLink": "/language/analyze-conversation/jobs/3e9e8518-492f-47f9-abd1-9a7468231086?$skip=10&$top=10" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskSubmit.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskSubmit.json new file mode 100644 index 000000000000..2f302b3bc9da --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarizationTaskSubmit.json @@ -0,0 +1,79 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationSummarizationTaskSubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Conversation Summarization Example", + "analysisInput": { + "conversations": [ + { + "id": "1", + "language": "en", + "modality": "transcript", + "conversationItems": [ + { + "participantId": "speaker 1", + "id": "1", + "text": "Let's get started.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 0, + "duration": 20000000 + } + }, + { + "participantId": "speaker 2", + "id": "2", + "text": "OK. How many remaining bugs do we have now?", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 20000000, + "duration": 50000000 + } + }, + { + "participantId": "speaker 3", + "id": "3", + "text": "Only 3.", + "lexical": "", + "itn": "", + "maskedItn": "", + "conversationItemLevelTiming": { + "offset": 50000000, + "duration": 60000000 + } + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "Conversation Summarization Task 1", + "kind": "ConversationalSummarizationTask", + "parameters": { + "summaryAspects": [ + "chapterTitle", + "narrative" + ] + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarySubmit.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarySubmit.json new file mode 100644 index 000000000000..ecb7862e3e08 --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/examples/SuccessfulConversationSummarySubmit.json @@ -0,0 +1,63 @@ +{ + "operationId": "AnalyzeConversationsSubmitJob", + "title": "SuccessfulConversationSummarySubmit", + "parameters": { + "Ocp-Apim-Subscription-Key": "{API key}", + "api-version": "2024-05-01", + "Endpoint": "{Endpoint}", + "jobId": "{Job ID}", + "body": { + "displayName": "Analyze conversations from Contoso meeting", + "analysisInput": { + "conversations": [ + { + "id": "20220101meeting", + "language": "en", + "modality": "text", + "domain": "generic", + "conversationItems": [ + { + "participantId": "user", + "role": "customer", + "id": "1", + "text": "Hi!" + }, + { + "participantId": "agent", + "role": "agent", + "id": "2", + "text": "Hello, how can I help you?" + }, + { + "participantId": "user", + "role": "customer", + "id": "3", + "text": "I am having trouble issuing a return of a game on my xbox: call of duty" + } + ] + } + ] + }, + "tasks": [ + { + "taskName": "analyze 1", + "kind": "ConversationalSummarizationTask", + "parameters": { + "modelVersion": "latest", + "summaryAspects": [ + "issue", + "resolution" + ] + } + } + ] + } + }, + "responses": { + "202": { + "headers": { + "Operation-Location": "{Endpoint}/language/analyze-conversation/jobs/{jobId}?api-version=2024-05-01" + } + } + } +} From 68a74ffbeed688b40801c0fad7c71bec1a4d4f2c Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Tue, 23 Apr 2024 14:24:37 -0700 Subject: [PATCH 10/16] Changes to remove older preview API version in Analyze conversations --- .../Language.Conversations/common.tsp | 4 +- .../Language.Conversations/main.tsp | 127 +++--------------- 2 files changed, 23 insertions(+), 108 deletions(-) diff --git a/specification/cognitiveservices/Language.Conversations/common.tsp b/specification/cognitiveservices/Language.Conversations/common.tsp index 5d08bb5eb3f5..8749fd8ba08d 100644 --- a/specification/cognitiveservices/Language.Conversations/common.tsp +++ b/specification/cognitiveservices/Language.Conversations/common.tsp @@ -543,7 +543,7 @@ model SentimentConfidenceScores { } /** Enum that defines the length of the output summaries. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) union SummaryLengthBucket { string, @@ -567,7 +567,7 @@ model AbstractiveSummarizationTaskParametersBase { stringIndexType?: StringIndexType = StringIndexType.TextElements_v8; /** (NOTE: Recommended to use summaryLength over sentenceCount) Controls the approximate length of the output summaries. */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_01) summaryLength?: SummaryLengthBucket; } diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index 33c75fb25344..059139631167 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -41,15 +41,11 @@ enum Versions { @useDependency(Azure.Core.Versions.v1_0_Preview_2) v2023_04_01: "2023-04-01", - /** Version 2023-11-15-preview */ - @useDependency(Azure.Core.Versions.v1_0_Preview_2) - v2023_11_15_preview: "2023-11-15-preview", - - @doc("Version 2024-05-01") + /** Version 2024-05-01 */ @useDependency(Azure.Core.Versions.v1_0_Preview_2) v2024_05_01: "2024-05-01", - @doc("Version 2024-05-15-preview") + /** Version 2024-05-15-preview" */ @useDependency(Azure.Core.Versions.v1_0_Preview_2) v2024_05_15_preview: "2024-05-15-preview" } @@ -660,16 +656,12 @@ union AnalyzeConversationLROTaskKind { ConversationalSummarizationTask: "ConversationalSummarizationTask", /** Conversational PII Task */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_01) ConversationalPIITask: "ConversationalPIITask", /** Custom Conversational Summarization Task */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_15_preview) CustomConversationalSummarizationTask: "CustomConversationalSummarizationTask", - - /** Conversational Sentiment Task */ - @added(Versions.v2023_11_15_preview) - ConversationalSentimentTask: "ConversationalSentimentTask", } /** Enumeration of results for supported conversation analysis Results. */ @@ -682,17 +674,12 @@ union AnalyzeConversationResultsKind { ConversationalSummarizationResults: "ConversationalSummarizationResults", /** Conversational PII Results */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_01) ConversationalPIIResults: "ConversationalPIIResults", /** Custom Conversational Summarization Results */ @added(Versions.v2024_05_15_preview) CustomConversationalSummarizationResults: "CustomConversationalSummarizationResults", - - /** Conversational Sentiment Results */ - @removed(Versions.v2024_05_01) - @added(Versions.v2023_11_15_preview) - ConversationalSentimentResults: "ConversationalSentimentResults", } /** Contains the status of the submitted job for analyzing a conversation, along with related statistics. */ @@ -903,74 +890,8 @@ model ConversationRequestStatistics is RequestStatistics { @added(Versions.v2023_04_01) model ConversationItemLevelTiming is AudioTiming; -/** Task definition for conversational sentiment. */ -@removed(Versions.v2024_05_01) -@added(Versions.v2023_11_15_preview) -model AnalyzeConversationalSentimentTask extends AnalyzeConversationLROTask { - /** discriminator kind */ - kind: AnalyzeConversationLROTaskKind.ConversationalSentimentTask; - - /** Supported parameters for a conversational sentiment task. */ - parameters?: ConversationalSentimentTaskParameters; -} - -/** Supported parameters for a conversational sentiment task. */ -@added(Versions.v2023_11_15_preview) -model ConversationalSentimentTaskParameters is PreBuiltTaskParameters { - /** For transcript conversations, this parameter provides information regarding which content type should be used for sentiment analysis. The details of the sentiment analysis - like the offset, length and the text itself - will correspond to the text type selected here. */ - @added(Versions.v2023_11_15_preview) - predictionSource?: TranscriptContentType; -} - -/** Result from the sentiment analysis operation performed on a list of conversations. */ -@added(Versions.v2023_11_15_preview) -model AnalyzeConversationSentimentResult extends AnalyzeConversationJobResult { - /** discriminator kind */ - kind: AnalyzeConversationResultsKind.ConversationalSentimentResults; - - /** The result from sentiment analysis operation for each conversation. */ - results: ConversationSentimentResults; -} - -/** The result from sentiment analysis operation for each conversation. */ -@added(Versions.v2023_11_15_preview) -model ConversationSentimentResults is PreBuiltResult { - /** Array of ConversationSentimentResults */ - conversations: Array; -} - -/** The result from sentiment analysis operation for each conversation. */ -@added(Versions.v2023_11_15_preview) -model ConversationSentimentResultsConversation { - ...ConversationResultBase; - ...ConversationSentimentResult; -} - -/** The result from sentiment analysis operation for each conversation item. */ -@added(Versions.v2023_11_15_preview) -model ConversationSentimentResult { - /** Enumeration of Sentiment operation results for all the conversation items in a conversation. */ - conversationItems: Array; -} - -/** Sentiment operation results for a conversation items */ -@added(Versions.v2023_11_15_preview) -model ConversationSentimentItemResult { - /** The identifier for the conversation item */ - id: string; - - /** The identifier for the speaker */ - participantId: string; - - /** Predicted sentiment */ - sentiment: TextSentiment; - - /** Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative. */ - confidenceScores: SentimentConfidenceScores; -} - /** Text that has been categorized into pre-defined classes or types such as: person, location, event, product, and organization. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) model Entity { /** Entity text as appears in the request. */ text: string; @@ -992,7 +913,7 @@ model Entity { } /** Result from the personally identifiable information detection and redaction operation performed on a list of conversations. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) model AnalyzeConversationConversationPiiResult extends AnalyzeConversationJobResult { /** discriminator kind */ @@ -1003,28 +924,28 @@ model AnalyzeConversationConversationPiiResult } /** The result from PII detection and redaction operation for each conversation. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) model ConversationPiiResults is PreBuiltResult { /** array of conversations */ conversations: Array; } /** Conversation PII result item */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) model ConversationalPiiResultWithResultBase { ...ConversationResultBase; ...ConversationPiiResult; } /** The result from PII detection and redaction operation for each conversation. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) model ConversationPiiResult { /** List of conversationItems */ conversationItems: Array; } /** The result from PII detection and redaction operation for each conversation. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) model ConversationPiiItemResult { /** Id of the result */ id: string; @@ -1037,7 +958,7 @@ model ConversationPiiItemResult { } /** Task definition for a PII redaction in conversations. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) model AnalyzeConversationPiiTask extends AnalyzeConversationLROTask { /** discriminator kind */ kind: AnalyzeConversationLROTaskKind.ConversationalPIITask; @@ -1047,30 +968,30 @@ model AnalyzeConversationPiiTask extends AnalyzeConversationLROTask { } /** Supported parameters for a conversational pii task. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) model ConversationPiiTaskParameters is PreBuiltTaskParameters { /** Array of ConversationPIICategories */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_01) piiCategories?: Array; /** Flag to indicate if response should include audio stream offset and duration for any detected entities to be redacted. By default, audio timing of redacted entities are not included. */ redactAudioTiming?: boolean; /** For transcript conversations, this parameter provides information regarding which content type (ITN, Text, Lexical, Masked ITN) should be used for entity detection. The details of the entities detected - like the offset, length and the text itself - will correspond to the text type selected here. */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_01) redactionSource?: TranscriptContentType; /** Optional parameter to use a Custom Character to be used for redaction in PII responses. Default character will be * as before. We allow specific ascii characters for redaction. */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_01) redactionCharacter?: redactionCharacter = redactionCharacter.asterisk; /** List of categories that need to be excluded instead of included. */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_01) excludePiiCategories?: Array; } /** Describes the PII categories to return for detection. If not provided, 'default' categories will be returned which will vary with the language. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) union ConversationPiiCategories { string, @@ -1106,7 +1027,7 @@ union ConversationPiiCategories { } /** Describes the PII categories to exclude for detection. If not provided, 'default' categories will be returned which will vary with the language. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) union ConversationPiiCategoriesExclude { string, @@ -1133,7 +1054,7 @@ union ConversationPiiCategoriesExclude { } /** Enumeration of supported transcript content types. */ -@added(Versions.v2023_11_15_preview) +@added(Versions.v2024_05_01) union TranscriptContentType { string, @@ -1152,7 +1073,6 @@ union TranscriptContentType { /** Task definition for custom conversational summarization. */ @added(Versions.v2024_05_15_preview) -@doc("Task definition for custom conversational summarization.") model AnalyzeCustomConversationSummarizationTask extends AnalyzeConversationLROTask { /** discriminator kind */ @@ -1210,7 +1130,7 @@ union SummaryAspect { narrative: "narrative", /** A concise one-paragraph summary to provide a quick overview. */ - @added(Versions.v2023_11_15_preview) + @added(Versions.v2024_05_01) recap: "recap", /** Action items and tasks that arose during a meeting. */ @@ -1231,9 +1151,6 @@ model AnalyzeConversationSummarizationResult /** Result for the custom summarization task on the conversation. */ @added(Versions.v2024_05_15_preview) -@removed(Versions.v2024_05_01) -@added(Versions.v2023_11_15_preview) -@doc("Result for the custom summarization task on the conversation.") model AnalyzeCustomConversationSummarizationResult extends AnalyzeConversationJobResult { /** discriminator kind */ @@ -1259,8 +1176,6 @@ model SummaryResult { /** Custom Summary Results */ @added(Versions.v2024_05_15_preview) -@removed(Versions.v2024_05_01) -@added(Versions.v2023_11_15_preview) model CustomSummaryResult { ...SummaryResultBase; ...CustomResult; From a490d3e7c5d935397ff73cef769280c9ee47458c Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Wed, 24 Apr 2024 16:09:09 -0700 Subject: [PATCH 11/16] Fix compile error and add compiled swagger json --- .../Language.Conversations/main.tsp | 12 +- .../analyzeconversations.json | 1085 +++++++++-------- .../2024-05-01/analyzeconversations.json | 1081 ++++++++-------- 3 files changed, 1131 insertions(+), 1047 deletions(-) diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index 059139631167..0d6c66d26e84 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -1109,7 +1109,17 @@ model ConversationSummarizationTaskParameters is PreBuiltTaskParameters { /** Supported parameters for a custom conversation summarization task. */ @added(Versions.v2024_05_15_preview) model CustomConversationSummarizationTaskParameters is CustomTaskParameters { - ...ConversationSummarizationTaskParametersBase; + /** It controls the approximate number of sentences in the output summaries. */ + sentenceCount?: int32; + + /** String index type */ + stringIndexType?: StringIndexType = StringIndexType.TextElements_v8; + + /** (NOTE: Recommended to use summaryLength over sentenceCount) Controls the approximate length of the output summaries. */ + summaryLength?: SummaryLengthBucket; + + /** Array of Summary Aspects */ + summaryAspects: Array; } /** Supported parameters for a conversational summarization task. */ diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json index 7db288edf7b8..802c430078d9 100644 --- a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json @@ -3,7 +3,7 @@ "info": { "title": "Microsoft Cognitive Language Service - Analyze Conversations", "version": "2024-05-15-preview", - "description": "The language service conversations API is a suite of natural language processing (NLP) skills that can be used to analyze structured conversations (textual or spoken). The synchronous API in this suite accepts a request and mediates among multiple language projects, such as LUIS Generally Available, Question Answering, Conversational Language Understanding, and then calls the best candidate service to handle the request. At last, it returns a response with the candidate service's response as a payload.\n\n In some cases, this API needs to forward requests and responses between the caller and an upstream service. The asynchronous APIs in this suite enable tasks like Conversation Summarization and Conversational PII detection.", + "description": "The language service conversations API is a suite of natural language processing (NLP) skills that can be used to analyze structured conversations (textual or spoken). The synchronous API in this suite accepts a request and mediates among multiple language projects, such as LUIS Generally Available, Question Answering, Conversational Language Understanding, and then calls the best candidate service to handle the request. At last, it returns a response with the candidate service's response as a payload.\\n\\n In some cases, this API needs to forward requests and responses between the caller and an upstream service. The asynchronous APIs in this suite enable tasks like Conversation Summarization and Conversational PII detection.", "x-typespec-generated": [ { "emitter": "@azure-tools/typespec-autorest" @@ -57,7 +57,6 @@ { "name": "body", "in": "body", - "description": "Collection of conversations to analyze and a single task to execute.", "required": true, "schema": { "$ref": "#/definitions/AnalyzeConversationTask" @@ -74,12 +73,12 @@ "default": { "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponseWithHeader" + "$ref": "#/definitions/ErrorResponse" }, "headers": { "x-ms-error-code": { "type": "string", - "description": "The error code for specific error that occurred." + "description": "String error code indicating what went wrong." } } } @@ -129,6 +128,12 @@ "description": "An unexpected error response.", "schema": { "$ref": "#/definitions/ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } } } }, @@ -191,6 +196,12 @@ "description": "An unexpected error response.", "schema": { "$ref": "#/definitions/ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } } } }, @@ -219,7 +230,7 @@ "/analyze-conversations/jobs/{jobId}:cancel": { "post": { "operationId": "AnalyzeConversationsCancelJob", - "summary": "Cancel a long-running Text Analysis conversations job", + "summary": "Cancel a long-running Text Analysis conversations job.", "description": "Cancel a long-running job for text analysis of conversations.", "parameters": [ { @@ -228,7 +239,7 @@ { "name": "jobId", "in": "path", - "description": "job ID", + "description": "The job ID to cancel.", "required": true, "type": "string", "format": "uuid" @@ -249,6 +260,12 @@ "description": "An unexpected error response.", "schema": { "$ref": "#/definitions/ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } } } }, @@ -303,23 +320,28 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified age unit" }, { "name": "Year", - "value": "Year" + "value": "Year", + "description": "Year age unit" }, { "name": "Month", - "value": "Month" + "value": "Month", + "description": "Month age unit" }, { "name": "Week", - "value": "Week" + "value": "Week", + "description": "Week age unit" }, { "name": "Day", - "value": "Day" + "value": "Day", + "description": "Day age unit" } ] } @@ -597,24 +619,6 @@ ] } }, - "AnalyzeConversationSentimentResult": { - "type": "object", - "description": "Result from the sentiment analysis operation performed on a list of conversations.", - "properties": { - "results": { - "$ref": "#/definitions/ConversationSentimentResults", - "description": "The result from sentiment analysis operation for each conversation." - } - }, - "required": [ - "results" - ], - "allOf": [ - { - "$ref": "#/definitions/AnalyzeConversationJobResult" - } - ] - }, "AnalyzeConversationSummarizationResult": { "type": "object", "description": "Result for the summarization task on the conversation.", @@ -680,7 +684,8 @@ "values": [ { "name": "Conversation", - "value": "Conversation" + "value": "Conversation", + "description": "Conversation task kind" } ] } @@ -711,7 +716,8 @@ "values": [ { "name": "ConversationResult", - "value": "ConversationResult" + "value": "ConversationResult", + "description": "Conversation result task kind" } ] } @@ -805,18 +811,15 @@ "format": "double", "description": "Minimum threshold score for answers, value ranges from 0 to 1.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidenceThreshold" + "maximum": 1 }, "context": { "$ref": "#/definitions/KnowledgeBaseAnswerContext", - "description": "Context object with previous QnA's information.", - "x-ms-client-name": "answerContext" + "description": "Context object with previous QnA's information." }, "rankerType": { "$ref": "#/definitions/RankerKind", - "description": "Type of ranker to be used.", - "x-ms-client-name": "rankerKind" + "description": "Type of ranker to be used." }, "filters": { "$ref": "#/definitions/QueryFilters", @@ -824,8 +827,7 @@ }, "answerSpanRequest": { "$ref": "#/definitions/ShortAnswerOptions", - "description": "To configure Answer span prediction feature.", - "x-ms-client-name": "shortAnswerOptions" + "description": "To configure Answer span prediction feature." }, "includeUnstructuredSources": { "type": "boolean", @@ -895,55 +897,68 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified area unit" }, { "name": "SquareKilometer", - "value": "SquareKilometer" + "value": "SquareKilometer", + "description": "Square kilometer area unit" }, { "name": "SquareHectometer", - "value": "SquareHectometer" + "value": "SquareHectometer", + "description": "Square hectometer area unit" }, { "name": "SquareDecameter", - "value": "SquareDecameter" + "value": "SquareDecameter", + "description": "Square decameter area unit" }, { "name": "SquareDecimeter", - "value": "SquareDecimeter" + "value": "SquareDecimeter", + "description": "Square decimeter area unit" }, { "name": "SquareMeter", - "value": "SquareMeter" + "value": "SquareMeter", + "description": "Square meter area unit" }, { "name": "SquareCentimeter", - "value": "SquareCentimeter" + "value": "SquareCentimeter", + "description": "Square centimeter area unit" }, { "name": "SquareMillimeter", - "value": "SquareMillimeter" + "value": "SquareMillimeter", + "description": "Square millimeter area unit" }, { "name": "SquareInch", - "value": "SquareInch" + "value": "SquareInch", + "description": "Square inch area unit" }, { "name": "SquareFoot", - "value": "SquareFoot" + "value": "SquareFoot", + "description": "Square foot area unit" }, { "name": "SquareMile", - "value": "SquareMile" + "value": "SquareMile", + "description": "Square mile area unit" }, { "name": "SquareYard", - "value": "SquareYard" + "value": "SquareYard", + "description": "Square yard area unit" }, { "name": "Acre", - "value": "Acre" + "value": "Acre", + "description": "Acre area unit" } ] } @@ -1067,7 +1082,7 @@ "description": "The input ConversationItem and its optional parameters", "properties": { "conversationItem": { - "$ref": "#/definitions/ConversationItemBase", + "$ref": "#/definitions/TextConversationItem", "description": "The abstract base for a user input formatted conversation (e.g., Text, Transcript)." } }, @@ -1148,8 +1163,7 @@ "confidenceScore": { "type": "number", "format": "float", - "description": "The entity confidence score.", - "x-ms-client-name": "confidence" + "description": "The entity confidence score." }, "resolutions": { "type": "array", @@ -1189,8 +1203,7 @@ "format": "float", "description": "The confidence score of the class from 0.0 to 1.0.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidence" + "maximum": 1 } }, "required": [ @@ -1198,37 +1211,6 @@ "confidenceScore" ] }, - "ConversationItemBase": { - "type": "object", - "description": "The abstract base for a user input formatted conversation (e.g., Text, Transcript).", - "properties": { - "id": { - "type": "string", - "description": "The ID of a conversation item." - }, - "participantId": { - "type": "string", - "description": "The participant ID of a conversation item." - }, - "language": { - "type": "string", - "description": "The override language of a conversation item in BCP 47 language representation." - }, - "modality": { - "$ref": "#/definitions/InputModality", - "description": "Enumeration of supported conversational modalities." - }, - "role": { - "$ref": "#/definitions/role", - "description": "Role of the participant." - } - }, - "required": [ - "id", - "participantId" - ], - "additionalProperties": {} - }, "ConversationItemLevelTiming": { "type": "object", "description": "Audio timing at the conversation item level.", @@ -1282,43 +1264,53 @@ "values": [ { "name": "Address", - "value": "Address" + "value": "Address", + "description": "Address category" }, { "name": "CreditCardNumber", - "value": "CreditCardNumber" + "value": "CreditCardNumber", + "description": "Credit card number category" }, { "name": "Email", - "value": "Email" + "value": "Email", + "description": "Email category" }, { "name": "Person", - "value": "Person" + "value": "Person", + "description": "Person category" }, { "name": "NumericIdentifier", - "value": "NumericIdentifier" + "value": "NumericIdentifier", + "description": "Numeric identifier category" }, { "name": "PhoneNumber", - "value": "PhoneNumber" + "value": "PhoneNumber", + "description": "Phone number category" }, { "name": "USSocialSecurityNumber", - "value": "USSocialSecurityNumber" + "value": "USSocialSecurityNumber", + "description": "US social security number category" }, { "name": "Miscellaneous", - "value": "Miscellaneous" + "value": "Miscellaneous", + "description": "Miscellaneous category" }, { "name": "All", - "value": "All" + "value": "All", + "description": "All categories" }, { "name": "Default", - "value": "Default" + "value": "Default", + "description": "Default categories" } ] } @@ -1341,31 +1333,38 @@ "values": [ { "name": "Address", - "value": "Address" + "value": "Address", + "description": "Address category" }, { "name": "CreditCardNumber", - "value": "CreditCardNumber" + "value": "CreditCardNumber", + "description": "Credit card number category" }, { "name": "Email", - "value": "Email" + "value": "Email", + "description": "Email category" }, { "name": "Person", - "value": "Person" + "value": "Person", + "description": "Person category" }, { "name": "NumericIdentifier", - "value": "NumericIdentifier" + "value": "NumericIdentifier", + "description": "Numeric identifier category" }, { "name": "PhoneNumber", - "value": "PhoneNumber" + "value": "PhoneNumber", + "description": "Phone number category" }, { "name": "USSocialSecurityNumber", - "value": "USSocialSecurityNumber" + "value": "USSocialSecurityNumber", + "description": "US social security number category" } ] } @@ -1485,59 +1484,73 @@ "values": [ { "name": "exclamationPoint", - "value": "!" + "value": "!", + "description": "Exclamation point character" }, { "name": "numberSign", - "value": "#" + "value": "#", + "description": "Number sign character" }, { "name": "dollar", - "value": "$" + "value": "$", + "description": "Dollar sign character" }, { - "name": "percent", - "value": "%" + "name": "perCent", + "value": "%", + "description": "Percent sign character" }, { "name": "ampersand", - "value": "&" + "value": "&", + "description": "Ampersand character" }, { "name": "asterisk", - "value": "*" + "value": "*", + "description": "Asterisk character" }, { "name": "plus", - "value": "+" + "value": "+", + "description": "Plus sign character" }, { "name": "minus", - "value": "-" + "value": "-", + "description": "Minus sign character" }, { "name": "equals", - "value": "=" + "value": "=", + "description": "Equals sign character" }, { "name": "questionMark", - "value": "?" + "value": "?", + "description": "Question mark character" }, { "name": "atSign", - "value": "@" + "value": "@", + "description": "At sign character" }, { "name": "caret", - "value": "^" + "value": "^", + "description": "Caret character" }, { "name": "underscore", - "value": "_" + "value": "_", + "description": "Underscore character" }, { "name": "tilde", - "value": "~" + "value": "~", + "description": "Tilde character" } ] } @@ -1654,101 +1667,6 @@ "query" ] }, - "ConversationSentimentItemResult": { - "type": "object", - "description": "Sentiment operation results for a conversation items", - "properties": { - "id": { - "type": "string", - "description": "The identifier for the conversation item" - }, - "participantId": { - "type": "string", - "description": "The identifier for the speaker" - }, - "sentiment": { - "$ref": "#/definitions/TextSentiment", - "description": "Predicted sentiment" - }, - "confidenceScores": { - "$ref": "#/definitions/SentimentConfidenceScores", - "description": "Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative." - } - }, - "required": [ - "id", - "participantId", - "sentiment", - "confidenceScores" - ] - }, - "ConversationSentimentResults": { - "type": "object", - "description": "The result from sentiment analysis operation for each conversation.", - "properties": { - "errors": { - "type": "array", - "description": "Errors by document id.", - "items": { - "$ref": "#/definitions/DocumentError" - } - }, - "statistics": { - "$ref": "#/definitions/RequestStatistics", - "description": "statistics" - }, - "modelVersion": { - "type": "string", - "description": "This field indicates which model is used for scoring." - }, - "conversations": { - "type": "array", - "description": "Array of ConversationSentimentResults", - "items": { - "$ref": "#/definitions/ConversationSentimentResultsConversation" - } - } - }, - "required": [ - "errors", - "modelVersion", - "conversations" - ] - }, - "ConversationSentimentResultsConversation": { - "type": "object", - "description": "The result from sentiment analysis operation for each conversation.", - "properties": { - "id": { - "type": "string", - "description": "Unique, non-empty conversation identifier." - }, - "warnings": { - "type": "array", - "description": "Warnings encountered in processing the document.", - "items": { - "$ref": "#/definitions/InputWarning" - }, - "x-ms-identifiers": [] - }, - "statistics": { - "$ref": "#/definitions/ConversationStatistics", - "description": "If showStats=true was specified in the request this field will contain information about the conversation payload." - }, - "conversationItems": { - "type": "array", - "description": "Enumeration of Sentiment operation results for all the conversation items in a conversation.", - "items": { - "$ref": "#/definitions/ConversationSentimentItemResult" - } - } - }, - "required": [ - "id", - "warnings", - "conversationItems" - ] - }, "ConversationStatistics": { "type": "object", "description": "If showStats=true was specified in the request, this field contains information about the conversation payload.", @@ -2213,23 +2131,28 @@ "values": [ { "name": "Time", - "value": "Time" + "value": "Time", + "description": "Time subkind" }, { "name": "Date", - "value": "Date" + "value": "Date", + "description": "Date subkind" }, { "name": "DateTime", - "value": "DateTime" + "value": "DateTime", + "description": "DateTime subkind" }, { "name": "Duration", - "value": "Duration" + "value": "Duration", + "description": "Duration subkind" }, { "name": "Set", - "value": "Set" + "value": "Set", + "description": "Set subkind" } ] } @@ -2397,75 +2320,93 @@ "values": [ { "name": "InvalidRequest", - "value": "InvalidRequest" + "value": "InvalidRequest", + "description": "Invalid request error" }, { "name": "InvalidArgument", - "value": "InvalidArgument" + "value": "InvalidArgument", + "description": "Invalid argument error" }, { "name": "Unauthorized", - "value": "Unauthorized" + "value": "Unauthorized", + "description": "Unauthorized access error" }, { "name": "Forbidden", - "value": "Forbidden" + "value": "Forbidden", + "description": "Forbidden access error" }, { "name": "NotFound", - "value": "NotFound" + "value": "NotFound", + "description": "Not found error" }, { "name": "ProjectNotFound", - "value": "ProjectNotFound" + "value": "ProjectNotFound", + "description": "Project not found error" }, { "name": "OperationNotFound", - "value": "OperationNotFound" + "value": "OperationNotFound", + "description": "Operation not found error" }, { "name": "AzureCognitiveSearchNotFound", - "value": "AzureCognitiveSearchNotFound" + "value": "AzureCognitiveSearchNotFound", + "description": "Azure Cognitive Search not found error" }, { "name": "AzureCognitiveSearchIndexNotFound", - "value": "AzureCognitiveSearchIndexNotFound" + "value": "AzureCognitiveSearchIndexNotFound", + "description": "Azure Cognitive Search index not found error" }, { "name": "TooManyRequests", - "value": "TooManyRequests" + "value": "TooManyRequests", + "description": "Too many requests error" }, { "name": "AzureCognitiveSearchThrottling", - "value": "AzureCognitiveSearchThrottling" + "value": "AzureCognitiveSearchThrottling", + "description": "Azure Cognitive Search throttling error" }, { "name": "AzureCognitiveSearchIndexLimitReached", - "value": "AzureCognitiveSearchIndexLimitReached" + "value": "AzureCognitiveSearchIndexLimitReached", + "description": "Azure Cognitive Search index limit reached error" }, { "name": "InternalServerError", - "value": "InternalServerError" + "value": "InternalServerError", + "description": "Internal server error" }, { "name": "ServiceUnavailable", - "value": "ServiceUnavailable" + "value": "ServiceUnavailable", + "description": "Service unavailable error" }, { "name": "Timeout", - "value": "Timeout" + "value": "Timeout", + "description": "Timeout error" }, { "name": "QuotaExceeded", - "value": "QuotaExceeded" + "value": "QuotaExceeded", + "description": "Quota exceeded error" }, { "name": "Conflict", - "value": "Conflict" + "value": "Conflict", + "description": "Conflict error" }, { "name": "Warning", - "value": "Warning" + "value": "Warning", + "description": "Warning error" } ] } @@ -2483,19 +2424,6 @@ "error" ] }, - "ErrorResponseWithHeader": { - "type": "object", - "description": "Error response.", - "properties": { - "error": { - "$ref": "#/definitions/Error", - "description": "The error object." - } - }, - "required": [ - "error" - ] - }, "ExtraInformationKind": { "type": "string", "description": "The extra information object kind.", @@ -2510,15 +2438,18 @@ "values": [ { "name": "EntitySubtype", - "value": "EntitySubtype" + "value": "EntitySubtype", + "description": "Entity subtype extra information kind" }, { "name": "ListKey", - "value": "ListKey" + "value": "ListKey", + "description": "List key extra information kind" }, { "name": "RegexKey", - "value": "RegexKey" + "value": "RegexKey", + "description": "Regex key extra information kind" } ] } @@ -2572,55 +2503,68 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified information unit" }, { "name": "Bit", - "value": "Bit" + "value": "Bit", + "description": "Bit information unit" }, { "name": "Kilobit", - "value": "Kilobit" + "value": "Kilobit", + "description": "Kilobit information unit" }, { "name": "Megabit", - "value": "Megabit" + "value": "Megabit", + "description": "Megabit information unit" }, { "name": "Gigabit", - "value": "Gigabit" + "value": "Gigabit", + "description": "Gigabit information unit" }, { "name": "Terabit", - "value": "Terabit" + "value": "Terabit", + "description": "Terabit information unit" }, { "name": "Petabit", - "value": "Petabit" + "value": "Petabit", + "description": "Petabit information unit" }, { "name": "Byte", - "value": "Byte" + "value": "Byte", + "description": "Byte information unit" }, { "name": "Kilobyte", - "value": "Kilobyte" + "value": "Kilobyte", + "description": "Kilobyte information unit" }, { "name": "Megabyte", - "value": "Megabyte" + "value": "Megabyte", + "description": "Megabyte information unit" }, { "name": "Gigabyte", - "value": "Gigabyte" + "value": "Gigabyte", + "description": "Gigabyte information unit" }, { "name": "Terabyte", - "value": "Terabyte" + "value": "Terabyte", + "description": "Terabyte information unit" }, { "name": "Petabyte", - "value": "Petabyte" + "value": "Petabyte", + "description": "Petabyte information unit" } ] } @@ -2650,59 +2594,73 @@ "values": [ { "name": "InvalidRequest", - "value": "InvalidRequest" + "value": "InvalidRequest", + "description": "Invalid request error" }, { "name": "InvalidParameterValue", - "value": "InvalidParameterValue" + "value": "InvalidParameterValue", + "description": "Invalid parameter value error" }, { "name": "KnowledgeBaseNotFound", - "value": "KnowledgeBaseNotFound" + "value": "KnowledgeBaseNotFound", + "description": "Knowledge base not found error" }, { "name": "AzureCognitiveSearchNotFound", - "value": "AzureCognitiveSearchNotFound" + "value": "AzureCognitiveSearchNotFound", + "description": "Azure Cognitive Search not found error" }, { "name": "AzureCognitiveSearchThrottling", - "value": "AzureCognitiveSearchThrottling" + "value": "AzureCognitiveSearchThrottling", + "description": "Azure Cognitive Search throttling error" }, { "name": "ExtractionFailure", - "value": "ExtractionFailure" + "value": "ExtractionFailure", + "description": "Extraction failure error" }, { "name": "InvalidRequestBodyFormat", - "value": "InvalidRequestBodyFormat" + "value": "InvalidRequestBodyFormat", + "description": "Invalid request body format error" }, { "name": "EmptyRequest", - "value": "EmptyRequest" + "value": "EmptyRequest", + "description": "Empty request error" }, { "name": "MissingInputDocuments", - "value": "MissingInputDocuments" + "value": "MissingInputDocuments", + "description": "Missing input documents error" }, { "name": "InvalidDocument", - "value": "InvalidDocument" + "value": "InvalidDocument", + "description": "Invalid document error" }, { "name": "ModelVersionIncorrect", - "value": "ModelVersionIncorrect" + "value": "ModelVersionIncorrect", + "description": "Model version incorrect error" }, { "name": "InvalidDocumentBatch", - "value": "InvalidDocumentBatch" + "value": "InvalidDocumentBatch", + "description": "Invalid document batch error" }, { "name": "UnsupportedLanguageCode", - "value": "UnsupportedLanguageCode" + "value": "UnsupportedLanguageCode", + "description": "Unsupported language code error" }, { "name": "InvalidCountryHint", - "value": "InvalidCountryHint" + "value": "InvalidCountryHint", + "description": "Invalid country hint error" } ] } @@ -2753,11 +2711,13 @@ "values": [ { "name": "transcript", - "value": "transcript" + "value": "transcript", + "description": "Transcript input modality" }, { "name": "text", - "value": "text" + "value": "text", + "description": "Text input modality" } ] } @@ -2829,14 +2789,12 @@ "format": "double", "description": "Answer confidence score, value ranges from 0 to 1.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidence" + "maximum": 1 }, "id": { "type": "integer", "format": "int32", - "description": "ID of the QnA result.", - "x-ms-client-name": "qnaId" + "description": "ID of the QnA result." }, "source": { "type": "string", @@ -2855,8 +2813,7 @@ }, "answerSpan": { "$ref": "#/definitions/AnswerSpan", - "description": "Answer span object of QnA with respect to user's question.", - "x-ms-client-name": "shortAnswer" + "description": "Answer span object of QnA with respect to user's question." } } }, @@ -2871,8 +2828,7 @@ }, "previousUserQuery": { "type": "string", - "description": "Previous user query.", - "x-ms-client-name": "previousQuestion" + "description": "Previous user query." } }, "required": [ @@ -2972,71 +2928,88 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified length unit" }, { "name": "Kilometer", - "value": "Kilometer" + "value": "Kilometer", + "description": "Kilometer length unit" }, { "name": "Hectometer", - "value": "Hectometer" + "value": "Hectometer", + "description": "Hectometer length unit" }, { "name": "Decameter", - "value": "Decameter" + "value": "Decameter", + "description": "Decameter length unit" }, { "name": "Meter", - "value": "Meter" + "value": "Meter", + "description": "Meter length unit" }, { "name": "Decimeter", - "value": "Decimeter" + "value": "Decimeter", + "description": "Decimeter length unit" }, { "name": "Centimeter", - "value": "Centimeter" + "value": "Centimeter", + "description": "Centimeter length unit" }, { "name": "Millimeter", - "value": "Millimeter" + "value": "Millimeter", + "description": "Millimeter length unit" }, { "name": "Micrometer", - "value": "Micrometer" + "value": "Micrometer", + "description": "Micrometer length unit" }, { "name": "Nanometer", - "value": "Nanometer" + "value": "Nanometer", + "description": "Nanometer length unit" }, { "name": "Picometer", - "value": "Picometer" + "value": "Picometer", + "description": "Picometer length unit" }, { "name": "Mile", - "value": "Mile" + "value": "Mile", + "description": "Mile length unit" }, { "name": "Yard", - "value": "Yard" + "value": "Yard", + "description": "Yard length unit" }, { "name": "Inch", - "value": "Inch" + "value": "Inch", + "description": "Inch length unit" }, { "name": "Foot", - "value": "Foot" + "value": "Foot", + "description": "Foot length unit" }, { "name": "LightYear", - "value": "LightYear" + "value": "LightYear", + "description": "Light year length unit" }, { "name": "Pt", - "value": "Pt" + "value": "Pt", + "description": "Point length unit" } ] } @@ -3102,7 +3075,6 @@ "description": "This customizes how the service calls LUIS Generally Available projects." } }, - "additionalProperties": {}, "allOf": [ { "$ref": "#/definitions/AnalysisParameters" @@ -3110,12 +3082,17 @@ ], "x-ms-discriminator-value": "Luis" }, + "LuisResult": { + "type": "object", + "description": "It is the response from a LUIS Generally Available application.", + "additionalProperties": {} + }, "LuisTargetIntentResult": { "type": "object", "description": "It is a wrap up of LUIS Generally Available response.", "properties": { "result": { - "type": "object", + "$ref": "#/definitions/LuisResult", "description": "The actual response from a LUIS Generally Available application." } }, @@ -3230,27 +3207,33 @@ "values": [ { "name": "Integer", - "value": "Integer" + "value": "Integer", + "description": "Integer number" }, { "name": "Decimal", - "value": "Decimal" + "value": "Decimal", + "description": "Decimal number" }, { "name": "Power", - "value": "Power" + "value": "Power", + "description": "Power number" }, { "name": "Fraction", - "value": "Fraction" + "value": "Fraction", + "description": "Fraction number" }, { "name": "Percent", - "value": "Percent" + "value": "Percent", + "description": "Percent number" }, { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified number kind" } ] } @@ -3339,7 +3322,7 @@ "properties": { "offset": { "type": "string", - "description": "The offset With respect to the reference (e.g., offset = -1 in \"show me the second to last\"" + "description": "The offset with respect to the reference (e.g., offset = -1 indicates the second to last)" }, "relativeTo": { "$ref": "#/definitions/RelativeTo", @@ -3452,43 +3435,53 @@ "values": [ { "name": "Number", - "value": "Number" + "value": "Number", + "description": "Number range" }, { "name": "Speed", - "value": "Speed" + "value": "Speed", + "description": "Speed range" }, { "name": "Weight", - "value": "Weight" + "value": "Weight", + "description": "Weight range" }, { "name": "Length", - "value": "Length" + "value": "Length", + "description": "Length range" }, { "name": "Volume", - "value": "Volume" + "value": "Volume", + "description": "Volume range" }, { "name": "Area", - "value": "Area" + "value": "Area", + "description": "Area range" }, { "name": "Age", - "value": "Age" + "value": "Age", + "description": "Age range" }, { "name": "Information", - "value": "Information" + "value": "Information", + "description": "Information range" }, { "name": "Temperature", - "value": "Temperature" + "value": "Temperature", + "description": "Temperature range" }, { "name": "Currency", - "value": "Currency" + "value": "Currency", + "description": "Currency range" } ] } @@ -3581,15 +3574,18 @@ "values": [ { "name": "Current", - "value": "Current" + "value": "Current", + "description": "Current state" }, { "name": "End", - "value": "End" + "value": "End", + "description": "End state" }, { "name": "Start", - "value": "Start" + "value": "Start", + "description": "Start state" } ] } @@ -3652,93 +3648,82 @@ "values": [ { "name": "BooleanResolution", - "value": "BooleanResolution" + "value": "BooleanResolution", + "description": "Resolution of a boolean entity" }, { "name": "DateTimeResolution", - "value": "DateTimeResolution" + "value": "DateTimeResolution", + "description": "Resolution of a date/time entity" }, { "name": "NumberResolution", - "value": "NumberResolution" + "value": "NumberResolution", + "description": "Resolution of a number entity" }, { "name": "OrdinalResolution", - "value": "OrdinalResolution" + "value": "OrdinalResolution", + "description": "Resolution of an ordinal entity" }, { "name": "SpeedResolution", - "value": "SpeedResolution" + "value": "SpeedResolution", + "description": "Resolution of a speed entity" }, { "name": "WeightResolution", - "value": "WeightResolution" + "value": "WeightResolution", + "description": "Resolution of a weight entity" }, { "name": "LengthResolution", - "value": "LengthResolution" + "value": "LengthResolution", + "description": "Resolution of a length entity" }, { "name": "VolumeResolution", - "value": "VolumeResolution" + "value": "VolumeResolution", + "description": "Resolution of a volume entity" }, { "name": "AreaResolution", - "value": "AreaResolution" + "value": "AreaResolution", + "description": "Resolution of an area entity" }, { "name": "AgeResolution", - "value": "AgeResolution" + "value": "AgeResolution", + "description": "Resolution of an age entity" }, { "name": "InformationResolution", - "value": "InformationResolution" + "value": "InformationResolution", + "description": "Resolution of an information entity" }, { "name": "TemperatureResolution", - "value": "TemperatureResolution" + "value": "TemperatureResolution", + "description": "Resolution of a temperature entity" }, { "name": "CurrencyResolution", - "value": "CurrencyResolution" + "value": "CurrencyResolution", + "description": "Resolution of a currency entity" }, { "name": "NumericRangeResolution", - "value": "NumericRangeResolution" + "value": "NumericRangeResolution", + "description": "Resolution of a numeric range entity" }, { "name": "TemporalSpanResolution", - "value": "TemporalSpanResolution" + "value": "TemporalSpanResolution", + "description": "Resolution of a temporal span entity" } ] } }, - "SentimentConfidenceScores": { - "type": "object", - "description": "Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative.", - "properties": { - "positive": { - "type": "number", - "format": "double", - "description": "Confidence score for positive sentiment" - }, - "neutral": { - "type": "number", - "format": "double", - "description": "Confidence score for neutral sentiment" - }, - "negative": { - "type": "number", - "format": "double", - "description": "Confidence score for negative sentiment" - } - }, - "required": [ - "positive", - "neutral", - "negative" - ] - }, "ShortAnswerOptions": { "type": "object", "description": "To configure Answer span prediction feature.", @@ -3746,30 +3731,23 @@ "enable": { "type": "boolean", "description": "Enable or disable Answer Span prediction.", - "enum": [ - true - ] + "default": true }, "confidenceScoreThreshold": { "type": "number", "format": "double", "description": "Minimum threshold score required to include an answer span, value ranges from 0 to 1.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidenceThreshold" + "maximum": 1 }, "topAnswersWithSpan": { "type": "integer", "format": "int32", "description": "Number of Top answers to be considered for span prediction from 1 to 10.", "minimum": 1, - "maximum": 10, - "x-ms-client-name": "top" + "maximum": 10 } - }, - "required": [ - "enable" - ] + } }, "SourceFilter": { "type": "array", @@ -3828,59 +3806,73 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified speed unit" }, { "name": "MetersPerSecond", - "value": "MetersPerSecond" + "value": "MetersPerSecond", + "description": "Meters per second speed unit" }, { "name": "KilometersPerHour", - "value": "KilometersPerHour" + "value": "KilometersPerHour", + "description": "Kilometers per hour speed unit" }, { "name": "KilometersPerMinute", - "value": "KilometersPerMinute" + "value": "KilometersPerMinute", + "description": "Kilometers per minute speed unit" }, { "name": "KilometersPerSecond", - "value": "KilometersPerSecond" + "value": "KilometersPerSecond", + "description": "Kilometers per second speed unit" }, { "name": "MilesPerHour", - "value": "MilesPerHour" + "value": "MilesPerHour", + "description": "Miles per hour speed unit" }, { "name": "Knot", - "value": "Knot" + "value": "Knot", + "description": "Knot speed unit" }, { "name": "FootPerSecond", - "value": "FootPerSecond" + "value": "FootPerSecond", + "description": "Foot per second speed unit" }, { "name": "FootPerMinute", - "value": "FootPerMinute" + "value": "FootPerMinute", + "description": "Foot per minute speed unit" }, { "name": "YardsPerMinute", - "value": "YardsPerMinute" + "value": "YardsPerMinute", + "description": "Yards per minute speed unit" }, { "name": "YardsPerSecond", - "value": "YardsPerSecond" + "value": "YardsPerSecond", + "description": "Yards per second speed unit" }, { "name": "MetersPerMillisecond", - "value": "MetersPerMillisecond" + "value": "MetersPerMillisecond", + "description": "Meters per millisecond speed unit" }, { "name": "CentimetersPerMillisecond", - "value": "CentimetersPerMillisecond" + "value": "CentimetersPerMillisecond", + "description": "Centimeters per millisecond speed unit" }, { "name": "KilometersPerMillisecond", - "value": "KilometersPerMillisecond" + "value": "KilometersPerMillisecond", + "description": "Kilometers per millisecond speed unit" } ] } @@ -3903,31 +3895,38 @@ "values": [ { "name": "notStarted", - "value": "notStarted" + "value": "notStarted", + "description": "Not started state" }, { "name": "running", - "value": "running" + "value": "running", + "description": "Running state" }, { "name": "succeeded", - "value": "succeeded" + "value": "succeeded", + "description": "Succeeded state" }, { "name": "partiallyCompleted", - "value": "partiallyCompleted" + "value": "partiallyCompleted", + "description": "Partially completed state" }, { "name": "failed", - "value": "failed" + "value": "failed", + "description": "Failed state" }, { "name": "cancelled", - "value": "cancelled" + "value": "cancelled", + "description": "Cancelled state" }, { "name": "cancelling", - "value": "cancelling" + "value": "cancelling", + "description": "Cancelling state" } ] } @@ -3973,9 +3972,9 @@ "description": "A concise one-paragraph summary to provide a quick overview." }, { - "name": "follow-up tasks", + "name": "followUpTasks", "value": "follow-up tasks", - "description": "Action items and tasks that arose during a meeting. " + "description": "Action items and tasks that arose during a meeting." } ] } @@ -4086,8 +4085,7 @@ "format": "double", "description": "The prediction score and it ranges from 0.0 to 1.0.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidence" + "maximum": 1 } }, "discriminator": "targetProjectKind", @@ -4177,23 +4175,28 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified temperature unit" }, { "name": "Fahrenheit", - "value": "Fahrenheit" + "value": "Fahrenheit", + "description": "Fahrenheit temperature unit" }, { "name": "Kelvin", - "value": "Kelvin" + "value": "Kelvin", + "description": "Kelvin temperature unit" }, { "name": "Rankine", - "value": "Rankine" + "value": "Rankine", + "description": "Rankine temperature unit" }, { "name": "Celsius", - "value": "Celsius" + "value": "Celsius", + "description": "Celsius temperature unit" } ] } @@ -4227,75 +4230,93 @@ "values": [ { "name": "AfterApprox", - "value": "AfterApprox" + "value": "AfterApprox", + "description": "AfterApprox temporal modifier" }, { "name": "Before", - "value": "Before" + "value": "Before", + "description": "Before temporal modifier" }, { "name": "BeforeStart", - "value": "BeforeStart" + "value": "BeforeStart", + "description": "BeforeStart temporal modifier" }, { "name": "Approx", - "value": "Approx" + "value": "Approx", + "description": "Approx temporal modifier" }, { "name": "ReferenceUndefined", - "value": "ReferenceUndefined" + "value": "ReferenceUndefined", + "description": "ReferenceUndefined temporal modifier" }, { "name": "SinceEnd", - "value": "SinceEnd" + "value": "SinceEnd", + "description": "SinceEnd temporal modifier" }, { "name": "AfterMid", - "value": "AfterMid" + "value": "AfterMid", + "description": "AfterMid temporal modifier" }, { "name": "Start", - "value": "Start" + "value": "Start", + "description": "Start temporal modifier" }, { "name": "After", - "value": "After" + "value": "After", + "description": "After temporal modifier" }, { "name": "BeforeEnd", - "value": "BeforeEnd" + "value": "BeforeEnd", + "description": "BeforeEnd temporal modifier" }, { "name": "Until", - "value": "Until" + "value": "Until", + "description": "Until temporal modifier" }, { "name": "End", - "value": "End" + "value": "End", + "description": "End temporal modifier" }, { "name": "Less", - "value": "Less" + "value": "Less", + "description": "Less temporal modifier" }, { "name": "Since", - "value": "Since" + "value": "Since", + "description": "Since temporal modifier" }, { "name": "AfterStart", - "value": "AfterStart" + "value": "AfterStart", + "description": "AfterStart temporal modifier" }, { "name": "BeforeApprox", - "value": "BeforeApprox" + "value": "BeforeApprox", + "description": "BeforeApprox temporal modifier" }, { "name": "Mid", - "value": "Mid" + "value": "Mid", + "description": "Mid temporal modifier" }, { "name": "More", - "value": "More" + "value": "More", + "description": "More temporal modifier" } ] } @@ -4387,44 +4408,7 @@ "id", "participantId", "text" - ], - "additionalProperties": {} - }, - "TextSentiment": { - "type": "string", - "description": "Predicted sentiment", - "enum": [ - "positive", - "neutral", - "negative", - "mixed" - ], - "x-ms-enum": { - "name": "TextSentiment", - "modelAsString": true, - "values": [ - { - "name": "positive", - "value": "positive", - "description": "Positive statement" - }, - { - "name": "neutral", - "value": "neutral", - "description": "Neutral statement" - }, - { - "name": "negative", - "value": "negative", - "description": "Negative statement" - }, - { - "name": "mixed", - "value": "mixed", - "description": "Mixed statement" - } - ] - } + ] }, "TranscriptContentType": { "type": "string", @@ -4441,19 +4425,23 @@ "values": [ { "name": "lexical", - "value": "lexical" + "value": "lexical", + "description": "Lexical content type" }, { "name": "itn", - "value": "itn" + "value": "itn", + "description": "ITN content type" }, { "name": "maskedItn", - "value": "maskedItn" + "value": "maskedItn", + "description": "Masked ITN content type" }, { "name": "text", - "value": "text" + "value": "text", + "description": "Text content type" } ] } @@ -4540,8 +4528,7 @@ "maskedItn", "text", "lexical" - ], - "additionalProperties": {} + ] }, "VolumeResolution": { "type": "object", @@ -4607,115 +4594,143 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified volume unit." }, { "name": "CubicMeter", - "value": "CubicMeter" + "value": "CubicMeter", + "description": "Volume unit in cubic meters." }, { "name": "CubicCentimeter", - "value": "CubicCentimeter" + "value": "CubicCentimeter", + "description": "Volume unit in cubic centimeters." }, { "name": "CubicMillimeter", - "value": "CubicMillimeter" + "value": "CubicMillimeter", + "description": "Volume unit in cubic millimeters." }, { "name": "Hectoliter", - "value": "Hectoliter" + "value": "Hectoliter", + "description": "Volume unit in hectoliters." }, { "name": "Decaliter", - "value": "Decaliter" + "value": "Decaliter", + "description": "Volume unit in decaliters." }, { "name": "Liter", - "value": "Liter" + "value": "Liter", + "description": "Volume unit in liters." }, { "name": "Centiliter", - "value": "Centiliter" + "value": "Centiliter", + "description": "Volume unit in centiliters." }, { "name": "Milliliter", - "value": "Milliliter" + "value": "Milliliter", + "description": "Volume unit in milliliters." }, { "name": "CubicYard", - "value": "CubicYard" + "value": "CubicYard", + "description": "Volume unit in cubic yards." }, { "name": "CubicInch", - "value": "CubicInch" + "value": "CubicInch", + "description": "Volume unit in cubic inches." }, { "name": "CubicFoot", - "value": "CubicFoot" + "value": "CubicFoot", + "description": "Volume unit in cubic feet." }, { "name": "CubicMile", - "value": "CubicMile" + "value": "CubicMile", + "description": "Volume unit in cubic miles." }, { "name": "FluidOunce", - "value": "FluidOunce" + "value": "FluidOunce", + "description": "Volume unit in fluid ounces." }, { "name": "Teaspoon", - "value": "Teaspoon" + "value": "Teaspoon", + "description": "Volume unit in teaspoons." }, { "name": "Tablespoon", - "value": "Tablespoon" + "value": "Tablespoon", + "description": "Volume unit in tablespoons." }, { "name": "Pint", - "value": "Pint" + "value": "Pint", + "description": "Volume unit in pints." }, { "name": "Quart", - "value": "Quart" + "value": "Quart", + "description": "Volume unit in quarts." }, { "name": "Cup", - "value": "Cup" + "value": "Cup", + "description": "Volume unit in cups." }, { "name": "Gill", - "value": "Gill" + "value": "Gill", + "description": "Volume unit in gills." }, { "name": "Pinch", - "value": "Pinch" + "value": "Pinch", + "description": "Volume unit in pinches." }, { "name": "FluidDram", - "value": "FluidDram" + "value": "FluidDram", + "description": "Volume unit in fluid drams." }, { "name": "Barrel", - "value": "Barrel" + "value": "Barrel", + "description": "Volume unit in barrels." }, { "name": "Minim", - "value": "Minim" + "value": "Minim", + "description": "Volume unit in minims." }, { "name": "Cord", - "value": "Cord" + "value": "Cord", + "description": "Volume unit in cords." }, { "name": "Peck", - "value": "Peck" + "value": "Peck", + "description": "Volume unit in pecks." }, { "name": "Bushel", - "value": "Bushel" + "value": "Bushel", + "description": "Volume unit in bushels." }, { "name": "Hogshead", - "value": "Hogshead" + "value": "Hogshead", + "description": "Volume unit in hogsheads." } ] } @@ -4772,67 +4787,83 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified weight unit" }, { "name": "Kilogram", - "value": "Kilogram" + "value": "Kilogram", + "description": "Weight unit in kilograms" }, { "name": "Gram", - "value": "Gram" + "value": "Gram", + "description": "Weight unit in grams" }, { "name": "Milligram", - "value": "Milligram" + "value": "Milligram", + "description": "Weight unit in milligrams" }, { "name": "Gallon", - "value": "Gallon" + "value": "Gallon", + "description": "Volume unit in gallons" }, { "name": "MetricTon", - "value": "MetricTon" + "value": "MetricTon", + "description": "Weight unit in metric tons" }, { "name": "Ton", - "value": "Ton" + "value": "Ton", + "description": "Weight unit in tons" }, { "name": "Pound", - "value": "Pound" + "value": "Pound", + "description": "Weight unit in pounds" }, { "name": "Ounce", - "value": "Ounce" + "value": "Ounce", + "description": "Weight unit in ounces" }, { "name": "Grain", - "value": "Grain" + "value": "Grain", + "description": "Weight unit in grains" }, { "name": "PennyWeight", - "value": "PennyWeight" + "value": "PennyWeight", + "description": "Weight unit in pennyweights" }, { "name": "LongTonBritish", - "value": "LongTonBritish" + "value": "LongTonBritish", + "description": "Weight unit in long tons (British)" }, { "name": "ShortTonUS", - "value": "ShortTonUS" + "value": "ShortTonUS", + "description": "Weight unit in short tons (US)" }, { "name": "ShortHundredWeightUS", - "value": "ShortHundredWeightUS" + "value": "ShortHundredWeightUS", + "description": "Weight unit in short hundredweights (US)" }, { "name": "Stone", - "value": "Stone" + "value": "Stone", + "description": "Weight unit in stones" }, { "name": "Dram", - "value": "Dram" + "value": "Dram", + "description": "Weight unit in drams" } ] } @@ -4870,11 +4901,13 @@ "values": [ { "name": "Conversation", - "value": "Conversation" + "value": "Conversation", + "description": "Conversation type" }, { "name": "Orchestration", - "value": "Orchestration" + "value": "Orchestration", + "description": "Orchestration type" } ] } @@ -4924,19 +4957,23 @@ "values": [ { "name": "Luis", - "value": "Luis" + "value": "Luis", + "description": "Luis target service type" }, { "name": "Conversation", - "value": "Conversation" + "value": "Conversation", + "description": "Conversation target service type" }, { "name": "QuestionAnswering", - "value": "QuestionAnswering" + "value": "QuestionAnswering", + "description": "QuestionAnswering target service type" }, { "name": "NonLinked", - "value": "NonLinked" + "value": "NonLinked", + "description": "NonLinked target service type" } ] } diff --git a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json index c5c524165629..af2147e67443 100644 --- a/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json +++ b/specification/cognitiveservices/data-plane/Language/stable/2024-05-01/analyzeconversations.json @@ -3,7 +3,7 @@ "info": { "title": "Microsoft Cognitive Language Service - Analyze Conversations", "version": "2024-05-01", - "description": "The language service conversations API is a suite of natural language processing (NLP) skills that can be used to analyze structured conversations (textual or spoken). The synchronous API in this suite accepts a request and mediates among multiple language projects, such as LUIS Generally Available, Question Answering, Conversational Language Understanding, and then calls the best candidate service to handle the request. At last, it returns a response with the candidate service's response as a payload.\n\n In some cases, this API needs to forward requests and responses between the caller and an upstream service. The asynchronous APIs in this suite enable tasks like Conversation Summarization and Conversational PII detection.", + "description": "The language service conversations API is a suite of natural language processing (NLP) skills that can be used to analyze structured conversations (textual or spoken). The synchronous API in this suite accepts a request and mediates among multiple language projects, such as LUIS Generally Available, Question Answering, Conversational Language Understanding, and then calls the best candidate service to handle the request. At last, it returns a response with the candidate service's response as a payload.\\n\\n In some cases, this API needs to forward requests and responses between the caller and an upstream service. The asynchronous APIs in this suite enable tasks like Conversation Summarization and Conversational PII detection.", "x-typespec-generated": [ { "emitter": "@azure-tools/typespec-autorest" @@ -57,7 +57,6 @@ { "name": "body", "in": "body", - "description": "Collection of conversations to analyze and a single task to execute.", "required": true, "schema": { "$ref": "#/definitions/AnalyzeConversationTask" @@ -74,12 +73,12 @@ "default": { "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponseWithHeader" + "$ref": "#/definitions/ErrorResponse" }, "headers": { "x-ms-error-code": { "type": "string", - "description": "The error code for specific error that occurred." + "description": "String error code indicating what went wrong." } } } @@ -129,6 +128,12 @@ "description": "An unexpected error response.", "schema": { "$ref": "#/definitions/ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } } } }, @@ -188,6 +193,12 @@ "description": "An unexpected error response.", "schema": { "$ref": "#/definitions/ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } } } }, @@ -213,7 +224,7 @@ "/analyze-conversations/jobs/{jobId}:cancel": { "post": { "operationId": "AnalyzeConversationsCancelJob", - "summary": "Cancel a long-running Text Analysis conversations job", + "summary": "Cancel a long-running Text Analysis conversations job.", "description": "Cancel a long-running job for text analysis of conversations.", "parameters": [ { @@ -222,7 +233,7 @@ { "name": "jobId", "in": "path", - "description": "job ID", + "description": "The job ID to cancel.", "required": true, "type": "string", "format": "uuid" @@ -243,6 +254,12 @@ "description": "An unexpected error response.", "schema": { "$ref": "#/definitions/ErrorResponse" + }, + "headers": { + "x-ms-error-code": { + "type": "string", + "description": "String error code indicating what went wrong." + } } } }, @@ -297,23 +314,28 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified age unit" }, { "name": "Year", - "value": "Year" + "value": "Year", + "description": "Year age unit" }, { "name": "Month", - "value": "Month" + "value": "Month", + "description": "Month age unit" }, { "name": "Week", - "value": "Week" + "value": "Week", + "description": "Week age unit" }, { "name": "Day", - "value": "Day" + "value": "Day", + "description": "Day age unit" } ] } @@ -579,24 +601,6 @@ ] } }, - "AnalyzeConversationSentimentResult": { - "type": "object", - "description": "Result from the sentiment analysis operation performed on a list of conversations.", - "properties": { - "results": { - "$ref": "#/definitions/ConversationSentimentResults", - "description": "The result from sentiment analysis operation for each conversation." - } - }, - "required": [ - "results" - ], - "allOf": [ - { - "$ref": "#/definitions/AnalyzeConversationJobResult" - } - ] - }, "AnalyzeConversationSummarizationResult": { "type": "object", "description": "Result for the summarization task on the conversation.", @@ -662,7 +666,8 @@ "values": [ { "name": "Conversation", - "value": "Conversation" + "value": "Conversation", + "description": "Conversation task kind" } ] } @@ -693,7 +698,8 @@ "values": [ { "name": "ConversationResult", - "value": "ConversationResult" + "value": "ConversationResult", + "description": "Conversation result task kind" } ] } @@ -752,18 +758,15 @@ "format": "double", "description": "Minimum threshold score for answers, value ranges from 0 to 1.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidenceThreshold" + "maximum": 1 }, "context": { "$ref": "#/definitions/KnowledgeBaseAnswerContext", - "description": "Context object with previous QnA's information.", - "x-ms-client-name": "answerContext" + "description": "Context object with previous QnA's information." }, "rankerType": { "$ref": "#/definitions/RankerKind", - "description": "Type of ranker to be used.", - "x-ms-client-name": "rankerKind" + "description": "Type of ranker to be used." }, "filters": { "$ref": "#/definitions/QueryFilters", @@ -771,8 +774,7 @@ }, "answerSpanRequest": { "$ref": "#/definitions/ShortAnswerOptions", - "description": "To configure Answer span prediction feature.", - "x-ms-client-name": "shortAnswerOptions" + "description": "To configure Answer span prediction feature." }, "includeUnstructuredSources": { "type": "boolean", @@ -842,55 +844,68 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified area unit" }, { "name": "SquareKilometer", - "value": "SquareKilometer" + "value": "SquareKilometer", + "description": "Square kilometer area unit" }, { "name": "SquareHectometer", - "value": "SquareHectometer" + "value": "SquareHectometer", + "description": "Square hectometer area unit" }, { "name": "SquareDecameter", - "value": "SquareDecameter" + "value": "SquareDecameter", + "description": "Square decameter area unit" }, { "name": "SquareDecimeter", - "value": "SquareDecimeter" + "value": "SquareDecimeter", + "description": "Square decimeter area unit" }, { "name": "SquareMeter", - "value": "SquareMeter" + "value": "SquareMeter", + "description": "Square meter area unit" }, { "name": "SquareCentimeter", - "value": "SquareCentimeter" + "value": "SquareCentimeter", + "description": "Square centimeter area unit" }, { "name": "SquareMillimeter", - "value": "SquareMillimeter" + "value": "SquareMillimeter", + "description": "Square millimeter area unit" }, { "name": "SquareInch", - "value": "SquareInch" + "value": "SquareInch", + "description": "Square inch area unit" }, { "name": "SquareFoot", - "value": "SquareFoot" + "value": "SquareFoot", + "description": "Square foot area unit" }, { "name": "SquareMile", - "value": "SquareMile" + "value": "SquareMile", + "description": "Square mile area unit" }, { "name": "SquareYard", - "value": "SquareYard" + "value": "SquareYard", + "description": "Square yard area unit" }, { "name": "Acre", - "value": "Acre" + "value": "Acre", + "description": "Acre area unit" } ] } @@ -1014,7 +1029,7 @@ "description": "The input ConversationItem and its optional parameters", "properties": { "conversationItem": { - "$ref": "#/definitions/ConversationItemBase", + "$ref": "#/definitions/TextConversationItem", "description": "The abstract base for a user input formatted conversation (e.g., Text, Transcript)." } }, @@ -1095,8 +1110,7 @@ "confidenceScore": { "type": "number", "format": "float", - "description": "The entity confidence score.", - "x-ms-client-name": "confidence" + "description": "The entity confidence score." }, "resolutions": { "type": "array", @@ -1136,8 +1150,7 @@ "format": "float", "description": "The confidence score of the class from 0.0 to 1.0.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidence" + "maximum": 1 } }, "required": [ @@ -1145,37 +1158,6 @@ "confidenceScore" ] }, - "ConversationItemBase": { - "type": "object", - "description": "The abstract base for a user input formatted conversation (e.g., Text, Transcript).", - "properties": { - "id": { - "type": "string", - "description": "The ID of a conversation item." - }, - "participantId": { - "type": "string", - "description": "The participant ID of a conversation item." - }, - "language": { - "type": "string", - "description": "The override language of a conversation item in BCP 47 language representation." - }, - "modality": { - "$ref": "#/definitions/InputModality", - "description": "Enumeration of supported conversational modalities." - }, - "role": { - "$ref": "#/definitions/role", - "description": "Role of the participant." - } - }, - "required": [ - "id", - "participantId" - ], - "additionalProperties": {} - }, "ConversationItemLevelTiming": { "type": "object", "description": "Audio timing at the conversation item level.", @@ -1229,43 +1211,53 @@ "values": [ { "name": "Address", - "value": "Address" + "value": "Address", + "description": "Address category" }, { "name": "CreditCardNumber", - "value": "CreditCardNumber" + "value": "CreditCardNumber", + "description": "Credit card number category" }, { "name": "Email", - "value": "Email" + "value": "Email", + "description": "Email category" }, { "name": "Person", - "value": "Person" + "value": "Person", + "description": "Person category" }, { "name": "NumericIdentifier", - "value": "NumericIdentifier" + "value": "NumericIdentifier", + "description": "Numeric identifier category" }, { "name": "PhoneNumber", - "value": "PhoneNumber" + "value": "PhoneNumber", + "description": "Phone number category" }, { "name": "USSocialSecurityNumber", - "value": "USSocialSecurityNumber" + "value": "USSocialSecurityNumber", + "description": "US social security number category" }, { "name": "Miscellaneous", - "value": "Miscellaneous" + "value": "Miscellaneous", + "description": "Miscellaneous category" }, { "name": "All", - "value": "All" + "value": "All", + "description": "All categories" }, { "name": "Default", - "value": "Default" + "value": "Default", + "description": "Default categories" } ] } @@ -1288,31 +1280,38 @@ "values": [ { "name": "Address", - "value": "Address" + "value": "Address", + "description": "Address category" }, { "name": "CreditCardNumber", - "value": "CreditCardNumber" + "value": "CreditCardNumber", + "description": "Credit card number category" }, { "name": "Email", - "value": "Email" + "value": "Email", + "description": "Email category" }, { "name": "Person", - "value": "Person" + "value": "Person", + "description": "Person category" }, { "name": "NumericIdentifier", - "value": "NumericIdentifier" + "value": "NumericIdentifier", + "description": "Numeric identifier category" }, { "name": "PhoneNumber", - "value": "PhoneNumber" + "value": "PhoneNumber", + "description": "Phone number category" }, { "name": "USSocialSecurityNumber", - "value": "USSocialSecurityNumber" + "value": "USSocialSecurityNumber", + "description": "US social security number category" } ] } @@ -1432,59 +1431,73 @@ "values": [ { "name": "exclamationPoint", - "value": "!" + "value": "!", + "description": "Exclamation point character" }, { "name": "numberSign", - "value": "#" + "value": "#", + "description": "Number sign character" }, { "name": "dollar", - "value": "$" + "value": "$", + "description": "Dollar sign character" }, { - "name": "percent", - "value": "%" + "name": "perCent", + "value": "%", + "description": "Percent sign character" }, { "name": "ampersand", - "value": "&" + "value": "&", + "description": "Ampersand character" }, { "name": "asterisk", - "value": "*" + "value": "*", + "description": "Asterisk character" }, { "name": "plus", - "value": "+" + "value": "+", + "description": "Plus sign character" }, { "name": "minus", - "value": "-" + "value": "-", + "description": "Minus sign character" }, { "name": "equals", - "value": "=" + "value": "=", + "description": "Equals sign character" }, { "name": "questionMark", - "value": "?" + "value": "?", + "description": "Question mark character" }, { "name": "atSign", - "value": "@" + "value": "@", + "description": "At sign character" }, { "name": "caret", - "value": "^" + "value": "^", + "description": "Caret character" }, { "name": "underscore", - "value": "_" + "value": "_", + "description": "Underscore character" }, { "name": "tilde", - "value": "~" + "value": "~", + "description": "Tilde character" } ] } @@ -1601,101 +1614,6 @@ "query" ] }, - "ConversationSentimentItemResult": { - "type": "object", - "description": "Sentiment operation results for a conversation items", - "properties": { - "id": { - "type": "string", - "description": "The identifier for the conversation item" - }, - "participantId": { - "type": "string", - "description": "The identifier for the speaker" - }, - "sentiment": { - "$ref": "#/definitions/TextSentiment", - "description": "Predicted sentiment" - }, - "confidenceScores": { - "$ref": "#/definitions/SentimentConfidenceScores", - "description": "Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative." - } - }, - "required": [ - "id", - "participantId", - "sentiment", - "confidenceScores" - ] - }, - "ConversationSentimentResults": { - "type": "object", - "description": "The result from sentiment analysis operation for each conversation.", - "properties": { - "errors": { - "type": "array", - "description": "Errors by document id.", - "items": { - "$ref": "#/definitions/DocumentError" - } - }, - "statistics": { - "$ref": "#/definitions/RequestStatistics", - "description": "statistics" - }, - "modelVersion": { - "type": "string", - "description": "This field indicates which model is used for scoring." - }, - "conversations": { - "type": "array", - "description": "Array of ConversationSentimentResults", - "items": { - "$ref": "#/definitions/ConversationSentimentResultsConversation" - } - } - }, - "required": [ - "errors", - "modelVersion", - "conversations" - ] - }, - "ConversationSentimentResultsConversation": { - "type": "object", - "description": "The result from sentiment analysis operation for each conversation.", - "properties": { - "id": { - "type": "string", - "description": "Unique, non-empty conversation identifier." - }, - "warnings": { - "type": "array", - "description": "Warnings encountered in processing the document.", - "items": { - "$ref": "#/definitions/InputWarning" - }, - "x-ms-identifiers": [] - }, - "statistics": { - "$ref": "#/definitions/ConversationStatistics", - "description": "If showStats=true was specified in the request this field will contain information about the conversation payload." - }, - "conversationItems": { - "type": "array", - "description": "Enumeration of Sentiment operation results for all the conversation items in a conversation.", - "items": { - "$ref": "#/definitions/ConversationSentimentItemResult" - } - } - }, - "required": [ - "id", - "warnings", - "conversationItems" - ] - }, "ConversationStatistics": { "type": "object", "description": "If showStats=true was specified in the request, this field contains information about the conversation payload.", @@ -2051,23 +1969,28 @@ "values": [ { "name": "Time", - "value": "Time" + "value": "Time", + "description": "Time subkind" }, { "name": "Date", - "value": "Date" + "value": "Date", + "description": "Date subkind" }, { "name": "DateTime", - "value": "DateTime" + "value": "DateTime", + "description": "DateTime subkind" }, { "name": "Duration", - "value": "Duration" + "value": "Duration", + "description": "Duration subkind" }, { "name": "Set", - "value": "Set" + "value": "Set", + "description": "Set subkind" } ] } @@ -2209,75 +2132,93 @@ "values": [ { "name": "InvalidRequest", - "value": "InvalidRequest" + "value": "InvalidRequest", + "description": "Invalid request error" }, { "name": "InvalidArgument", - "value": "InvalidArgument" + "value": "InvalidArgument", + "description": "Invalid argument error" }, { "name": "Unauthorized", - "value": "Unauthorized" + "value": "Unauthorized", + "description": "Unauthorized access error" }, { "name": "Forbidden", - "value": "Forbidden" + "value": "Forbidden", + "description": "Forbidden access error" }, { "name": "NotFound", - "value": "NotFound" + "value": "NotFound", + "description": "Not found error" }, { "name": "ProjectNotFound", - "value": "ProjectNotFound" + "value": "ProjectNotFound", + "description": "Project not found error" }, { "name": "OperationNotFound", - "value": "OperationNotFound" + "value": "OperationNotFound", + "description": "Operation not found error" }, { "name": "AzureCognitiveSearchNotFound", - "value": "AzureCognitiveSearchNotFound" + "value": "AzureCognitiveSearchNotFound", + "description": "Azure Cognitive Search not found error" }, { "name": "AzureCognitiveSearchIndexNotFound", - "value": "AzureCognitiveSearchIndexNotFound" + "value": "AzureCognitiveSearchIndexNotFound", + "description": "Azure Cognitive Search index not found error" }, { "name": "TooManyRequests", - "value": "TooManyRequests" + "value": "TooManyRequests", + "description": "Too many requests error" }, { "name": "AzureCognitiveSearchThrottling", - "value": "AzureCognitiveSearchThrottling" + "value": "AzureCognitiveSearchThrottling", + "description": "Azure Cognitive Search throttling error" }, { "name": "AzureCognitiveSearchIndexLimitReached", - "value": "AzureCognitiveSearchIndexLimitReached" + "value": "AzureCognitiveSearchIndexLimitReached", + "description": "Azure Cognitive Search index limit reached error" }, { "name": "InternalServerError", - "value": "InternalServerError" + "value": "InternalServerError", + "description": "Internal server error" }, { "name": "ServiceUnavailable", - "value": "ServiceUnavailable" + "value": "ServiceUnavailable", + "description": "Service unavailable error" }, { "name": "Timeout", - "value": "Timeout" + "value": "Timeout", + "description": "Timeout error" }, { "name": "QuotaExceeded", - "value": "QuotaExceeded" + "value": "QuotaExceeded", + "description": "Quota exceeded error" }, { "name": "Conflict", - "value": "Conflict" + "value": "Conflict", + "description": "Conflict error" }, { "name": "Warning", - "value": "Warning" + "value": "Warning", + "description": "Warning error" } ] } @@ -2295,19 +2236,6 @@ "error" ] }, - "ErrorResponseWithHeader": { - "type": "object", - "description": "Error response.", - "properties": { - "error": { - "$ref": "#/definitions/Error", - "description": "The error object." - } - }, - "required": [ - "error" - ] - }, "ExtraInformationKind": { "type": "string", "description": "The extra information object kind.", @@ -2322,15 +2250,18 @@ "values": [ { "name": "EntitySubtype", - "value": "EntitySubtype" + "value": "EntitySubtype", + "description": "Entity subtype extra information kind" }, { "name": "ListKey", - "value": "ListKey" + "value": "ListKey", + "description": "List key extra information kind" }, { "name": "RegexKey", - "value": "RegexKey" + "value": "RegexKey", + "description": "Regex key extra information kind" } ] } @@ -2384,55 +2315,68 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified information unit" }, { "name": "Bit", - "value": "Bit" + "value": "Bit", + "description": "Bit information unit" }, { "name": "Kilobit", - "value": "Kilobit" + "value": "Kilobit", + "description": "Kilobit information unit" }, { "name": "Megabit", - "value": "Megabit" + "value": "Megabit", + "description": "Megabit information unit" }, { "name": "Gigabit", - "value": "Gigabit" + "value": "Gigabit", + "description": "Gigabit information unit" }, { "name": "Terabit", - "value": "Terabit" + "value": "Terabit", + "description": "Terabit information unit" }, { "name": "Petabit", - "value": "Petabit" + "value": "Petabit", + "description": "Petabit information unit" }, { "name": "Byte", - "value": "Byte" + "value": "Byte", + "description": "Byte information unit" }, { "name": "Kilobyte", - "value": "Kilobyte" + "value": "Kilobyte", + "description": "Kilobyte information unit" }, { "name": "Megabyte", - "value": "Megabyte" + "value": "Megabyte", + "description": "Megabyte information unit" }, { "name": "Gigabyte", - "value": "Gigabyte" + "value": "Gigabyte", + "description": "Gigabyte information unit" }, { "name": "Terabyte", - "value": "Terabyte" + "value": "Terabyte", + "description": "Terabyte information unit" }, { "name": "Petabyte", - "value": "Petabyte" + "value": "Petabyte", + "description": "Petabyte information unit" } ] } @@ -2462,59 +2406,73 @@ "values": [ { "name": "InvalidRequest", - "value": "InvalidRequest" + "value": "InvalidRequest", + "description": "Invalid request error" }, { "name": "InvalidParameterValue", - "value": "InvalidParameterValue" + "value": "InvalidParameterValue", + "description": "Invalid parameter value error" }, { "name": "KnowledgeBaseNotFound", - "value": "KnowledgeBaseNotFound" + "value": "KnowledgeBaseNotFound", + "description": "Knowledge base not found error" }, { "name": "AzureCognitiveSearchNotFound", - "value": "AzureCognitiveSearchNotFound" + "value": "AzureCognitiveSearchNotFound", + "description": "Azure Cognitive Search not found error" }, { "name": "AzureCognitiveSearchThrottling", - "value": "AzureCognitiveSearchThrottling" + "value": "AzureCognitiveSearchThrottling", + "description": "Azure Cognitive Search throttling error" }, { "name": "ExtractionFailure", - "value": "ExtractionFailure" + "value": "ExtractionFailure", + "description": "Extraction failure error" }, { "name": "InvalidRequestBodyFormat", - "value": "InvalidRequestBodyFormat" + "value": "InvalidRequestBodyFormat", + "description": "Invalid request body format error" }, { "name": "EmptyRequest", - "value": "EmptyRequest" + "value": "EmptyRequest", + "description": "Empty request error" }, { "name": "MissingInputDocuments", - "value": "MissingInputDocuments" + "value": "MissingInputDocuments", + "description": "Missing input documents error" }, { "name": "InvalidDocument", - "value": "InvalidDocument" + "value": "InvalidDocument", + "description": "Invalid document error" }, { "name": "ModelVersionIncorrect", - "value": "ModelVersionIncorrect" + "value": "ModelVersionIncorrect", + "description": "Model version incorrect error" }, { "name": "InvalidDocumentBatch", - "value": "InvalidDocumentBatch" + "value": "InvalidDocumentBatch", + "description": "Invalid document batch error" }, { "name": "UnsupportedLanguageCode", - "value": "UnsupportedLanguageCode" + "value": "UnsupportedLanguageCode", + "description": "Unsupported language code error" }, { "name": "InvalidCountryHint", - "value": "InvalidCountryHint" + "value": "InvalidCountryHint", + "description": "Invalid country hint error" } ] } @@ -2565,11 +2523,13 @@ "values": [ { "name": "transcript", - "value": "transcript" + "value": "transcript", + "description": "Transcript input modality" }, { "name": "text", - "value": "text" + "value": "text", + "description": "Text input modality" } ] } @@ -2641,14 +2601,12 @@ "format": "double", "description": "Answer confidence score, value ranges from 0 to 1.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidence" + "maximum": 1 }, "id": { "type": "integer", "format": "int32", - "description": "ID of the QnA result.", - "x-ms-client-name": "qnaId" + "description": "ID of the QnA result." }, "source": { "type": "string", @@ -2667,8 +2625,7 @@ }, "answerSpan": { "$ref": "#/definitions/AnswerSpan", - "description": "Answer span object of QnA with respect to user's question.", - "x-ms-client-name": "shortAnswer" + "description": "Answer span object of QnA with respect to user's question." } } }, @@ -2683,8 +2640,7 @@ }, "previousUserQuery": { "type": "string", - "description": "Previous user query.", - "x-ms-client-name": "previousQuestion" + "description": "Previous user query." } }, "required": [ @@ -2784,71 +2740,88 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified length unit" }, { "name": "Kilometer", - "value": "Kilometer" + "value": "Kilometer", + "description": "Kilometer length unit" }, { "name": "Hectometer", - "value": "Hectometer" + "value": "Hectometer", + "description": "Hectometer length unit" }, { "name": "Decameter", - "value": "Decameter" + "value": "Decameter", + "description": "Decameter length unit" }, { "name": "Meter", - "value": "Meter" + "value": "Meter", + "description": "Meter length unit" }, { "name": "Decimeter", - "value": "Decimeter" + "value": "Decimeter", + "description": "Decimeter length unit" }, { "name": "Centimeter", - "value": "Centimeter" + "value": "Centimeter", + "description": "Centimeter length unit" }, { "name": "Millimeter", - "value": "Millimeter" + "value": "Millimeter", + "description": "Millimeter length unit" }, { "name": "Micrometer", - "value": "Micrometer" + "value": "Micrometer", + "description": "Micrometer length unit" }, { "name": "Nanometer", - "value": "Nanometer" + "value": "Nanometer", + "description": "Nanometer length unit" }, { "name": "Picometer", - "value": "Picometer" + "value": "Picometer", + "description": "Picometer length unit" }, { "name": "Mile", - "value": "Mile" + "value": "Mile", + "description": "Mile length unit" }, { "name": "Yard", - "value": "Yard" + "value": "Yard", + "description": "Yard length unit" }, { "name": "Inch", - "value": "Inch" + "value": "Inch", + "description": "Inch length unit" }, { "name": "Foot", - "value": "Foot" + "value": "Foot", + "description": "Foot length unit" }, { "name": "LightYear", - "value": "LightYear" + "value": "LightYear", + "description": "Light year length unit" }, { "name": "Pt", - "value": "Pt" + "value": "Pt", + "description": "Point length unit" } ] } @@ -2914,7 +2887,6 @@ "description": "This customizes how the service calls LUIS Generally Available projects." } }, - "additionalProperties": {}, "allOf": [ { "$ref": "#/definitions/AnalysisParameters" @@ -2922,12 +2894,17 @@ ], "x-ms-discriminator-value": "Luis" }, + "LuisResult": { + "type": "object", + "description": "It is the response from a LUIS Generally Available application.", + "additionalProperties": {} + }, "LuisTargetIntentResult": { "type": "object", "description": "It is a wrap up of LUIS Generally Available response.", "properties": { "result": { - "type": "object", + "$ref": "#/definitions/LuisResult", "description": "The actual response from a LUIS Generally Available application." } }, @@ -3042,27 +3019,33 @@ "values": [ { "name": "Integer", - "value": "Integer" + "value": "Integer", + "description": "Integer number" }, { "name": "Decimal", - "value": "Decimal" + "value": "Decimal", + "description": "Decimal number" }, { "name": "Power", - "value": "Power" + "value": "Power", + "description": "Power number" }, { "name": "Fraction", - "value": "Fraction" + "value": "Fraction", + "description": "Fraction number" }, { "name": "Percent", - "value": "Percent" + "value": "Percent", + "description": "Percent number" }, { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified number kind" } ] } @@ -3151,7 +3134,7 @@ "properties": { "offset": { "type": "string", - "description": "The offset With respect to the reference (e.g., offset = -1 in \"show me the second to last\"" + "description": "The offset with respect to the reference (e.g., offset = -1 indicates the second to last)" }, "relativeTo": { "$ref": "#/definitions/RelativeTo", @@ -3264,43 +3247,53 @@ "values": [ { "name": "Number", - "value": "Number" + "value": "Number", + "description": "Number range" }, { "name": "Speed", - "value": "Speed" + "value": "Speed", + "description": "Speed range" }, { "name": "Weight", - "value": "Weight" + "value": "Weight", + "description": "Weight range" }, { "name": "Length", - "value": "Length" + "value": "Length", + "description": "Length range" }, { "name": "Volume", - "value": "Volume" + "value": "Volume", + "description": "Volume range" }, { "name": "Area", - "value": "Area" + "value": "Area", + "description": "Area range" }, { "name": "Age", - "value": "Age" + "value": "Age", + "description": "Age range" }, { "name": "Information", - "value": "Information" + "value": "Information", + "description": "Information range" }, { "name": "Temperature", - "value": "Temperature" + "value": "Temperature", + "description": "Temperature range" }, { "name": "Currency", - "value": "Currency" + "value": "Currency", + "description": "Currency range" } ] } @@ -3393,15 +3386,18 @@ "values": [ { "name": "Current", - "value": "Current" + "value": "Current", + "description": "Current state" }, { "name": "End", - "value": "End" + "value": "End", + "description": "End state" }, { "name": "Start", - "value": "Start" + "value": "Start", + "description": "Start state" } ] } @@ -3464,93 +3460,82 @@ "values": [ { "name": "BooleanResolution", - "value": "BooleanResolution" + "value": "BooleanResolution", + "description": "Resolution of a boolean entity" }, { "name": "DateTimeResolution", - "value": "DateTimeResolution" + "value": "DateTimeResolution", + "description": "Resolution of a date/time entity" }, { "name": "NumberResolution", - "value": "NumberResolution" + "value": "NumberResolution", + "description": "Resolution of a number entity" }, { "name": "OrdinalResolution", - "value": "OrdinalResolution" + "value": "OrdinalResolution", + "description": "Resolution of an ordinal entity" }, { "name": "SpeedResolution", - "value": "SpeedResolution" + "value": "SpeedResolution", + "description": "Resolution of a speed entity" }, { "name": "WeightResolution", - "value": "WeightResolution" + "value": "WeightResolution", + "description": "Resolution of a weight entity" }, { "name": "LengthResolution", - "value": "LengthResolution" + "value": "LengthResolution", + "description": "Resolution of a length entity" }, { "name": "VolumeResolution", - "value": "VolumeResolution" + "value": "VolumeResolution", + "description": "Resolution of a volume entity" }, { "name": "AreaResolution", - "value": "AreaResolution" + "value": "AreaResolution", + "description": "Resolution of an area entity" }, { "name": "AgeResolution", - "value": "AgeResolution" + "value": "AgeResolution", + "description": "Resolution of an age entity" }, { "name": "InformationResolution", - "value": "InformationResolution" + "value": "InformationResolution", + "description": "Resolution of an information entity" }, { "name": "TemperatureResolution", - "value": "TemperatureResolution" + "value": "TemperatureResolution", + "description": "Resolution of a temperature entity" }, { "name": "CurrencyResolution", - "value": "CurrencyResolution" + "value": "CurrencyResolution", + "description": "Resolution of a currency entity" }, { "name": "NumericRangeResolution", - "value": "NumericRangeResolution" + "value": "NumericRangeResolution", + "description": "Resolution of a numeric range entity" }, { "name": "TemporalSpanResolution", - "value": "TemporalSpanResolution" + "value": "TemporalSpanResolution", + "description": "Resolution of a temporal span entity" } ] } }, - "SentimentConfidenceScores": { - "type": "object", - "description": "Represents the confidence scores between 0 and 1 across all sentiment classes: positive, neutral, negative.", - "properties": { - "positive": { - "type": "number", - "format": "double", - "description": "Confidence score for positive sentiment" - }, - "neutral": { - "type": "number", - "format": "double", - "description": "Confidence score for neutral sentiment" - }, - "negative": { - "type": "number", - "format": "double", - "description": "Confidence score for negative sentiment" - } - }, - "required": [ - "positive", - "neutral", - "negative" - ] - }, "ShortAnswerOptions": { "type": "object", "description": "To configure Answer span prediction feature.", @@ -3558,30 +3543,23 @@ "enable": { "type": "boolean", "description": "Enable or disable Answer Span prediction.", - "enum": [ - true - ] + "default": true }, "confidenceScoreThreshold": { "type": "number", "format": "double", "description": "Minimum threshold score required to include an answer span, value ranges from 0 to 1.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidenceThreshold" + "maximum": 1 }, "topAnswersWithSpan": { "type": "integer", "format": "int32", "description": "Number of Top answers to be considered for span prediction from 1 to 10.", "minimum": 1, - "maximum": 10, - "x-ms-client-name": "top" + "maximum": 10 } - }, - "required": [ - "enable" - ] + } }, "SourceFilter": { "type": "array", @@ -3640,59 +3618,73 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified speed unit" }, { "name": "MetersPerSecond", - "value": "MetersPerSecond" + "value": "MetersPerSecond", + "description": "Meters per second speed unit" }, { "name": "KilometersPerHour", - "value": "KilometersPerHour" + "value": "KilometersPerHour", + "description": "Kilometers per hour speed unit" }, { "name": "KilometersPerMinute", - "value": "KilometersPerMinute" + "value": "KilometersPerMinute", + "description": "Kilometers per minute speed unit" }, { "name": "KilometersPerSecond", - "value": "KilometersPerSecond" + "value": "KilometersPerSecond", + "description": "Kilometers per second speed unit" }, { "name": "MilesPerHour", - "value": "MilesPerHour" + "value": "MilesPerHour", + "description": "Miles per hour speed unit" }, { "name": "Knot", - "value": "Knot" + "value": "Knot", + "description": "Knot speed unit" }, { "name": "FootPerSecond", - "value": "FootPerSecond" + "value": "FootPerSecond", + "description": "Foot per second speed unit" }, { "name": "FootPerMinute", - "value": "FootPerMinute" + "value": "FootPerMinute", + "description": "Foot per minute speed unit" }, { "name": "YardsPerMinute", - "value": "YardsPerMinute" + "value": "YardsPerMinute", + "description": "Yards per minute speed unit" }, { "name": "YardsPerSecond", - "value": "YardsPerSecond" + "value": "YardsPerSecond", + "description": "Yards per second speed unit" }, { "name": "MetersPerMillisecond", - "value": "MetersPerMillisecond" + "value": "MetersPerMillisecond", + "description": "Meters per millisecond speed unit" }, { "name": "CentimetersPerMillisecond", - "value": "CentimetersPerMillisecond" + "value": "CentimetersPerMillisecond", + "description": "Centimeters per millisecond speed unit" }, { "name": "KilometersPerMillisecond", - "value": "KilometersPerMillisecond" + "value": "KilometersPerMillisecond", + "description": "Kilometers per millisecond speed unit" } ] } @@ -3715,31 +3707,38 @@ "values": [ { "name": "notStarted", - "value": "notStarted" + "value": "notStarted", + "description": "Not started state" }, { "name": "running", - "value": "running" + "value": "running", + "description": "Running state" }, { "name": "succeeded", - "value": "succeeded" + "value": "succeeded", + "description": "Succeeded state" }, { "name": "partiallyCompleted", - "value": "partiallyCompleted" + "value": "partiallyCompleted", + "description": "Partially completed state" }, { "name": "failed", - "value": "failed" + "value": "failed", + "description": "Failed state" }, { "name": "cancelled", - "value": "cancelled" + "value": "cancelled", + "description": "Cancelled state" }, { "name": "cancelling", - "value": "cancelling" + "value": "cancelling", + "description": "Cancelling state" } ] } @@ -3892,8 +3891,7 @@ "format": "double", "description": "The prediction score and it ranges from 0.0 to 1.0.", "minimum": 0, - "maximum": 1, - "x-ms-client-name": "confidence" + "maximum": 1 } }, "discriminator": "targetProjectKind", @@ -3983,23 +3981,28 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified temperature unit" }, { "name": "Fahrenheit", - "value": "Fahrenheit" + "value": "Fahrenheit", + "description": "Fahrenheit temperature unit" }, { "name": "Kelvin", - "value": "Kelvin" + "value": "Kelvin", + "description": "Kelvin temperature unit" }, { "name": "Rankine", - "value": "Rankine" + "value": "Rankine", + "description": "Rankine temperature unit" }, { "name": "Celsius", - "value": "Celsius" + "value": "Celsius", + "description": "Celsius temperature unit" } ] } @@ -4033,75 +4036,93 @@ "values": [ { "name": "AfterApprox", - "value": "AfterApprox" + "value": "AfterApprox", + "description": "AfterApprox temporal modifier" }, { "name": "Before", - "value": "Before" + "value": "Before", + "description": "Before temporal modifier" }, { "name": "BeforeStart", - "value": "BeforeStart" + "value": "BeforeStart", + "description": "BeforeStart temporal modifier" }, { "name": "Approx", - "value": "Approx" + "value": "Approx", + "description": "Approx temporal modifier" }, { "name": "ReferenceUndefined", - "value": "ReferenceUndefined" + "value": "ReferenceUndefined", + "description": "ReferenceUndefined temporal modifier" }, { "name": "SinceEnd", - "value": "SinceEnd" + "value": "SinceEnd", + "description": "SinceEnd temporal modifier" }, { "name": "AfterMid", - "value": "AfterMid" + "value": "AfterMid", + "description": "AfterMid temporal modifier" }, { "name": "Start", - "value": "Start" + "value": "Start", + "description": "Start temporal modifier" }, { "name": "After", - "value": "After" + "value": "After", + "description": "After temporal modifier" }, { "name": "BeforeEnd", - "value": "BeforeEnd" + "value": "BeforeEnd", + "description": "BeforeEnd temporal modifier" }, { "name": "Until", - "value": "Until" + "value": "Until", + "description": "Until temporal modifier" }, { "name": "End", - "value": "End" + "value": "End", + "description": "End temporal modifier" }, { "name": "Less", - "value": "Less" + "value": "Less", + "description": "Less temporal modifier" }, { "name": "Since", - "value": "Since" + "value": "Since", + "description": "Since temporal modifier" }, { "name": "AfterStart", - "value": "AfterStart" + "value": "AfterStart", + "description": "AfterStart temporal modifier" }, { "name": "BeforeApprox", - "value": "BeforeApprox" + "value": "BeforeApprox", + "description": "BeforeApprox temporal modifier" }, { "name": "Mid", - "value": "Mid" + "value": "Mid", + "description": "Mid temporal modifier" }, { "name": "More", - "value": "More" + "value": "More", + "description": "More temporal modifier" } ] } @@ -4193,44 +4214,7 @@ "id", "participantId", "text" - ], - "additionalProperties": {} - }, - "TextSentiment": { - "type": "string", - "description": "Predicted sentiment", - "enum": [ - "positive", - "neutral", - "negative", - "mixed" - ], - "x-ms-enum": { - "name": "TextSentiment", - "modelAsString": true, - "values": [ - { - "name": "positive", - "value": "positive", - "description": "Positive statement" - }, - { - "name": "neutral", - "value": "neutral", - "description": "Neutral statement" - }, - { - "name": "negative", - "value": "negative", - "description": "Negative statement" - }, - { - "name": "mixed", - "value": "mixed", - "description": "Mixed statement" - } - ] - } + ] }, "TranscriptContentType": { "type": "string", @@ -4247,19 +4231,23 @@ "values": [ { "name": "lexical", - "value": "lexical" + "value": "lexical", + "description": "Lexical content type" }, { "name": "itn", - "value": "itn" + "value": "itn", + "description": "ITN content type" }, { "name": "maskedItn", - "value": "maskedItn" + "value": "maskedItn", + "description": "Masked ITN content type" }, { "name": "text", - "value": "text" + "value": "text", + "description": "Text content type" } ] } @@ -4346,8 +4334,7 @@ "maskedItn", "text", "lexical" - ], - "additionalProperties": {} + ] }, "VolumeResolution": { "type": "object", @@ -4413,115 +4400,143 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified volume unit." }, { "name": "CubicMeter", - "value": "CubicMeter" + "value": "CubicMeter", + "description": "Volume unit in cubic meters." }, { "name": "CubicCentimeter", - "value": "CubicCentimeter" + "value": "CubicCentimeter", + "description": "Volume unit in cubic centimeters." }, { "name": "CubicMillimeter", - "value": "CubicMillimeter" + "value": "CubicMillimeter", + "description": "Volume unit in cubic millimeters." }, { "name": "Hectoliter", - "value": "Hectoliter" + "value": "Hectoliter", + "description": "Volume unit in hectoliters." }, { "name": "Decaliter", - "value": "Decaliter" + "value": "Decaliter", + "description": "Volume unit in decaliters." }, { "name": "Liter", - "value": "Liter" + "value": "Liter", + "description": "Volume unit in liters." }, { "name": "Centiliter", - "value": "Centiliter" + "value": "Centiliter", + "description": "Volume unit in centiliters." }, { "name": "Milliliter", - "value": "Milliliter" + "value": "Milliliter", + "description": "Volume unit in milliliters." }, { "name": "CubicYard", - "value": "CubicYard" + "value": "CubicYard", + "description": "Volume unit in cubic yards." }, { "name": "CubicInch", - "value": "CubicInch" + "value": "CubicInch", + "description": "Volume unit in cubic inches." }, { "name": "CubicFoot", - "value": "CubicFoot" + "value": "CubicFoot", + "description": "Volume unit in cubic feet." }, { "name": "CubicMile", - "value": "CubicMile" + "value": "CubicMile", + "description": "Volume unit in cubic miles." }, { "name": "FluidOunce", - "value": "FluidOunce" + "value": "FluidOunce", + "description": "Volume unit in fluid ounces." }, { "name": "Teaspoon", - "value": "Teaspoon" + "value": "Teaspoon", + "description": "Volume unit in teaspoons." }, { "name": "Tablespoon", - "value": "Tablespoon" + "value": "Tablespoon", + "description": "Volume unit in tablespoons." }, { "name": "Pint", - "value": "Pint" + "value": "Pint", + "description": "Volume unit in pints." }, { "name": "Quart", - "value": "Quart" + "value": "Quart", + "description": "Volume unit in quarts." }, { "name": "Cup", - "value": "Cup" + "value": "Cup", + "description": "Volume unit in cups." }, { "name": "Gill", - "value": "Gill" + "value": "Gill", + "description": "Volume unit in gills." }, { "name": "Pinch", - "value": "Pinch" + "value": "Pinch", + "description": "Volume unit in pinches." }, { "name": "FluidDram", - "value": "FluidDram" + "value": "FluidDram", + "description": "Volume unit in fluid drams." }, { "name": "Barrel", - "value": "Barrel" + "value": "Barrel", + "description": "Volume unit in barrels." }, { "name": "Minim", - "value": "Minim" + "value": "Minim", + "description": "Volume unit in minims." }, { "name": "Cord", - "value": "Cord" + "value": "Cord", + "description": "Volume unit in cords." }, { "name": "Peck", - "value": "Peck" + "value": "Peck", + "description": "Volume unit in pecks." }, { "name": "Bushel", - "value": "Bushel" + "value": "Bushel", + "description": "Volume unit in bushels." }, { "name": "Hogshead", - "value": "Hogshead" + "value": "Hogshead", + "description": "Volume unit in hogsheads." } ] } @@ -4578,67 +4593,83 @@ "values": [ { "name": "Unspecified", - "value": "Unspecified" + "value": "Unspecified", + "description": "Unspecified weight unit" }, { "name": "Kilogram", - "value": "Kilogram" + "value": "Kilogram", + "description": "Weight unit in kilograms" }, { "name": "Gram", - "value": "Gram" + "value": "Gram", + "description": "Weight unit in grams" }, { "name": "Milligram", - "value": "Milligram" + "value": "Milligram", + "description": "Weight unit in milligrams" }, { "name": "Gallon", - "value": "Gallon" + "value": "Gallon", + "description": "Volume unit in gallons" }, { "name": "MetricTon", - "value": "MetricTon" + "value": "MetricTon", + "description": "Weight unit in metric tons" }, { "name": "Ton", - "value": "Ton" + "value": "Ton", + "description": "Weight unit in tons" }, { "name": "Pound", - "value": "Pound" + "value": "Pound", + "description": "Weight unit in pounds" }, { "name": "Ounce", - "value": "Ounce" + "value": "Ounce", + "description": "Weight unit in ounces" }, { "name": "Grain", - "value": "Grain" + "value": "Grain", + "description": "Weight unit in grains" }, { "name": "PennyWeight", - "value": "PennyWeight" + "value": "PennyWeight", + "description": "Weight unit in pennyweights" }, { "name": "LongTonBritish", - "value": "LongTonBritish" + "value": "LongTonBritish", + "description": "Weight unit in long tons (British)" }, { "name": "ShortTonUS", - "value": "ShortTonUS" + "value": "ShortTonUS", + "description": "Weight unit in short tons (US)" }, { "name": "ShortHundredWeightUS", - "value": "ShortHundredWeightUS" + "value": "ShortHundredWeightUS", + "description": "Weight unit in short hundredweights (US)" }, { "name": "Stone", - "value": "Stone" + "value": "Stone", + "description": "Weight unit in stones" }, { "name": "Dram", - "value": "Dram" + "value": "Dram", + "description": "Weight unit in drams" } ] } @@ -4676,11 +4707,13 @@ "values": [ { "name": "Conversation", - "value": "Conversation" + "value": "Conversation", + "description": "Conversation type" }, { "name": "Orchestration", - "value": "Orchestration" + "value": "Orchestration", + "description": "Orchestration type" } ] } @@ -4730,19 +4763,23 @@ "values": [ { "name": "Luis", - "value": "Luis" + "value": "Luis", + "description": "Luis target service type" }, { "name": "Conversation", - "value": "Conversation" + "value": "Conversation", + "description": "Conversation target service type" }, { "name": "QuestionAnswering", - "value": "QuestionAnswering" + "value": "QuestionAnswering", + "description": "QuestionAnswering target service type" }, { "name": "NonLinked", - "value": "NonLinked" + "value": "NonLinked", + "description": "NonLinked target service type" } ] } From d658184de8017805c8e8fc48122b450d0aae80f0 Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Thu, 25 Apr 2024 12:48:32 -0700 Subject: [PATCH 12/16] Fix some avocado and prettier check issues --- .../SuccessfulAnalyzeConversations.json | 128 +++++++++--------- ...cessfulConversationPIIExclusionSubmit.json | 2 +- .../SuccessfulAnalyzeConversations.json | 128 +++++++++--------- ...cessfulConversationPIIExclusionSubmit.json | 2 +- .../2024-05-15-preview/readme.csharp.md | 18 +++ .../preview/2024-05-15-preview/readme.md | 107 +++++++++++++++ .../data-plane/Language/readme.md | 32 ++++- 7 files changed, 284 insertions(+), 133 deletions(-) create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.csharp.md create mode 100644 specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.md diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json index 078d8d307fc1..b4dd75203aff 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulAnalyzeConversations.json @@ -47,70 +47,70 @@ } ], "entities": [ - { - "category": "Geography.Location", - "text": "seattle", - "offset": 17, - "length": 7, - "confidenceScore": 1, - "extraInformation": [ - { - "extraInformationKind": "EntitySubtype", - "value": "geography.location", - "tags": [ - { - "name": "City", - "confidenceScore": 1 - }, - { - "name": "GPE", - "confidenceScore": 1 - }, - { - "name": "Location", - "confidenceScore": 1 - } - ] - } - ] - }, - { - "category": "DateTime", - "text": "oct 10th", - "offset": 28, - "length": 8, - "confidenceScore": 1, - "resolutions": [ - { - "resolutionKind": "DateTimeResolution", - "dateTimeSubKind": "Date", - "timex": "XXXX-10-10", - "value": "2023-10-10" - }, - { - "resolutionKind": "DateTimeResolution", - "dateTimeSubKind": "Date", - "timex": "XXXX-10-10", - "value": "2024-10-10" - } - ], - "extraInformation": [ - { - "extraInformationKind": "EntitySubtype", - "value": "datetime.date", - "tags": [ - { - "name": "Date", - "confidenceScore": 1 - }, - { - "name": "Temporal", - "confidenceScore": 1 - } - ] - } - ] - } + { + "category": "Geography.Location", + "text": "seattle", + "offset": 17, + "length": 7, + "confidenceScore": 1, + "extraInformation": [ + { + "extraInformationKind": "EntitySubtype", + "value": "geography.location", + "tags": [ + { + "name": "City", + "confidenceScore": 1 + }, + { + "name": "GPE", + "confidenceScore": 1 + }, + { + "name": "Location", + "confidenceScore": 1 + } + ] + } + ] + }, + { + "category": "DateTime", + "text": "oct 10th", + "offset": 28, + "length": 8, + "confidenceScore": 1, + "resolutions": [ + { + "resolutionKind": "DateTimeResolution", + "dateTimeSubKind": "Date", + "timex": "XXXX-10-10", + "value": "2023-10-10" + }, + { + "resolutionKind": "DateTimeResolution", + "dateTimeSubKind": "Date", + "timex": "XXXX-10-10", + "value": "2024-10-10" + } + ], + "extraInformation": [ + { + "extraInformationKind": "EntitySubtype", + "value": "datetime.date", + "tags": [ + { + "name": "Date", + "confidenceScore": 1 + }, + { + "name": "Temporal", + "confidenceScore": 1 + } + ] + } + ] + } ] } } diff --git a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json index 50ed17c60db6..1236a317bdf2 100644 --- a/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json +++ b/specification/cognitiveservices/Language.Conversations/examples/2024-05-15-preview/SuccessfulConversationPIIExclusionSubmit.json @@ -3,7 +3,7 @@ "title": "SuccessfulConversationPIIExclusionSubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", - "api-version": "2023-05-15-preview", + "api-version": "2024-05-15-preview", "Endpoint": "{Endpoint}", "jobId": "{Job ID}", "body": { diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversations.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversations.json index 078d8d307fc1..b4dd75203aff 100644 --- a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversations.json +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulAnalyzeConversations.json @@ -47,70 +47,70 @@ } ], "entities": [ - { - "category": "Geography.Location", - "text": "seattle", - "offset": 17, - "length": 7, - "confidenceScore": 1, - "extraInformation": [ - { - "extraInformationKind": "EntitySubtype", - "value": "geography.location", - "tags": [ - { - "name": "City", - "confidenceScore": 1 - }, - { - "name": "GPE", - "confidenceScore": 1 - }, - { - "name": "Location", - "confidenceScore": 1 - } - ] - } - ] - }, - { - "category": "DateTime", - "text": "oct 10th", - "offset": 28, - "length": 8, - "confidenceScore": 1, - "resolutions": [ - { - "resolutionKind": "DateTimeResolution", - "dateTimeSubKind": "Date", - "timex": "XXXX-10-10", - "value": "2023-10-10" - }, - { - "resolutionKind": "DateTimeResolution", - "dateTimeSubKind": "Date", - "timex": "XXXX-10-10", - "value": "2024-10-10" - } - ], - "extraInformation": [ - { - "extraInformationKind": "EntitySubtype", - "value": "datetime.date", - "tags": [ - { - "name": "Date", - "confidenceScore": 1 - }, - { - "name": "Temporal", - "confidenceScore": 1 - } - ] - } - ] - } + { + "category": "Geography.Location", + "text": "seattle", + "offset": 17, + "length": 7, + "confidenceScore": 1, + "extraInformation": [ + { + "extraInformationKind": "EntitySubtype", + "value": "geography.location", + "tags": [ + { + "name": "City", + "confidenceScore": 1 + }, + { + "name": "GPE", + "confidenceScore": 1 + }, + { + "name": "Location", + "confidenceScore": 1 + } + ] + } + ] + }, + { + "category": "DateTime", + "text": "oct 10th", + "offset": 28, + "length": 8, + "confidenceScore": 1, + "resolutions": [ + { + "resolutionKind": "DateTimeResolution", + "dateTimeSubKind": "Date", + "timex": "XXXX-10-10", + "value": "2023-10-10" + }, + { + "resolutionKind": "DateTimeResolution", + "dateTimeSubKind": "Date", + "timex": "XXXX-10-10", + "value": "2024-10-10" + } + ], + "extraInformation": [ + { + "extraInformationKind": "EntitySubtype", + "value": "datetime.date", + "tags": [ + { + "name": "Date", + "confidenceScore": 1 + }, + { + "name": "Temporal", + "confidenceScore": 1 + } + ] + } + ] + } ] } } diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionSubmit.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionSubmit.json index 50ed17c60db6..1236a317bdf2 100644 --- a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionSubmit.json +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/examples/SuccessfulConversationPIIExclusionSubmit.json @@ -3,7 +3,7 @@ "title": "SuccessfulConversationPIIExclusionSubmit", "parameters": { "Ocp-Apim-Subscription-Key": "{API key}", - "api-version": "2023-05-15-preview", + "api-version": "2024-05-15-preview", "Endpoint": "{Endpoint}", "jobId": "{Job ID}", "body": { diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.csharp.md b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.csharp.md new file mode 100644 index 000000000000..f0c6a178371a --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.csharp.md @@ -0,0 +1,18 @@ +# Cognitive Services Language SDK for .NET + +This is the AutoRest configuration file the Cognitive Services Language SDK for .NET. + +> see https://aka.ms/autorest + +## Common C# Settings + +```yaml $(csharp) +csharp: + clear-output-folder: true + license-header: MICROSOFT_MIT_NO_VERSION + +directive: + from: swagger-document + where: $.parameters.Endpoint + transform: $.format = "url" +``` diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.md b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.md new file mode 100644 index 000000000000..ef9a784c6daf --- /dev/null +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.md @@ -0,0 +1,107 @@ +# Cognitive Services Language SDK + +This is the AutoRest configuration file the Cognitive Services Language SDK. + +> see https://aka.ms/autorest + +## Releases + +The current release of Language is 2024-05-15-preview. + + + +```yaml +tag: release_2024-05-15-preview +add-credentials: true +clear-output-folder: true +openapi-type: data-plane +directive: + - suppress: LongRunningResponseStatusCode + reason: The validation tools do not properly recognize 202 as a supported response code. +``` + +### Release + +``` yaml $(tag) == 'release_2024-05-15-preview' +input-file: + - analyzeconversations.json +title: + Microsoft Cognitive Language Service +modelerfour: + lenient-model-deduplication: true +``` + +``` yaml $(tag) == 'release_2023-11-15-preview' +input-file: + - analyzetext.json + - analyzetext-authoring.json + - analyzeconversations.json + - analyzeconversations-authoring.json + - questionanswering.json + - questionanswering-authoring.json +title: + Microsoft Cognitive Language Service +modelerfour: + lenient-model-deduplication: true +``` + +``` yaml $(tag) == 'release_2023-04-15-preview' +input-file: + - analyzetext.json + - analyzetext-authoring.json + - analyzeconversations.json + - analyzeconversations-authoring.json + - questionanswering.json + - questionanswering-authoring.json +title: + Microsoft Cognitive Language Service +modelerfour: + lenient-model-deduplication: true +``` + +``` yaml $(tag) == 'release_2022-10-01-preview' +input-file: + - analyzetext.json + - analyzetext-authoring.json + - analyzeconversations.json + - analyzeconversations-authoring.json + - questionanswering.json + - questionanswering-authoring.json +title: + Microsoft Cognitive Language Service +modelerfour: + lenient-model-deduplication: true +``` + +``` yaml $(tag) == 'release_2022-07-01-preview' +input-file: + - analyzetext.json + - analyzetext-authoring.json + - analyzeconversations.json + - analyzeconversations-authoring.json + - questionanswering.json + - questionanswering-authoring.json +title: + Microsoft Cognitive Language Service +modelerfour: + lenient-model-deduplication: true +``` + +## Swagger to SDK + +This section describes what SDK should be generated by the automatic system. +This is not used by Autorest itself. + +``` yaml $(swagger-to-sdk) +swagger-to-sdk: + - repo: azure-sdk-for-net-track2 + - repo: azure-sdk-for-python +``` + +## Suppression + +``` yaml +directive: + - suppress: MISSING_APIS_IN_DEFAULT_TAG + reason: Not every service will ship new versions within the Language pillar. +``` diff --git a/specification/cognitiveservices/data-plane/Language/readme.md b/specification/cognitiveservices/data-plane/Language/readme.md index 2b6eb4e90ba6..84cb78e4ba86 100644 --- a/specification/cognitiveservices/data-plane/Language/readme.md +++ b/specification/cognitiveservices/data-plane/Language/readme.md @@ -6,12 +6,12 @@ This is the AutoRest configuration file the Cognitive Services Language SDK. ## Releases -The current preview release of Language is 2023-11-15-preview. +The current preview release of Language is 2024-05-15-preview. -The current stable release of Language is 2023-04-01. +The current stable release of Language is 2024-05-01. ```yaml -tag: release_2023-11-15-preview +tag: release_2024-05-15-preview add-credentials: true clear-output-folder: true openapi-type: data-plane @@ -22,6 +22,32 @@ directive: where: $.definitions.CurrencyResolution.properties.ISO4217 reason: ISO should be upper case. ``` +### Release 2024-05-15-preview + +These settings apply only when `--tag=release_2024_05_15_preview` is specified on the command line. + +``` yaml $(tag) == 'release_2024-05-15-preview' +input-file: + - preview/2024-05-15-preview/analyzeconversations.json +title: + Microsoft Cognitive Language Service +modelerfour: + lenient-model-deduplication: true +``` + +### Release 2024-05-01 + +These settings apply only when `--tag=release_2024_05_01` is specified on the command line. + +``` yaml $(tag) == 'release_2024-05-01' +input-file: + - preview/2024-05-01/analyzeconversations.json +title: + Microsoft Cognitive Language Service +modelerfour: + lenient-model-deduplication: true +``` + ### Release 2023-11-15-preview From 9e5a8b863a3733d737d3709ea03b6b7d705a8a7b Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Thu, 25 Apr 2024 13:34:13 -0700 Subject: [PATCH 13/16] Fix some more lintdiff and avocado errors --- .../preview/2024-05-15-preview/readme.md | 56 ------------------- 1 file changed, 56 deletions(-) diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.md b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.md index ef9a784c6daf..091738ac4ebe 100644 --- a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.md +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/readme.md @@ -31,62 +31,6 @@ modelerfour: lenient-model-deduplication: true ``` -``` yaml $(tag) == 'release_2023-11-15-preview' -input-file: - - analyzetext.json - - analyzetext-authoring.json - - analyzeconversations.json - - analyzeconversations-authoring.json - - questionanswering.json - - questionanswering-authoring.json -title: - Microsoft Cognitive Language Service -modelerfour: - lenient-model-deduplication: true -``` - -``` yaml $(tag) == 'release_2023-04-15-preview' -input-file: - - analyzetext.json - - analyzetext-authoring.json - - analyzeconversations.json - - analyzeconversations-authoring.json - - questionanswering.json - - questionanswering-authoring.json -title: - Microsoft Cognitive Language Service -modelerfour: - lenient-model-deduplication: true -``` - -``` yaml $(tag) == 'release_2022-10-01-preview' -input-file: - - analyzetext.json - - analyzetext-authoring.json - - analyzeconversations.json - - analyzeconversations-authoring.json - - questionanswering.json - - questionanswering-authoring.json -title: - Microsoft Cognitive Language Service -modelerfour: - lenient-model-deduplication: true -``` - -``` yaml $(tag) == 'release_2022-07-01-preview' -input-file: - - analyzetext.json - - analyzetext-authoring.json - - analyzeconversations.json - - analyzeconversations-authoring.json - - questionanswering.json - - questionanswering-authoring.json -title: - Microsoft Cognitive Language Service -modelerfour: - lenient-model-deduplication: true -``` - ## Swagger to SDK This section describes what SDK should be generated by the automatic system. From 49533f1a66731a2d498eb4241fb5df52ec7ecb7d Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Thu, 25 Apr 2024 13:46:56 -0700 Subject: [PATCH 14/16] Correct Readme --- specification/cognitiveservices/data-plane/Language/readme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/cognitiveservices/data-plane/Language/readme.md b/specification/cognitiveservices/data-plane/Language/readme.md index 84cb78e4ba86..2b536416980d 100644 --- a/specification/cognitiveservices/data-plane/Language/readme.md +++ b/specification/cognitiveservices/data-plane/Language/readme.md @@ -41,7 +41,7 @@ These settings apply only when `--tag=release_2024_05_01` is specified on the co ``` yaml $(tag) == 'release_2024-05-01' input-file: - - preview/2024-05-01/analyzeconversations.json + - stable/2024-05-01/analyzeconversations.json title: Microsoft Cognitive Language Service modelerfour: From 549544942057bb88a24a91c8d272b2d651de95fa Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Thu, 25 Apr 2024 14:15:58 -0700 Subject: [PATCH 15/16] Fix typespec validation --- specification/cognitiveservices/Language.Conversations/main.tsp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index 0d6c66d26e84..649ed451d672 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -47,7 +47,7 @@ enum Versions { /** Version 2024-05-15-preview" */ @useDependency(Azure.Core.Versions.v1_0_Preview_2) - v2024_05_15_preview: "2024-05-15-preview" + v2024_05_15_preview: "2024-05-15-preview", } /** These are the [Azure Active Directory OAuth2](https://docs.microsoft.com/azure/active-directory/develop/v1-overview) Flows. When paired with [Azure role-based access](https://docs.microsoft.com/azure/role-based-access-control/overview) control it can be used to control access to Azure Maps REST APIs. Azure role-based access controls are used to designate access to one or more Azure Maps resource account or sub-resources. Any user, group, or service principal can be granted access via a built-in role or a custom role composed of one or more permissions to Azure Maps REST APIs.\n\nTo implement scenarios, we recommend viewing [authentication concepts](https://aka.ms/amauth). In summary, this security definition provides a solution for modeling application(s) via objects capable of access control on specific APIs and scopes.\n\n#### Notes\n* This security definition **requires** the use of the `x-ms-client-id` header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the [Maps management API](https://aka.ms/amauthdetails).\n* \nThe `Authorization URL` is specific to the Azure public cloud instance. Sovereign clouds have unique Authorization URLs and Azure Active directory configurations. \n* \nThe Azure role-based access control is configured from the [Azure management plane](https://aka.ms/amrbac) via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.\n* \nUsage of the [Azure Maps Web SDK](https://aka.ms/amaadmc) allows for configuration based setup of an application for multiple use cases.\n* Currently, Azure Active Directory [v1.0 or v2.0](https://docs.microsoft.com/azure/active-directory/develop/azure-ad-endpoint-comparison) supports Work, School, and Guests but does not support Personal accounts. */ From 0eb0bfee1c9a0d6377eba754d5ceed29a2841e8a Mon Sep 17 00:00:00 2001 From: Aurgho Bhattacharjee Date: Tue, 7 May 2024 09:44:48 -0700 Subject: [PATCH 16/16] Address minor documenatation comment --- specification/cognitiveservices/Language.Conversations/main.tsp | 2 +- .../preview/2024-05-15-preview/analyzeconversations.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/specification/cognitiveservices/Language.Conversations/main.tsp b/specification/cognitiveservices/Language.Conversations/main.tsp index 649ed451d672..c2c1e8190d50 100644 --- a/specification/cognitiveservices/Language.Conversations/main.tsp +++ b/specification/cognitiveservices/Language.Conversations/main.tsp @@ -1115,7 +1115,7 @@ model CustomConversationSummarizationTaskParameters is CustomTaskParameters { /** String index type */ stringIndexType?: StringIndexType = StringIndexType.TextElements_v8; - /** (NOTE: Recommended to use summaryLength over sentenceCount) Controls the approximate length of the output summaries. */ + /** Controls the approximate length of the output summaries. Recommended to use summaryLength over sentenceCount */ summaryLength?: SummaryLengthBucket; /** Array of Summary Aspects */ diff --git a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json index 802c430078d9..3d8ddfd9d81a 100644 --- a/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json +++ b/specification/cognitiveservices/data-plane/Language/preview/2024-05-15-preview/analyzeconversations.json @@ -2028,7 +2028,7 @@ }, "summaryLength": { "$ref": "#/definitions/SummaryLengthBucket", - "description": "(NOTE: Recommended to use summaryLength over sentenceCount) Controls the approximate length of the output summaries." + "description": "Controls the approximate length of the output summaries. Recommended to use summaryLength over sentenceCount" }, "summaryAspects": { "type": "array",