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

# Connect Customer Analytics データレイクのボット分析データ
<a name="data-lake-botdata"></a>

このトピックでは、Connect Customer データレイクボットテーブルの内容について詳しく説明します。以下の表には、内容の列、タイプ、説明が一覧表示されています。

分析データレイクにアクセスし、共有するデータを設定するには、次の 2 つの方法があります。
+ [オプション 1: Connect Customer コンソールを使用する](access-datalake.md#option1-configure-data-to-be-shared)
+ [オプション 2: CLI または CloudShell を使用する](access-datalake.md#option2-configure-data-to-be-shared)

オプション 1 を使用してスケジューリングテーブルにアクセスできない場合は、オプション 2 を試してください。

**Topics**
+ [ボットの会話](#data-lake-bot-conversations)
+ [ボットインテント](#data-lake-bot-intents)
+ [ボットスロット](#data-lake-bot-slots)

## ボットの会話
<a name="data-lake-bot-conversations"></a>

**テーブル名:** `bot_conversations`

**説明:** Lex ボットインタラクションの会話結果、ターンカウント、関連するフローと問い合わせコンテキストを含むボット会話セッションを記録します。

**プライマリキー:** `instance_id, event_id`

**パーティションキー:** `bot_conversation_start_timestamp` (毎日)

**結合キー:**
+ `instance_id` — すべてのテーブルに結合します
+ `contact_id` — 問い合わせレコードに結合します
+ `flow_resource_id` — 問い合わせフローイベントに参加します
+ `bot_originating_request_id`、 `bot_session_id` — bot\_intents に結合します


| 列 | 型 | 説明 | 
| --- | --- | --- | 
| event\_id | String |  いいえ  | これはテーブルのプライマリキーです。これは、発信元のリクエスト識別子とセッション識別子のハッシュになります。 | 
| bot\_originating\_request\_id | String |  はい  | 特定のボットリクエストの一意の識別子。 | 
| bot\_session\_id | String |  はい  | 会話が行われているユーザーセッションの識別子。 | 
| aws\_account\_id | String |  はい  | コンタクトを所有する AWS アカウントの識別子。 | 
| instance\_arn | String |  はい  | Connect Customer インスタンスの ARN。 | 
| instance\_id | String |  いいえ  | Connect Customer インスタンスの識別子。 | 
| invoking\_resource\_type | String |  はい  | フローまたはモジュールにすることができます。 | 
| flow\_resource\_id | String |  はい  | フロー識別子。 | 
| module\_resource\_id | String |  はい  | モジュール識別子。 | 
| invoking\_resource\_start\_timestamp | タイムスタンプ |  はい  | フローが開始された時刻。 | 
| parent\_flow\_resource\_id | String |  はい  | モジュールが呼び出されたフロー ID。このフィールドはモジュールに対してのみ入力されます。 | 
| contact\_id | String |  はい  | コンタクトの識別子。 | 
| flow\_action\_id | String |  はい  | 実行されたアクションの識別子。アクションは、フローの実行の 1 つのステップです。 | 
| invoking\_resource\_published\_timestamp | タイムスタンプ |  はい  | フロー自体の「作成」日または「改訂」日。 | 
| flow\_type | String |  はい  | Connect Customer には、9 つのフロータイプのセットが含まれています。詳細については、「[フロータイプを選択する](create-contact-flow.md#contact-flow-types)」を参照してください。 | 
| channel | String |  はい  | コンタクトセンターとの通話に使用する方法 (VOICE、CHAT、または TASK)。 | 
| sub\_type | String |  はい  | コンタクトのこのサブタイプ。例: connect:Guide または connect:SMS。 | 
| initiation\_method | String |  はい  | コンタクトが開始された方法を示します。 | 
| flow\_language\_version | String |  はい  | フロー言語バージョン。 | 
| invoking\_resource\_version | String |  はい  | 使用したコンタクトフローのバージョン。 | 
| bot\_id | String |  はい  | ボットの識別子。 | 
| bot\_alias\_id | String |  はい  | セッションの実行に使用されたボットのエイリアスの識別子。 | 
| bot\_version | String |  はい  | セッションの実行に使用されたボットのバージョン。 | 
| bot\_locale | String |  はい  | ボットの言語設定。 | 
| bot\_conversation\_start\_timestamp | タイムスタンプ |  はい  | ボットとの会話の開始時刻を示すタイムスタンプ。 | 
| bot\_conversation\_end\_timestamp | タイムスタンプ |  はい  | ボットとの会話の終了時刻を示すタイムスタンプ。 | 
| bot\_conversation\_outcome | String |  はい  | 会話の最終状態。値: 成功 \| 失敗 \| 除外 | 
| bot\_number\_of\_conversation\_turns | Number |  はい  | セッションで行われたターンの数。 | 
| data\_lake\_last\_processed\_timestamp | タイムスタンプ |  はい  | データレイクがレコードを最後に処理した時刻を示すタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドを使用して、データの鮮度を確実に判断することはできません。 | 

## ボットインテント
<a name="data-lake-bot-intents"></a>

**テーブル名:** `bot_intents`

**説明:** ボット会話のインテントレベルの結果、ボットインタラクションターンごとのインテント名、レベル、解決ステータスの追跡を記録します。

**プライマリキー:** `instance_id, event_id`

**パーティションキー:** `bot_conversation_start_timestamp` (毎日)

**結合キー:**
+ `instance_id` — すべてのテーブルに結合します
+ `bot_originating_request_id`、 `bot_session_id` — bot\_conversations に結合します
+ `bot_originating_request_id`、`bot_session_id`、`bot_intent_name`、 `bot_intent_level` — bot\_slots に結合します
+ `contact_id` — 問い合わせレコードに結合します


| 列 | 型 | 説明 | 
| --- | --- | --- | 
| event\_id | String |  いいえ  | これはテーブルのプライマリキーです。これは、送信元のリクエスト識別子、セッション識別子、インテント名、およびインテントレベルのハッシュになります。 | 
| bot\_originating\_request\_id | String |  はい  | 特定のボットリクエストの一意の識別子。 | 
| bot\_session\_id | String |  はい  | 会話が行われているユーザーセッションの識別子。 | 
| account\_id | String |  はい  | コンタクトを所有する AWS アカウントの識別子。 | 
| instance\_arn | String |  はい  | Connect Customer インスタンスの ARN。 | 
| instance\_id | String |  いいえ  | Connect Customer インスタンスの識別子。 | 
| invoking\_resource\_type | String |  はい  | フローまたはモジュールにすることができます。 | 
| flow\_resource\_id | String |  はい  | フロー識別子。 | 
| module\_resource\_id | String |  はい  | モジュール識別子。 | 
| invoking\_resource\_start\_timestamp | タイムスタンプ |  はい  | フローが開始された時刻。 | 
| parent\_flow\_resource\_id | String |  はい  | モジュールが呼び出されたフロー識別子。このフィールドはモジュールに対してのみ入力されます。 | 
| contact\_id | String |  はい  | コンタクトの識別子。 | 
| ACTION\_ID | String |  はい  | 実行されたアクションの識別子。アクションは、フローの実行の 1 つのステップです。 | 
| invoking\_resource\_published\_timestamp | タイムスタンプ |  はい  | フロー自体の「作成」日または「改訂」日。 | 
| flow\_type | String |  はい  | フローのタイプ。Connect Customer には、9 つのフロータイプのセットが含まれています。詳細については、「[フロータイプを選択する](create-contact-flow.md#contact-flow-types)」を参照してください。 | 
| channel | String |  はい  | コンタクトセンターとの通話に使用する方法 (VOICE、CHAT、または TASK)。 | 
| sub\_type | String |  はい  | コンタクトのサブタイプ。例: connect:Guide または connect:SMS。 | 
| initiation\_method | String |  はい  | コンタクトが開始された方法。 | 
| flow\_language\_version | String |  はい  | フロー言語バージョン。 | 
| invoking\_resource\_version | String |  はい  | 使用したコンタクトフローのバージョン。 | 
| bot\_id | String |  はい  | ボットの識別子。 | 
| bot\_alias\_id | String |  はい  | セッションの実行に使用されたボットのエイリアスの識別子。 | 
| bot\_version | String |  はい  | セッションの実行に使用されたボットのバージョン。 | 
| bot\_locale | String |  はい  | ボットの言語設定。 | 
| bot\_conversation\_start\_timestamp | タイムスタンプ |  はい  | ボットとの会話の開始時刻を示すタイムスタンプ。 | 
| bot\_conversation\_end\_timestamp | タイムスタンプ |  はい  | ボットとの会話の終了時刻を示すタイムスタンプ。 | 
| bot\_intent\_name | String |  はい  | インテントの名前。 | 
| bot\_intent\_level | Number |  はい  | リクエストされたパスまでの (リクエストされたパスを含む) インテントの数。 | 
| bot\_intent\_outcome | String |  はい  | インテントの終了状態。成功、失敗、切り替え、または除外の値。 | 
| data\_lake\_last\_processed\_timestamp | タイムスタンプ |  はい  | データレイクがレコードを最後に処理した時刻を示すタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドを使用して、データの鮮度を確実に判断することはできません。 | 

## ボットスロット
<a name="data-lake-bot-slots"></a>

**テーブル名:** `bot_slots`

**説明:** ボットインテントフルフィルメントのスロットレベルの結果、スロット解決ステータスの追跡、インテント内の各スロットの再試行回数を記録します。

**プライマリキー:** `instance_id, event_id`

**パーティションキー:** `bot_conversation_start_timestamp` (毎日)

**結合キー:**
+ `instance_id` — すべてのテーブルに結合します
+ `bot_originating_request_id`、`bot_session_id`、`bot_intent_name`、 `bot_intent_level` — bot\_intents に結合します
+ `bot_originating_request_id`、 `bot_session_id` — bot\_conversations に結合します
+ `contact_id` — 問い合わせレコードに結合します


| 列 | 型 | 説明 | 
| --- | --- | --- | 
| event\_id | String |  いいえ  | これはテーブルのプライマリキーです。これは、送信元のリクエスト識別子、セッション識別子、インテント名、インテントレベル、スロット名、スロットレベルのハッシュになります。 | 
| bot\_originating\_request\_id | String |  はい  | 特定のボットリクエストの一意の識別子 | 
| bot\_session\_id | String |  はい  | 会話が行われているユーザーセッションの識別子。 | 
| account\_id | String |  はい  | コンタクトを所有する AWS アカウントの識別子。 | 
| instance\_arn | String |  はい  | Connect Customer インスタンスの ARN。 | 
| instance\_id | String |  いいえ  | Connect Customer インスタンスの識別子。 | 
| invoking\_resource\_type | String |  はい  | フローまたはモジュールにすることができます。 | 
| flow\_resource\_id | String |  はい  | フロー識別子。 | 
| module\_resource\_id | String |  はい  | モジュール識別子。 | 
| invoking\_resource\_start\_timestamp | タイムスタンプ |  はい  | フローが開始された時刻。 | 
| parent\_flow\_resource\_id | String |  はい  | モジュールが呼び出されたフロー識別子。このフィールドはモジュールに対してのみ入力されます。 | 
| contact\_id | String |  はい  | コンタクトの識別子。 | 
| ACTION\_ID | String |  はい  | 実行されたアクションの識別子。アクションは、フローの実行の 1 つのステップです。 | 
| invoking\_resource\_published\_timestamp | タイムスタンプ |  はい  | フロー自体の「作成」日または「改訂」日。 | 
| flow\_type | String |  はい  | Connect Customer には、9 つのフロータイプのセットが含まれています。詳細については、「[フロータイプを選択する](create-contact-flow.md#contact-flow-types)」を参照してください。 | 
| channel | String |  はい  | コンタクトセンターとの通話に使用する方法 (VOICE、CHAT、または TASK)。 | 
| sub\_type | String |  はい  | コンタクトのこのサブタイプ。例: connect:Guide または connect:SMS。 | 
| initiation\_method | String |  はい  | コンタクトが開始された方法を示します。 | 
| flow\_language\_version | String |  はい  | フロー言語バージョン。 | 
| invoking\_resource\_version | String |  はい  | 使用したコンタクトフローのバージョン。 | 
| bot\_id | String |  はい  | ボットの識別子。 | 
| bot\_alias\_id | String |  はい  | セッションの実行に使用されたボットのエイリアスの識別子。 | 
| bot\_version | String |  はい  | セッションの実行に使用されたボットのバージョン。 | 
| bot\_locale | String |  はい  | ボットの言語設定。 | 
| bot\_conversation\_start\_timestamp | タイムスタンプ |  はい  | ボットとの会話の開始時刻を示すタイムスタンプ。 | 
| bot\_conversation\_end\_timestamp | タイムスタンプ |  はい  | ボットとの会話の終了時刻を示すタイムスタンプ。 | 
| bot\_intent\_name | String |  はい  | インテントの名前。 | 
| bot\_intent\_level | Number |  はい  | リクエストされたパスまでの (リクエストされたパスを含む) インテントの数。 | 
| bot\_slot\_name | String |  はい  | スロットの名前。 | 
| bot\_slot\_level | Number |  はい  | リクエストされたパスまでのスロット数。 | 
| bot\_slot\_outcome | String |  はい  | スロットの終了状態。成功、失敗、除外、または 再試行 の値。 | 
| bot\_slot\_retry\_count | Number |  はい  | ボットがスロットのユーザーからレスポンスを引き出しようとした回数。 | 
| data\_lake\_last\_processed\_timestamp | タイムスタンプ |  はい  | データレイクがレコードを最後に処理した時刻を示すタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドを使用して、データの鮮度を確実に判断することはできません。 |