从零搭建工程造价AI查询助手MVP:Dify+SQL Server实战教程

一、项目目标

前一篇文章实现了Windows本地跑通Dify+Ollama，今天我们实现一个可在飞书 / 网页端调用的造价查询助手的MVP，用户用自然语言提问（如「城东商业综合体的材料明细」），AI 自动转成 SQL 查询，从 SQL Server 中获取数据并返回结果。整体过程还算顺利，最后有最终的视频效果展示。

二、环境准备

1. 核心组件

WSL2（Ubuntu）环境
Docker（运行 SQL Server）
Dify（本地部署）
SQL Server Management Studio（可选，用于手动管理数据）

2. 安装 SQL Server

你可以选择以下两种方式之一安装 SQL Server，推荐使用 Docker 快速部署。

2.1（可选）WSL 原生安装 SQL Server

如果你想在 WSL 中原生部署 SQL Server，可执行以下步骤：

打开 WSL 终端，导入微软 GPG 密钥：

curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-archive-keyring.gpg

sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/22.04/mssql-server-2022.list)"

更新源并安装 SQL Server：

sudo apt update && sudo apt install -y mssql-server

运行配置命令，完成初始化：

sudo /opt/mssql/bin/mssql-conf setup

执行后会提示你接受许可协议，设置 SA 管理员密码（需满足复杂度要求），并选择 SQL Server 版本。

验证服务状态：

systemctl status mssql-server --no-pager

如果输出显示 active (running)，说明安装成功。

2.2（推荐）Docker 快速启动 SQL Server

如果你想快速部署、避免环境冲突，推荐使用 Docker 容器运行 SQL Server：

docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=YourStrongPassword123!" \
  -p 1433:1433 --name sqlserver -d mcr.microsoft.com/mssql/server:2022-latest

注意：密码需满足 SQL Server 复杂度要求，后续配置会用到。

三、数据库与数据准备

1. 创建专用数据库与表

在 SSMS 中执行以下 SQL，创建造价明细表：

USE master;
GO

IF NOT EXISTS (SELECT * FROM sys.databases WHERE name = 'ProjectCostDB')
BEGIN
    CREATE DATABASE ProjectCostDB;
END
GO

USE ProjectCostDB;
GO

IF NOT EXISTS (SELECT * FROM sys.tables WHERE name = 'ProjectCostDetails')
BEGIN
    CREATE TABLE dbo.ProjectCostDetails (
        ID INT IDENTITY(1,1) PRIMARY KEY,
        ProjectName NVARCHAR(100) NOT NULL,
        ModuleCategory NVARCHAR(50) NOT NULL,
        ContractNo NVARCHAR(50) NOT NULL,
        Supplier NVARCHAR(100) NOT NULL,
        MaterialName NVARCHAR(100) NOT NULL,
        TaxInclusivePrice DECIMAL(18,2) NOT NULL,
        TaxRate DECIMAL(5,2) NOT NULL,
        TaxExclusivePrice DECIMAL(18,2) NOT NULL,
        Quantity DECIMAL(18,2) NOT NULL DEFAULT 1,
        TotalTaxInclusivePrice AS (TaxInclusivePrice * Quantity),
        TotalTaxExclusivePrice AS (TaxExclusivePrice * Quantity),
        CreateTime DATETIME NOT NULL DEFAULT GETDATE()
    );
END
GO

2. 插入测试数据

执行以下 SQL，批量导入造价数据：

USE ProjectCostDB;
GO

INSERT INTO dbo.ProjectCostDetails
(ProjectName, ModuleCategory, ContractNo, Supplier, MaterialName, TaxInclusivePrice, TaxRate, TaxExclusivePrice, Quantity)
VALUES
('城东商业综合体项目', '土建工程', 'HT2025-001', '华建建材有限公司', '普通硅酸盐水泥 P.O 42.5', 480.00, 13.00, 424.78, 100),
('城东商业综合体项目', '土建工程', 'HT2025-001', '华建建材有限公司', 'HRB400 螺纹钢 Φ16', 4200.00, 13.00, 3716.81, 50),
('城东商业综合体项目', '安装工程', 'AZ2025-003', '鑫源机电设备厂', '铜芯电缆 YJV-4*16', 28.50, 13.00, 25.22, 2000),
('城东商业综合体项目', '装饰工程', 'ZS2025-005', '美居装饰材料商行', '800*800mm 抛光地砖', 68.00, 13.00, 60.18, 3000),
('城西住宅开发项目', '土建工程', 'HT2025-002', '诚信砂石料厂', '中粗河砂', 120.00, 3.00, 116.50, 500),
('城西住宅开发项目', '安装工程', 'AZ2025-004', '顺达管道有限公司', 'UPVC 排水管 DN110', 32.00, 13.00, 28.32, 800),
('城西住宅开发项目', '机电工程', 'JD2025-006', '汇通电气设备公司', '低压配电柜 GGD', 2800.00, 13.00, 2477.88, 10),
('城北市政道路工程', '市政工程', 'SZ2025-007', '路通沥青材料厂', 'AC-13C 沥青混凝土', 420.00, 13.00, 371.68, 2000),
('城北市政道路工程', '市政工程', 'SZ2025-007', '路通沥青材料厂', '水泥稳定碎石基层', 180.00, 3.00, 174.76, 3000),
('城南产业园一期', '钢结构工程', 'GG2025-008', '恒信钢结构有限公司', 'H 型钢 H300*300', 4850.00, 13.00, 4292.04, 120),
('城南产业园一期', '给排水工程', 'PS2025-009', '清水环保设备厂', 'HDPE 双壁波纹管 DN300', 165.00, 13.00, 146.02, 1000),
('城南产业园一期', '电气工程', 'DQ2025-010', '星光照明工程公司', 'LED 投光灯 200W', 380.00, 13.00, 336.28, 50),
('城南产业园一期', '电气工程', 'DQ2025-010', '星光照明工程公司', '穿线管 PVC Φ20', 2.80, 13.00, 2.48, 5000),
('城南产业园一期', '消防工程', 'XF2025-011', '安盾消防设备公司', '消防水带 DN65', 75.00, 13.00, 66.37, 200),
('城南产业园一期', '消防工程', 'XF2025-011', '安盾消防设备公司', '手提式干粉灭火器 4kg', 115.00, 13.00, 101.77, 100);
GO

