翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Contact Lens で音声コンタクトを分析するための会話分析セグメントストリームのデータモデル
<a name="real-time-contact-analysis-segment-streams-data-model"></a>

リアルタイム問い合わせ分析セグメントストリームは JSON で生成されます。リアルタイム会話分析が有効になっているすべてのコンタクトの関連ストリームに、イベント JSON blob が公開されます。音声コンタクトの会話分析セッションのために、以下のタイプのイベントを公開できます。
+ STARTED イベント - 各会話分析セッションは、セッションの開始時に 1 つの STARTED イベントを公開します。
+ SEGMENTS イベント - 各会話分析セッションは、セッション中に 1 つ以上の SEGMENTS イベントを公開することがあります (イベントが 0 の場合もあります)。これらのイベントには、分析された情報を含むセグメントのリストが含まれます。音声コンタクトの場合、セグメントのリストには 、「`Utterance`」、「`Transcript`」、「`Categories`」または「`PostContactSummary`」セグメントが含まれる場合があります。
+ COMPLETED または FAILED イベント - 各会話分析セッションは、セッションの終了時に 1 つの COMPLETED イベントまたは FAILED イベントを公開します。

## 音声コンタクトのすべてのイベントに含まれる共通のプロパティ
<a name="segment-streams-data-model-common-properties"></a>

すべてのイベントには、以下のプロパティが含まれます。

**バージョン**  
イベントスキーマのバージョン。  
型: 文字列

**Channel**  
この問い合わせのチャネルのタイプ。  
型: 文字列  
有効な値: `VOICE`、`CHAT`、`TASK`  
チャネルの詳細については、「[Amazon Connect で問い合わせをルーティングするためのチャネルと同時実行数](channels-and-concurrency.md)」を参照してください。

**AccountId**  
この問い合わせが行われるアカウントの ID。  
型: 文字列

**ContactId**  
分析される問い合わせの ID。  
型: 文字列

**InstanceId**  
この問い合わせが行われるインスタンスの ID。  
型: 文字列 

**LanguageCode**  
この問い合わせに関連付けられている言語コード。  
タイプ: 文字列   
有効な値: [Contact Lens リアルタイム通話分析でサポートされている言語](supported-languages.md#supported-languages-contact-lens)のいずれかの言語コード。

**EventType**  
発行されるイベントのタイプ。  
型: 文字列  
有効な値: `STARTED`、`SEGMENTS`、`COMPLETED`、`FAILED`

## STARTED イベント
<a name="segment-streams-data-model-started-event"></a>

`STARTED` イベントには、共通のプロパティのみが含まれます。
+ Version
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: STARTED

## SEGMENTS イベント
<a name="segment-streams-data-model-segments-event"></a>

`SEGMENTS` イベントには、以下のプロパティが含まれます。
+ Version
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: SEGMENTS
+ セグメント: 共通のプロパティに加えて、`SEGMENTS` イベントには、セグメントのリストと分析情報が含まれます。

  タイプ: [セグメント](#segment)オブジェクトの配列
+ PostContactSummary: 音声コンタクトセグメントのコンタクト後の概要に関する情報。

  タイプ: [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html) オブジェクト 

  必須: いいえ

**セグメント**  
リアルタイム分析セッションで分析されたセグメント。  
各セグメントは、以下のオプションのプロパティを持つオブジェクトです。セグメントタイプに応じて、以下のプロパティの 1 つだけが存在します。  
+ Utterance
+ Transcript
+ カテゴリ
+ PostContactSummary

**Utterance**  
分析された発話。  
必須: いいえ  
+ **ID**

  発話の ID。

  型: 文字列
+ ** TranscriptId**

  この発話に関連付けられているトランスクリプトの ID。

  タイプ: 文字列
+ **ParticipantId**

  参加者の ID。

  型: 文字列
+ ** ParticipantRole**

  参加者のロール。例えば、顧客、エージェント、システムなどです。

  型: 文字列
+ ** PartialContent**

  発話の内容。

  型: 文字列
+ ** BeginOffsetMillis**

  このトランスクリプトのコンタクトの開始オフセット。

  タイプ: 整数
+ ** EndOffsetMillis**

  このトランスクリプトのコンタクトの終了オフセット。

  タイプ: 整数

**Transcript**  
分析されたトランスクリプト。  
型: [トランスクリプト](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Transcript.html)オブジェクト   
必須: いいえ

**Categories**  
一致したカテゴリルール。  
タイプ: [Categories](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Categories.html) オブジェクト  
必須: いいえ

**PostContactSummary**  
音声コンタクトセグメントのコンタクト後の概要に関する情報。  
タイプ: [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html) オブジェクト  
必須: いいえ

## COMPLETED イベント
<a name="segment-streams-data-model-completed-event"></a>

`COMPLETED` イベントには、以下の共通プロパティのみが含まれます。
+ Version
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: COMPLETED

## FAILED イベント
<a name="segment-streams-data-model-failed-event"></a>

`FAILED` イベントには、以下の共通プロパティのみが含まれます。
+ Version
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: FAILED