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

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

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

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

每個事件含有以下屬性：

**版本**  
事件結構描述的版本。對於聊天聯絡，此項目為 2.0.0。  
類型：字串

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

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

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

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

**StreamingEventType**  
已發布的事件類型。  
類型：字串   
有效值：`STARTED`、`SEGMENTS`、`COMPLETED`、`FAILED`

**StreamingSettings**  
此聯絡的 Contact Lens 設定  
類型：[StreamingSettings](#streamingsettingsobject) 物件 

## StreamingSettings 物件
<a name="streamingsettingsobject"></a>

**LanguageCode**  
與此聯絡關聯的語言代碼。  
類型：字串   
有效值：[Contact Lens 即時通話分析支援的語言](supported-languages.md#supported-languages-contact-lens)之一的語言代碼。

**Output**  
為此聯絡啟用的 Contact Lens 輸出類型。  
類型：字串  
有效值：`Raw`、`Redacted`、`RedactedAndRaw`

**RedactionTypes**  
為此聯絡啟用的修訂類型。  
類型：字串陣列  
有效值：`PII`

**RedactionTypesMetadata**  
每個修訂類型的修訂中繼資料。  
類型：[RedactionMetadata](#redactionmetadata) 物件的 RedactionType 字串   
有效值：`PII`

## RedactionMetadata 物件
<a name="redactionmetadata"></a>

提供修訂設定的相關資訊。

**RedactionMaskMode**  
資料修訂取代設定  
類型：字串   
有效值：`PII`、`EntityType`

## STARTED 事件
<a name="chat-segment-streams-data-model-started-event"></a>

`STARTED` 事件僅包括通用屬性：
+ 版本
+ Channel
+ AccountId
+ ContactId
+ StreamingEventType：STARTED
+ StreamingSettings

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

`SEGMENTS` 事件包括下列屬性：
+ 版本
+ Channel
+ AccountId
+ OutputType
  + 目前區段的 Contact Lens 輸出類型
  + 類型：字串
  + 有效值：`Raw`、`Redacted`
+ ContactId
+ StreamingEventType：SEGMENTS
+ StreamingSettings
+ 客群
  + 分析資訊的區段清單。
  + 類型：[區段](#chat-segment)物件的陣列

**區段**  
即時分析工作階段的分析區段。  
每個區段都是具有下列選用屬性的物件。視區段類型而定，僅存在下列屬性之一：  
+  [附件](#chat-attachments)
+  [類別](#chat-category)
+  [事件](#chat-event)
+  [問題](#chat-issues)
+  [文字記錄](#chat-transcript)
+ [PostContactSummary](#chat-postcontactsummary)

**附件**  
已分析的附件。  
必要：否  
類型：[RealTimeContactAnalysisSegmentAttachments](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentAttachments.html) 物件

**類別**  
符合的類別規則。  
類型：[RealTimeContactAnalysisSegmentCategories](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentCategories.html) 物件  
必要：否

**事件**  
描述聯絡事件的區段類型。  
類型：[RealTimeContactAnalysisSegmentEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentEvent.html) 物件  
必要：否

**問題**  
包含偵測到的問題清單的區段類型。  
類型：[RealTimeContactAnalysisSegmentIssues](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentIssues.html) 物件  
必要：否

**文字記錄**  
已分析的文字記錄區段。  
類型：[RealTimeContactAnalysisSegmentTranscript](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentTranscript.html) 物件  
必要：否

**PostContactSummary**  
聊天即時聯絡區段的聯絡後摘要的相關資訊。  
類型：[RealTimeContactAnalysisSegmentPostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentPostContactSummary.html) 物件   
必要：否

## COMPLETED 事件
<a name="chat-segment-streams-data-model-completed-event"></a>

`COMPLETED` 事件僅包括下列通用屬性：
+ 版本
+ Channel
+ AccountId
+ InstanceId
+ ContactId
+ StreamingEventType：COMPLETED
+ StreamingSettings

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

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