报表 AI助手 · 配置集成

version 2.5.0+ | 20250622

AI 助手可根据业务描述自动生成 SQL、报表与图表。本篇介绍如何接入大模型；具体使用方法见报表AI助手使用。

按版本选择一种接入方式：

版本	接入方式	配置见
v2.5+（推荐）	基于 Spring AI 直连任意 OpenAI 兼容大模型，无需 JeecgBoot	一、新版配置
v1.9.6 ~ v2.3.x	通过 JeecgBoot AI 工作流调用	二、老版本配置

一、新版配置（v2.5+，Spring AI 直连）

1.1 快速配置

前置条件：

JDK 17+、Spring Boot 3.x
Python 3.12+（AI 助手必须依赖，未安装时会报『未检测到可用的 python / python3 命令』错误；详见附录：Python 环境安装）
一个 OpenAI 兼容大模型端点（DeepSeek、通义千问、OpenAI、本地 Ollama 等）

推荐使用 DeepSeek deepseek-v4-pro 模型
- 国内环境友好，性价比高、中文理解能力强，是报表 AI 助手的最佳搭档。
- API Key 获取步骤： 访问 DeepSeek 开放平台 → 注册/登录 → 进入 API Keys 页面 → 创建 API Key 并复制保存。

在 application.yml 中配置（默认推荐 DeepSeek）：

jeecg:
  jmreport:
    ai:
      base-url: https://api.deepseek.com
      # 厂商控制台申请的 API Key（请替换为自己的）
      api-key: sk-xxxxxxxx
      # 模型名称，其他厂商见 1.2
      model: deepseek-v4-pro
      #确定性输出，默认temperature=0
      temperature: 0
      #如果非deepseek模型，按照支持的最大配置
      max-tokens: 16384
      # AI自动建表（安全警告: 此功能会直接操作数据库DDL/DML，生产环境请勿启用）
      autoTableEnabled: false

配置项	必填	默认值	说明
`base-url`	是	`https://api.openai.com`	OpenAI 兼容端点 base 地址
`api-key`	是	无	模型厂商签发的 API Key
`model`	是	`gpt-4o`	模型名称
`temperature`	否	模型默认	采样温度，越大越发散
`max-tokens`	否	不限	单次响应最大 token 数
`completions-path`	否	`/v1/chat/completions`	仅厂商路径与 OpenAI 不同时才需设置（如 Azure）

若宿主应用已集成 Spring AI（存在 ChatClient.Builder 或唯一 ChatModel Bean），积木会自动复用，无需重复配置上面的参数。客户端内置连接超时 30s、读取超时 300s。

1.2 各厂商参数对照

只要厂商提供 OpenAI 兼容接口即可使用。常用厂商参考配置（base-url 与 model 填入 1.1 的模板即可）：

厂商	`base-url`	`model` 示例	备注
DeepSeek（推荐）	`https://api.deepseek.com`	`deepseek-v4-pro` / `deepseek-chat` / `deepseek-reasoner`	性价比高，推荐首选
OpenAI	`https://api.openai.com`	`gpt-4o` / `gpt-4o-mini`
通义千问（百炼）	`https://dashscope.aliyuncs.com/compatible-mode`	`qwen-plus` / `qwen-max`
智谱（GLM）	`https://open.bigmodel.cn/api/paas`	`glm-4` / `glm-4-plus`	api-key 形如 `xxx.xxx`
Moonshot（Kimi）	`https://api.moonshot.cn`	`moonshot-v1-32k`
火山方舟（豆包）	`https://ark.cn-beijing.volces.com/api`	接入点 endpoint id	model 填开通的接入点 id
硅基流动	`https://api.siliconflow.cn`	`Qwen/Qwen2.5-72B-Instruct`
零一万物（Yi）	`https://api.lingyiwanwu.com`	`yi-large`
百度千帆	`https://qianfan.baidubce.com/v2`	`ernie-4.0-8k`	api-key 形如 `bce-v3/xxx`
本地 Ollama	`http://localhost:11434/v1`	`llama3` / `qwen2.5`	api-key 填任意非空值
LM Studio	`http://localhost:1234/v1`	已加载的模型标识	api-key 填任意非空值
Azure OpenAI	`https://{资源}.openai.azure.com/openai/deployments/{部署}`	`gpt-4o`	需加 `completions-path: /chat/completions?api-version=2024-08-01-preview`

附录：Python 环境安装

最低要求：Python 3.12+（3.11 及以下与新版依赖不兼容，请勿使用）。

AI 助手必须依赖 Python 3.12+ 运行环境，否则启动会报 未检测到可用的 python / python3 命令 错误并失败。安装后无需重启即可重试。

未检测到 Python 的失败提示

安装步骤

下载安装包：https://www.python.org/downloads/ ，选择 3.12.x 或 3.13.x 稳定版
Windows 用户：双击安装包，务必勾选 "Add Python to PATH"，再点 Install Now
macOS 用户：brew install python@3.12
Linux 用户：apt install python3.12 python3-pip（按发行版调整包名）

验证安装

python --version    # 应输出 Python 3.12.x 或更高

常见问题

启动报 未检测到可用的 python / python3 命令 失败：未安装或未加入 PATH。按上面步骤装好 Python 3.12+，无需重启直接重试。
python 不是内部或外部命令：Windows 安装时没勾 "Add to PATH"，重跑安装包 → Modify → 勾上即可。
系统 PATH 已经有 python，但 IDEA 里 Run Spring Boot 仍报未检测到：IDEA 启动时会缓存当时的环境变量，后续 IDEA 内启动的 Java 进程不会自动感知系统 PATH 的更新。修复：Settings → 工具 → 终端 → 环境变量（红框处）把 Path 加上 Python 目录（如 D:\Software\Python314\;D:\Software\Python314\Scripts\），保存后重启 IDEA 即可。
pip 安装依赖太慢（国内网络）：执行 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple 切到清华源。

一、新版配置（v2.5+，Spring AI 直连）​

1.1 快速配置​

1.2 各厂商参数对照​

附录：Python 环境安装​

安装步骤​

验证安装​

常见问题​