翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 通話分析を設定する
通話分析を使用するには、最初に設定を行います。設定とは、通話分析パイプラインの作成に必要な情報を保持する静的構造を意味します。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**
+ [前提条件](#ca-ag-prereqs)
+ [通話分析設定の作成](#create-config-steps)
## 前提条件
Amazon Transcribe、Amazon Transcribe Analytics、または Amazon Chime SDK 音声分析で通話分析を使用するには、次の項目が必要です。
+ Amazon Chime SDK Voice Connector。そうでない場合は、このガイドの前半の[Amazon Chime SDK Voice Connector の作成](create-voicecon.md)「」を参照してください。
+ Amazon EventBridge の対象。そうでない場合は、このガイドの前半にある[Amazon CloudWatch による Amazon Chime SDK のモニタリング](monitoring-cloudwatch.md)「」を参照してください。
+ サービスにリンクされたロール。これにより、Voice Connector が EventBridge の対象で生じるアクションにアクセスできるようにします。詳細については、このガイドの前半にある「[Amazon Chime SDK Voice Connector サービスにリンクされたロールポリシーの使用](using-service-linked-roles-stream.md)」を参照してください。
+ 1 つの Amazon Kinesis Data Streams。そうでない場合は、「Amazon [Kinesis Video Stream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-createstream.html) デベロッパーガイド」の「Kinesis Video Stream の作成」を参照してください。 *Amazon Kinesis * 音声分析と文字起こしには Kinesis ストリームが必要です。
+ 通話をオフラインで分析するには、Amazon Chime SDK データレイクを作成する必要があります。これを行うには、[「Amazon Chime SDK デベロッパーガイド」の「Amazon Chime SDK データレイク](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-data-lake.html)の作成」を参照してください。 **
## 通話分析設定の作成
設定を完了したら、Voice Connector をその設定に関連付けて通話分析を有効にします。これにより、その Voice Connector で通話の着信が発生したタイミングで通話分析が自動的に開始されます。詳細については、このガイドの前半にある「[通話分析を使用するように Voice Connector を設定する](configure-voicecon.md)」を参照してください。
次のセクションでは、プロセスの各手順を完了する方法について説明します。リストされている項目をこの順序で展開してください。
### 設定の詳細を指定する
**設定の詳細を指定するには、**
1. [https://console.aws.amazon.com/chime-sdk/home](https://console.aws.amazon.com/chime-sdk/home) で Amazon Chime SDK コンソールを開きます。
1. ナビゲーションペインの **[通話分析]** で **[設定]** を選択し、**[設定の作成]** を選択します。
1. **[基本的な情報]** で、以下を実行します。
1. 設定の名前を入力します。ユースケースとタグがわかる名前にする必要があります。
1. (オプション) **[タグ]** で **[新しいタグの追加]** を選択し、タグキーとオプションの値を入力します。キーと値を定義します。タグは、設定のクエリに役立ちます。
1. [**Next (次へ)**] を選択します。
### 録音を設定する
**録音を設定するには**
+ **[記録を設定]** ページで、次の手順を実行します。
1. **[通話録音を有効にする]** チェックボックスを選択します。これにより、Voice Connector の通話や KVS のストリームを録音し、そのデータを Amazon S3 バケットに送信できます。
1. **[ファイル形式]** で **[WAV と PCM]** を選択します。これにより、最良の音質が得られます。
または
**[OGG と OPUS]** を選択すると、音声を圧縮し、ストレージを最適化できます。
1. (オプション) 必要に応じて、**[Amazon S3 バケットの作成]** リンクを選択し、次の手順に従って Amazon S3 バケットを作成します。
1. Amazon S3 バケットの URI を入力するか、**[参照]** を選択してバケットを検索します。
1. (オプション) **[音声エンハンスメントを有効にする]** を選択すると、録音の音質が向上します。
1. [**Next (次へ)**] を選択します。
音声エンハンスメントの詳細については、次のセクションを展開してください。
### 音声エンハンスメントを理解する
音声エンハンスメントは、顧客の Amazon S3 バケットで録音された通話の音声品質を向上させるのに役立ちます。通話はナローバンドフィルタリングされ、8 kHz レートでサンプリングされます。音声エンハンスメントでは、サンプリングレートを 8 kHz から 16 kHz に引き上げ、機械学習モデルを使用して周波数成分を狭帯域から広帯域に拡張することで、より自然な音声を実現しています。また、Amazon Voice Focus と呼ばれるノイズリダクションモデルを使用し、拡張機能を使用した音声でバックグラウンドノイズも低減します。
音声エンハンスメントを有効にすると、通話録音が完了した後に音声エンハンスメント処理が実行されます。拡張オーディオファイルは元の録音として Amazon S3 バケットに書き込まれ、元の録音のベースファイル名にサフィックス **\$1enhanced** が追加されます。音声エンハンスメントでは、最大 30 分間通話を処理できます。30 分を超える通話では、拡張録音は行えません。
プログラムによる音声エンハンスメントの使用の詳細については、*「Amazon Chime SDK* [デベロッパーガイドAPIs を使用した通話分析設定の作成](https://docs.aws.amazon.com/chime-sdk/latest/dg/create-config-apis.html)」を参照してください。
音声エンハンスメントの詳細については、*https://docs.aws.amazon.com/chime/latest/dg/* の「Understanding [voice enhancement ](https://docs.aws.amazon.com/chime-sdk/latest/dg/understand-voice-enhancement.html)」を参照してください。
### 分析サービスを設定する
Amazon Transcribe を使用すると、通話の文字起こしを行えます。その後、文字起こししたテキストを使用して、Amazon Comprehend といった他の機械学習サービスや独自の機械学習モデルを強化できます。
**注記**
Amazon Transcribe は、自動言語認識機能も備えていますが、この機能は、カスタム言語モデルやコンテンツ編集では使用できません。また、他の機能で言語識別を使用する場合は、その機能が対応している言語しか使用できません。詳細については、「*Amazon Transcribe Developer Guide*」の「[Language identification with streaming transcriptions](https://docs.aws.amazon.com/transcribe/latest/dg/lang-id-stream.html)」を参照してください。
Amazon Transcribe Call Analytics は、機械学習を活用した API であり、これによって、通話の文字起こし、センチメント分析、会話に関するインサイトのリアルタイム取得などが可能になります。このサービスを利用すると、メモを取る必要がなくなり、見つかった問題にすぐに対処できます。また、発信者の感情、通話の要因、会話のない時間、会話のさえぎり、会話の速度、会話の特徴などに通話後分析も行えます。
**注記**
デフォルトの場合、通話後分析は、Amazon S3 バケットにストリーミングされます。録音の重複を防ぐには、通話録音と通話後分析を同時に有効化しないようにします。
さらに、Transcribe Call Analytics では、特定のフレーズに基づいて会話に自動的にタグを付けることで、音声やテキストから機密情報を削除できます。通話分析メディアプロセッサ、これらのプロセッサによって生成されたインサイト、および出力先の詳細については、*「Amazon Chime SDK デベロッパーガイド*」の[「通話分析プロセッサと出力先](https://docs.aws.amazon.com/chime-sdk/latest/dg/call-analytics-processor-and-output-destinations.html)」を参照してください。
**分析サービスを設定するには**
1. **[分析サービスを設定]** ページで、**[音声分析]** または **[文字起こしサービス]** の横にあるチェックボックスを選択します。両方の選択も可能です。
**[音声分析]** チェックボックスを選択すると、**[発話者検索]** と **[ボイストーン分析]** を任意に組み合わせることができます。
**[文字起こしサービス]** チェックボックスを選択して、Amazon Transcribe または Transcribe Call Analytics を有効にします。
1. **発話者検索を有効にするには**
+ **[はい、Amazon Chime SDK 音声分析の同意確認を認めます]** チェックボックスを選択し、**[承諾]** を選択します。
1. ボイストーン分析を有効にするには
+ **[ボイストーン分析]** チェックボックスを選択します。
1. Amazon Transcribe を有効にするには
1. **[Amazon Transcribe]** ボタンを選択します。
1. **[言語設定]** で、次のいずれかを実行します。
1. 発信者が 1 つの言語を話す場合は、**[特定の言語]** を選択して **[言語]** リストを開き、対象の言語を指定します。
1. 発信者が複数の言語を話す場合は、自動的に識別されます。**[言語の自動検出]** を選択します。
1. **[自動言語識別の言語オプション]** リストを開き、少なくとも 2 つの言語を選択します。
1. (オプション) **[優先言語]** リストを開き、優先言語を指定します。前の手順で選択した言語の信頼スコアが一致すると、優先言語での文字起こしが実行されます。
1. (オプション) **[コンテンツ削除設定]** を展開して 1 つまたは複数のオプションを選択し、表示される追加オプションから 1 つ以上を選択します。各オプションの説明は、ヘルパーテキストで確認できます。
1. (オプション) **[その他の設定]** を展開して 1 つまたは複数のオプションを選択し、表示される追加オプションから 1 つ以上を選択します。各オプションの説明は、ヘルパーテキストで確認できます。
1. Amazon Transcribe Call Analytics を有効にするには
1. **[Amazon Transcribe Call Analytics]** ボタンを選択します。
1. **[言語]** リストを開き、言語を選択します。
1. (オプション) **[コンテンツ削除設定]** を展開して 1 つまたは複数のオプションを選択し、表示される追加オプションから 1 つ以上を選択します。各オプションの説明は、ヘルパーテキストで確認できます。
1. (オプション) **[その他の設定]** を展開して 1 つまたは複数のオプションを選択し、表示される追加オプションから 1 つ以上を選択します。各オプションの説明は、ヘルパーテキストで確認できます。
1. (オプション) **[通話後分析]** 設定を展開し、次の操作を行います。
1. **[通話後分析]** チェックボックスを選択します。
1. Amazon S3 バケットの URI を入力します。
1. コンテンツ編集タイプを選択します。
1. 選択したら、**[次へ]** を選択します。
### 出力の詳細設定を行う
メディア処理の手順を完了したら、分析結果の出力先を選択します。通話分析では、Amazon Kinesis Data Streams を介して、また、オプションにより、選択した Amazon S3 バケット内のデータウェアハウスを介して、インサイトをライブで取得できます。データウェアハウスを作成するには、CloudFormation テンプレートを使用します。このテンプレートにより、通話のメタデータとインサイトを Amazon S3 バケットに配信するインフラストラクチャを構築できます。データウェアハウスの作成の詳細については、[「Amazon Chime SDK デベロッパーガイド」の「Amazon Chime データレイク](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-data-lake.html)の作成」と[「通話分析データモデル](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-data-model.html)」を参照してください。 **
設定の作成時に音声分析を有効にすると、 AWS Lambda、Amazon Simple Queue Service、Amazon Simple Notification Service などの音声分析通知の送信先を追加することもできます。以下では、その手順を説明します。
**出力の詳細を設定するには**
1. **[Kinesis Data Stream]** リストを開き、データストリームを選択します。
**注記**
データを視覚化するには、Amazon S3 バケットと Amazon Kinesis Data Firehose で使用する Kinesis Data Stream を選択する必要があります。
1. (オプション) **[その他の音声分析通知先]** を展開し、送信先として [ AWS Lambda]、[Amazon SNS]、[Amazon SQS] を任意に組み合わせ、選択します。
1. (オプション) **[インサイトの分析と視覚化]** で、**[データレイクを使用した過去データ分析を実行]** チェックボックスを選択します。
1. 完了したら、[**次へ**] を選択します。
### アクセス許可を設定する
通話分析を有効にするには、機械学習サービスなどのリソースに、データメディアにアクセスしてインサイトを提供するための権限が必要です。詳細については、*「Amazon Chime SDK* [デベロッパーガイド」の「通話分析リソースアクセスロール](https://docs.aws.amazon.com/chime-sdk/latest/dg/call-analytics-resource-access-role.html)の使用」を参照してください。
**アクセス許可を設定するには**
1. **[アクセス許可を設定]** ページで、次の操作のいずれかを行います。
1. **[新しいサービスロールを作成し使用する]** を選択します。
1. **[サービスロール名のサフィックス]** ボックスに、どのようなロールかがわかるようなサフィックスを入力します。
または
1. **[既存のサービスロールを使用する]** を選択します。
1. **[サービスロール]** リストを開き、ロールを選択します。
1. [**Next (次へ)**] を選択します。
### (オプション) リアルタイムアラートを設定する
**重要**
リアルタイムアラートを使用するには、まず Amazon Transcribe または Amazon Transcribe Call Analytics を有効にする必要があります。
Amazon EventBridge にリアルタイムアラートを送信するルールセットを作成できます。Amazon Transcribe または Amazon Transcribe Call Analytics によって生成されたインサイトが、分析セッション中に指定されたルールと一致すると、アラートが送信されます。アラートには `Media Insights Rules Matched` という詳細タイプが設定されています。EventBridge は、Amazon Lambda、Amazon SQS、Amazon SNS などのダウンストリームサービスにも対応しているため、エンドユーザーへの通知をトリガーしたり、他のカスタムビジネスロジックを開始したりできます。詳細については、このセクションで後述する「[EventBridge を使用した Amazon Chime SDK の自動化](automating-chime-with-cloudwatch-events.md)」を参照してください。
**アラートを設定するには**
1. **[リアルタイムアラート]** で **[リアルタイムアラートを有効にする]** を選択します。
1. **[ルール]** で **[ルールを作成]** を選択します。
1. **[ルール名]** ボックスにルールの名前を入力します。
1. **[ルールタイプ]** リストを開き、使用するルールタイプを選択します。
1. 表示されるコントロールを使用して、ルールにキーワードを追加したり、**[言及あり]** や **[言及なし]** などのロジックを適用したりできます。
1. [**Next (次へ)**] を選択します。
### 確認と作成
**設定を行うには**
1. 各セクションの設定内容を確認します。必要に応じて **[編集]** を選択し、設定を変更します。
1. **[設定を作成]** を選択します。
設定内容は、Amazon Chime SDK コンソールの **[設定]** ページに表示されます。