AI エージェント AI エージェントナレッジベース AI プロンプト AI セッション AI ツール

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

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

内容

AI エージェント
AI エージェントナレッジベース
AI プロンプト
AI セッション
AI ツール

AI エージェント

テーブル名: ai_agent

説明: 問い合わせ内の各 AI エージェントのインタラクションについて、呼び出しの成功、レイテンシー、会話のターン、有用性の評価など、AI エージェントの呼び出しイベントを追跡します。

プライマリキー: ai_agent_event_id, instance_id

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

結合キー:

instance_id — すべてのテーブルに結合します
contact_id — 問い合わせレコード、問い合わせ統計レコード、問い合わせレンズ、問い合わせ評価レコード、問い合わせフローイベントに参加します
ai_session_id — AI セッション、AI プロンプト、AI ツール、AI エージェントナレッジベースに参加します
assistant_id — AI セッション、AI プロンプト、AI ツールに参加します

列	タイプ	Nullable	説明
instance_arn	string	はい	Connect インスタンスの ARN。
instance_id	string	いいえ	Connect インスタンスの ID。
contact_id	string	はい	コンタクト ID。
ai_agent_id	string	はい	リクエストされた AI エージェントの ID。
ai_agent_version	string	はい	リクエストされた AI エージェントのバージョン。
ai_agent_event_id	string	いいえ	イベントの ID。
aws_account_id	string	はい	AI Assistant が使用されている AWS アカウントの ID。
assistant_id	string	はい	AI Assistant の ID。
ai_session_id	string	はい	AI-Agent セッションの ID。
creation_timestamp	bigint	はい	イベントのタイムスタンプはデータレイクに作成されます。
update_timestamp	bigint	はい	イベントのタイムスタンプはデータレイクで更新されます。
ai_use_case	string	はい	AI エージェントのユースケース。
ai_agent_type	string	はい	リクエストされた AI エージェントのタイプ。
ai_agent_name	string	はい	リクエストされた AI エージェントの名前。
ai_agent_arn	string	はい	リクエストされた AI エージェントの Arn。
invocation_success	ブール	はい	AI エージェントの呼び出しが成功したかどうかを示すブール値フィールド。
invocation_latency_ms	フロート	はい	評価された問い合わせにおける AI エージェントの呼び出しレイテンシー。
conversation_turns_in_response	bigint	はい	リクエストされた AI エージェントによって応答された会話ターンの数。
response_helpful	int	はい	サムアップに役立つと評価された AI 提案の数。
response_not_helpful	int	はい	サムダウンで役に立たないと評価された AI 提案の数。

AI エージェントナレッジベース

テーブル名: ai_agent_knowledge_base

説明: ナレッジベースのリファレンスイベントを記録し、AI エージェントとのやり取り中に取得および使用されたナレッジコンテンツを追跡します。

プライマリキー: ai_agent_knowledge_base_event_id, instance_id

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

結合キー:

instance_id — すべてのテーブルに結合します
contact_id — 問い合わせレコード、問い合わせ統計レコード、問い合わせレンズに参加します
ai_session_id — AI セッション、AI エージェント、AI プロンプト、AI ツールに参加します
ai_agent_id — AI エージェントに参加します

列	タイプ	Nullable	説明
instance_arn	string	はい	Connect インスタンスの ARN。
aws_account_id	string	はい	Connect AI Assistant を所有する AWS アカウントの ID。
instance_id	string	いいえ	Connect インスタンスの ID。
contact_id	string	はい	特定の連絡先の ID。
knowledge_content_id	string	はい	参照されるナレッジコンテンツの ID。
ai_agent_type	string	はい	リクエストされた AI エージェントのタイプ。
ai_agent_knowledge_base_event_id	string	いいえ	ナレッジベースのリファレンスイベントの ID。
assistant_id	string	はい	Amazon Connect AI Assistant の ID。
ai_session_id	string	はい	AI エージェントセッションの ID。
creation_timestamp	string	はい	データレイクイベントが作成された瞬間。
update_timestamp	string	はい	データレイクイベントが最後に変更された瞬間。
ai_agent_id	string	はい	リクエストされた AI エージェントの ID。
ai_agent_name	string	はい	リクエストされた AI エージェントの名前。
ai_agent_version	string	はい	リクエストされた AI エージェントのバージョン番号。
ai_agent_arn	string	はい	リクエストされた AI エージェントの ARN。
knowledge_base_id	string	はい	参照されるナレッジベースの ID。
knowledge_base_name	string	はい	参照されるナレッジベースの名前。
knowledge_content_reference	string	はい	参照されるナレッジコンテンツのタイトル。
data_lake_last_processed_timestamp	timestamp	はい	タイムスタンプ。レコードがデータレイクに最後にタッチされた時刻を示します。これには、変換とバックフィルが含まれる場合があります。このフィールドは、データの鮮度を判断するために確実に使用することはできません。

