DataWorks：建立知識庫提升準確率

配置問題範本

進入知識庫頁面，單擊问题模板頁簽，您可以通過兩種方式新增問題範本：

• 通過頁面配置。

  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. 對比前後效果：記錄配置知識庫前後的問答準確率變化，量化評估改進效果。