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

# 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)
+ [人工智能会话](#data-lake-ai-session)
+ [人工智能工具](#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 工具


|  **列**  |  **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 代理知识库
<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`— 加入接触记录、接触统计记录、隐形眼镜
+ `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 提示符
<a name="data-lake-ai-prompt"></a>

**表名：**`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 提示符的输出标记。 | 

## 人工智能会话
<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 代理知识库


|  **列**  |  **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 代理的响应是否完全解决了客户请求的所有部分。 | 

## 人工智能工具
<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 代理


|  **列**  |  **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 表示使用效果良好。 |