本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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` — 加入 Contact Record、Contact Statistic Record、Contact Lens、Contact Evaluation Record、Contact Flow Events
+ `ai_session_id` — 加入 AI 工作階段、AI 提示、AI 工具、AI 代理器知識庫
+ `assistant_id` — 加入 AI 工作階段、AI 提示、AI 工具


|  **Column (欄)**  |  **類型**  |  **Nullable**  |  **Description**  | 
| --- | --- | --- | --- | 
| 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 助理的 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 | bool |  是  | 布林值欄位，指出 AI 代理器的調用是否成功。 | 
| invocation\_latency\_ms | float |  是  | 評估聯絡中的 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 Agent 互動期間擷取和使用的知識內容。

**主索引鍵：** `ai_agent_knowledge_base_event_id, instance_id`

**分割區索引鍵：** `creation_timestamp` （每日）

**聯結金鑰：**
+ `instance_id` — 聯結至所有資料表
+ `contact_id` — 加入聯絡記錄、聯絡統計資料記錄、Contact Lens
+ `ai_session_id` — 加入 AI 工作階段、AI 代理器、AI 提示、AI 工具
+ `ai_agent_id` — 加入 AI 代理器


|  **Column (欄)**  |  **類型**  |  **Nullable**  |  **Description**  | 
| --- | --- | --- | --- | 
| instance\_arn | string |  是  |  Connect 執行個體的 ARN。 | 
| aws\_account\_id | string |  是  | 擁有 Connect AI Assistant 的 AWS 帳戶識別符。 | 
| 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 助理的 ID。 | 
| ai\_session\_id | string |  是  | AI Agent 工作階段的 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` — 加入聯絡記錄、聯絡統計資料記錄、Contact Lens
+ `ai_session_id` — 加入 AI 工作階段、AI 代理器、AI 工具
+ `ai_agent_id` — 加入 AI 代理器


|  **Column (欄)**  |  **類型**  |  **Nullable**  |  **Description**  | 
| --- | --- | --- | --- | 
| 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 助理的識別符。 | 
| 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 提示字元的響起。 | 
| model\_id | string |  是  | 與 AI 提示相關聯的 llm 模型名稱。 | 
| invocation\_success | boolean |  是  | 布林值欄位，指出提示的調用是否成功。 | 
| invocation\_latency\_ms | float |  是  | 評估聯絡中的 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` — 加入聯絡記錄、聯絡統計資料記錄、Contact Lens
+ `ai_session_id` — 加入 AI Agent、AI Prompt、AI Tool、AI Agent 知識庫


|  **Column (欄)**  |  **類型**  |  **Nullable**  |  **Description**  | 
| --- | --- | --- | --- | 
| 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 | float |  是  | 回應 AI Agent 調用的平均對話次數。 | 
| goal\_success\_rate | double |  是  | 介於 0 和 1 之間的兩倍，用於評估協調 AI 代理器是否成功解決客戶問題。 | 
| 忠實\_分數 | double |  是  | 介於 0 和 1 之間的兩倍，用於評估協調 AI 代理器的回應是否忠於對話內容，包括訊息和工具呼叫結果。 | 
| completeness\_score | double |  是  | 介於 0 和 1 之間的兩倍，評估協調 AI 代理器的回應是否完全解決客戶請求的所有部分。 | 

## AI 工具
<a name="data-lake-ai-tool"></a>

**資料表名稱：** `ai_tool`

**描述：**追蹤 AI 工具調用事件，包括 AI 工作階段中每個工具呼叫的工具選擇準確性、參數準確性、使用率準確性和調用延遲。

**主索引鍵：** `ai_tool_event_id, instance_id`

**分割區索引鍵：** `creation_timestamp` （每日）

**聯結金鑰：**
+ `instance_id` — 聯結至所有資料表
+ `contact_id` — 加入聯絡記錄、聯絡統計資料記錄、Contact Lens
+ `ai_session_id` — 加入 AI 工作階段、AI 代理器、AI 提示
+ `ai_agent_id` — 加入 AI 代理器


|  **Column (欄)**  |  **類型**  |  **Nullable**  |  **Description**  | 
| --- | --- | --- | --- | 
| 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 Agent 工作階段的 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 | float |  是  | AI 工具呼叫的調用延遲。 | 
| ai\_tool\_parameter\_accuracy | double |  是  | 介於 0 和 1 之間的兩倍，評估 AI 代理器是否提供正確的工具參數，其中 1 表示正確的工具參數。 | 
| ai\_tool\_selection\_accuracy | double |  是  | 介於 0 和 1 之間的兩倍，評估 AI 代理器是否選擇了正確的工具，其中 1 表示正確的工具選擇。 | 
| ai\_tool\_utilization\_accuracy | double |  是  | 介於 0 和 1 之間的兩倍，評估 AI 代理器是否正確使用工具，其中 1 表示完美使用。 |