启动实时呼叫分析转录 - Amazon Transcribe

启动实时呼叫分析转录

在启动实时呼叫分析转录之前,您必须创建希望 Amazon Transcribe 在通话中匹配的所有类别

注意

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

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

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

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

要启动实时通话分析转录,您可以使用 AWS 管理控制台HTTP/2WebSocket;有关示例,请参阅以下内容:

重要

目前,AWS 管理控制台 仅提供带有预加载音频示例的实时呼叫分析演示。如果您想使用自己的音频,则必须使用 API(HTTP/2、WebSocket 或 SDK)。

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

注意

AWS 管理控制台中只有演示可用。要启动自定义实时分析转录,必须使用 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 请求。有关结合 Amazon Transcribe 使用 HTTP/2 流式转录的更多信息,请参阅设置 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://amzn-s3-demo-bucket/my-output-files/", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole" } } } }

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

此示例创建了一个在 WebSocket 音频流中使用呼叫分析的预签名 URL。为了便于阅读,已增加了换行符。有关结合 Amazon Transcribe 使用 WebSocket 音频流的更多信息,请参阅设置 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://amzn-s3-demo-bucket/my-output-files/", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole" } } } }

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

提示

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

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

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

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

为类别匹配创建实时警报

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

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

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

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

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

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

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

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