四、Dify 工作流搭建（Chatflow 模式）

1. 创建应用

进入 Dify 后台 → 新建应用 → 选择「Chatflow（多轮对话工作流）」
应用名称：工程造价查询助手

2. 核心节点配置

节点 1：SQL 生成器（LLM）

系统提示词：

你是专业的工程造价数据查询专家，只能基于ProjectCostDB库的ProjectCostDetails表生成SQL查询语句。
字段说明：ProjectName(项目名)、ModuleCategory(模块)、ContractNo(合同号)、Supplier(供应商)、MaterialName(材料名)、TaxInclusivePrice(含税单价)、TaxRate(税率)、TaxExclusivePrice(不含税单价)、Quantity(数量)。
规则：只返回可直接执行的SQL，禁止修改/删除语句，用户未指定项目时默认汇总所有数据。

模型选择：DeepSeek-R1 8B（或其他支持复杂指令的模型）

节点 2：TEXT TO SQL（数据库连接）

关键配置（通用兼容版）：
- 数据库 URI：mssql://sa:YourStrongPassword123!@host.docker.internal:1433/ProjectCostDB
- 数据库连接配置选项：留空（避免驱动参数冲突）
- 表名：ProjectCostDetails
- 模型：同 SQL 生成器

节点 3：结果整理器（LLM）

系统提示词：

你是工程造价数据分析助手，负责把数据库返回的原始数据整理成清晰回答：
1. 用一句话总结查询结果
2. 关键数据用Markdown表格展示
3. 自动计算合计、成本占比，给出简要分析

3. 节点连接顺序

START → SQL生成器 → TEXT TO SQL → 结果整理器 → ANSWER

五、关键问题排查（驱动/SSL报错解决）

常见报错 1：connect() got an unexpected keyword argument 'ssl'

原因：不同 Dify 数据库插件底层驱动（pymssql/pyodbc）不兼容 SSL 参数
解决：
1. 数据库 URI 去掉 pymssql 前缀，改为 mssql:// 通用格式
2. 数据库连接配置选项清空，不传递任何 SSL 相关参数

常见报错 2：SSMS 连接时证书验证失败

解决：在 SSMS 登录界面勾选「信任服务器证书」，或通过 SQL Server 配置关闭强制加密。

六、最终效果验证

在 Dify 测试界面提问：城东商业综合体的材料明细，查看是否返回正确表格
数据验证：对比 SSMS 中的原始数据，确保查询结果准确。

📹 视频演示：下方视频展示了工程造价AI查询助手的实际操作效果，包括自然语言提问和查询结果展示。

已关注

关注

重播分享赞

视频详情

七、常用查询 SQL 模板

1. 全部项目总价汇总

SELECT ProjectName 项目名称,
SUM(TotalTaxInclusivePrice) 含税总造价,
SUM(TotalTaxExclusivePrice) 不含税总成本
FROM ProjectCostDetails
GROUP BY ProjectName
ORDER BY 含税总造价 DESC

2. 供应商供货统计

SELECT Supplier 供应商,
SUM(TotalTaxInclusivePrice) 供货含税总额,
COUNT(MaterialName) 供货材料种类
FROM ProjectCostDetails
GROUP BY Supplier
ORDER BY 供货含税总额 DESC

3. 单项目明细查询

SELECT * FROM ProjectCostDetails WHERE ProjectName = @项目名

4. 模块分类成本统计

SELECT ModuleCategory 工程模块,
SUM(TotalTaxInclusivePrice) 模块造价
FROM ProjectCostDetails
GROUP BY ModuleCategory