启动实时呼叫分析转录 - Amazon Transcribe
创建实时警报

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

启动实时呼叫分析转录

在开始实时 Call Analytics 转录之前，您必须创建 Amazon Transcribe 要在通话中匹配的所有类别。

注意

呼叫分析转录无法追溯性地与新类别匹配。只有您在启动呼叫分析转录之前创建的类别才能应用于该转录输出。

如果您创建了一个或多个类别，并且您的音频与至少一个类别中的所有规则匹配， Amazon Transcribe 会使用匹配的类别来标记您的输出。如果您选择不使用类别，或者您的音频与类别中指定的规则不匹配，则不会标记您的转录。

要在实时呼叫分析转录中包含通话后分析，您必须使用 OutputLocation 参数在请求中提供一个 Amazon S3 存储桶。您还必须包括对指定存储桶具有写入权限的 DataAccessRoleArn。在您的实时呼叫分析流式会话完成后，系统会生成一份单独的转录并将其存储在指定的存储桶中。

借助实时呼叫分析，您还可以选择创建实时类别警报；有关说明，请参阅为类别匹配创建实时警报。

要开始实时 Call Analytics 转录，你可以使用AWS Management Console、HTTP/2 或 WebSockets；查看以下示例：

重要

目前， AWS Management Console 唯一提供带有预加载音频示例的实时呼叫分析演示。如果您想使用自己的音频，则必须使用 API（HTTP/2 或 SDK）。 WebSockets

请按以下过程启动呼叫分析请求。符合类别定义的所有特点的通话将使用该类别进行标记。

注意

AWS Management Console中只有演示可用。要启动自定义实时分析转录，必须使用 API。

  1. 在导航窗格的 “ Amazon Transcribe 呼叫分析” 下，选择 “分析实时通话”。

    Amazon Transcribe 控制台屏幕截图：“分析直播通话” 演示页面。

  2. 对于步骤 1: 指定输入音频，请从下拉菜单中选择一个演示测试文件。

    Amazon Transcribe 控制台屏幕截图：演示输入音频的下拉选项。

  3. 对于第 2 步: 查看通话类别，您可以选择查看之前创建的实时呼叫分析类别。所有实时呼叫分析类别都应用于您的转录。

    选择查看类别后将打开一个新窗格，其中显示您现有的实时呼叫分析类别，并提供创建新类别的链接。

    Amazon Transcribe 控制台屏幕截图：“通话分析类别” 页面。

  4. 对于步骤 3: 配置输入和输出，您可以选择应用其它设置。

    选择配置高级设置将打开一个新窗格，您可以在其中指定内容编辑设置。

    Amazon Transcribe 控制台屏幕截图：高级设置面板全部折叠。

    完成所有选择后，选择保存返回主页。

  5. 要应用其它分析，您可以开启通话后分析。这为您提供了与通话后分析转录相同的分析，包括中断、音量、非通话时间、通话速度、通话时间、问题、操作项目和结果。通话后分析输出与您的实时呼叫分析转录存储在不同的文件中。

    Amazon Transcribe 控制台屏幕截图：通话后分析面板已折叠。

    如果您应用电话后分析，则必须指定 Amazon S3 输出文件目标和 IAM 角色。您可以选择对输出进行加密。

    Amazon Transcribe 控制台屏幕截图：通话后分析面板，已展开。

  6. 选择 Start streaming（开始流式传输）。

此示例创建了一个启用了呼叫分析的 HTTP/2 请求。有关使用 HTTP/2 流式传输的更多信息 Amazon Transcribe，请参阅。设置 HTTP/2 音频流有关特定于的参数和标题的更多详细信息 Amazon Transcribe，请参阅StartCallAnalyticsStreamTranscription。

此示例包括通话后分析。如果您不想进行通话后分析，请从请求中删除 PostCallAnalyticsSettings 部分。

请注意，以下示例中显示的配置事件需要作为流中的第一个事件传送。

POST /stream-transcription HTTP/2
host: transcribestreaming.us-west-2.amazonaws.com
X-Amz-Target: com.amazonaws.transcribe.Transcribe.StartCallAnalyticsStreamTranscription
Content-Type: application/vnd.amazon.eventstream
X-Amz-Content-Sha256: string
X-Amz-Date: 20220208T235959Z
Authorization: AWS4-HMAC-SHA256 Credential=access-key/20220208/us-west-2/transcribe/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date;x-amz-target;x-amz-security-token, Signature=string
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000  
transfer-encoding: chunked
    
