本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 针对 Amazon Chime SDK 创建呼叫分析配置。
要使用呼叫分析，首先要创建一个*配置*，这是一个静态结构，用于保存创建呼叫分析管道所需的信息。您可以使用 Amazon Chime SDK 控制台或调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 来创建配置。
呼叫分析配置包括有关音频处理器的详细信息，例如录音、语音分析或 Amazon Transcribe。它还包括见解目的地和警报事件配置。或者，您可以将呼叫数据保存到 Amazon S3 存储桶，以便进一步分析。
但是，*配置不包括特定的音频源*。这允许您在多个呼叫分析工作流程中重复使用配置。例如，您可以对不同的 Voice Connector 使用相同的呼叫分析配置，也可以跨不同的 Amazon Kinesis Video Streams (KVS) 来源使用相同的呼叫分析配置。
当通过 Voice Connector 进行 SIP 呼叫时，或者当新媒体被发送到 Amazon Kinesis Video Streams (KVS) 时，您可以使用这些配置来创建管道。反过来，管道根据配置中的规格处理媒体。
您可以随时以编程方式停止管道。当 Voice Connector 呼叫结束时，管道也会停止处理媒体。此外，您还可以暂停管道。这样做会禁用对底层 Amazon 机器学习服务的调用，并在需要时恢复调用。但是，当您暂停管道时，会运行通话录音。
以下各节说明了创建呼叫分析配置的先决条件以及如何创建呼叫分析配置。
**Topics**
+ [了解 Amazon Chime SDK 的呼叫分析先决条件](ca-prerequisites.md)
+ [使用 Amazon Chime SDK 控制台创建呼叫分析配置](create-config-console.md)
+ [用于 APIs 为 Amazon Chime 软件开发工具包创建通话分析配置](create-config-apis.md)
+ [针对 Amazon Chime SDK 将配置与 Voice Connector 关联](ca-associate-vc-steps.md)
# 了解 Amazon Chime SDK 的呼叫分析先决条件
在创建呼叫分析配置之前，您必须具有以下项目。你可以使用 AWS 控制台来创建它们：
+ Amazon Chime SDK Voice Connector。如果不是，请参阅[创建 Amazon Chime SDK Voice Connector](https://docs.aws.amazon.com/chime-sdk/latest/ag/ca-prerequisites.html)。您还必须：
+ 为 Voice Connector 启用流媒体。有关更多信息，请参阅[《亚马逊 Chime 软件开发工具包管理员指南》中的 “ EventBridge使用自动化 Amazon *Chime* 软件开发工具包](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html)”
+ 将 Voice Connector 配置为使用呼叫分析。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[配置 Voice Connector 以使用呼叫分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)。
+ 亚马逊的 EventBridge 目标。如果没有，请参阅[《Amazon Chime 软件开发工具包管理员指南》中的 “使用 EventBridge监控](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html)*亚马逊 Chime* 软件开发工具包”。
+ 一种服务相关角色，允许语音连接器访问对 EventBridge 目标的操作。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[使用 Amazon Chime SDK Voice Connector 服务相关角色策略](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html)。
+ Amazon Kinesis Data Streams。如果不是，请参阅《Amazon Kinesis Streams 开发者指南》**中的[创建和管理流](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html)。语音分析和转录需要 Kinesis Data Streams。
+ 要离线分析通话，您必须创建 Amazon Chime SDK 数据湖。要执行此操作，请参阅本指南后面的 [创建 Amazon Chime SDK 数据湖](ca-data-lake.md)。
# 使用 Amazon Chime SDK 控制台创建呼叫分析配置
在创建了上一节中列出的先决条件后，您可以使用 Amazon Chime SDK 控制台创建一个或多个呼叫分析配置。您还可以使用该控制台将一个或多个 Voice Connector 与配置关联。完成该过程后，呼叫分析将使用您在创建配置时启用的功能开始运行。
您可以按照以下步骤创建呼叫分析配置：
1. 指定配置详细信息，包括名称和可选标签。
1. 配置您的录制设置。创建呼叫分析配置，包括录音和基于机器学习的见解。
1. 配置您的分析服务。
1. 选择用于获取实时见解的输出目的地。创建可选的数据湖以执行通话后分析。
1. 创建新的服务角色或使用现有角色。
1. 设置实时提醒，在满足特定条件 EventBridge 时通过 Amazon 发送通知。
1. 检查您的设置，然后创建配置。
创建配置后，您可以通过将 Voice Connector 与配置关联来启用呼叫分析。完成此操作后，当呼叫进入该 Voice Connector 时，呼叫分析会自动启动。有关更多信息，请参阅本节后文中的 [针对 Amazon Chime SDK 将配置与 Voice Connector 关联](ca-associate-vc-steps.md)。
以下章节介绍如何完成流程的每个步骤。按列出的顺序展开各章节。
## 指定配置详细信息
**若要指定配置详细信息**
1. [在家中打开 Amazon Chime 主机。https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)
1. 在导航窗格中的**呼叫分析**下，选择**配置**，然后选择**创建配置**。
1. 在**基本信息**中，执行以下操作：
1. 为配置输入名称。名称应反映您的用例和所有标签。
1. （可选）在**标签**下，选择**添加新标签**，然后输入标签键和可选值。您可以定义键和值。标签可帮助您查询配置。
1. 选择**下一步**。
## 配置录制
**若要配置录制**
+ 在**配置录制**页面上，执行以下操作：
1. 选中**激活通话录音**复选框。这样可以为 Voice Connector 呼叫或 KVS 流启用录制并将数据发送到您的 Amazon S3 存储桶。
1. 在**文件格式**下，选择**采用 PCM 编码的 WAV** 以获得最佳音频质量。
—或者—
选择**采用 OPUS 编码的 OGG** 来压缩音频并优化存储空间。
1. （可选）根据需要，选择 **Create an Amazon S3 bucket** 链接，然后按照以下步骤创建 Amazon S3 存储桶。
1. 输入您的 Amazon S3 存储桶的 URI，或者选择**浏览**以找到存储桶。
1. （可选）选择**激活语音增强**以帮助提高录音的音频质量。
1. 选择**下一步**。
## 了解语音增强
创建呼叫分析配置时，您可以启用通话录音并将录制的呼叫存储在 Amazon S3 存储桶中。作为其中的一部分，您还可以启用语音增强功能并提高存储通话的音频质量。语音增强功能仅适用于启用该功能后生成的录音。启用语音增强功能后，除了原始录音外，还会创建增强录音，并存储在相同的 Amazon S3 存储桶和格式中。语音增强功能将为长达 30 分钟的通话生成增强录音。长度超过 30 分钟的通话不会生成增强录音。
电话经过窄带过滤，采样频率为 8。 KHz语音增强将采样率从 8kHz 提高到 16kHz，并使用机器学习模型将频率内容从窄带扩展到宽带，使语音听起来更自然。语音增强还使用一种名为 Amazon Voice Focus 的降噪模型来帮助减少增强音频中的背景噪音。
语音增强还使用名为 Voice Focus 的降噪模型。该模型有助于减少增强音频中的背景噪音。语音增强功能将模型应用于升级后的 16 个 KHz 音频。
**注意**
仅在美国东部（弗吉尼亚州北部）地区和美国西部（俄勒冈州）地区支持语音增强功能。
语音增强录音元数据通过您配置的 KDS 发布到现有的 Glue 数据目录表 *call\$1anal* ytics\$1rec AWS ording\$1metadata 中。*为了识别语音增强型通话录音中的原始通话录音记录，在 KDS 通知和粘合表 call\$1analytics\$1recording\$1metadata 中添加了一个名为 deta *il-sub *VoiceEnhancement*type* 的新字段，该字段具有值。*有关数据仓库架构的更多信息，请参阅 [Amazon Chime SDK 的呼叫分析数据模型。](ca-data-model.md)。
### 语音增强文件格式
请注意以下有关增强录音文件的注意事项。
+ 增强录音将写入与普通录音相同的 Amazon S3 存储桶。您可以通过调用[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkConfiguration.html)或或[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkRuntimeConfiguration.html)APIs使用 Amazon Chime 软件开发工具包控制台来配置目标。
+ 增强录音在基本文件名后面附加了 **\$1enhanced**。
+ 增强录音保持与原始录音相同的文件格式。您可以通过调用[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkConfiguration.html)或或[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkRuntimeConfiguration.html) APIs使用 Amazon Chime 软件开发工具包控制台来配置文件格式。
以下示例介绍了一个典型的文件名格式。
```
s3://original_file_name_enhanced.wav
```
或者
```
s3://original_file_name_enhanced.ogg
```
## 配置分析服务
Amazon Transcribe 提供通话文本转录。然后，您可以使用转录来增强其他机器学习服务，例如 Amazon Comprehend 或您自己的机器学习模型。
**注意**
Amazon Transcribe 还提供自动语言识别功能。但是，您不能在自定义语言模型或内容编辑中使用该功能。此外，如果您将语言识别与其他功能一起使用，则只能使用这些功能支持的语言。有关更多信息，请参阅《Amazon Transcribe 开发者指南》**中的[附带流媒体转录的语言识别](https://docs.aws.amazon.com/transcribe/latest/dg/lang-id-stream.html)。
Amazon Transcribe 通话分析功能是一款基于机器学习的 API，可提供通话记录、情绪和实时对话见解。该服务无需记笔记，并且可以对检测到的问题立即采取行动。该服务还提供通话后分析，例如呼叫者情绪、呼叫驱动程序、非通话时间、中断、通话速度和对话特征。
**注意**
默认情况下，通话后分析会将通话录音流式传输到您的 Amazon S3 存储桶。为避免创建重复的录音，请勿同时启用通话录音和通话后分析。
最后，Transcribe 通话分析可以根据特定的短语自动标记对话，并帮助编辑音频和文本中的敏感信息。有关呼叫分析媒体处理器、其生成的见解以及输出目的地的更多信息，请参阅本节后文中的 [Amazon Chime SDK 的呼叫分析处理器和输出目的地](call-analytics-processor-and-output-destinations.md)。
**若要配置分析服务**
1. 在**配置分析服务**页面上，选中**语音分析**或**转录服务**旁边的复选框。您可以同时选择这两个项目。
选中**语音分析**复选框以启用**发言人搜索**和**语调分析**的任意组合。
选中**转录服务**复选框以启用 Amazon Transcribe 或 Transcribe 呼叫分析。
1. **若要启用发言人搜索**
+ 选中 **Yes, I agree to the Consent Acknowledgement for Amazon Chime SDK voice analytics** 复选框，然后选择**接受**。
1. 启用语调分析
+ 选中**语调分析**复选框。
1. 启用 Amazon Transcribe
1. 选择 **Amazon Transcribe** 按钮。
1. 在**语言设置**下，执行以下任一操作：
1. 如果您的呼叫者只讲一种语言，请选择**特定语言**，然后打开**语言**列表并选择语言。
1. 如果您的呼叫者讲多种语言，您可以自动识别这些语言。选择 **Automatic language detection**。
1. 打开 **Language options for automatic language identification** 列表并选择至少两种语言。
1. （可选）打开**首选语言**列表并指定首选语言。当您在上一步中选择的语言具有匹配的置信度分数时，该服务会转录首选语言。
1. （可选）展开**内容删除设置**，选择一个或多个选项，然后选择显示的一个或多个其他选项。帮助文本解释了每个选项。
1. （可选）展开**其他设置**，选择一个或多个选项，然后选择显示的一个或多个其他选项。帮助文本解释了每个选项。
1. 若要启用 Amazon Transcribe 通话分析功能
1. 选择 **Amazon Transcribe 通话分析功能**按钮。
1. 打开**语言**列表并选择一种语言。
1. （可选）展开**内容删除设置**，选择一个或多个选项，然后选择显示的一个或多个其他选项。帮助文本解释了每个选项。
1. （可选）展开**其他设置**，选择一个或多个选项，然后选择显示的一个或多个其他选项。帮助文本解释了每个选项。
1. （可选）展开**通话后分析设置**，然后执行以下操作：
1. 选中**通话后分析**复选框。
1. 输入 Amazon S3 存储桶的 URI。
1. 选择内容密文类型。
1. 完成选择后，选择**下一步**。
## 配置输出详细信息
完成媒体处理步骤后，您可以为分析输出选择目的地。呼叫分析通过 Amazon Kinesis Data Streams 提供实时见解，也可以选择通过您选择的 Amazon S3 存储桶中的数据仓库提供实时见解。要创建数据仓库，请使用 CloudFormation 模板。此模板可帮助您创建基础设施，将呼叫元数据和见解传送到 Amazon S3 存储桶。有关创建数据仓库的更多信息，请参阅本节后文中的 [创建 Amazon Chime SDK 数据湖](ca-data-lake.md)。有关数据仓库架构的更多信息，请参阅本节后文中的 [Amazon Chime SDK 的呼叫分析数据模型。](ca-data-model.md)。
如果您在上一节中启用了语音分析，则还可以添加语音分析通知目的地，例如 AWS Lambda、Amazon 简单队列服务或亚马逊简单通知服务。以下步骤说明了操作方法。
**若要配置输出详细信息**
1. 打开 **Kinesis Data Streams **列表并选择您的数据流。
**注意**
如果要对数据进行可视化，则必须选择 Amazon S3 存储桶和 Amazon Kinesis Data Firehose 使用的 Kinesis Data Streams。
1. （可选）展开**其他语音分析通知目的地**，然后选择 AWS Lambda、Amazon SNS 和亚马逊 SQS 目的地的任意组合。
1. （可选）在**分析和可视化见解**下，选中**使用数据湖执行历史分析**复选框。有关数据湖的更多信息，请参阅本节后文中的 [创建 Amazon Chime SDK 数据湖](ca-data-lake.md)。
1. 在完成后，选择**下一步**。
## 配置访问权限
要启用呼叫分析，机器学习服务和其他资源必须具有访问数据媒体和提供见解的权限。您可以使用现有的服务角色或使用控制台创建新的角色。有关角色的详细信息，请参阅本节后文中的 [针对 Amazon Chime SDK 使用通话分析资源访问角色](call-analytics-resource-access-role.md)。
**若要配置访问权限**
1. 在**配置访问权限**页面上，执行以下任一操作：
1. 选择**创建和使用新的服务角色**。
1. 在**服务角色名后缀**框中，输入该角色的描述性后缀。
—或者—
1. 选择**使用现有服务角色**。
1. 打开**服务角色**列表并选择一个角色。
1. 选择**下一步**。
## （可选）配置实时警报
**重要**
要使用实时提醒，您必须先启用 Amazon Transcribe 或 Amazon Transcribe 分析。
您可以创建一组向 Amazon 发送实时提醒的规则 EventBridge。在分析会话期间，当 Amazon Transcribe 或 Amazon Transcribe 通话分析功能生成的见解与您的指定规则相匹配时，就会发送警报。警报具有详细类型`Media Insights Rules Matched`。 EventBridge 支持与 Amazon Lambda、Amazon SQS 和 Amazon SNS 等下游服务集成，以触发终端用户的通知或启动其他自定义业务逻辑。有关更多信息，请参阅本节后文中的 [为亚马逊 Chime 软件开发工具包使用亚马逊 EventBridge 通知](using-eventbridge-notifications.md)。
**若要配置警报**
1. 在**实时警报**下，选择 **Active real-time alerts**。
1. 在**规则**下，选择**创建规则**。
1. 在**规则名称**框中，输入规则的名称。
1. 打开**规则类型**列表并选择要使用的规则类型。
1. 使用显示的控件向规则添加关键字并应用逻辑，例如 **mentioned** 或 **not mentioned**。
1. 选择**下一步**。
## 审核并创建
**若要创建配置文件**
1. 查看每个章节的设置。根据需要选择**编辑**以更改设置。
1. 选择**创建配置**。
您的配置会显示在 Amazon Chime SDK 控制台的**配置**页面上。
# 用于 APIs 为 Amazon Chime 软件开发工具包创建通话分析配置
您可以通过编程方式创建 Voice Connector 和呼叫分析配置，然后将其关联以启动呼叫分析工作流程。本指南假设您知道如何编写代码。
根据工作流程 APIs 的类型，您使用的会有所不同。例如，要录制音频，您需要先调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 来创建呼叫分析配置。然后，您可以[CreateVoiceConnector](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html)致电创建语音连接器。最后，您可以使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_PutVoiceConnectorStreamingConfiguration.html) API 将配置与 Voice Connector 关联起来。
相反，要使用 Kinesis 视频流创建工具录制音频，您需要调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)，然后再调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
有关使用呼叫分析配置来启用不同工作流程的更多信息，请参阅本节后文 [针对 Amazon Chime SDK 使用呼叫分析配置](using-call-analytics-configurations.md) 中的工作流程。
# 针对 Amazon Chime SDK 将配置与 Voice Connector 关联
使用控制台创建呼叫分析配置后，您可以通过将 Voice Connector 与其关联来使用该配置。然后，Voice Connector 会自动调用您的配置中指定的分析服务。Voice Connector 会为每个呼叫调用呼叫分析。
**关联 Voice Connector**
1. [在家中打开 Amazon Chime 主机。https://console.aws.amazon.com/chime-sdk/](https://console.aws.amazon.com/chime-sdk/home)
1. 在导航窗格的 **SIP 中继**下，选择 **Voice Connector**。
1. 选择要与配置关联的 Voice Connector 的名称，然后选择**流式传输**选项卡。
1. 如果尚未选中，选择**开始**以便开始向 Kinesis 视频流进行流式传输。
1. 在**呼叫分析**下，选择**激活**，然后在出现的菜单上，选择您的呼叫分析配置 ARN。
1. 选择**保存**。
**注意**
启用、禁用或修改与 Voice Connector 关联的配置后，请等待 5 分钟，让新设置通过服务传播并生效。
有关呼叫分析配置的更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[管理呼叫分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/ag-call-analytics.html)。
有关使用呼叫分析配置来启用不同工作流程的更多信息，请参阅本节后文中的 [针对 Amazon Chime SDK 使用呼叫分析配置](using-call-analytics-configurations.md)。