AI プロンプト

テーブル名: ai_prompt

説明: AI セッション内の各プロンプト呼び出しのモデル使用状況、トークン数、レイテンシー、呼び出しの成功など、AI プロンプト呼び出しイベントを追跡します。

プライマリキー: ai_prompt_event_id, instance_id

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

結合キー:

instance_id — すべてのテーブルに結合します
contact_id — 問い合わせレコード、問い合わせ統計レコード、問い合わせレンズに参加します
ai_session_id — AI セッション、AI エージェント、AI ツールに参加します
ai_agent_id — AI エージェントに参加します

列	タイプ	Nullable	説明
instance_arn	string	はい	Connect Customer インスタンスの ARN。
aws_account_id	string	はい	カスタマー AWS アカウント ID。
instance_id	string	いいえ	Connect Customer インスタンスの ID。
contact_id	string	はい	コンタクト ID。
ai_prompt_id	string	はい	リクエストされた AI プロンプトの ID。
ai_prompt_version	string	はい	リクエストされた AI プロンプトのバージョン。
ai_prompt_event_id	string	いいえ	イベントの ID。
assistant_id	string	はい	AI Assistant の識別子。
ai_session_id	string	はい	AI-Agent セッションの ID。
creation_timestamp	bigint	はい	データレイクにイベントが作成されたときのタイムスタンプ。
update_timestamp	bigint	はい	データレイクでイベントが更新されたときのタイムスタンプ。
ai_agent_type	string	はい	リクエストされた AI エージェントのタイプ。
ai_agent_name	string	はい	リクエストされた AI エージェントの名前。
ai_agent_id	string	はい	リクエストされた AI エージェントの ID。
ai_agent_version	string	はい	リクエストされた AI エージェントのバージョン番号。
ai_agent_arn	string	はい	リクエストされた AI エージェントの Arn。
ai_prompt_type	string	はい	呼び出された AI プロンプトのタイプ。
ai_prompt_name	string	はい	呼び出された AI プロンプトの名前。
ai_prompt_arn	string	はい	呼び出された AI プロンプトの ARN。
model_id	string	はい	AI プロンプトに関連付けられた llm モデルの名前。
invocation_success	boolean	はい	プロンプトの呼び出しが成功したかどうかを示すブール値フィールド。
invocation_latency_ms	フロート	はい	評価された問い合わせにおける AI プロンプトの呼び出しレイテンシー。
input_token	bigint	はい	評価された問い合わせの AI プロンプトの入力トークン。
output_token	bigint	はい	評価された問い合わせの AI プロンプトの出力トークン。

AI セッション

テーブル名: ai_session

説明: 各 AI セッションのプロアクティブインテント検出、呼び出し数、ハンドオフステータス、品質スコア (目標の成功、忠実度、完全性) など、セッションレベルの AI メトリクスが含まれます。

プライマリキー: ai_session_id, instance_id

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

結合キー:

instance_id — すべてのテーブルに結合します
contact_id — 問い合わせレコード、問い合わせ統計レコード、問い合わせレンズに参加します
ai_session_id — AI エージェント、AI プロンプト、AI ツール、AI エージェントナレッジベースに参加します

