Page Comparison

Overview

When a Digital Person has the Transcription Skill, the conversation session is stored as a text file in the Customer’s secure Amazon S3 container with the user's requests and conversation responses. The transcript is updated throughout the conversation until the session ends.

This skill is:

• Built and owned by Soul Machines Ltd.

• Only supported in English.

• Powered by the Amazon S3.

Transcription Files

Where to find the transcription files in Amazon S3?

<screenshot of sample transcription>

Limitations

• Transcription Skill doesn't work with Wake Word Skill, Repeat Skill, and Translation Skill if added to the same project

• The Digital Person cannot differentiate between users if added to a MS teams meeting

• The time stamp is in UTC time zone

• If the Digital Person in sleep mode, there will not be a response line from the Digital Person. The file name is

Transcription Files

The transcription files are located inside the S3 bucket with the files named in the format YYYYMMDDTHHMMSS_{SessionID}.txt

Limitations

• Transcription Skill doesn't work with Translation Skill if added to the same project

• The Digital Person cannot differentiate between users if added to a MS teams meeting

• The time stamp is in UTC time zone

as shown below:

Image Added

Sample transcription file:

Image Added

Skill Demo

Transcription Skill Demo (No Audio)

Configurations

Provide the following information in the Transcription Skill configuration screen in Digital DNA Studio. See Adding Skills to your Digital Person for detailed instructions:

Image Modified

Creating AWS Role for Transcription Skill

1. Log into your AWS account where the Lex Bot S3 bucket is provisioned.

2. You will need to generate an External ID that our services will use as a unique identifier to connect to your Lex BotS3 bucket, the External ID is any unique string that should be a minimum of 16 characters alpha-numeric string.

3. Go into the IAM tab in the AWS Console and click Roles > Create Role at the top right corner.

4. In the role creation screen, click Custom trust policy entity type and copy the below code block into the policy field, make sure to replace <Your External ID> with the string generated in step 3 and click Next.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": [
          "arn:aws:iam::858507401646924390807111:role/SM_Transcription_Role"
        ]
      },
      "Action": "sts:AssumeRole",
    "Condition": {
        "StringEquals": {
          "sts:ExternalId": "<Your External ID>"
        }
      }
    }
  ]
}

5. In the Add Permissions screen,

AmazonLexRunBotsOnly policy, select it, and click Next.

Image Removed

click Create Policy and enter the below code:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket"],
      "Resource": ["arn:aws:iam::924390807111:role/SM_Transcription_Role"]
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:DeleteObject"
      ],
      "Resource": ["arn:aws:iam::924390807111:role/SM_Transcription_Role"]
    }
  ]
}

Image Added

6. Ensure to use the below value as the Role Name otherwise the bot will not be reachable using this Role (this is a case sensitive value) and verify that all the other values (Aside from your unique External ID being different) match the code provided in step 4 and click

Create Role.

SM_Transcription_Role

7. Once the role is created, navigate to the

SM_Lex_AccessTranscription_Role role under the Roles tab and you will be able to copy the Role ARN.Image Removed

S3 Bucket Properties

You can find the details of the S3 bucket needed to configure the skill:

Image Added