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

# 啟用聯絡分析區段串流以分析 Contact Lens 對話
<a name="enable-contact-analysis-segment-streams"></a>

依預設不會啟用聯絡分析區段串流。本主題介紹如何啟用。

## 步驟 1：建立 Kinesis 串流
<a name="enable-segment-streams-step1"></a>

在 Amazon Connect 執行個體所在的相同帳戶和區域上建立資料串流。如需指示，請參閱《Amazon Kinesis Data Streams 開發人員指南》**中的[步驟 1：建立資料串流](https://docs.aws.amazon.com/streams/latest/dev/tutorial-stock-data-kplkcl-create-stream.html)。

**提示**  
我們建議您為每種類型的資料建立單獨的串流。儘管可以將相同的串流用於聯絡分析區段串流，客服人員事件和聯絡人記錄，但是當您分別為其使用個別串流時，管理和從串流中獲取資料要容易得多。如需詳細資訊，請參閱《[Amazon Kinesis Data Streams 開發人員指南](https://docs.aws.amazon.com/streams/latest/dev/introduction.html)》。

## 步驟 2：為 Kinesis 串流設定伺服器端加密 (選用但建議使用)
<a name="enable-segment-streams-step2"></a>

您有幾種方式可以執行此作業。
+ 選項 1：使用 Kinesis AWS 受管金鑰 (`aws/kinesis`)。這無須其他設定即可使用。
+ 選項 2：對 Amazon Connect 執行個體中的通話錄音、聊天記錄或匯出的報告使用相同的客戶受管金鑰。

  啟用加密，並在 Amazon Connect 執行個體中將客戶受管金鑰用於通話錄音、聊天記錄或匯出的報告。然後為 Kinesis 資料串流選擇相同的 KMS 金鑰。此密鑰已經具有使用所需的許可 (授予)。
+ 選項 3：使用其他客戶受管金鑰。

  使用現有的客戶受管金鑰或建立新金鑰，然後為 Amazon Connect 角色新增必要許可用金鑰。若要使用 AWS KMS 授權新增許可，請參閱以下範例：

  ```
  aws kms create-grant \
      --key-id {{your key ID}} \
      --grantee-principal arn:aws:iam::{{your AWS account ID}}:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_{{11111111111111111111}} \
      --operations GenerateDataKey \
      --retiring-principal arn:aws:iam::{{your AWS account ID}}:role/adminRole
  ```

  與您的 Amazon Connect 執行個體相關聯的服務連結角色的 ARN 在 `grantee-principal`。若要尋找服務連結角色的 ARN，請在 Amazon Connect 主控台中前往 **概覽**、**分佈設定**、**服務連結角色**。

## 步驟 3：關聯 Kinesis 串流
<a name="enable-segment-streams-step3"></a>

使用 Amazon Connect [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html) API 建立下列資源類型的關聯：
+ 對於語音聯絡，請使用 `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS`
+ 對於聊天聯絡，請使用 `REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS`

**注意**  
`REAL_TIME_CONTACT_ANALYSIS_SEGMENTS` 已棄用，但仍受支援，僅適用於語音聯絡。對往後的語音聯絡請使用 `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS`。  
如果您先前已將串流與 `REAL_TIME_CONTACT_ANALYSIS_SEGMENTS` 建立關聯，則不需要採取任何動作將串流更新為 `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS`。

指定要發布即時聯絡分析區段的 Kinesis 串流。您需要執行個體 ID 和 Kinesis 串流 ARN。下列代碼顯示了範例：

```
// Build request
  const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
    InstanceId: 'your Amazon Connect instance ID',
    ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS or REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS',
    StorageConfig: {
      StorageType: 'KINESIS_STREAM',
      KinesisStreamConfig: {
        StreamArn: 'the ARN of your Kinesis stream',
      },
    }
  };
```

### AWS CLI
<a name="step3-cli"></a>

以下是聊天聯絡的範例。

**提示**  
如果您未包含 AWS 區域 (`--region`)，則會根據 CLI 設定檔使用預設區域。  
`--storage-config` 參數值不可含括在單引號 (') 內。這樣會引發錯誤。

```
aws connect associate-instance-storage-config \
--region "us-west-2" \
--instance-id {{your Amazon Connect instance ID}} \
--resource-type REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS \
--storage-config StorageType=KINESIS_STREAM,KinesisStreamConfig={StreamArn={{the ARN of your Kinesis stream}}}
```

### AWS 開發套件
<a name="step3-sdk"></a>

以下是語音聯絡的範例。

```
import { Connect } from 'aws-sdk';

async function associate (): Promise <void> {
  const clientConfig: Connect.ClientConfiguration = {
    region: '{{the Region of your Amazon Connect instance}}',
  };

  const connect = new Connect(clientConfig);

  // Build request
  const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
    InstanceId: '{{your Amazon Connect instance ID}}',
    ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS',
    StorageConfig: {
      StorageType: 'KINESIS_STREAM',
      KinesisStreamConfig: {
        StreamArn: '{{the ARN of your Kinesis stream}}',
      },
    }
  };

  try {
    // Execute request
    const response: Connect.Types.AssociateInstanceStorageConfigResponse = await connect.associateInstanceStorageConfig(request).promise();

    // Process response
    console.log('raw response: ${JSON.stringify(response, null, 2)}');
  } catch (err) {
    console.error('Error calling associateInstanceStorageConfig. err.code: ${err.code},' +
      'err.message: ${err.message}, err.statusCode: ${err.statusCode}, err.retryable: ${err.retryable}');
  }
}

associate().then(r => console.log('{{Done}}'));
```

## 步驟 4：為您的 Amazon Connect 執行個體啟用 Contact Lens。
<a name="enable-segment-streams-step4"></a>

如需說明，請參閱[在 Amazon Connect Contact Lens 中啟用對話分析](enable-analytics.md)。

## 步驟 5 (選用)：檢閱範例區段串流
<a name="enable-segment-streams-step5"></a>

建議您檢閱[語音](sample-real-time-contact-analysis-segment-stream.md)或[聊天](chat-sample-real-time-contact-analysis-segment-stream.md)範例區段串流，以熟悉其看起來的樣子。