Merge pull request #139 from aws-samples/fixes/tca-testing

rstrahan · web-flow · commit a5257a836857 · 2022-11-27T18:04:32.000-05:00
Fixes/040rcTesting
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2022-11-27
+### Added
+- Supports ingestion of post-call output transcripts from Transcribe Real-time Call Analytics. 
+- Supports integration with Live Call Analytics and Agent Assist (LCA) v0.6.0 or later. See [LCA Integration](./README.md#live-call-analytics-and-agent-assist-companion-solution)
+
+
 ## [0.3.4] - 2022-11-9
 ### Added
 - Additional processing for Genesys CTR telephony files. See [Integration with Telephony CTR Files](./README.md#integration-with-telephony-ctr-files)
@@ -90,7 +96,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Initial release
 
-[Unreleased]: https://github.com/aws-samples/amazon-transcribe-post-call-analytics/compare/v0.3.4...develop
+[Unreleased]: https://github.com/aws-samples/amazon-transcribe-post-call-analytics/compare/v0.4.0...develop
+[0.4.0]: https://github.com/aws-samples/amazon-transcribe-post-call-analytics/releases/tag/v0.3.4
 [0.3.4]: https://github.com/aws-samples/amazon-transcribe-post-call-analytics/releases/tag/v0.3.4
 [0.3.3]: https://github.com/aws-samples/amazon-transcribe-post-call-analytics/releases/tag/v0.3.3
 [0.3.2]: https://github.com/aws-samples/amazon-transcribe-post-call-analytics/releases/tag/v0.3.2
diff --git a/README.md b/README.md
@@ -8,13 +8,15 @@ Your contact center connects your business to your community, enabling customers
 
 This sample solution, Post Call Analytics (PCA), does most of the heavy lifting associated with providing an end-to-end solution that can process call recordings from your existing contact center. PCA provides actionable insights to spot emerging trends, identify agent coaching opportunities, and assess the general sentiment of calls.
 
-If you already have Amazon Transcribe transcripts generated from the Streaming Call Analytics feature then those output transcripts can de delivered to PCA so that they can be aggregated and analyzed in exactly the same way as any audio files that you process from telephony system.  You can use PCA with audio files, with transcript files, or with both.
+If you already have Amazon Transcribe transcripts generated from the Streaming Call Analytics feature then those output transcripts can de delivered to PCA so that they can be aggregated and analyzed in exactly the same way as any audio files that you process from telephony system.  You can use PCA with audio files, with transcript files, or with both. 
+
+*(New!) The latest version (v0.6.0) of our companion Live Call Analytics and Agent Assist (LCA) supports Amazon Transcribe Real-time Call Analytics and provides easy integration with PCA. See [Live Call Analytics and Agent Assist: Companion Solution](#live-call-analytics-and-agent-assist-companion-solution) section below.*
 
 PCA currently supports the following features:
 
 * **Source Input Data**
     * Audio files can be delivered to audio ingestion location in Amazon S3, which is defined in AWS Systems Manager Parameter store in the bucket defined in `InputBucketName` and folder `InputBucketRawAudio`. 
-    * Transcript files from Transcribe's Streaming Analytics APIs can be delivered to the transcript ingest location in Amazon S3, which is defined in AWS Systems Manager Parameter store in the bucket defined in `InputBucketName` and folder `InputBucketTranscribeResults`
+    * Transcript files from Transcribe's Streaming Analytics APIs can be delivered to the transcript ingest location in Amazon S3, which is defined in AWS Systems Manager Parameter store in the bucket defined in `InputBucketName` and folder `InputBucketOrigTranscripts`
     
 
 * **Transcription** *(audio files only)*
@@ -209,6 +211,10 @@ As before, your new password must have a length of at least 8 characters, and co
 
 You’re now logged in to the transcript search Finder application. The sample audio files are indexed already, and ready for search.
 
+## Live Call Analytics and Agent Assist: Companion solution
+
+Our companion solution, Live Call Analytics and Agent Assist (LCA), offers real-time transcription and analytics capabilities by using the Amazon Transcribe real-time APIs. Unlike PCA, which transcribes and analyzes recorded audio after the call has ended, LCA transcribes and analyzes your calls as they are happening and provides real-time updates to supervisors and agents.  The new Amazon Transcribe Real-time Call Analytics service provides post-call analytics output from your streaming sessions just a few minutes after the call has ended. LCA (v 0.6.0 or later) can now send this post-call analytics data to PCA to provide analytics visualizations for completed calls without needing to transcribe the audio a second time. Configure LCA (v0.6.0 or later) to integrate with PCA (v0.4.0 or later) and use the two solutions together to get the best of both worlds.. See [Live call analytics and agent assist for your contact center with Amazon language AI services](https://www.amazon.com/live-call-analytics) for more information.
+
 ## Learn more
 
 Check out the AWS blog post: [Post call analytics for your contact center with Amazon language AI services](https://www.amazon.com/post-call-analytics)
diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-0.3.4
+0.4.0
diff --git a/pca-main-nokendra.template b/pca-main-nokendra.template
@@ -1,6 +1,6 @@
 AWSTemplateFormatVersion: "2010-09-09"
 
-Description: Amazon Transcribe Post Call Analytics - PCA (v0.3.4) (uksb-1sn29lk73)
+Description: Amazon Transcribe Post Call Analytics - PCA (v0.4.0) (uksb-1sn29lk73)
 
 Parameters:
 
@@ -74,7 +74,7 @@ Parameters:
   InputBucketAudioPlayback:
     Type: String
     Default: playbackAudio
-    Description: Folder that holds the audio files to playback in the browser when original audio cannot be used
+    Description: Folder that holds the audio files to playback in the browser.
 
   InputBucketFailedTranscriptions:
     Type: String
@@ -609,6 +609,10 @@ Outputs:
   InputBucketTranscriptPrefix:
     Description: S3 Bucket prefix/folder for uploading input transcripts
     Value: !Ref InputBucketOrigTranscripts
+    
+  InputBucketPlaybackAudioPrefix:
+    Description: S3 Bucket prefix/folder for audio used for playboack from browser
+    Value: !Ref InputBucketAudioPlayback
 
   OutputBucket:
     Description: S3 Bucket where Transcribe output files are delivered
diff --git a/pca-main.template b/pca-main.template
@@ -1,6 +1,6 @@
 AWSTemplateFormatVersion: "2010-09-09"
 
-Description: Amazon Transcribe Post Call Analytics - PCA (v0.3.4) (uksb-1sn29lk73)
+Description: Amazon Transcribe Post Call Analytics - PCA (v0.4.0) (uksb-1sn29lk73)
 
 Parameters:
 
@@ -74,7 +74,7 @@ Parameters:
   InputBucketAudioPlayback:
     Type: String
     Default: playbackAudio
-    Description: Folder that holds the audio files to playback in the browser when original audio cannot be used
+    Description: Folder that holds the audio files to playback in the browser
 
   InputBucketFailedTranscriptions:
     Type: String
@@ -755,6 +755,10 @@ Outputs:
   InputBucketTranscriptPrefix:
     Description: S3 Bucket prefix/folder for uploading input transcripts
     Value: !Ref InputBucketOrigTranscripts
+  
+  InputBucketPlaybackAudioPrefix:
+    Description: S3 Bucket prefix/folder for audio used for playboack from browser
+    Value: !Ref InputBucketAudioPlayback
 
   OutputBucket:
     Description: S3 Bucket where Transcribe output files are delivered
diff --git a/pca-server/cfn/lib/trigger.template b/pca-server/cfn/lib/trigger.template
@@ -116,8 +116,10 @@ Resources:
         Variables:
           StackName: !Ref AWS::StackName
 
-  ConfigureBucketAudioFile:
+  ConfigureBucket:
     Type: "AWS::CloudFormation::CustomResource"
+    DependsOn:
+      - FileDropTriggerPermission
     Properties:
       ServiceToken: !GetAtt ConfigureBucketFunction.Arn
       BucketName: !Ref InputBucketName
@@ -127,7 +129,8 @@ Resources:
   ConfigureBucketTranscriptFile:
     Type: "AWS::CloudFormation::CustomResource"
     DependsOn:
-      - ConfigureBucketAudioFile
+      - FileDropTriggerPermission
+      - ConfigureBucket
     Properties:
       ServiceToken: !GetAtt ConfigureBucketFunction.Arn
       BucketName: !Ref InputBucketName
diff --git a/publish-nokendra.sh b/publish-nokendra.sh
@@ -82,6 +82,7 @@ popd
 
 echo "Packaging Cfn artifacts"
 aws cloudformation package --template-file pca-main-nokendra.template --output-template-file build/packaged.template --s3-bucket ${BUCKET} --s3-prefix ${PREFIX_AND_VERSION} --region ${region}|| exit 1
+aws s3 cp build/packaged.template "s3://${BUCKET}/${PREFIX}/pca-main.yaml" || exit 1
 
 if $PUBLIC; then
   echo "Setting public read ACLs on published artifacts"
@@ -92,17 +93,14 @@ if $PUBLIC; then
     done
 fi
 
-aws s3 cp build/packaged.template "s3://${BUCKET}/${PREFIX}/pca-main.yaml" || exit 1
-
 echo "Validating Cfn artifacts"
 template="https://s3.${region}.amazonaws.com/${BUCKET}/${PREFIX}/pca-main.yaml"
 aws cloudformation validate-template --template-url $template > /dev/null || exit 1
 
-
 echo "Outputs"
 echo Template URL: $template
-echo CF Launch URL: https://${region}.console.aws.amazon.com/cloudformation/home?region=${region}#/stacks/create/review?templateURL=${template}\&stackName=PostCallAnalytics
-echo CLI Deploy: aws cloudformation deploy --template-file `pwd`/build/packaged.template --capabilities CAPABILITY_NAMED_IAM CAPABILITY_AUTO_EXPAND --stack-name PostCallAnalytics --parameter-overrides AdminEmail=johndoe@example.com
+echo CF Launch URL: https://${region}.console.aws.amazon.com/cloudformation/home?region=${region}#/stacks/create/review?templateURL=${template}\&stackName=PCA
+echo CLI Deploy: aws cloudformation deploy --template-file `pwd`/build/packaged.template --capabilities CAPABILITY_NAMED_IAM CAPABILITY_AUTO_EXPAND --stack-name PCA --parameter-overrides AdminEmail=johndoe@example.com
 
 echo Done
 exit 0
diff --git a/publish.sh b/publish.sh
@@ -113,8 +113,8 @@ aws cloudformation validate-template --template-url $template > /dev/null || exi
 
 echo "Outputs"
 echo Template URL: $template
-echo CF Launch URL: https://${region}.console.aws.amazon.com/cloudformation/home?region=${region}#/stacks/create/review?templateURL=${template}\&stackName=PostCallAnalytics
-echo CLI Deploy: aws cloudformation deploy --template-file `pwd`/build/packaged.template --capabilities CAPABILITY_NAMED_IAM CAPABILITY_AUTO_EXPAND --stack-name PostCallAnalytics --parameter-overrides AdminEmail=johndoe@example.com
+echo CF Launch URL: https://${region}.console.aws.amazon.com/cloudformation/home?region=${region}#/stacks/create/review?templateURL=${template}\&stackName=PCA
+echo CLI Deploy: aws cloudformation deploy --template-file `pwd`/build/packaged.template --capabilities CAPABILITY_NAMED_IAM CAPABILITY_AUTO_EXPAND --stack-name PCA --parameter-overrides AdminEmail=johndoe@example.com
 
 echo Done
 exit 0
