Connect Customer データレイクのエージェントデータ

次の表には、エージェントデータが含まれています。

内容

エージェントキュー統計レコード
エージェント統計レコード
エージェントイベント

エージェントキュー統計レコード

テーブル名: agent_queue_statistic_record

説明: エージェントごと、間隔ごとのキューレベルの統計が含まれます。エージェントとキューの組み合わせごとに、提供、処理、処理時間、接続時間などのメトリクスを追跡します。

プライマリキー: aqsr_statistic_id, instance_id

パーティションキー: interval_start_time (毎日)

結合キー:

instance_id — すべてのテーブルに結合します
user_id — エージェント統計レコード、エージェントイベント、問い合わせレコード ( としてagent_id)、問い合わせ評価レコード、ユーザーに結合します
queue_id — 問い合わせレコード、問い合わせ統計レコードに結合
routing_profile_id — エージェント統計レコード、routing_profiles に結合します
agent_hierarchy_level_*_id — agent_hierarchy_groups に結合します

列	タイプ	Nullable	説明
aqsr_statistic_id	string	いいえ	AQSR レコードの一意の ID
instance_id	string	いいえ	Connect Customer インスタンスの識別子。インスタンスの Amazon リソースネーム (ARN) でインスタンス ID を確認できます。
user_id	string	はい	ユーザーアカウントの識別子。
routing_profile_id	string	はい	ルーティングプロファイルの ID。
agent_hierarchy_level_1_id	string	はい	レベル 1 階層グループの ID。
agent_hierarchy_level_2_id	string	はい	レベル 2 階層グループの ID。
agent_hierarchy_level_3_id	string	はい	レベル 3 階層グループの ID。
agent_hierarchy_level_4_id	string	はい	レベル 4 階層グループの ID。
agent_hierarchy_level_5_id	string	はい	レベル 5 階層グループの ID。
interval_start_time	タイムスタンプ	はい	間隔が開始されたときの会話のタイムスタンプ。
interval_end_time	タイムスタンプ	はい	間隔が終了したときの会話のタイムスタンプ。
published_date	Timestamp	はい
aws_account_id	string	はい	コンタクトを所有する AWS アカウントの ID。
queue_id	string	はい	キューの識別子。
channel	string	はい	コンタクトセンターとの通話に使用する方法 (VOICE、CHAT、TASK、または EMAIL)。
queue_type	string	はい	QueueType はキューの分類を指定し、その用途と動作を示します。QueueType の有効な値は STANDARD です。これは、問い合わせがエージェントにルーティングされて受け入れられる前に待機する汎用キューであり、AGENT は Connect Customer を追加するエージェントユーザーごとに自動的に作成されます。
agent_non_response	bigint	はい	エージェントにルーティングされたがエージェントによって応答されなかったコンタクトの数 (顧客によって中止されたコンタクトを含む)。
contacts_offered	bigint	はい
contacts_handled	bigint	はい	エージェントに接続されていたコンタクトの数。コンタクトがエージェントにどのように接続されたかは重要ではありません。顧客がコンタクトセンターに電話をかける場合もあれば、エージェントが顧客に電話をかける場合もあります。あるエージェントから別のエージェントに転送されたコンタクトである場合もあります。エージェントが応答したものの、どうすればよいか分からなくなり、再度転送したコンタクトである場合もあります。エージェントがコンタクトに接続されていれば、対応したコンタクトが増加します。
handle_time	bigint	はい	コンタクトがエージェントに接続されている、開始から終了までの平均時間です。これには、通話時間、保留時間、アフターコンタクトワーク (ACW) 時間、カスタムステータス時間、エージェントの一時停止時間 (タスクにのみ適用) が含まれます。AHT は、エージェントがコンタクトに応答したときから会話の終了までの時間を平均することで計算されます。これは、着信通話と発信通話の両方に適用されます。
agent_incoming_connecting_time	bigint	はい	Connect Customer が問い合わせのためにエージェントを予約して問い合わせを開始し、エージェントが接続されるまでの合計時間。
agent_outbound_connecting_time	bigint	はい	Connect Customer がコンタクトのエージェントを予約してアウトバウンドコンタクトを開始し、エージェントが接続されるまでの合計時間。
agent_callback_connecting_time	bigint	はい	Connect Customer が問い合わせのエージェントを予約してコールバック問い合わせを開始し、エージェントが接続されるまでの合計時間。
agent_api_connecting_time	bigint	はい	Connect Customer API を使用して問い合わせが開始されてからエージェントが接続されるまでの合計時間。
incoming_connecting_attempts	bigint	はい	Connect Customer が INBOUND 開始タイプの問い合わせのエージェントを予約して開始した試行回数。
outbound_connecting_attempts	bigint	はい	Connect Customer が発信開始タイプの問い合わせのエージェントを予約して開始した試行回数。
callback_connecting_attempts	bigint	はい	コールバックを試みたものの、顧客が電話に出なかったコンタクトの数。
api_connecting_attempts	bigint	はい	平均エージェントの着信接続時間を計算するために使用されます。
data_lake_last_processed_timestamp	タイムスタンプ	はい	データレイクがレコードを最後に処理した時刻を示すタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドは、データの鮮度を判断するために確実に使用することはできません。

