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

# Amazon Connect で予測の履歴データをインポートする
<a name="import-data-for-forecasting"></a>

Amazon Connect では、コンタクトパターンを把握し、適切な予測を行うために、十分な履歴データが必要です。デフォルトでは、Amazon Connect の過去のコンタクトデータを予測に使用します。Amazon Connect が予測に使用できるように、外部アプリケーションから履歴データをインポートできます。データをインポートすると、Amazon Connect は Amazon Connect のデータとインポートされたデータの両方を予測に使用します。ただし、*インポートされたデータは Amazon Connect のデータより優先されます*。

## データをインポートすべきとき
<a name="when-import-data-for-forecasting"></a>

次のようなユースケースでは、外部アプリケーションから履歴データをインポートすることをお勧めします。
+ **Amazon Connect の履歴データが不十分**。Amazon Connect の履歴データが 1 年未満の場合は、以前のシステムから履歴データを抽出して、データを Amazon Connect にアップロードすることを強くお勧めします。Amazon Connect のデータとアップロードされた履歴データの間でデータを分割しても問題ありません。例えば、2022 年 1 月 1 日に予測を生成し、Amazon Connect に 9 か月分の履歴 (2021 年 4 月 1 日から 12 月 31 日) がある場合、さらに 3 か月分のデータ (2022 年 1 月1日から 3 月31 日) をインポートして、*[連続]* 1 年分の履歴データセットを利用可能にすることをお勧めします。
+ **Amazon Connect での誤った履歴データ**。過去の問い合わせパターンが正しくない場合 (例えば、コンタクトセンターの広範囲にわたる停電の日に問い合わせボリュームが異常に少ない)、より典型的なデータをインポートして、異常を修正できます。

Amazon Connect に 1 年分以上の履歴データがある場合は、データのインポートをスキップして、[予測の作成](create-forecasts.md)を開始できます。

