本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 對話分析區段串流的資料模型，用來分析 Contact Lens 中的語音聯絡
<a name="real-time-contact-analysis-segment-streams-data-model"></a>

即時聯絡分析細分流以 JSON 生成。對於每個已啟用即時對話分析的聯絡，事件 JSON 都會發布至相關聯的串流。您可以為語音聯絡的對話分析工作階段發布下列類型的事件：
+ STARTED 事件 - 每個對話分析工作階段都會在工作階段開始時發布一個 STARTED 事件。
+ SEGMENTS 事件 - 每個對話分析工作階段都可能在工作階段期間發佈零或多個 SEGMENTS 事件。這些事件包含具有分析資訊的區段清單。對於語音聯絡，區段清單可能包含「`Utterance`」、「`Transcript`」、「`Categories`」或「`PostContactSummary`」區段。
+ COMPLETED 或 FAILED 事件 - 每個對話分析工作階段都會在工作階段結束時發布一個 COMPLETED 或 FAILED 事件。

## 語音聯絡的所有事件中包含的共同屬性
<a name="segment-streams-data-model-common-properties"></a>

每個事件含有以下屬性：

**版本**  
事件結構描述的版本。  
類型：字串

**Channel**  
此聯絡管道的類型。  
類型：字串  
有效值：`VOICE`、`CHAT`、`TASK`  
如需頻道的詳細資訊，請參閱 [在 Amazon Connect 中轉接聯絡人的頻道和並行](channels-and-concurrency.md)。

**AccountId**  
發生此聯絡所在帳戶的識別碼。  
類型：字串

**ContactId**  
正在分析的聯絡識別碼。  
類型：字串

**InstanceId**  
發生此聯絡所在的執行個體識別碼。  
類型：字串 

**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` 事件僅包括通用屬性：
+ 版本
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType：STARTED

## SEGMENTS 事件
<a name="segment-streams-data-model-segments-event"></a>

`SEGMENTS` 事件包括下列屬性：
+ 版本
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType：SEGMENTS
+ 區段：除了通用屬性之外，`SEGMENTS` 事件還包括具有分析資訊的區段清單。

  類型：[區段](#segment)物件的陣列
+ PostContactSummary：語音聯絡區段的聯絡後摘要的相關資訊。

  類型：[PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html) 物件 

  必要：否

**區段**  
即時分析工作階段的分析區段。  
每個區段都是具有下列選用屬性的物件。視區段類型而定，僅存在下列屬性之一：  
+ 表達用語
+ 文字記錄
+ 類別
+ PostContactSummary

**表達用語**  
經分析的表達用語。  
必要：否  
+ **Id**

  表達用語的識別碼。

  類型：字串
+ ** TranscriptId**

  與此表達用語關聯的文字記錄識別碼。

  類型：字串
+ **ParticipantId**

  參與者的識別碼。

  類型：字串
+ ** ParticipantRole**

  參與者的角色。例如，是客戶、客服人員或是系統。

  類型：字串
+ ** PartialContent**

  表達用語的內容。

  類型：字串
+ ** BeginOffsetMillis**

  此文字記錄聯絡中的開始偏移。

  類型：整數
+ ** EndOffsetMillis**

  此文字記錄聯絡中的結束偏移。

  類型：整數

**文字記錄**  
經分析的文字記錄。  
類型：[文字記錄](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Transcript.html)物件   
必要：否

**類別**  
符合的類別規則。  
類型：[類別](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` 事件僅包括下列通用屬性：
+ 版本
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType：COMPLETED

## 失敗的事件
<a name="segment-streams-data-model-failed-event"></a>

`FAILED` 事件僅包括下列通用屬性：
+ 版本
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType：FAILED