基於Dify+NL2SQL搭建ChatBI - Data Management

Dify on DMS+NL2SQL構建的ChatBI重新定義了資料分析方式，ChatBI可通過AI工具理解使用者問題並使用自然語言回答，然後通過NL2SQL將自然語言處理為SQL，並在Dify中執行SQL，以可視化方式展示執行結果。該ChatBI方案可以將資料分析從技術團隊擴充至全員、提升業務響應速度，讓您輕鬆擷取資料洞察。

前提條件

已成功部署Dify。
Dify on DMS版本已升級至V1.4.3。更多資訊，請參見查看Dify版本。

步驟一：安裝ChatBI依賴的AliyunDMS外掛程式

登入Data Management 5.0。
單擊控制台左上方的表徵圖，選擇全部功能 > Data+AI > Dify。
說明
若您使用的是非極簡模式的控制台，請在頂部功能表列中，選擇Data+AI > Dify。
單擊目標空間名稱。
在工作空間左側導覽列選擇 > 工作室。
單擊右上方的外掛程式，再單擊安裝外掛程式。
選擇安裝源並安裝通義千問和AliyunDMS外掛程式。
- 請通過Marketplace安裝通義千問外掛程式。
- 請通過DMS外掛程式安裝AliyunDMS外掛程式。
等待外掛程式安裝成功。
當外掛程式列表出現AliyunDMS和通義千問外掛程式表示安裝成功。

步驟二：給AliyunDMS外掛程式授權

單擊AliyunDMS外掛程式，再單擊去授權。
請根據您需要使用的外掛程式版本，選擇是否配置DMS API Key。
說明
- 如果您僅需要使用基礎版的DMS SQL執行器，則無需填寫DMS API Key，直接單擊儲存。
- 如果您需要使用企業版的外掛程式（例如企業版SQL執行器、企業版NL2SQL演算法），則需要填寫DMS API Key。DMS API Key由當前登入DMS的阿里雲帳號的AccessKey ID和AccessKey Secret組成，其填寫格式為<AccessKey ID>:<AccessKey Secret>。
單擊儲存。
當組件頁面出現已授權，表示授權成功。

步驟三：為通義千問模型配置API Key

在工作室頁面，單擊帳號名稱，選擇設定。
在模型供應商頁面，單擊通義千問模型右側的設定，為其配置API Key。
請前往阿里雲百鍊擷取API Key。
單擊儲存。

步驟四：應用ChatBI模板

在工作室 > 全部頁面，單擊從應用模板建立。
在左側分類導覽列，單擊DMS Data+AI。
其中內建了DMS提供的一系列模板。
將滑鼠指標懸停在ChatBI一鍵體驗（整合版）卡片，然後單擊該卡片出現的使用該模板。
在彈出的對話方塊，單擊建立。
當頁面出現ChatBI一鍵體驗區塊，則表示建立成功。

步驟五：運行Demo並體驗ChatBI Agent

單擊ChatBI一鍵體驗模板。
ChatBI模板內建一套Demo資料集，您可單擊右上方的預覽，體驗ChatBI Agent。
單擊右上方的預覽，體驗ChatBI Agent。
您可對Agent進行提問，以查詢相關資料。

步驟六：配置您自己的ChatBI應用

單擊，編輯db_connection_url變數，將其值更換為目標資料庫的私網或公網串連地址。
說明
db_connection_url是工作流程中使用的全域環境變數。當變數值為demo_db時，會自動載入外掛程式內建的資料集。
支援的資料庫類型及串連地址格式如下：
- MySQL：mysql+pymysql://<user>:<password>@<host>:<port>/<database>。
- PostgreSQL：postgresql+psycopg2://<user>:<password>@<host>:<port>/<database>。
- SQL Server：mssql+pymssql://<user>:<password>@<host>:<port>/<database>。
- Oracle：oracle+oracledb://<user>:<password>@<host>:<port>/<service_name>。
- Clickhouse：clickhouse+native://<user>:<password>@<host>:<port>/<database>。
- MongoDB：mongodb://<user>:<password>@<host>:<port>/<database>"。
單擊儲存。
根據資料庫連接方式，在資料庫白名單中添加Dify的出口IP或內網IP。
- 如果您需要通過公網串連資料庫，則需要在資料庫的白名單中添加Dify公網出口IP。
  您可運行查詢DIFY公網出口IP節點以獲得具體IP。
