本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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 工具
| 列 | Type | 可以为空 | 描述 |
|---|---|---|---|
| instance_arn | 字符串 | 是 | Connect 实例的 ARN。 |
| instance_id | 字符串 | 否 | 连接实例的 ID。 |
| contact_id | 字符串 | 是 | 联系人的 ID。 |
| ai_agent_id | 字符串 | 是 | 所请求的 AI 代理的 ID。 |
| ai_agent_version | 字符串 | 是 | 所请求的 AI 代理的版本。 |
| ai_agent_event_id | 字符串 | 否 | 事件的 ID。 |
| aws_account_id | 字符串 | 是 | 使用 AI 助手的 AWS 账号的 ID。 |
| assistant_id | 字符串 | 是 | AI 助手的 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 代理的调用是否成功。 |
| 调用延迟_ms | 浮点数 | 是 | 评估的联系人中 AI 代理的调用延迟。 |
| 对话回应 | bigint | 是 | 请求的 AI 代理响应的对话回复次数。 |
| 回复_有帮助 | int | 是 | 竖起大拇指后被评为有用的 AI 建议的数量。 |
| 回复_不_有用 | int | 是 | 按下大拇指被评为无用的 AI 建议的数量。 |
| data_lake_last_processed_timestamp | Timestamp | 是 | 时间戳，显示数据湖上次触摸记录的时间。这可能包括转换和回填。该字段不能可靠地用于确定数据的新鲜度。 |
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_agent_id— 加入人工智能代理
| 列 | Type | 可以为空 | 描述 |
|---|---|---|---|
| instance_arn | 字符串 | 是 | Connect 实例的 ARN。 |
| aws_account_id | 字符串 | 是 | 拥有 Connect AI Assistant 的 AWS 账户的标识符。 |
| instance_id | 字符串 | 否 | 连接实例的 ID。 |
| contact_id | 字符串 | 是 | 特定联系人的 ID。 |
| 知识内容_ID | 字符串 | 是 | 引用的知识内容的 ID。 |
| ai_agent_type | 字符串 | 是 | 所请求的 AI 代理的类型。 |
| ai_agent_knowledge_base_event_id | 字符串 | 否 | 知识库参考事件的 ID。 |
| assistant_id | 字符串 | 是 | 亚马逊 Connect AI 助手的 ID。 |
| ai_session_id | 字符串 | 是 | AI 代理会话的 ID。 |
| creation_timestamp | 字符串 | 是 | 创建数据湖事件的那一刻。 |
| 更新时间戳 | 字符串 | 是 | 上次修改数据湖事件的那一刻。 |
| ai_agent_id | 字符串 | 是 | 所请求的 AI 代理的 ID。 |
| ai_agent_name | 字符串 | 是 | 所请求的 AI 代理的名称。 |
| ai_agent_version | 字符串 | 是 | 所请求的 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_agent_id— 加入人工智能代理
| 列 | Type | 可以为空 | 描述 |
|---|---|---|---|
| instance_arn | 字符串 | 是 | 连接客户实例的 ARN。 |
| aws_account_id | 字符串 | 是 | 客户 AWS 账户 ID。 |
| instance_id | 字符串 | 否 | 连接客户实例的 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_version | 字符串 | 是 | 所请求的 AI 代理的版本号。 |
| ai_agent_arn | 字符串 | 是 | 所请求的 AI 代理的 Arn。 |
| ai_prompt_ty | 字符串 | 是 | 调用的 AI 提示符的类型。 |
| ai_promt_name | 字符串 | 是 | 调用的 AI 提示符的名称。 |
| ai_prompt_arn | 字符串 | 是 | 调用的 AI 提示符的 arn。 |
| model_id | 字符串 | 是 | 与 AI 提示符关联的 llm 模型的名称。 |
| 调用_成功 | 布尔值 | 是 | 一个布尔字段，用于指示提示调用是否成功。 |
| 调用延迟_ms | 浮点数 | 是 | 评估的联系人中 AI 提示符的调用延迟。 |
| 输入令牌 | bigint | 是 | 评估的联系人中 AI 提示符的输入令牌。 |
| output_token | bigint | 是 | 评估的联系人中 AI 提示符的输出令牌。 |
| data_lake_last_processed_timestamp | Timestamp | 是 | 时间戳，显示数据湖上次触摸记录的时间。这可能包括转换和回填。该字段不能可靠地用于确定数据的新鲜度。 |
AI 会话
表名：ai_session
描述：包含会话级别的人工智能指标，包括每个 AI 会话的主动意图检测、调用次数、移交状态和质量分数（目标成功率、忠诚度、完整性）。
主键：ai_session_id, instance_id
分区键：creation_timestamp（每天）
加入密钥：
instance_id— 加入所有表contact_id— 加入联系人记录、接触统计记录、隐形眼镜ai_session_id— 加入 AI 代理、AI Prompt、AI 工具、AI 代理知识库
| 列 | Type | 可以为空 | 描述 |
|---|---|---|---|
| instance_arn | 字符串 | 是 | 连接客户实例的 ARN。 |
| instance_id | 字符串 | 否 | 连接客户实例的 ID。 |
| contact_id | 字符串 | 是 | 联系人的 ID。 |
| ai_session_id | 字符串 | 否 | AI-Agent 会话的 ID。 |
| aws_account_id | 字符串 | 是 | 客户 AWS 账户 ID。 |
| assistant_id | 字符串 | 是 | 代理助理的标识符。 |
| creation_timestamp | bigint | 是 | 在数据湖中创建事件的时间戳。 |
| 更新时间戳 | bigint | 是 | 在数据湖中更新事件的时间戳。 |
| 已检测到主动意图 | bigint | 是 | 在 AI 会话期间针对代理协助用例检测到的主动意图（客户查询）的数量。 |
| 主动_意图_已参与 | bigint | 是 | 代理协助用例在 AI 会话中参与的主动意图（客户查询）数量。 |
| proactive_intents_已回答 | bigint | 是 | 在 AI 会话中针对代理协助用例回答的主动意图（客户查询）的数量。 |
| ai_agent_invocation_count_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 代理的响应是否完全满足了客户请求的所有部分。 |
| data_lake_last_processed_timestamp | Timestamp | 是 | 时间戳，显示数据湖上次触摸记录的时间。这可能包括转换和回填。该字段不能可靠地用于确定数据的新鲜度。 |
人工智能工具
表名：ai_tool
描述：跟踪 AI 工具调用事件，包括 AI 会话中每个工具调用的工具选择精度、参数精度、使用率精度以及调用延迟。
主键：ai_tool_event_id, instance_id
分区键：creation_timestamp（每天）
加入密钥：
instance_id— 加入所有表contact_id— 加入联系人记录、接触统计记录、隐形眼镜ai_session_id— 加入人工智能会话、AI 代理、AI 提示符ai_agent_id— 加入人工智能代理
| 列 | Type | 可以为空 | 描述 |
|---|---|---|---|
| instance_arn | 字符串 | 是 | Connect 实例的 ARN。 |
| aws_account_id | 字符串 | 是 | 拥有 Connect AI Assistant 的 AWS 账户的标识符。 |
| instance_id | 字符串 | 否 | 连接实例的 ID。 |
| contact_id | 字符串 | 是 | 联系人的 ID。 |
| ai_agent_id | 字符串 | 是 | 所请求的 AI 代理的 ID。 |
| ai_tool_id | 字符串 | 是 | 所请求的 AI 工具的 ID。 |
| ai_tool_event_id | 字符串 | 否 | AI 工具调用事件的 ID。 |
| assistant_id | 字符串 | 是 | Connect 客户 AI 助手的 ID。 |
| ai_session_id | 字符串 | 是 | AI 代理会话的 ID。 |
| creation_timestamp | bigint | 是 | 创建数据湖事件的那一刻。 |
| 更新时间戳 | bigint | 是 | 上次修改数据湖事件的那一刻。 |
| ai_agent_type | 字符串 | 是 | 所请求的 AI 代理的类型。 |
| ai_agent_name | 字符串 | 是 | 所请求的 AI 代理的名称。 |
| ai_agent_version | 字符串 | 是 | 所请求的 AI 代理的版本号。 |
| ai_agent_arn | 字符串 | 是 | 所请求的 AI 代理的 ARN。 |
| ai_tool_type | 字符串 | 是 | 调用的 AI 工具的类型。 |
| ai_tool_name | 字符串 | 是 | 调用的 AI 工具的名称。 |
| ai_tool_arn | 字符串 | 是 | 调用的 AI 工具的 ARN。 |
| 调用_成功 | 布尔值 | 是 | 一个布尔字段，用于指示工具的调用是否成功。 |
| 调用延迟_ms | 浮点数 | 是 | AI 工具调用的调用延迟。 |
| ai_tool_参数_精度 | double | 是 | 介于 0 和 1 之间的双数，用于评估 AI 代理是否提供了正确的工具参数，其中 1 表示工具参数正确。 |
| ai_tool_selection_精度 | double | 是 | 介于 0 和 1 之间的双数，用于评估 AI 代理是否选择了正确的工具，其中 1 表示工具选择正确。 |
| ai_tool_利用率_精度 | double | 是 | 介于 0 和 1 之间的双数，用于评估 AI 代理是否正确使用了该工具，其中 1 表示完美使用。 |
| data_lake_last_processed_timestamp | Timestamp | 是 | 时间戳，显示数据湖上次触摸记录的时间。这可能包括转换和回填。该字段不能可靠地用于确定数据的新鲜度。 |