エージェント統計レコード

テーブル名: agent_statistic_record

説明: オンライン時間、アイドル時間、オンコンタクト時間、最大 50 個のカスタムエージェント状態継続時間など、間隔あたりのエージェントレベルの集計統計が含まれます。

プライマリキー: asr_statistic_id, instance_id

パーティションキー: interval_start_time (毎日)

結合キー:

instance_id — すべてのテーブルに結合します
user_id — エージェントキュー統計レコード、エージェントイベント、問い合わせレコード ( としてagent_id)、問い合わせ評価レコード、ユーザーに結合します
routing_profile_id — エージェントキュー統計レコード、routing_profiles に結合します
agent_hierarchy_level_*_id — agent_hierarchy_groups に結合します

列	タイプ	Nullable	説明
asr_statistic_id	string	いいえ	リクエストの一意の ID。
instance_id	string	いいえ	Connect Customer インスタンスの識別子。インスタンスの Amazon リソースネーム (ARN) でインスタンス ID を確認できます。
user_id	string	はい	ユーザーアカウントの識別子。
routing_profile_id	string	はい	ルーティングプロファイルの ID。
agent_hierarchy_level_1_id	string	はい	レベル 1 階層グループの ID。
agent_hierarchy_level_2_id	string	はい	レベル 2 階層グループの ID。
agent_hierarchy_level_3_id	string	はい	レベル 3 階層グループの ID。
agent_hierarchy_level_4_id	string	はい	レベル 4 階層グループの ID。
agent_hierarchy_level_5_id	string	はい	レベル 5 階層グループの ID。
interval_start_time	タイムスタンプ	はい	間隔が開始されたときの会話のタイムスタンプ。
interval_end_time	タイムスタンプ	はい	間隔が終了したときの会話のタイムスタンプ。
published_date	Timestamp	はい
aws_account_id	string	はい	コンタクトを所有する AWS アカウントの ID。
online_time	bigint	はい	エージェントが CCP を [オフライン] 以外のステータスに設定して費やした合計時間。これには、カスタムステータスの間に費やされた時間が含まれます。履歴メトリクスレポートを作成するとき、このメトリクスをキュー、電話番号、またはチャネルでグループ化したりフィルタリングしたりすることはできません。
error_time	bigint	はい	特定のエージェントについて、コンタクトがエラー状態であった合計時間。このメトリクスはキューでグループ分けまたはフィルタリングすることはできません。
non_productive_time	bigint	はい	エージェントがカスタムステータスに費やした合計時間。つまり、CCP のステータスは [使用可能] または [オフライン] 以外です。このメトリクスは、エージェントが非生産的に時間を費やしていたことを意味するものではありません。
agent_idle_time	bigint	はい	エージェントが CCP のステータスを [使用可能] に設定してから、コンタクトを処理していない時間 + コンタクトが [エラー] 状態になっている時間を指します。エージェントアイドル時間には、Connect Customer がエージェントへの問い合わせのルーティングを開始してから、エージェントが問い合わせをピックアップまたは拒否するまでの時間は含まれません。
agent_on_contact_time	bigint	はい	エージェントが顧客の保留時間および連絡作業後の時間を含む 1 つ以上のコンタクトに費やした合計時間。これには、カスタムステータスまたは [オフライン] ステータスの間にコンタクトに費やされた時間は含まれません。(カスタムステータスとは、エージェントの CCP ステータスが [対応可能] または [オフライン] 以外の場合です。例えば、[トレーニング] はカスタムステータスです。)
custom_state_time_01	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_02	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_03	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_04	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_05	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_06	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_07	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_08	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_09	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_10	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_11	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_12	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_13	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_14	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_15	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_16	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_17	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_18	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_19	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_20	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_21	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_22	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_23	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_24	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_25	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_26	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_27	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_28	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_29	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_30	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_31	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_32	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_33	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_34	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_35	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_36	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_37	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_38	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_39	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_40	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_41	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_42	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_43	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_44	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_45	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_46	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_47	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_48	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_49	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
custom_state_time_50	bigint	はい	顧客が定義したカスタムエージェントの状態を表します。例: Coffee_break。
data_lake_last_processed_timestamp	タイムスタンプ	はい	データレイクがレコードを最後に処理した時刻を示すタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドは、データの鮮度を判断するために確実に使用することはできません。

