View a markdown version of this page

Connect Customer 数据湖中的 AI 代理数据 - Amazon Connect Customer
AI 代理AI 代理知识库AI 提示符人工智能会话人工智能工具

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Connect Customer 数据湖中的 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 工具

列 Type 可为空 描述
instance_arn 字符串 是 Connect 实例的 ARN。
instance_id 字符串 否 Connect 实例的 ID。
contact_id 字符串 是 联系人的 ID。
ai_agent_id 字符串 是 请求的 AI 代理的 ID。
ai_agent_版本 字符串 是 请求的 AI 代理的版本。
ai_agent_event_id 字符串 否 事件的 ID。
aws_account_id 字符串 是 使用 AI 助手的 AWS 账号 ID。
assistant_id 字符串 是 人工智能助手的 ID。
ai_session_id 字符串 是 AI-Agent 会话的 ID。
creation_timestamp bigint 是 事件的时间戳是在数据湖中创建的。
更新时间戳 bigint 是 事件的时间戳将在数据湖中更新。
ai_use_case 字符串 是 AI 代理的用例。
ai_agent_type 字符串 是 请求的 AI 代理的类型。
ai_agent_name 字符串 是 请求的 AI 代理的名称。
ai_agent_arn 字符串 是 所请求的 AI 代理的 Arn。
调用_成功 布尔 是 一个布尔值字段，用于指示 AI 代理的调用是否成功。
调用 latency_ms 浮点数 是 评估的联系人中 AI 代理的调用延迟。
对话_turns_in_response bigint 是 请求的 AI 代理响应的对话回合数。
回应_有帮助 int 是 竖起大拇指后被评为有用的 AI 建议数量。
回复_不_有用 int 是 竖起大拇指被评为无济于事的 AI 建议数量。

AI 代理知识库

表名：ai_agent_knowledge_base

描述：记录知识库参考事件，跟踪在 AI Agent 交互期间检索和使用了哪些知识内容。

主键：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 代理

列 Type 可为空 描述
instance_arn 字符串 是 Connect 实例的 ARN。
aws_account_id 字符串 是 拥有 Connect AI Assistant 的 AWS 账户的标识符。
instance_id 字符串 否 Connect 实例的 ID。
contact_id 字符串 是 特定联系人的 ID。
知识_内容_ID 字符串 是 引用的知识内容的 ID。
ai_agent_type 字符串 是 请求的 AI 代理的类型。
ai_agent_knowledge_base_event 字符串 否 知识库参考事件的 ID。
assistant_id 字符串 是 Amazon Connect 人工智能助手的 ID。
ai_session_id 字符串 是 AI 代理会话的 ID。
creation_timestamp 字符串 是 创建数据湖事件的那一刻。
更新时间戳 字符串 是 上次修改数据湖事件的那一刻。
ai_agent_id 字符串 是 请求的 AI 代理的 ID。
ai_agent_name 字符串 是 请求的 AI 代理的名称。
ai_agent_版本 字符串 是 请求的 AI 代理的版本号。
ai_agent_arn 字符串 是 请求的 AI 代理的 ARN。
知识库 ID 字符串 是 引用的知识库的 ID。
知识库名称 字符串 是 引用的知识库的名称。
知识_内容_参考 字符串 是 引用的知识内容的标题。
data_lake_last_processed_timestamp timestamp 是 时间戳，显示上次数据湖触摸记录的时间。这可能包括转换和回填。此字段不能可靠地用于确定数据的新鲜度。

AI 提示符

表名：ai_prompt

描述：跟踪 AI Prompt 调用事件，包括 AI 会话中每个提示调用的模型使用情况、令牌计数、延迟和调用成功。

主键：ai_prompt_event_id, instance_id

分区键：creation_timestamp（每天）

加入密钥：

  • instance_id— 联接到所有表

  • contact_id— 加入接触记录、接触统计记录、隐形眼镜

  • ai_session_id— 加入 AI 会话、AI 代理、AI 工具

  • ai_agent_id— 加入 AI 代理

列 Type 可为空 描述
instance_arn 字符串 是 Connect Customer 实例的 ARN。
aws_account_id 字符串 是 客户 AWS 账户 ID。
instance_id 字符串 否 Connect 客户实例的 ID。
contact_id 字符串 是 联系人的 ID。
ai_prompt_id 字符串 是 所请求的 ID AI-prompt。
ai_prompt_版本 字符串 是 所请求的版本 AI-prompt。
ai_prompt_event_ID 字符串 否 实体的 ID。
assistant_id 字符串 是 AI 助手的标识符。
ai_session_id 字符串 是 AI-Agent 会话的 ID。
creation_timestamp bigint 是 在数据湖中创建事件的时间戳。
更新时间戳 bigint 是 数据湖中更新事件的时间戳。
ai_agent_type 字符串 是 请求的 AI 代理的类型。
ai_agent_name 字符串 是 请求的 AI 代理的名称。
ai_agent_id 字符串 是 请求的 AI 代理的 ID。
ai_agent_版本 字符串 是 请求的 AI 代理的版本号。
ai_agent_arn 字符串 是 所请求的 AI 代理的 Arn。
ai_prompt_ty 字符串 是 调用的 AI 提示符的类型。
ai_promp_name 字符串 是 调用的 AI 提示符的名称。
ai_prompt_arn 字符串 是 被调用的 AI 提示符的 arn。
model_id 字符串 是 与 AI Prompt 关联的 llm 模型的名称。
调用_成功 布尔值 是 一个布尔值字段，用于指示调用提示符是否成功。
调用 latency_ms 浮点数 是 评估的联系人中 AI 提示的调用延迟。
输入令牌 bigint 是 被评估的联系人中 AI 提示的输入令牌。
输出令牌 bigint 是 被评估的联系人中 AI 提示符的输出标记。

