View a markdown version of this page

Connect Customer 資料湖中的 AI 代理程式資料 - Amazon Connect 客戶
AI 代理器AI 代理器知識庫AI 提示AI 工作階段AI 工具

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

Connect Customer 資料湖中的 AI 代理程式資料

下表包含 AI 代理程式資料。

AI 代理器

資料表名稱： 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 代理器知識庫

資料表名稱： 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 提示

資料表名稱： 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 工作階段

資料表名稱： 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 工具

資料表名稱： 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 表示完美使用。