## 重要事項
<a name="important-things-to-know-import-forecast"></a>
+ データファイルは .csv ファイルで、必要な形式である必要があります。ファイル形式とデータが要件を満たしていない場合、アップロードは機能しません。履歴データの準備に役立つように、 Amazon Connect 管理ウェブサイトから提供されているテンプレートをダウンロードして使用することをお勧めします (「」のステップ 4 を参照[履歴データのインポート方法](#how-import-data-for-forecasting))。

  次の図は、CSV テンプレートの例を示しています。最初の行には、`QueueName`、`QueueId`、`ChannelType` などの見出しがあります。  
![\[履歴データの csv テンプレート。最初の行の見出し、ファイルには他のデータはありません。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/wfm-forecasting-import-template.png)

  インポートされるデータの要件は次のとおりです。
  + `QueueName`: Amazon Connect キュー名を入力します。
  + `QueueId`: Amazon Connect キュー ID を入力します。 Amazon Connect 管理ウェブサイトでキュー ID を検索するには、左側のナビゲーションで、**ルーティング**、**キュー**に移動し、キューを選択し、**追加のキュー情報を表示する**を選択します。キュー ID は、`/queue/` の後の最後の番号です。
  + `ChannelType`:「`CHAT`」または「`VOICE`」と入力します。チャンネルタイプは大文字にする必要があります。
  + `TimeStamp`: タイムスタンプを ISO8601 形式で入力します。`Daily` 間隔データの場合、時間値は[選択したタイムゾーン](set-forecast-timezone.md)の午前 0 時である必要があります。
  + `IntervalDuration`: 短期予測については、予測とスケジュールの間隔に応じて、「`15mins`」または「`30mins`」と入力します。長期予測については「`daily`」と入力します。
  + `IncomingContactVolume`: インバウンド、転送、およびコールバックコンタクトの数を整数で入力します。
  + `AverageHandleTime`: 平均処理時間 (秒) を 2 進数/10 進数で入力します。
  + `ContactsHandled`: 処理されたインバウンド、転送、およびコールバックコンタクトの数を整数で入力します。
+ 複数のファイルをインポートできます。すべてのデータを 1 つの大きなファイルに統合する必要はありません。必要に応じて、年、キュー、間隔期間タイプなどでデータを分割できます。

  複数のファイル間で重複データが見つかった場合、最後にアップロードされたレコードが使用されます。例: 

  1. 7/1 から 8/1 までのオリジナルの履歴データ (Amazon Connect) があります。

  1. 新しい履歴データファイル X をアップロードして、7/10 から 8/1 をオーバーライドしました。

  1. 別の新しい履歴データファイル Y をアップロードして、7/15 から 8/1 をオーバーライドしました。

  1. これで、履歴データのベースラインは、7/1 から 7/9 はオリジナル、7/10 から 7/14 はファイル X、7/15 から 8/1 はファイル Y になりました。
+ 短期および長期予測の履歴データは*個別に*アップロードする必要があります。
  + 15 分または 30 分間隔で集計されたデータは、短期予測に使用されます。
  + 日単位で集計されたデータは、長期予測に使用されます。

例えば、15 分または 30 分間隔でのみデータをアップロードした場合、長期予測を生成することはできません。
+ CSV ファイルでは、次の特殊文字を使用できます: -、\$1、.、(、)。スペースを使用できます。

次の図は、Excel で開いた CSV ファイルの例を示しています。

![\[Excel で開いた CSV ファイル内のデータの例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/wfm-forecasting-import-table.png)


## 履歴データのインポート方法
<a name="how-import-data-for-forecasting"></a>

1. Analytics、Forecasting Amazon Connect - Edit のセキュリティプロファイル権限を持つアカウントを使用して****、管理者ウェブサイトにログインします。 ****

   詳細については、「[アクセス許可の割り当て](required-optimization-permissions.md)」を参照してください。

1. Amazon Connect のナビゲーションメニューで、**[分析と最適化]**、**[予測]** を選択し、**[データのインポート]** タブを選択します。

1. **[データのアップロード]** を選択します。

1. **[履歴データのアップロード]** ダイアログボックスで、**[履歴データ用 CSV テンプレートをダウンロードする]** を選択します。

1. 履歴データを csv ファイルに追加して、**[ファイルをアップロードする]** を選択してアップロードします。**[適用]** を選択します。

1. アップロードが失敗した場合は、**[ダウンロードの詳細]** を選択し、エラーログメッセージを表示して詳細を確認します。次の **[予測]** ページの図は、**[失敗]** ステータスメッセージの横にある **[詳細のダウンロード]** リンクの位置を示しています。  
![\[[予測] ページ、[ステータス] 列、失敗ステータス、[詳細のダウンロード] リンク。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/wfm-forecasting-import-historical-data-error.png)

   次の図は、メモ帳を使用して開いたダウンロード詳細ファイルを示しています。エラーが行 2 にあり、QueueId が無効であることを示しています。  
![\[メモ帳で開いたダウンロード詳細ファイル。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/wfm-forecasting-import-historical-data-error-message.png)

1. 予測が正常にアップロードされた場合、**[ステータス]** = **[完了]** になり、**[アップロードされた日付]** は今日の日付になります。

## インポートした履歴データを削除する
<a name="delete-imported-historical-data"></a>

Amazon Connect で以前にインポートした履歴データを削除できます。

**注記**  
履歴データを削除または追加すると、関連付けられている予測が即座に変更されます。このアクションにより、モデルがトレーニングされる履歴データのベースラインが変更されるためです。

次の図は、データを削除した結果に関する警告メッセージの例を示しています。

![\[データを削除すると、関連付けられている予測がすぐに変更されるという警告メッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/wfm-forecasting-delete-imported-data.png)


インポートされた履歴データが削除されると、最後にアップロードされたデータがベースラインとして使用されます。前の例で見てみましょう。
+ 7/1 から 8/1 までのオリジナルの履歴データ (Amazon Connect) があります。
+ 新しい履歴データファイル X をアップロードして、7/10 から 8/1 をオーバーライドしました。
+ 別の新しい履歴データファイル Y をアップロードして、7/15 から 8/1 をオーバーライドしました。
+ これで、履歴データのベースラインは、7/1 から 7/9 はオリジナル、7/10 から 7/14 はファイル X、7/15 から 8/1 はファイル Y になりました。
+ 次の場合、

  1. ファイル Y を削除すると、ベースラインは、7/1 から 7/9 はオリジナル、7/10 から 8/1 は X になります。

  1. ファイル X を削除すると、ベースラインは、7/1 から 7/14 はオリジナル、7/15 から 8/1 は Y になります。