
Data-Analysis-Agent如何读懂你的数据DataProfiler数据画像模块原理详解【免费下载链接】Data-Analysis-Agent你的私人数据分析助手。通过对话式交互自动生成可视化报表与商业洞察让数据决策变得像聊天一样简单。 Your personal data analysis assistant. Say goodbye to complex SQL and Excel formulas. An LLM-powered data analysis agent. Chat with your data to instantly generate visualizations and business insights. Making>项目地址: https://gitcode.com/gh_mirrors/vi/Data-Analysis-AgentData-Analysis-Agent 是一个 LLM 驱动的私人数据分析助手上传 Excel/CSV 文件就能自动推荐图表并生成交互式可视化报表。而它看懂你数据的关键是核心的数据画像模块 DataProfiler位于 core/data_profiler.py。这篇文章将详解它如何自动识别字段类型与数据特征以及画像结果如何驱动智能图表推荐。上传成功后会立即显示6 行3 列——这正是数据画像的第一步产出一、DataProfiler 是什么数据画像的感知层DataProfiler 的定位是Excel/CSV 数据结构感知层一个独立模块、不与任何图表耦合。它的职责只有一件事把原始数据体检一遍输出标准的数据画像profile字典供下游的推荐引擎和数据验证器使用。它支持两种数据入口入口方法特点文件路径load_file()自动识别 CSV 编码Excel 可指定 sheetDataFrameload()直接接收内存数据自动复制避免污染针对中文用户最常见的CSV 乱码痛点load_file 实现 会依次尝试utf-8-sig → gbk → gb2312 → latin1四种编码哪个能读通就用哪个基本做到了拿到什么文件都能读。二、数据画像的 4 步流水线1️⃣ 列类型推断不止 7 种聪明分类核心方法infer_column_type会把每一列归入 7 类之一类型含义典型例子number数值销量、金额string文本产品名、备注datetime日期时间下单日期bool布尔是否退货id唯一标识订单号、用户IDempty空列全为空的列mixed混合无法归类的列规则上还有几个很实用的细节见 类型推断源码纯数字字符串也算数值一列文本若 80% 以上能转成数字直接判定为number——Excel 里存成文本的数字由此复活高唯一性文本自动识别为 ID唯一值占比 90% 且超过 20 个不同值的列如订单号判定为id避免被误当成分类维度列名即线索列名含date/日期/时间等关键词时即使是数字类型也推断为时间戳如20260101。2️⃣ 逐列统计给每列建一份小档案column_stats 方法 为每一列计算非空/空值数、缺失率、唯一值数数值列还会给出 min/max/mean/median/sum文本列则提取 Top 5 高频值和平均长度。这些统计量是后续数据质量预警的原料。3️⃣ 语义列识别地理、时间、层级、流向profile() 方法 会扫描列名关键词额外标记出几组语义列geo_cols含lat/lon/经度/纬度/省/城市/国家等 → 可画地图类图表time_cols含date/时间/年/月等 → 可画趋势类图表has_hierarchy出现parent/child/path/层级→ 可画旭日图、树图has_flow同时存在source和target列 → 可画桑基图、弧图4️⃣ 输出标准画像最终 profile 字典包含行列规模、各类型列清单、can_aggregate是否有可聚合的数值列、每列前 3 个示例值、全部列统计。这份字典就是整个系统读懂数据的结论一次计算、全链路复用。三、画像结果的三大消费者DataProfiler 的价值在于一次画像三处使用规则推荐引擎RuleRecommender 直接消费 profile用确定性规则匹配图表——例如sourcetarget数值列 → 桑基图、地理列≥2数值 → 地图、时间列数值 → 折线图、仅 1 个数值列 → 直方图。没有配置 LLM 时也能离线出推荐。LLM 推荐llm_recommender 构建提示词 时把行数、数值列、文本列等画像特征填入 prompt让大模型基于真实数据特征而非猜测来推荐图表再经白名单校验剔除幻觉结果。数据验证器DataValidator 基于统计量检测高缺失率、异常值等问题在生成图表前预警数据质量风险。基于数据画像系统自动给出五星推荐 桑基图及完整的字段映射理由四、suggest_mapping列名到图表角色的自动映射suggest_mapping 方法 内置了一份中英文角色线索表source对应起点/fromlat/lon对应经纬度省/城市对应地理字段开盘/收盘/成交量对应 K 线图字段……拿到上传的数据后它直接告诉你这一列适合当 X 轴、那一列适合当 Y 轴、这一列是分组系列把用户手动拖拽字段的工作省掉——这也是界面上生成图表时可以一键确认映射的原因。选择推荐图表并确认映射后一键生成交互式 HTML 图表并支持下载五、写在最后DataProfiler 的设计哲学可以概括为三点独立解耦画像模块只负责感知不与图表实现耦合新增 40 种图表无需改动它规则兜底 LLM 增强离线规则保证可用性LLM 画像提示词提升推荐精度面向真实脏数据编码容错、文本数字识别、ID 判定处处为中文 Excel 数据打补丁。想动手体验先阅读 README 完成安装再配合 charts/registry.py 了解图表注册机制就能完整走通上传 → 画像 → 推荐 → 生成的全流程。【免费下载链接】Data-Analysis-Agent你的私人数据分析助手。通过对话式交互自动生成可视化报表与商业洞察让数据决策变得像聊天一样简单。 Your personal data analysis assistant. Say goodbye to complex SQL and Excel formulas. An LLM-powered data analysis agent. Chat with your data to instantly generate visualizations and business insights. Making>项目地址: https://gitcode.com/gh_mirrors/vi/Data-Analysis-Agent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考