列	タイプ	Nullable	説明
instance_arn	string	はい	Connect Customer インスタンスの ARN。
instance_id	string	いいえ	Connect Customer インスタンスの ID。
contact_id	string	はい	コンタクト ID。
ai_session_id	string	いいえ	AI-Agent セッションの ID。
aws_account_id	string	はい	お客様の AWS アカウント ID。
assistant_id	string	はい	Connect AI エージェントアシスタントの識別子。
creation_timestamp	bigint	はい	データレイクにイベントが作成されたときのタイムスタンプ。
update_timestamp	bigint	はい	データレイクでイベントが更新されたときのタイムスタンプ。
Proactive_intents_detected	bigint	はい	エージェントアシスタンスユースケースの AI セッション中に検出されたプロアクティブインテント (顧客クエリ) の数。
Proactive_intents_engaged	bigint	はい	エージェントアシスタンスユースケースの AI セッションに関与したプロアクティブインテント (顧客クエリ) の数。
Proactive_intents_answered	bigint	はい	エージェントアシスタンスユースケースの AI セッションで応答されたプロアクティブインテント (顧客クエリ) の数。
ai_agent_invocation_count	bigint	はい	AI セッション内の AI エージェント呼び出しの数。
ai_agent_invocation_success_count	bigint	はい	AI セッションで成功した AI エージェント呼び出しの数。
is_handed_off	boolean	はい	AI エージェントが AI セッション中に人間のエージェントに引き渡したかどうかを示すブール値フィールド。
avg_conversation_turns_in_response	フロート	はい	AI エージェントの呼び出しに対する会話の平均ターン数。
goal_success_rate	double	はい	オーケストレーション AI エージェントが顧客の問題を正常に解決したかどうかを評価する 0 から 1 までの倍数。
忠実度スコア	double	はい	メッセージやツール呼び出しの結果など、オーケストレーション AI エージェントの応答が会話コンテキストに忠実かどうかを評価する 0 から 1 までの倍数。
completeness_score	double	はい	オーケストレーション AI エージェントのレスポンスが顧客のリクエストのすべての部分を完全に処理しているかどうかを評価する 0 から 1 までの倍数。

AI ツール

テーブル名: ai_tool

説明: AI セッション内の各ツール呼び出しのツール選択精度、パラメータ精度、使用率精度、呼び出しレイテンシーなど、AI ツール呼び出しイベントを追跡します。

プライマリキー: ai_tool_event_id, instance_id

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

結合キー:

instance_id — すべてのテーブルに結合します
contact_id — 問い合わせレコード、問い合わせ統計レコード、問い合わせレンズに参加します
ai_session_id — AI セッション、AI エージェント、AI プロンプトに参加します
ai_agent_id — AI エージェントに参加します

列	タイプ	Nullable	説明
instance_arn	string	はい	Connect インスタンスの ARN。
aws_account_id	string	はい	Connect AI Assistant を所有する AWS アカウントの識別子。
instance_id	string	いいえ	Connect インスタンスの ID。
contact_id	string	はい	コンタクト ID。
ai_agent_id	string	はい	リクエストされた AI エージェントの ID。
ai_tool_id	string	はい	リクエストされた AI ツールの ID。
ai_tool_event_id	string	いいえ	AI ツール呼び出しイベントの ID。
assistant_id	string	はい	Connect Customer AI Assistant の ID。
ai_session_id	string	はい	AI エージェントセッションの ID。
creation_timestamp	bigint	はい	データレイクイベントが作成された瞬間。
update_timestamp	bigint	はい	データレイクイベントが最後に変更された瞬間。
ai_agent_type	string	はい	リクエストされた AI エージェントのタイプ。
ai_agent_name	string	はい	リクエストされた AI エージェントの名前。
ai_agent_version	string	はい	リクエストされた AI エージェントのバージョン番号。
ai_agent_arn	string	はい	リクエストされた AI エージェントの ARN。
ai_tool_type	string	はい	呼び出された AI ツールのタイプ。
ai_tool_name	string	はい	呼び出された AI ツールの名前。
ai_tool_arn	string	はい	呼び出された AI ツールの ARN。
invocation_success	boolean	はい	ツールの呼び出しが成功したかどうかを示すブール値フィールド。
invocation_latency_ms	フロート	はい	AI ツール呼び出しの呼び出しレイテンシー。
ai_tool_parameter_accuracy	double	はい	AI エージェントが正しいツールパラメータを提供したかどうかを評価する 0～1 の倍精度。1 は正しいツールパラメータを示します。
ai_tool_selection_accuracy	double	はい	AI エージェントが正しいツールを選択したかどうかを評価する 0～1 の倍精度。1 は正しいツールの選択を示します。
ai_tool_utilization_accuracy	double	はい	AI エージェントがツールを正しく使用したかどうかを評価する 0～1 の倍精度。1 は完全な使用を示します。

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

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

ドキュメントの表記規則

問い合わせ分析データ

フローデータ