Zafer-Liu/Data-Analysis-Agent

📊 Data‑Analysis‑Agent (智析 Agent)

是什么 – 一个开源的对话式AI代理，允许非技术用户通过输入自然语言问题来分析业务数据。它可连接Excel/CSV文件或关系型数据库，自动推断数据结构，生成并执行SQL，选择合适的Plotly图表，并返回书面业务洞察。

核心功能

• 自然语言转SQL – 无需手动编写查询；LLM将用户意图转化为SQL并执行。
• 多源支持 – Excel、CSV、SQLite、MySQL、PostgreSQL、SQL Server（未来支持：DuckDB、Spark）。
• 自动绘图 – 从6个类别（趋势、对比、分布、地理、关系、比例）的41种图表类型中选择，并使用Plotly渲染。
• 流式反馈 – 使用Server-Sent Events显示逐步进度条（模式检测 → SQL生成 → 执行 → 图表与洞察）。
• LLM无关 – 支持任何OpenAI兼容API（OpenAI、DeepSeek、AtlasCloud等），可配置base_url、model和api_key。
• 高级分析 – 支持异常值处理、百分位分组、K-means聚类、决策树建模，并可将结果导出为Excel、DOCX或PPT。
• 可扩展 – 可附加本地/远程“MCP”以扩展功能，并可导入业务知识库。

如何获取

1. Windows安装程序 – 从发布页面下载BusinessAnalyticsAgent_v1.2.0_LTS.exe并运行（需Python 3.10+）。
2. 跨平台ZIP – 下载源码ZIP，运行start.bat（Windows）或start.command（macOS），该脚本会创建虚拟环境、安装依赖并启动Flask服务器至http://localhost:5001。
3. 一键脚本 – 运行提供的PowerShell（install.ps1）或Shell（install.sh）脚本，全局安装并添加data-analysis-agent命令。
4. 手动克隆 – git clone https://github.com/ZaVar‑Liu/Data-Analysis-Agent.git && pip install -r requirements.txt && python app.py。

典型工作流

> 最近 12 个月销售趋势
[1/4] 读取数据结构…
[2/4] 生成 SQL…
[3/4] 执行查询…
[4/4] 生成折线图并给出增长分析

您还可以强制指定图表（/chart …）、执行原始SQL（/sql …），或调用深度分析（/kmeans、/tree）。

配置 – 在UI侧边栏的 ⚙ 下，输入您的LLM API密钥、可选的base URL和模型名称。默认模型为deepseek‑v4‑flash（DeepSeek）和gpt‑4o‑mini（OpenAI）。

扩展与贡献 – 项目遵循PEP 8规范，使用常规提交，欢迎提交PR修复bug、添加新图表类型或高级分析功能。详见CONTRIBUTING.md中的工作流程。

许可证 – CC BY-NC 4.0（仅限非商业用途；商业用途可向作者获取授权）。

---

更多详情，请参阅README中的*功能、安装、斜杠命令和常见问题部分。*