# JimuChatBI

**Repository Path**: jeecg/jimuchatbi

## Basic Information

- **Project Name**: JimuChatBI
- **Description**: JimuChatBI 是积木报表推出的对话式智能数据分析产品（Chat2BI），以语义建模构建可信数据底座，让业务同学无需写 SQL、不懂建模，用自然语言即可秒级完成取数、生成 SQL 与可视化图表，把企业 BI 分析变成一场顺畅的对话。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: https://jimureport.com/chat2bi
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2026-05-25
- **Last Updated**: 2026-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">JimuChatBI · Chat2BI</h1>

<p align="center">
  <b>对话式 AI 数据分析工具 —— 一句话描述需求，AI 自动出图表</b>
</p>

<p align="center">
  免费开源 · 企业级 · 用聊天的方式做 BI 分析
</p>

<p align="center">
  <a href="https://jimureport.com/chat2bi">官网</a> ·
  <a href="#快速开始">快速开始</a> ·
  <a href="#功能特性">功能特性</a> ·
  <a href="#技术架构">技术架构</a> ·
  <a href="#源码下载">源码下载</a> ·
  <a href="#快速集成">快速集成</a>
</p>

---

## 简介

**JimuChatBI（Chat2BI）** 是 [积木报表（JimuReport）](https://jimureport.com) 推出的**对话式智能数据分析产品**。它以**语义建模构建可信数据底座**，让业务同学**无需写 SQL、不懂建模**，仅用自然语言即可**秒级完成取数、生成 SQL 与可视化图表**，把企业 BI 分析变成一场顺畅的对话。

> 让数据分析像聊天一样简单——你只管问，AI 负责取数、写 SQL、出图表。

## 源码下载

- GitHub：<https://github.com/jeecgboot/jimureport>
- Gitee：<https://gitee.com/jeecg/jimureport>

## 技术文档

- 🌐 在线体验：<https://jimureport.com/chat2bi>
- 📚 技术文档：<https://help.jimureport.com/chat2bi>
- 🎬 视频教程：<https://www.bilibili.com/video/BV1wBNm6HE6u>

## 快速集成

JimuChatBI 是一个独立 JAR（Spring Boot starter），自动装配嵌入宿主应用，兼容 Spring Boot 4，集成像积木报表一样简单。**前提：宿主应用已集成积木报表。**

### 1. 引入依赖

```xml
<!-- 积木chatbi -->
<dependency>
    <groupId>org.jeecgframework.jimureport</groupId>
    <artifactId>jimuchatbi-spring-boot4-starter</artifactId>
    <version>1.0.0</version>
</dependency>
```

> 前提：需先集成积木报表 `jimureport-spring-boot4-starter` 的依赖，参考文档 <https://help.jimureport.com/quick.html>

### 2. 配置 DeepSeek 大模型

问答要靠大模型生成 SQL，必须先配 AI。默认适配 DeepSeek，采用 OpenAI 接口。

```yaml
jeecg:
  jmreport:
    ai:
      # OpenAI 兼容 base 地址（必填）
      base-url: https://api.deepseek.com
      # API Key（必填，留空则 AI 不可用）
      api-key: sk-??
      # 模型名
      model: deepseek-v4-pro
      # 采样温度，可选
      temperature: 0
      # 单次生成最大 token 数(传给大模型的 max_tokens)，DeepSeek 合法范围[1,393216]
      max-tokens: 16384
```

### 3. 配置 Minidao 扫码路径

这块参考积木报表依赖集成。

```yaml
minidao:
  base-package: org.jeecg.modules.jmreport.*,org.jeecg.modules.drag.*,org.jeecg.modules.chat2bi.*
```

### 4. JimuChatBI 模块升级 SQL

该模块建表脚本请查看：<https://gitee.com/jeecg/jimureport/blob/master/db/jimuchatbi_module_upgrade.sql>

## 功能特性

### 🧱 语义建模 · 可信数据底座
- 通过**语义建模**抽象出业务可理解的指标、维度与口径，构建统一、可信的数据底座
- 业务同学**无需懂建模、无需写 SQL**，即可获得准确一致的分析结果
- 让 AI 取数「问得准、答得对」，避免口径混乱与数据歧义

### 🗣️ 自然语言取数 · NL2SQL
- 用自然语言描述需求，**秒级**完成取数
- 自动生成可查看、可复用的 **SQL**，过程透明可信
- 自动解析意图并生成对应可视化图表，对话式交互告别手工拖拽配置

### 📊 丰富的图表类型
| 类型 | 说明 |
|------|------|
| 柱状图 | 单列 / 多列柱状图 |
| 折线图 | 单行 / 多行折线图 |
| 饼图 | 占比分析 |
| 折柱图 | 折线 + 柱状组合图 |
| 面积图 | 趋势填充展示 |
| 雷达图 | 多维度对比 |
| 仪表盘 | 指标监控 |

### 🔌 多数据源查询
- 兼容 **30 余种数据源**，配置后即可用于图表查询
- 不指定数据源时，默认使用系统数据库
- 支持跨数据源的统一对话式分析

### 🧠 AI 智能体
- 内置 Chat2BI 图表生成智能体，自动完成「解析意图 → 选择数据源 → 查询 → 出图」全流程
- 上下文感知，支持多轮追问与图表迭代

## 技术架构

- **大模型集成**：基于 **LangChain4j**，支持 **DeepSeek / ChatGPT** 等主流大模型一键切换
- **知识增强**：接入 **RAG（检索增强生成）** 知识库，提升语义解析与分析准确性
- **数据接入**：内置 30+ 数据源适配，支持主流关系型数据库
- **可视化**：Web 端图表渲染，覆盖大屏、仪表盘、报表等多种展现形态

## 快速开始

> ⚠️ 当前仓库为初始化状态，代码尚未发布。以下为通用接入流程，请以官方最新发布为准。

```bash
# 克隆仓库
git clone https://github.com/jeecgboot/JimuChatBI.git
cd JimuChatBI
```

配置步骤通常包括：

1. 配置大模型（API Key、选择 DeepSeek / ChatGPT 等）
2. 接入业务数据源
3. 启动服务并进入对话界面开始提问

详细的环境要求与部署说明，请参考[官网文档](https://jimureport.com/chat2bi)。

## 使用示例

在对话界面中直接用自然语言提问，例如：

```
帮我统计各部门今年的销售额，用柱状图展示
近三个月的用户增长趋势，画一张折线图
展示男女用户比例的饼图
对比各产品线营收，用折柱组合图
```

AI 智能体将自动解析意图 → 选择数据源 → 执行查询 → 生成对应图表。

## 相关链接

- 🌐 官网：<https://jimureport.com/chat2bi>
- 📦 源码仓库：<https://github.com/jeecgboot/JimuChatBI>

## 许可证

本项目为开源项目，具体许可证以仓库声明为准。

---

<p align="center">把企业 BI 分析变成一场顺畅的对话 · JimuChatBI（Chat2BI）· 积木报表出品</p>