# MetricBot

**Repository Path**: study_44/metric-bot

## Basic Information

- **Project Name**: MetricBot
- **Description**: MetricBot是致力于打造数据分析领域的DataAgent开源项目，参考Dify、N8N、openClaw,基于langgraph+langchain的可视化图编排能力和自主规划执行能力、Text2DSL2SQL自研技术实现sql生成、chatBI、多代理可编排复杂智能体。持续迭代的核心功能有DataAgentFlow、指标口径问答、chatBI、sql智能生成、指标资产&血缘可视化、指标预警
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 40
- **Created**: 2026-03-30
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MetricBot

### 介绍
MetricBot是致力于打造数据分析领域的DataAgent开源项目，参考Dify、N8N、openClaw,基于langgraph+langchain的可视化图编排能力和自主规划执行能力、Text2DSL2SQL自研技术实现sql生成、chatBI、多代理可编排复杂智能体。持续迭代的核心功能有DataAgentFlow、指标口径问答、chatBI、sql智能生成、指标资产&血缘可视化、指标预警等。

如果该项目对您有帮助，请帮忙点个Star吧！！！



## 软件架构
项目是基于dcluster开源指标数据中台+langgraph+langchain+python重构的敏捷轻量级指标AI智能体单体应用。 \
前端：基于python实现的flet构建 \
后端：python实现 \
特性：支持跨平台部署，一份代码同时支持windows、linux等平台部署

## 快速开始 🚀

下载一键启动包，解压直接使用（路径不要有 **中文**、**特殊字符**、**空格**）

### Windows
- 夸克网盘（MetricBot 1.9.1 最新版本20260328-特性： 能智能问数、能写报告、能写sql、能查口径DataAgent Skills）:  https://pan.quark.cn/s/d0fb68d7c59b \
使用步骤：\
1.下载解压后，如果没有安装java环境的情况下，双击文件夹里的jdk-8-install进行安装，一直点击下一步直到完成关闭（注意不要修改路径）,安装一次即可。\
2.安装java后，双击MetricBot后即可启动。\
注：如果已经安装过jdk8，但没有配置JAVA_HOME，则需要先配置JAVA_HOME\
![配置JAVA_HOME.png](imgs/%E9%85%8D%E7%BD%AEJAVA_HOME.png) 

使用指南文档：\
操作指南案例一：https://mp.weixin.qq.com/s/nFAIm5HVW1VtjlAUUGSY5g

历史特性：\
1.9.0 ：新增可视化编排DataAgent数据分析AIBot \
1.8.0 ：新增基于指标数据资产的可视化编排DataAgentFlow,实现langgraph+langchain的可视化编排 \
1.7.0 ：新增指标预警功能、优化安装启动 \
1.6.0 :新增指标分析功能、数据集支持自定义维度扩展和指标扩展、简化指标模板配置\
1.5.0 :增加数据集管理，指标定义和生成sql支持自动关联数据集、 text2sql支持复杂表关联预定义、指标维度自定义扩展\
1.4.0 :增加内容路径拆解&财务杜邦分析模板、指标资产新增探索、指标口径定义支持嵌套、指标归因bug修复、text2sql规则优化\
1.3.0 :指标归因分析、sql生成支持修改与执行查询、text2sql输入sug词、指标资产优化\
1.2.0 :包体积优化、指标资产、可视化图表、分页表格、text2sql优化

#### 其他系统
还在迭代中，后续更新

##  使用场景

适用于希望快速敏捷进行指标资产管理、数据分析报告生成、指标归因分析、AI智能生成sql、ChatBi问答、指标口径问答的数据业务各场景。

| 场景          | 描述                            | 典型用户类型             |
| ----------- | ----------------------------- | ------------------ |
| **指标管理**  | 统一定义业务指标口径和指标语义，构建指标资产字典。 | 数据工程师、数据分析师、数据产品、业务人员     |
| **智能指标口径问答** | 通过AI快速查询用户需要的指标语义数据，快速定位指标口径。    | 数据工程师、数据分析师、数据产品、业务人员    |
| **智能生成sql**  | 针对众多临时取数需求，想要快速生成通用sql模板，在此基础上进行修改，提升取数效率。   | 数据工程师、数据分析师、数据产品、业务人员  |
| **智能可视化图表生成ChatBI** | 希望输入自然语言查询出可视化图表数据。 | 数据工程师、数据分析师、数据产品、业务人员  |
| **指标资产血缘追踪** | 希望对指标资产可以进行可视化血缘查询管理。 | 数据工程师、数据分析师、数据产品、业务人员  |   

