Amazon Transcribe Service Update: This update provides error messaging for generative call summarization in Transcribe Call Analytics

Author: AWS

.changes/next-release/feature-AmazonTranscribeService-e972354.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "Amazon Transcribe Service",
+    "contributor": "",
+    "description": "This update provides error messaging for generative call summarization in Transcribe Call Analytics"
+}

services/transcribe/src/main/resources/codegen-resources/service-2.json

@@ -5,6 +5,7 @@
     "endpointPrefix":"transcribe",
     "jsonVersion":"1.1",
     "protocol":"json",
+    "protocols":["json"],
     "serviceFullName":"Amazon Transcribe Service",
     "serviceId":"Transcribe",
     "signatureVersion":"v4",
@@ -737,6 +738,10 @@
         "ja-JP"
       ]
     },
+    "CallAnalyticsFeature":{
+      "type":"string",
+      "enum":["GENERATIVE_SUMMARIZATION"]
+    },
     "CallAnalyticsJob":{
       "type":"structure",
       "members":{
@@ -748,6 +753,10 @@
           "shape":"CallAnalyticsJobStatus",
           "documentation":"<p>Provides the status of the specified Call Analytics job.</p> <p>If the status is <code>COMPLETED</code>, the job is finished and you can find the results at the location specified in <code>TranscriptFileUri</code> (or <code>RedactedTranscriptFileUri</code>, if you requested transcript redaction). If the status is <code>FAILED</code>, <code>FailureReason</code> provides details on why your transcription job failed.</p>"
         },
+        "CallAnalyticsJobDetails":{
+          "shape":"CallAnalyticsJobDetails",
+          "documentation":"<p>Provides detailed information about a call analytics job, including information about skipped analytics features.</p>"
+        },
         "LanguageCode":{
           "shape":"LanguageCode",
           "documentation":"<p>The language code used to create your Call Analytics job. For a list of supported languages and their associated language codes, refer to the <a href=\"https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html\">Supported languages</a> table.</p> <p>If you do not know the language spoken in your media file, you can omit this field and let Amazon Transcribe automatically identify the language of your media. To improve the accuracy of language identification, you can include several language codes and Amazon Transcribe chooses the closest match for your transcription.</p>"
@@ -800,6 +809,16 @@
       },
       "documentation":"<p>Provides detailed information about a Call Analytics job.</p> <p>To view the job's status, refer to <code>CallAnalyticsJobStatus</code>. If the status is <code>COMPLETED</code>, the job is finished. You can find your completed transcript at the URI specified in <code>TranscriptFileUri</code>. If the status is <code>FAILED</code>, <code>FailureReason</code> provides details on why your transcription job failed.</p> <p>If you enabled personally identifiable information (PII) redaction, the redacted transcript appears at the location specified in <code>RedactedTranscriptFileUri</code>.</p> <p>If you chose to redact the audio in your media file, you can find your redacted media file at the location specified in the <code>RedactedMediaFileUri</code> field of your response.</p>"
     },
+    "CallAnalyticsJobDetails":{
+      "type":"structure",
+      "members":{
+        "Skipped":{
+          "shape":"CallAnalyticsSkippedFeatureList",
+          "documentation":"<p>Contains information about any skipped analytics features during the analysis of a call analytics job.</p> <p>This array lists all the analytics features that were skipped, along with their corresponding reason code and message.</p>"
+        }
+      },
+      "documentation":"<p>Contains details about a call analytics job, including information about skipped analytics features.</p>"
+    },
     "CallAnalyticsJobName":{
       "type":"string",
       "max":200,
@@ -881,13 +900,46 @@
           "shape":"CallAnalyticsJobStatus",
           "documentation":"<p>Provides the status of your Call Analytics job.</p> <p>If the status is <code>COMPLETED</code>, the job is finished and you can find the results at the location specified in <code>TranscriptFileUri</code> (or <code>RedactedTranscriptFileUri</code>, if you requested transcript redaction). If the status is <code>FAILED</code>, <code>FailureReason</code> provides details on why your transcription job failed.</p>"
         },
+        "CallAnalyticsJobDetails":{
+          "shape":"CallAnalyticsJobDetails",
+          "documentation":"<p>Provides detailed information about a call analytics job, including information about skipped analytics features.</p>"
+        },
         "FailureReason":{
           "shape":"FailureReason",
           "documentation":"<p>If <code>CallAnalyticsJobStatus</code> is <code>FAILED</code>, <code>FailureReason</code> contains information about why the Call Analytics job failed. See also: <a href=\"https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonErrors.html\">Common Errors</a>.</p>"
         }
       },
       "documentation":"<p>Provides detailed information about a specific Call Analytics job.</p>"
     },
+    "CallAnalyticsSkippedFeature":{
+      "type":"structure",
+      "members":{
+        "Feature":{
+          "shape":"CallAnalyticsFeature",
+          "documentation":"<p>Indicates the type of analytics feature that was skipped during the analysis of a call analytics job.</p>"
+        },
+        "ReasonCode":{
+          "shape":"CallAnalyticsSkippedReasonCode",
+          "documentation":"<p>Provides a code indicating the reason why a specific analytics feature was skipped during the analysis of a call analytics job.</p>"
+        },
+        "Message":{
+          "shape":"String",
+          "documentation":"<p>Contains additional information or a message explaining why a specific analytics feature was skipped during the analysis of a call analytics job.</p>"
+        }
+      },
+      "documentation":"<p>Represents a skipped analytics feature during the analysis of a call analytics job.</p> <p>The <code>Feature</code> field indicates the type of analytics feature that was skipped.</p> <p>The <code>Message</code> field contains additional information or a message explaining why the analytics feature was skipped.</p> <p>The <code>ReasonCode</code> field provides a code indicating the reason why the analytics feature was skipped.</p>"
+    },
+    "CallAnalyticsSkippedFeatureList":{
+      "type":"list",
+      "member":{"shape":"CallAnalyticsSkippedFeature"}
+    },
+    "CallAnalyticsSkippedReasonCode":{
+      "type":"string",
+      "enum":[
+        "INSUFFICIENT_CONVERSATION_CONTENT",
+        "FAILED_SAFETY_GUIDELINES"
+      ]
+    },
     "CategoryName":{
       "type":"string",
       "max":200,
@@ -2207,7 +2259,7 @@
     },
     "MaxSpeakers":{
       "type":"integer",
-      "max":10,
+      "max":30,
       "min":2
     },
     "Media":{