{
    "AudioStream": { 
        "AudioEvent": { 
            "AudioChunk": blob
        },
        "ConfigurationEvent": {
            "ChannelDefinitions": [
                {
                    "ChannelId": 0,
                    "ParticipantRole": "AGENT"
                },
                {
                     "ChannelId": 1,
                    "ParticipantRole": "CUSTOMER"
                }
            ],
            "PostCallAnalyticsSettings": {
                "OutputLocation": "s3://DOC-EXAMPLE-BUCKET/my-output-files/",
                "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
            }
        }
    }
}

参数定义可在 API 参考中找到；所有 AWS API 操作的通用参数列在常用参数部分中。

此示例创建了一个在 WebSocket 直播中使用 Call Analytics 的预签名网址。为了便于阅读，已增加了换行符。有关将 WebSocket 直播与配合使用的更多信息 Amazon Transcribe，请参阅设置直 WebSocket 播。有关参数的更多详细信息，请参阅 StartCallAnalyticsStreamTranscription。

此示例包括通话后分析。如果您不想进行通话后分析，请从请求中删除 PostCallAnalyticsSettings 部分。

请注意，以下示例中显示的配置事件需要作为流中的第一个事件传送。

GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/call-analytics-stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=string
&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date
&language-code=en-US
&media-encoding=flac    
&sample-rate=16000

{
    "AudioStream": { 
        "AudioEvent": { 
            "AudioChunk": blob
        },
        "ConfigurationEvent": {
            "ChannelDefinitions": [
                {
                    "ChannelId": 0,
                    "ParticipantRole": "AGENT"
                },
                {
                     "ChannelId": 1,
                    "ParticipantRole": "CUSTOMER"
                }
            ],
            "PostCallAnalyticsSettings": {
                "OutputLocation": "s3://DOC-EXAMPLE-BUCKET/my-output-files/",
                "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
            }
        }
    }
}

参数定义可在 API 参考中找到；所有 AWS API 操作的通用参数列在常用参数部分中。

提示

上面的 HTTP/2 和 WebSocket 示例包括通话后分析。如果您不想进行通话后分析，请从请求中删除 PostCallAnalyticsSettings 部分。

如果启用 PostCallAnalyticsSettings，则必须将配置事件作为第一个事件发送。您的配置事件包括 ChannelDenifitions 和 PostStreamAnalyticsSettings 的设置，如前面的示例所示。

二进制数据通过 content-type application/octet-stream 以二进制消息的形式传送，配置事件通过 content-type application/json 以文本消息的形式传送。

有关更多信息，请参阅 设置流式转录。

为类别匹配创建实时警报

要设置实时警报，必须先创建一个带有 REAL_TIME 标志的 TranscriptFilterType 类别。此标志允许将您的类别应用于实时呼叫分析转录。

有关创建新类别的说明，请参阅 为实时转录创建类别。

当您开始实时呼叫分析转录时，所有带有 REAL_TIME 标记的类别都会自动应用于片段级转录输出。如果出现 TranscriptFilterType 匹配，则会显示在转录的 CategoryEvent 部分下。然后，您可以使用此参数及其子参数 MatchedCategories 和 MatchedDetails，来设置自定义实时警报。

以下是 CategoryEvent 匹配的实时呼叫分析转录输出示例：


"CategoryEvent": { 
    "MatchedCategories": [ "shipping-complaint" ],
    "MatchedDetails": { 
        "my package never arrived" : { 
            "TimestampRanges": [    
                { 
                    "BeginOffsetMillis": 19010,
                    "EndOffsetMillis": 22690
                }
            ]
        }
    }
},

前面的示例表示与“我的包裹一直未送达”这句话完全匹配的文本，其代表了“配送投诉”类别中的一条规则。

您可以将实时警报设置为包含所列参数的任意组合。例如，您可以将警报设置为仅包含匹配的短语 (MatchedDetails) 或仅包含类别名称 (MatchedCategories)。或者，您可以将警报设置为包含所有参数。

如何设置实时警报取决于组织的界面和所需的警报类型。例如，您可以将 CategoryEvent 匹配项设置为发送弹出式通知、电子邮件、短信或系统可以接受的任何其它警报。