## ✅ 已有功能一览

| 模块   | 描述                                                                                        |
|------|-------------------------------------------------------------------------------------------|
| 指标管理 | 管理指标语义定义，支持指标模板下载、导入，支持指标新增、删除、导出。  |
| 模型管理 | 管理大模型配置，支持新增、修改、删除。  |
| 数据源管理 | 管理数据源配置，支持新增、修改、删除。  |
| AI指标口径问答 | 通过自然语言查询相关指标定义口径信息，返回相关的指标口径。  |
| AI生成SQL | 通过自然语言生成SQL查询模板。  |
| AI生成数据 | 通过自然语言生成数据可视化图表。  |


## 🚧 未来计划

| 模块   | 描述                                                                                        |
|------|-------------------------------------------------------------------------------------------|
| 指标资产 | 指标资产血缘可视化展示和查询。  |
| 模型管理 | 新增更多大模型支持。  |
| 数据源管理 | 新增更多数据源支持。  |
| AI指标口径问答 | 优化用户体验。  |
| AI生成SQL | 持续迭代优化。  |
| AI生成数据 | 持续迭代优化。  |
| 指标预警 | 设置指标目标预警管理。  |
| 数据分析 | AI数据分析。  |
| 指标归因 | 指标归因拆解分析。  |
## 演示视频
![指标归因拆解分析.gif](videos/%E6%8C%87%E6%A0%87%E5%BD%92%E5%9B%A0%E6%8B%86%E8%A7%A3%E5%88%86%E6%9E%90.gif)





## 功能配图
| 归因分析 |![归因分析介绍页.png](imgs/%E5%BD%92%E5%9B%A0%E5%88%86%E6%9E%90%E4%BB%8B%E7%BB%8D%E9%A1%B5.png)|![归因分析拆解页.png](imgs/%E5%BD%92%E5%9B%A0%E5%88%86%E6%9E%90%E6%8B%86%E8%A7%A3%E9%A1%B5.png)|
|------|-|----------------------------------------------|
 | 指标资产 | ![指标资产页.png](imgs/%E6%8C%87%E6%A0%87%E8%B5%84%E4%BA%A7%E9%A1%B5.png) |![top折线图.png](imgs/top%E6%8A%98%E7%BA%BF%E5%9B%BE.png)   |
| 指标管理 | ![指标管理.png](imgs/%E6%8C%87%E6%A0%87%E7%AE%A1%E7%90%86.png)           | ![AI指标口径问答.png](imgs/AI%E6%8C%87%E6%A0%87%E5%8F%A3%E5%BE%84%E9%97%AE%E7%AD%94.png) |
| AI生成 | ![表格1.png](imgs/%E8%A1%A8%E6%A0%BC1.png)                             | ![AI生成sql.png](imgs/AI%E7%94%9F%E6%88%90sql.png) |
| AI生成 | ![img.png](imgs/img.png)                                             |![img_1.png](imgs/img_1.png)|
| 管理中心 | ![数据源管理.png](imgs/%E6%95%B0%E6%8D%AE%E6%BA%90%E7%AE%A1%E7%90%86.png) | ![大模型管理.png](imgs/%E5%A4%A7%E6%A8%A1%E5%9E%8B%E7%AE%A1%E7%90%86.png) |
| 指标预警 |![指标预警展示.png](imgs/%E6%8C%87%E6%A0%87%E9%A2%84%E8%AD%A6%E5%B1%95%E7%A4%BA.png)|![指标预警新增.png](imgs/%E6%8C%87%E6%A0%87%E9%A2%84%E8%AD%A6%E6%96%B0%E5%A2%9E.png)|