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

# Connect Customer データレイクの AI エージェントデータ
<a name="data-lake-ai-agent-data"></a>

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

**Topics**
+ [AI エージェント](#data-lake-ai-agent)
+ [AI エージェントナレッジベース](#data-lake-ai-agent-knowledge-base)
+ [AI プロンプト](#data-lake-ai-prompt)
+ [AI セッション](#data-lake-ai-session)
+ [AI ツール](#data-lake-ai-tool)

## AI エージェント
<a name="data-lake-ai-agent"></a>

**テーブル名:** `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 エージェントナレッジベース
<a name="data-lake-ai-agent-knowledge-base"></a>

**テーブル名:** `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 プロンプト
<a name="data-lake-ai-prompt"></a>

**テーブル名:** `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 セッション
<a name="data-lake-ai-session"></a>

**テーブル名:** `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 ツール
<a name="data-lake-ai-tool"></a>

**テーブル名:** `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 は完全な使用を示します。 |