7.5.1 测试数据集的设计思路为了验证 Agent 的端到端能力本项目专门构造了一份电商销售订单的 CSV 测试数据集。数据规模为 150 条订单时间跨度从 2024 年 1 月至 2025 年 12 月共 17 列字段覆盖订单标识、时间、客户信息、地域三级、产品类别与名称、价格与数量、折扣、销售额、支付方式、渠道、销售员等维度。字段设计思路可以概括为以下四点时间维度订单日期用于验证月度、季度、年度聚合地域三级下钻地区→省份→城市用于验证多级 GROUP BY品类与客户等级维度用于验证多条件筛选与交叉分析数值列单价、数量、折扣、销售额则用于验证 SUM、AVG 等聚合函数。构造中文数据而非使用英文公开数据集核心目的是打靶打到痛点——真实测试中文渲染与中文 SQL 字段名的处理能力。图 7-7 测试数据集前50行预览7.5.2 Agent 的执行流程展示在将 CSV 上传到系统后笔者仅向 Agent 发送了一句提示请对这份电商销售数据做一份完整的分析报告。随后 Agent 依次自主完成了以下四个步骤。第一步表结构探查。Agent 首先通过 exec_sql 查询了目标表的字段定义确认 17 列字段的名称与类型后才开始撰写业务查询。这一步虽不直接产出业务结果却是保证后续 SQL 正确性的关键环节。第二步动态 SQL 查询如图7-8所示。Agent 根据“完整分析”这一抽象需求自行拆解为多个分析视角并生成了若干条 SQL。以下列出其中三条具有代表性的查询。图7-8 exec_sql查询页面1月度销售趋势查询SELECTTO_CHAR(订单日期, YYYY-MM) AS 月份,SUM(销售额) AS 月销售额FROM ordersGROUP BY TO_CHAR(订单日期, YYYY-MM)ORDER BY月份;2各品类销售额占比查询SELECT产品类别,SUM(销售额) AS 类别销售额,ROUND(SUM(销售额) * 100.0 / SUM(SUM(销售额)) OVER (), 1)AS占比百分比FROM ordersGROUP BY产品类别ORDER BY类别销售额 DESC;3地区销售排行查询SELECT地区, SUM(销售额) AS 地区销售额FROM ordersGROUP BY地区ORDER BY地区销售额 DESC;值得强调的是以上三条 SQL 均非笔者预先提供亦非在系统提示词中硬编码而是 Agent 根据自然语言需求“分析报告”动态推理生成。这直接印证了 7.2.1 节提出的“动态 SQL 查询能力”设计目标。7.5.3 三幅图的中文渲染验证在获得查询结果后Agent 自主判断每一组数据应配何种图表并依次调用 create_chart_tool 生成了三幅图按月销售额变化的折线图用于呈现趋势按品类销售额占比的饼图用于展示结构按地区销售额对比的柱状图用于进行横向排名。如图7-9所示。图 7-9 数据可视化图表页面由 Agent 自动生成7.5.4 Markdown 报告的完整输出最终 Agent 输出了一份结构完整的 Markdown 分析报告包含 7.2.3 节要求的四个模块。以下为报告节选。#电商销售数据分析报告##一、数据概览本次分析基于 2024 年 1 月至 2025 年 12 月的电商销售订单数据共包含 146 条有效订单记录总销售额达 154,520.58 元覆盖 7 个地区、8 大产品类别……##二、关键发现### 1.销售趋势特征-整体销售呈现波动上升趋势2025 年销售额较 2024 年增长约 45%-季节性特征明显每年 11-12 月为销售高峰期- 2025年 12 月销售额达 29,711.71 元为历史最高值占总销售额的 19.2%### 2.产品结构表现-电子产品为核心收入来源销售额达 75,251.4 元占比 48.7%-家居和服装分列二、三位三大类别合计占比超过 83%-图书类别占比最低仅 3.4%### 3.区域销售分布-西南地区销售表现最优占比 30.3%-东北地区销售额最低仅 5,627.56 元##三、数据可视化##四、结论与建议1.品类策略巩固电子产品优势……2.区域拓展深耕西南、华南……3.营销优化把握年末旺季……4.产品矩阵丰富家居、服装产品线……报告结构完整、数据引用准确、结论可执行达到了一份初级分析报告的交付标准。如图7-10所示。图7-10 报告完整截图7.5.5 与设计目标的逐项对照将 7.3 节中提示词所声明的三项核心能力与本节实际运行结果进行对照如表 7-3 所示。表 7-3 能力设计与实际运行效果对照设计目标实际交付验证结果动态生成SQL查询CSV数据Agent自主生成3条以上含聚合、时间函数的SQL达成Python绘图、中文渲染、对象存储、Markdown链接返回3幅图中文全部正常返回链接可直接渲染达成Markdown形式产出数据分析报告四段式报告结构完整含关键发现与可执行建议达成三项核心能力均实现闭环验证了本章提出的设计方法与实现路径的有效性。
7.5 运行效果验证
7.5.1 测试数据集的设计思路为了验证 Agent 的端到端能力本项目专门构造了一份电商销售订单的 CSV 测试数据集。数据规模为 150 条订单时间跨度从 2024 年 1 月至 2025 年 12 月共 17 列字段覆盖订单标识、时间、客户信息、地域三级、产品类别与名称、价格与数量、折扣、销售额、支付方式、渠道、销售员等维度。字段设计思路可以概括为以下四点时间维度订单日期用于验证月度、季度、年度聚合地域三级下钻地区→省份→城市用于验证多级 GROUP BY品类与客户等级维度用于验证多条件筛选与交叉分析数值列单价、数量、折扣、销售额则用于验证 SUM、AVG 等聚合函数。构造中文数据而非使用英文公开数据集核心目的是打靶打到痛点——真实测试中文渲染与中文 SQL 字段名的处理能力。图 7-7 测试数据集前50行预览7.5.2 Agent 的执行流程展示在将 CSV 上传到系统后笔者仅向 Agent 发送了一句提示请对这份电商销售数据做一份完整的分析报告。随后 Agent 依次自主完成了以下四个步骤。第一步表结构探查。Agent 首先通过 exec_sql 查询了目标表的字段定义确认 17 列字段的名称与类型后才开始撰写业务查询。这一步虽不直接产出业务结果却是保证后续 SQL 正确性的关键环节。第二步动态 SQL 查询如图7-8所示。Agent 根据“完整分析”这一抽象需求自行拆解为多个分析视角并生成了若干条 SQL。以下列出其中三条具有代表性的查询。图7-8 exec_sql查询页面1月度销售趋势查询SELECTTO_CHAR(订单日期, YYYY-MM) AS 月份,SUM(销售额) AS 月销售额FROM ordersGROUP BY TO_CHAR(订单日期, YYYY-MM)ORDER BY月份;2各品类销售额占比查询SELECT产品类别,SUM(销售额) AS 类别销售额,ROUND(SUM(销售额) * 100.0 / SUM(SUM(销售额)) OVER (), 1)AS占比百分比FROM ordersGROUP BY产品类别ORDER BY类别销售额 DESC;3地区销售排行查询SELECT地区, SUM(销售额) AS 地区销售额FROM ordersGROUP BY地区ORDER BY地区销售额 DESC;值得强调的是以上三条 SQL 均非笔者预先提供亦非在系统提示词中硬编码而是 Agent 根据自然语言需求“分析报告”动态推理生成。这直接印证了 7.2.1 节提出的“动态 SQL 查询能力”设计目标。7.5.3 三幅图的中文渲染验证在获得查询结果后Agent 自主判断每一组数据应配何种图表并依次调用 create_chart_tool 生成了三幅图按月销售额变化的折线图用于呈现趋势按品类销售额占比的饼图用于展示结构按地区销售额对比的柱状图用于进行横向排名。如图7-9所示。图 7-9 数据可视化图表页面由 Agent 自动生成7.5.4 Markdown 报告的完整输出最终 Agent 输出了一份结构完整的 Markdown 分析报告包含 7.2.3 节要求的四个模块。以下为报告节选。#电商销售数据分析报告##一、数据概览本次分析基于 2024 年 1 月至 2025 年 12 月的电商销售订单数据共包含 146 条有效订单记录总销售额达 154,520.58 元覆盖 7 个地区、8 大产品类别……##二、关键发现### 1.销售趋势特征-整体销售呈现波动上升趋势2025 年销售额较 2024 年增长约 45%-季节性特征明显每年 11-12 月为销售高峰期- 2025年 12 月销售额达 29,711.71 元为历史最高值占总销售额的 19.2%### 2.产品结构表现-电子产品为核心收入来源销售额达 75,251.4 元占比 48.7%-家居和服装分列二、三位三大类别合计占比超过 83%-图书类别占比最低仅 3.4%### 3.区域销售分布-西南地区销售表现最优占比 30.3%-东北地区销售额最低仅 5,627.56 元##三、数据可视化##四、结论与建议1.品类策略巩固电子产品优势……2.区域拓展深耕西南、华南……3.营销优化把握年末旺季……4.产品矩阵丰富家居、服装产品线……报告结构完整、数据引用准确、结论可执行达到了一份初级分析报告的交付标准。如图7-10所示。图7-10 报告完整截图7.5.5 与设计目标的逐项对照将 7.3 节中提示词所声明的三项核心能力与本节实际运行结果进行对照如表 7-3 所示。表 7-3 能力设计与实际运行效果对照设计目标实际交付验证结果动态生成SQL查询CSV数据Agent自主生成3条以上含聚合、时间函数的SQL达成Python绘图、中文渲染、对象存储、Markdown链接返回3幅图中文全部正常返回链接可直接渲染达成Markdown形式产出数据分析报告四段式报告结构完整含关键发现与可执行建议达成三项核心能力均实现闭环验证了本章提出的设计方法与实现路径的有效性。
