创建知识库提升准确率

配置问题模板

进入知识库页面，单击问题模板页签，您可以通过两种方式新增问题模板：

• 通过页面配置。

  1. 在知识库页面，单击新增，进入新建问题模板页面。

  2. 配置问题模板的相关参数：

     参数	描述
     问题	定义在会话中的常用问题，例如： 门店A中商品B的月度销售额趋势。 问题中支持以${参数名}格式包含变量，若在此处定义变量，须在参数处补充变量的枚举值或样本值。变量定义如： ${shopName}中${commodityName}的月度销售额趋势。
     SQL	基于问题描述提供能够准确、正确执行的数据查询SQL。 若问题中包含${参数名}，则SQL中也需要包含同名参数，例如： SELECT shop_name, commodity_name, sales, month FROM ads_order_table WHERE shop_Name = ${shopName} AND commodity_Name = ${commodityName} ORDER BY month;
     参数	若问题和SQL中包含${参数名}，请补充参数的枚举值或样本值，例如： ${参数名}: [“参数值1”,”参数值2”,”参数值3”]
     数据集	指定该问题模板对哪些数据集生效。若不指定，则全局生效。

  3. 配置完成，单击保存。

• 通过本地文件批量导入。

  1. 在知识库页面，单击导入新增。

  2. 在导入弹窗中，单击下载模板，在模板中填写问题模板、模板脚本、模板参数和数据集。各参数解释与通过页面配置类似。

  3. 拖拽本地文件或单击弹窗中的＋，选择需要导入的文件。

  4. 添加完成后，单击确认。

配置术语管理

进入知识库页面，单击术语管理页签，您可以通过两种方式新增术语：

1. 通过页面配置。

   1. 单击新增，进入新建术语管理页面。

   2. 配置问题模板的关键参数：

      参数	描述
      术语	业务交流和分析中涉及到的常用和专业词汇，例如：月环比。
      别名	术语的同义词、缩写、全称、多语言翻译等。输入别名后回车，支持添加多个别名。
      数据集	指定该问题模板对哪些数据集生效。若不指定，则全局生效。

   3. 配置完成，单击保存。

2. 通过本地文件导入。

   1. 在知识库页面，单击导入新增。

   2. 在导入弹窗中，单击下载模板，在模板中填写术语、别名、描述和数据集。各参数解释与通过页面配置类似。

   3. 拖拽本地文件或单击弹窗中的＋，选择需要导入的文件。

   4. 添加完成后，单击确认。

配置业务逻辑

进入知识库页面，单击业务逻辑页签，您可以通过两种方式新增业务逻辑：

1. 通过页面配置。

   1. 进入新建业务逻辑页面。

   2. 配置问题模板的关键参数：

      参数	描述
      业务概念	业务交流和分析中涉及到的常用概念的名称，例如：有效订单。
      逻辑解释	对业务概念的名称下一个定义，例如：ord_cnt_1d>0 表示有效订单。
      数据集	指定该问题模板对哪些数据集生效。若不指定，则全局生效。
      字段	选择数据集后，可选择数据集下的表中字段，将业务概念跟物理表/字段进行关联。

   3. 配置完成，单击保存。

2. 通过本地文件批量导入。

   1. 在知识库页面，单击导入新增。

   2. 在导入弹窗中，单击下载模板，在模板中填写业务概念、逻辑解释、关联表字段和数据集。各参数解释与通过页面配置类似。

   3. 拖拽本地文件或单击弹窗中的＋，选择需要导入的文件。

   4. 添加完成后，单击确认。

编辑知识库对象

1. 在页面左侧导航栏单击知识库，进入知识库页面。

2. 在知识库页面的各个对象的页签中，单击操作列的编辑，进入编辑页面。

   各参数解释与配置知识库保持一致。

查看知识库对象

• 您可以在知识库各个页签顶部的搜索框中输入关键字后回车，对搜索对象进行快捷定位。

• 您也可以单击某个知识库对象，查看该对象的详情。

删除知识库对象

在知识库各个页签，找到已添加的知识库对象，单击操作列的删除，将该对象从知识库中删除。

场景说明

某电商企业使用 ChatBI 分析销售数据，底层表结构如下：

• 表名：ads_order_table

• 关键字段：shop_name（门店名称）、product_name（商品名称）、sales_amount（销售额）、order_date（订单日期）、valid_order_flag（有效订单标志，1 表示有效）

案例1：问题模板的价值

SELECT SUM(sales_amount)
FROM ads_order_table
WHERE shop_name LIKE '%华东%'
  AND product_name LIKE '%iPhone%'
  AND order_date >= '2026-02-01'
  AND order_date < '2026-03-01';

SELECT SUM(sales_amount) as total_sales
FROM ads_order_table
WHERE shop_name = ${shopName}
  AND product_category = ${productCategory}
  AND order_date >= ${startDate}
  AND order_date < ${endDate}
  AND valid_order_flag = 1;

${shopName}: ["华东区旗舰店","华南区旗舰店","华北区专卖店"]
${productCategory}: ["iPhone","iPad","MacBook","AirPods"]
${period}: ["上个月","本月","上周","本周"]

SELECT SUM(sales_amount) as total_sales
FROM ads_order_table
WHERE shop_name = '华东区旗舰店'
  AND product_category = 'iPhone'
  AND order_date >= '2026-02-01'
  AND order_date < '2026-03-01'
  AND valid_order_flag = 1;

案例2：术语管理的价值

WITH monthly_sales AS (
  SELECT
    DATE_FORMAT(order_date, '%Y-%m') as month,
    SUM(sales_amount) as sales
  FROM ads_order_table
  WHERE shop_name = '华东区旗舰店'
    AND valid_order_flag = 1
    AND order_date >= '2026-01-01'
    AND order_date < '2026-03-01'
  GROUP BY DATE_FORMAT(order_date, '%Y-%m')
)
SELECT
  (curr.sales - prev.sales) / prev.sales * 100 as mom_growth_rate
FROM monthly_sales curr
JOIN monthly_sales prev
  ON prev.month = '2026-01'
  AND curr.month = '2026-02';

案例3：业务逻辑的价值

SELECT SUM(sales_amount)
FROM ads_order_table
WHERE shop_name = '华东区旗舰店'
  AND order_date >= '2026-02-01'
  AND order_date < '2026-03-01';

SELECT SUM(sales_amount) as valid_sales
FROM ads_order_table
WHERE shop_name = '华东区旗舰店'
  AND order_date >= '2026-02-01'
  AND order_date < '2026-03-01'
  AND valid_order_flag = 1
  AND sales_amount > 0;

如何验证知识库生效

配置知识库后，您可以通过以下方式验证其是否生效：

1. 在 ChatBI 会话中提问：使用配置的问题模板中的示例问题进行提问，查看生成的 SQL 是否符合预期。

2. 测试术语识别：在问题中使用配置的术语别名（如"MoM"），观察 ChatBI 是否能正确理解。

3. 验证业务逻辑：询问涉及业务概念的问题（如"有效订单"），检查生成的 SQL 是否包含正确的业务逻辑过滤条件。

4. 对比前后效果：记录配置知识库前后的问答准确率变化，量化评估改进效果。