エージェントイベント

テーブル名: agent_event

説明: 現在および以前のエージェントステータス、ルーティングプロファイル、階層グループ、および各エージェントイベントの関連する問い合わせを含む、完全なエージェント状態スナップショットをキャプチャします。

プライマリキー: instance_id, event_id

パーティションキー: event_timestamp (毎日)

結合キー:

instance_id — すべてのテーブルに結合します
agent_arn — 問い合わせレコード ( としてagent_arn)、スケジュールテーブル ( としてagent_arn)、ユーザー ( としてuser_arn) に結合します。
current_routing_profile_arn — routing_profiles に結合します ( としてagent_routing_profile_arn)
current_agent_hierarchy_groups_level_*_arn — agent_hierarchy_groups に結合します ( としてagent_hierarchy_group_arn)
current_contacts (ネスト) — 問い合わせレコードに結合 ( としてcontact_id)

列	タイプ	Nullable	説明
instance_id	string	いいえ	Connect Customer インスタンスの ID。
aws_account_id	string	はい	エージェントイベントを所有する AWS アカウントの ID。
instance_arn	string	はい	Connect Customer インスタンスの ARN。
agent_arn	string	はい	エージェントの ARN。
event_id	string	いいえ	一意のイベント識別子。
event_timestamp	タイムスタンプ	はい	イベントが発生したときのタイムスタンプ。
event_type	string	はい	エージェントイベントのタイプ。
バージョン	string	はい	日付形式のエージェントイベントストリームのバージョン。
current_agent_status_arn	string	はい	現在のエージェントステータスの ARN。
current_agent_status_name	string	はい	現在のエージェントステータスの名前。
current_agent_status_start_timestamp	タイムスタンプ	はい	現在のエージェントステータスが開始されたタイムスタンプ。
current_agent_status_type	string	はい	現在のエージェントステータスのタイプ分類。
current_next_agent_status_arn	string	はい	次のエージェントステータスの ARN。
current_next_agent_status_name	string	はい	次のエージェントステータスの名前。
current_next_agent_status_enqueued_timestamp	タイムスタンプ	はい	次のエージェントステータスがキューに入れられたときのタイムスタンプ。
current_next_agent_status_type	string	はい	次のエージェントステータスのタイプ分類。
current_configuration_username	string	はい	現在のエージェントのユーザー名。
current_configuration_first_name	string	はい	現在のエージェントの名。
current_configuration_last_name	string	はい	現在のエージェントの姓。
current_configuration_sip_address	string	はい	エージェントの通信エンドポイントの SIP アドレス。
current_configuration_auto_accept	boolean	はい	エージェントが着信問い合わせを自動承諾するかどうか。
current_configuration_language_code	string	はい	エージェントのインターフェイスの言語コード。
current_configuration_proficiencies	array(構造体)	はい	エージェント習熟度属性 (名前、値、レベル）。
current_routing_profile_arn	string	はい	現在のルーティングプロファイルの ARN。
current_routing_profile_name	string	はい	現在のルーティングプロファイルの名前。
current_routing_profile_concurrency	array(構造体)	はい	現在のルーティングプロファイルの同時実行設定。
current_routing_profile_default_outbound_queue_arn	string	はい	デフォルトのアウトバウンドキューの ARN。
current_routing_profile_default_outbound_queue_name	string	はい	デフォルトのアウトバウンドキューの名前。
current_routing_profile_default_outbound_queue_channels	array(string)	はい	デフォルトのアウトバウンドキューのチャネル。
current_routing_profile_inbound_queues	array(構造体)	はい	ルーティングプロファイルのインバウンドキュー。
current_agent_hierarchy_groups_level_1_arn	string	はい	エージェント階層グループレベル 1 の ARN。
current_agent_hierarchy_groups_level_1_name	string	はい	エージェント階層グループレベル 1 の名前。
current_agent_hierarchy_groups_level_2_arn	string	はい	エージェント階層グループレベル 2 の ARN。
current_agent_hierarchy_groups_level_2_name	string	はい	エージェント階層グループレベル 2 の名前。
current_agent_hierarchy_groups_level_3_arn	string	はい	エージェント階層グループレベル 3 の ARN。
current_agent_hierarchy_groups_level_3_name	string	はい	エージェント階層グループレベル 3 の名前。
current_agent_hierarchy_groups_level_4_arn	string	はい	エージェント階層グループレベル 4 の ARN。
current_agent_hierarchy_groups_level_4_name	string	はい	エージェント階層グループレベル 4 の名前。
current_agent_hierarchy_groups_level_5_arn	string	はい	エージェント階層グループレベル 5 の ARN。
current_agent_hierarchy_groups_level_5_name	string	はい	エージェント階層グループレベル 5 の名前。
current_contacts	array(構造体)	はい	エージェントに関連付けられている現在の問い合わせ。
previous_agent_status_arn	string	はい	以前のエージェントステータスの ARN。
previous_agent_status_name	string	はい	以前のエージェントステータスの名前。
previous_agent_status_start_timestamp	タイムスタンプ	はい	以前のエージェントステータスが開始されたタイムスタンプ。
previous_agent_status_type	string	はい	以前のエージェントステータスのタイプ分類。
previous_configuration_proficiencies	array(構造体)	はい	以前のエージェントの習熟度属性。
previous_routing_profile_arn	string	はい	以前のルーティングプロファイルの ARN。
previous_routing_profile_name	string	はい	以前のルーティングプロファイルの名前。
previous_routing_profile_concurrency	array(構造体)	はい	以前のルーティングプロファイルの同時実行設定。
previous_routing_profile_default_outbound_queue_arn	string	はい	以前のデフォルトのアウトバウンドキューの ARN。
previous_routing_profile_default_outbound_queue_name	string	はい	以前のデフォルトのアウトバウンドキューの名前。
previous_routing_profile_default_outbound_queue_channels	array(string)	はい	以前のデフォルトのアウトバウンドキューのチャネル。
previous_routing_profile_inbound_queues	array(構造体)	はい	ルーティングプロファイルの以前のインバウンドキュー。
previous_agent_hierarchy_groups_level_1_arn	string	はい	以前のエージェント階層グループレベル 1 の ARN。
previous_agent_hierarchy_groups_level_1_name	string	はい	以前のエージェント階層グループレベル 1 の名前。
previous_agent_hierarchy_groups_level_2_arn	string	はい	以前のエージェント階層グループレベル 2 の ARN。
previous_agent_hierarchy_groups_level_2_name	string	はい	以前のエージェント階層グループレベル 2 の名前。
previous_agent_hierarchy_groups_level_3_arn	string	はい	以前のエージェント階層グループレベル 3 の ARN。
previous_agent_hierarchy_groups_level_3_name	string	はい	以前のエージェント階層グループレベル 3 の名前。
previous_agent_hierarchy_groups_level_4_arn	string	はい	以前のエージェント階層グループレベル 4 の ARN。
previous_agent_hierarchy_groups_level_4_name	string	はい	以前のエージェント階層グループレベル 4 の名前。
previous_agent_hierarchy_groups_level_5_arn	string	はい	以前のエージェント階層グループレベル 5 の ARN。
previous_agent_hierarchy_groups_level_5_name	string	はい	以前のエージェント階層グループレベル 5 の名前。
previous_contacts	array(構造体)	はい	エージェントに関連付けられた以前の問い合わせ。
data_lake_last_processed_timestamp	タイムスタンプ	はい	タイムスタンプ。レコードがデータレイクに最後にタッチされた時刻を示します。これには、変換とバックフィルが含まれる場合があります。このフィールドは、データの鮮度を判断するために確実に使用することはできません。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

データ型の定義

問い合わせデータ