- 如果您是通過VPC串連資料庫，則需要在資料庫白名單中添加Dify所在VPC的IPv4網段。
IP添加成功後，單擊預覽，向Agent提問目標資料庫中資料的相關資訊。

AliyunDMS企業版與基礎版外掛程式能力說明

外掛程式名稱	能力說明	ChatBI企業版	ChatBI基礎版
DMS NL2SQL（基礎版）	內建NL2SQL演算法（敏捷版）。敏捷版自然語言轉SQL演算法，即時資料流式輸出SQL結果。	√	√
DMS NL2SQL（企業版）	內建NL2SQL演算法（企業版），且具備如下特性：提供簡潔直觀的知識庫配置介面。先進的自然語言轉SQL演算法，可實現精準的查詢轉換。無需設定資料庫帳號和密碼。	√	×
DMS SQL執行器（基礎版）	需要使用資料庫帳號、密碼串連資料庫，再執行SQL。支援串連MySQL、PostgreSQL、SQL Server、Oracle、ClickHouse、MongoDB資料庫。	√	√
DMS SQL執行器（企業版）	採用免密認證機制，無需在工作流程中設定資料庫帳號和密碼，可有效防範帳號和密碼泄露風險。支援串連30+種主流資料來源。強大的企業級管控能力：精細化的資源存取權限管理。完整的Action Trail追蹤。嚴格的SQL規範合規檢查。	√	×
DMS資料視覺效果	將SQL執行結果轉換為ECharts圖表，支援柱狀圖、折線圖、餅圖和表格。	√	√

使用ChatBI企業版

如果您需要使用ChatBI企業版模板，在步驟四：應用ChatBI模板時，選擇ChatBI一鍵體驗（企業版）模板即可完成對應的建立。

注意事項

在使用ChatBI企業版能力前，請確保授權AliyunDMS外掛程式的DMS API KEY由當前登入DMS的阿里雲帳號建立。

企業版外掛程式配置說明

DMS NL2SQL

在配置該外掛程式之前，請先將目標資料庫執行個體錄入至DMS，並為執行個體開啟安全託管。

參數說明：

問題：請填寫需要轉換為SQL的自然語言。
DMS管理的資料庫：選擇已託管至DMS的資料庫類型及資料庫。
DMS API KEY：調用外掛程式所需的DMS API KEY，填寫後將覆蓋外掛程式授權時填寫的DMS API KEY。
業務知識：填寫業務情境特有的領域知識，用於提升NL2SQL的準確性。
模型：選擇用於產生SQL的LLM（Large Language Model）。當前預設使用DMS-AI/XiYan-SQL-32B，若選擇自適應模型，則NL2SQL演算法會根據問題的難易程度自動選擇合適的模型。
私人部署模型：私人部署模型的ID
推理深度：NL2SQL演算法的推理深度，程度越深，產生SQL所需的時間越長，可選標準（推薦）、進階、深度思考。當前預設使用標準（推薦），效能較為均衡。

DMS SQL執行器

參數說明：

SQL：需要執行的SQL。
DMS管理的資料庫：選擇已託管至DMS的資料庫類型及資料庫。
DMS API KEY：調用外掛程式所需的DMS API KEY，填寫後將覆蓋外掛程式授權時填寫的DMS API KEY。
地區ID：選擇當前Dify所在地區。
輸出格式：可選擇Markdown或JSON，當前預設使用Markdown。
逾時時間：執行SQL的逾時時間。