人工智能会话

表名：ai_session

描述：包含会话级 AI 指标，包括每个 AI 会话的主动意图检测、调用次数、切换状态和质量分数（目标成功率、忠诚度、完整性）。

主键：ai_session_id, instance_id

分区键：creation_timestamp（每天）

加入密钥：

  • instance_id— 联接到所有表

  • contact_id— 加入接触记录、接触统计记录、隐形眼镜

  • ai_session_id— 加入 AI 代理、AI 提示、AI 工具、AI 代理知识库

列 Type 可为空 描述
instance_arn 字符串 是 Connect Customer 实例的 ARN。
instance_id 字符串 否 Connect 客户实例的 ID。
contact_id 字符串 是 联系人的 ID。
ai_session_id 字符串 否 AI-Agent 会话的 ID。
aws_account_id 字符串 是 客户的 AWS 账户编号。
assistant_id 字符串 是 Connect 人工智能代理助手的标识符。
creation_timestamp bigint 是 在数据湖中创建事件的时间戳。
更新时间戳 bigint 是 数据湖中更新事件的时间戳。
检测到主动意图 bigint 是 在 AI 会话期间检测到的 “座席协助” 用例的主动意图（客户查询）的数量。
proactive_intents_engage bigint 是 在座席协助用例的 AI 会话中参与的主动意图（客户查询）的数量。
proactive_intents_已回答 bigint 是 座席协助用例在 AI 会话中回答的主动意图（客户查询）的数量。
ai_agent_invocation_count bigint 是 AI 会话中的 AI 代理调用次数。
ai_agent_调用成功_计数 bigint 是 AI 会话中成功调用 AI 代理的次数。
is_handed_off 布尔值 是 一个布尔值字段，用于指示 AI 代理在 AI 会话期间是否已移交给人工代理。
avg_conversation_turns_in_response 浮点数 是 响应 AI 代理调用的平均会话次数。
目标成功率 double 是 介于 0 和 1 之间的双精度值，用于评估 Orchestration AI 代理是否成功解决了客户问题。
忠诚度分数 double 是 介于 0 和 1 之间的双精度，用于评估 Orchestration AI 代理的响应是否忠实于对话上下文，包括消息和工具调用结果。
完整性分数 double 是 介于 0 和 1 之间的双精度，用于评估 Orchestration 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 代理

列 Type 可为空 描述
instance_arn 字符串 是 Connect 实例的 ARN。
aws_account_id 字符串 是 拥有 Connect AI Assistant 的 AWS 账户的标识符。
instance_id 字符串 否 Connect 实例的 ID。
contact_id 字符串 是 联系人的 ID。
ai_agent_id 字符串 是 请求的 AI 代理的 ID。
ai_tool_id 字符串 是 请求的 AI 工具的 ID。
ai_tool_event_id 字符串 否 AI 工具调用事件的 ID。
assistant_id 字符串 是 Connect 客户人工智能助手的 ID。
ai_session_id 字符串 是 AI 代理会话的 ID。
creation_timestamp bigint 是 创建数据湖事件的那一刻。
更新时间戳 bigint 是 上次修改数据湖事件的那一刻。
ai_agent_type 字符串 是 请求的 AI 代理的类型。
ai_agent_name 字符串 是 请求的 AI 代理的名称。
ai_agent_版本 字符串 是 请求的 AI 代理的版本号。
ai_agent_arn 字符串 是 请求的 AI 代理的 ARN。
ai_tool_type 字符串 是 调用的 AI 工具的类型。
ai_tool_name 字符串 是 调用的 AI 工具的名称。
ai_tool_arn 字符串 是 被调用的 AI 工具的 ARN。
调用_成功 布尔值 是 一个布尔值字段，用于指示工具的调用是否成功。
调用 latency_ms 浮点数 是 AI 工具调用的调用延迟。
ai_tool_parameter_精度 double 是 介于 0 和 1 之间的双精度值，用于评估 AI 代理提供的工具参数是否正确，其中 1 表示工具参数正确。
ai_tool_selection_精度 double 是 介于 0 和 1 之间的双精度值，用于评估 AI 代理选择的工具是否正确，其中 1 表示工具选择正确。
ai_tool_利用率_精度 double 是 介于 0 和 1 之间的双精度值，用于评估 AI 代理是否正确使用了该工具，其中 1 表示使用效果良好。