本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 启动实时呼叫分析转录
在开始实时 Call Analytics 转录之前，您必须创建 Amazon Transcribe 要在通话中匹配的所有[类别](tca-categories-stream.md)。
**注意**
呼叫分析转录无法追溯性地与新类别匹配。只有您在启动呼叫分析转录*之前*创建的类别才能应用于该转录输出。
如果您创建了一个或多个类别，并且您的音频与至少一个类别中的所有规则匹配， Amazon Transcribe 会使用匹配的类别来标记您的输出。如果您选择不使用类别，或者您的音频与类别中指定的规则不匹配，则不会标记您的转录。
要在实时呼叫分析转录中包含通话后分析，您必须使用 `OutputLocation` 参数在请求中提供一个 Amazon S3 存储桶。您还必须包括对指定存储桶具有写入权限的 `DataAccessRoleArn`。在您的实时呼叫分析流式会话完成后，系统会生成一份单独的转录并将其存储在指定的存储桶中。
借助实时呼叫分析，您还可以选择创建实时类别警报；有关说明，请参阅[为类别匹配创建实时警报](#tca-create-alert-stream)。
要开始实时呼叫分析转录，你可以使用**AWS 管理控制台**、**HTTP/2** 或 **WebSockets**；有关示例，请参阅以下内容：
**重要**
目前， AWS 管理控制台 唯一提供带有预加载音频示例的实时呼叫分析演示。如果您想使用自己的音频，则必须使用 API（HTTP/2 或 SDK）。 WebSockets
## AWS 管理控制台
请按以下过程启动呼叫分析请求。符合类别定义的所有特点的通话将使用该类别进行标记。
**注意**
AWS 管理控制台中只有演示可用。要启动自定义实时分析转录，必须使用 [API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html)。
1. 在导航窗格的 “ Amazon Transcribe 呼叫分析” 下，选择 “**分析实时通话**”。
![\[Amazon Transcribe 控制台屏幕截图：“分析直播通话” 演示页面。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start-stream.png)
1. 对于**步骤 1: 指定输入音频**，请从下拉菜单中选择一个演示测试文件。
![\[Amazon Transcribe 控制台屏幕截图：演示输入音频的下拉选项。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start-stream-settings1.png)
1. 对于**第 2 步: 查看通话类别**，您可以选择查看之前创建的实时呼叫分析类别。所有实时呼叫分析类别都应用于您的转录。
选择**查看类别**后将打开一个新窗格，其中显示您现有的实时呼叫分析类别，并提供创建新类别的链接。
![\[Amazon Transcribe 控制台屏幕截图：“通话分析类别” 页面。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start-stream-settings2.png)
1. 对于**步骤 3: 配置输入和输出**，您可以选择应用其它设置。
选择**配置高级设置**将打开一个新窗格，您可以在其中指定内容编辑设置。
![\[Amazon Transcribe 控制台屏幕截图：高级设置面板全部折叠。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start-stream-settings3.png)
完成所有选择后，选择**保存**返回主页。
1. 要应用其它分析，您可以开启**通话后分析**。这为您提供了与通话后分析转录相同的分析，包括中断、音量、非通话时间、通话速度、通话时间、问题、操作项目和结果。通话后分析输出与您的实时呼叫分析转录存储在不同的文件中。
![\[Amazon Transcribe 控制台屏幕截图：通话后分析面板已折叠。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start-stream-post-call1.png)
如果您应用电话后分析，则必须指定 Amazon S3 输出文件目标和 IAM 角色。您可以选择对输出进行加密。
![\[Amazon Transcribe 控制台屏幕截图：通话后分析面板已展开。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start-stream-post-call1a.png)
1. 选择 **Start streaming（开始流式传输）**。
## HTTP/2 音频流
此示例创建了一个启用了呼叫分析的 HTTP/2 请求。有关使用 HTTP/2 流式传输的更多信息 Amazon Transcribe，请参阅。[设置 HTTP/2 音频流](streaming-setting-up.md#streaming-http2)有关特定于的参数和标题的更多详细信息 Amazon Transcribe，请参阅[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html)。
此示例包括[通话后分析](tca-post-call.md)。如果您不想进行通话后分析，请从请求中删除 `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 参考](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html)中找到；所有 AWS API 操作的通用参数列在[常用参数](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html)部分中。
## WebSocket 直播
此示例创建了一个在 WebSocket 直播中使用 Call Analytics 的预签名网址。为了便于阅读，已增加了换行符。有关将 WebSocket 直播与配合使用的更多信息 Amazon Transcribe，请参阅[设置直 WebSocket 播](streaming-setting-up.md#streaming-websocket)。有关参数的更多详细信息，请参阅 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html)。
此示例包括[通话后分析](tca-post-call.md)。如果您不想进行通话后分析，请从请求中删除 `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 参考](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html)中找到；所有 AWS API 操作的通用参数列在[常用参数](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html)部分中。
**提示**
上面的 HTTP/2 和 WebSocket 示例包括通话后分析。如果您不想进行通话后分析，请从请求中删除 `PostCallAnalyticsSettings` 部分。
如果启用 `PostCallAnalyticsSettings`，则必须将配置事件作为第一个事件发送。您的配置事件包括 `ChannelDenifitions` 和 `PostStreamAnalyticsSettings` 的设置，如前面的示例所示。
二进制数据通过 `content-type application/octet-stream` 以二进制消息的形式传送，配置事件通过 `content-type application/json` 以文本消息的形式传送。
有关更多信息，请参阅 [设置流式转录](streaming-setting-up.md)。
## 为类别匹配创建实时警报
要设置实时警报，必须先创建一个带有 `REAL_TIME` 标志的 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html) 类别。此标志允许将您的类别应用于实时呼叫分析转录。
有关创建新类别的说明，请参阅 [为实时转录创建类别](tca-categories-stream.md)。
当您开始实时呼叫分析转录时，所有带有 `REAL_TIME` 标记的类别都会自动应用于片段级转录输出。如果出现 `TranscriptFilterType` 匹配，则会显示在转录的 `CategoryEvent` 部分下。然后，您可以使用此参数及其子参数 `MatchedCategories` 和 `MatchedDetails`，来设置自定义实时警报。
以下是 `CategoryEvent` 匹配的实时呼叫分析转录输出示例：
```
"CategoryEvent": {
"MatchedCategories": [ "shipping-complaint" ],
"MatchedDetails": {
"my package never arrived" : {
"TimestampRanges": [
{
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22690
}
]
}
}
},
```
前面的示例表示与“*我的包裹一直未送达*”这句话完全匹配的文本，其代表了“配送投诉”类别中的一条规则。
您可以将实时警报设置为包含所列参数的任意组合。例如，您可以将警报设置为仅包含匹配的短语 (`MatchedDetails`) 或仅包含类别名称 (`MatchedCategories`)。或者，您可以将警报设置为包含所有参数。
如何设置实时警报取决于组织的界面和所需的警报类型。例如，您可以将 `CategoryEvent` 匹配项设置为发送弹出式通知、电子邮件、短信或系统可以接受的任何其它警报。