通話分析のステータスを理解する

メディアインサイトパイプラインでは、次のいずれかまたは両方を行うと、一連のステータスが追跡されます。

• Amazon Transcribe や音声分析など、機械学習処理の要素を複数使用する。

• 機械学習処理の有無にかかわらず、通話録音を有効にする。

パイプラインと要素のステータスを取得するには、 GetMediaPipeline API とEventBridge 通知 を使用します。

音声分析タスクのステータスを取得するには、 GetSpeakerSearchTaskと GetVoiceToneAnalysisTask APIs、および音声分析通知ターゲット を使用します。

メディアインサイトパイプラインでは、次のステータスが追跡されます。

• パイプラインステータス — 通話分析パイプライン (メディアインサイトパイプラインとも呼ばれる) の全体的なステータス。これは、その要素のステータスによって決まります。

• 要素ステータス — 各メディアインサイトパイプライン設定要素の処理ステータス。

• タスクステータス — 音声分析用に開始したメディアインサイトパイプラインタスクの処理ステータス。VoiceAnalyticsProcessor 要素のステータスは、タスクステータスによって決まります。通話分析パイプラインの他の要素には、タスクステータスはありません。

  メディアインサイトパイプラインタスクの詳細については、このガイドで前述した「通話分析の用語」を参照してください。

必ずしもすべてのメディアインサイト設定要素タイプに要素ステータスがあるわけではありません。一般的に、「プロセッサ」タイプのメディアインサイト設定要素にのみ要素ステータスがあります。また、Amazon S3 録音シンクと音声エンハンスメントシンクにはプロセッサステータスがあります。具体的には、次のメディアインサイト設定要素タイプに要素ステータスがあります。

• AmazonTranscribeProcessor

• AmazonTranscribeCallAnalyticsProcessor

• S3RecordingSink

• VoiceAnalyticsProcessor

• VoiceEnhancementSink

パイプラインのステータスは、次に示すように、要素ステータスによって決まります。

パイプラインのステータス	条件
NotStarted	すべての要素ステータスが開始になっていません。
Initializing	少なくとも 1 つの要素が初期化中で、それ以外は開始されていません。
InProgress	少なくとも 1 つの要素が稼働中です。
[失敗]	少なくとも 1 つの要素に障害が発生し、それ以外の要素は停止しています。
停止中	停止条件をすべて確認するには、通話分析パイプラインを管理する を参照してください。
停止	すべての要素が停止しています。
一時停止中	すべての要素が一時停止しています。

他の要素のステータスとは異なり、VoiceAnalyticsProcessor 要素には、やや特別な性質があります。前述のように、Amazon Chime SDK 音声分析機能に対応する VoiceAnalyticsProcessor要素のステータスは、 StartSpeakerSearchTaskおよび から作成されたタスクステータスによって決まりますStartVoiceToneAnalysisTask。

• VoiceAnalyticsProcessor の要素のステータスは NotStarted の状態で始まります。これは、StartSpeakerSearchTask と StartVoiceToneAnalysisTask を呼び出さないと、要素のステータスが Initializing から InProgress に変わらないからです。

• VoiceAnalyticsProcessor では、1 つのタスクを開始し、タスクの実行中に停止条件を満たさない限り、InProgress が維持されます。

• VoiceAnalyticsProcessor が InProgress の場合にも、タスクの処理時間に対してのみ課金が発生します。

• 少なくとも 1 つの音声分析タスクを開始し、それ以外のタスクを実行していないメディアインサイトパイプラインをクリーンアップするには、DeleteMediaPipeline を呼び出す必要があります。

• タスクが実行中、または正常に完了している限り、VoiceAnalyticsProcessor 要素のステータスは InProgress が維持されます。