Hologres：基於Dify和Hologres快速搭建ChatBI應用

背景資訊

Dify是一款開源的大語言模型（LLM） 應用開發平台，它融合了Backend as Service和LLMOps理念，開發人員可以快速搭建生產級的產生式AI應用。非技術人員也能參與到AI應用的定義和資料營運過程中。

前提條件

• 已部署1.2.0或以上版本的Dify。

• 已準備Hologres相關資料，操作詳情如下：

  1. 購買Hologres。

  2. 建立資料庫。

  3. 建立使用者並授予目標資料庫的操作許可權。具體操作，請參見建立自訂使用者和使用者授權。

  4. 準備業務資料。本文以Hologres公用資料集TPC-H 10 GB為例。匯入公用資料集操作詳情，請參見一鍵匯入公用資料集。

注意事項

Dify會通過已配置的使用者訪問Hologres執行個體，需注意以下內容：

• 資源隔離：可以使用Serverless Computing進行資源隔離。

• 許可權隔離：建議僅賦予使用者查詢許可權，更多對於ChatBI的許可權控制詳情，請參見Dify官網文檔。

操作步驟

1. 安裝hologres_text2data和模型工具。本文使用通義千問外掛程式提供模型服務。

   在Dify平台，單擊外掛程式，選擇探索 Marketplace，然後搜尋hologres_text2data和tongyi並單擊安裝。

   

   說明

   hologres_text2data外掛程式，已經上線Dify官方市場，且源碼已經在GitHub上開源。

2. 配置模型供應商。

   1. 選擇我的帳號，然後單擊設定，進入成員頁面。

      

   2. 在左側導覽列中，單擊模型供應商。

   3. 單擊通義千問後面的設定，在彈出的添加 通義千問對話方塊中，填寫API Key。

      您可以在添加 通義千問對話方塊中，單擊從阿里雲百鍊擷取 API Key，擷取API Key。詳情請參見首次調用通義千問API。

   4. 單擊儲存，完成配置。

3. 匯入DSL檔案，構建ChatFlow。

   1. 在Dify平台，選擇功能表列的工作室，然後單擊匯入DSL檔案。

      

   2. 在彈出的對話方塊中，上傳DSL檔案Hologres ChatBI with Holo Plugin-250422-v1.yml。

   3. 單擊建立，完成上傳。

      上傳完成後，系統預設產生如下工作流程。該工作流程採用了百鍊的Qwen-Max-Latest模型，關於更多的模型詳情，請參見模型列表。

      

4. 在目標ChatFlow的編排頁面，單擊hologres_text2data和hologres_excute_sql節點，配置相關Hologres的參數。

   參數名	說明
   資料庫IP/網域名稱	Hologres執行個體的網域名稱，例如：hgprecn-cn-xxxk3ovx003-cn-hangzhou.hologres.aliyuncs.com。 您可以登入Hologres管理主控台，在左側導覽列選擇執行個體列表，單擊目標執行個體ID。在執行個體詳情頁面的網路資訊地區，擷取網域名稱。詳情請參見訪問網域名稱。
   資料庫連接埠	連接埠號碼，預設是80。
   資料庫名稱	已建立的資料庫名稱。 您可以登入Hologres管理主控台，在左側導覽列選擇執行個體列表，單擊目標執行個體ID，進入執行個體詳情頁面。單擊資料庫管理，在DB 授權頁面，擷取資料庫名稱。
   使用者名稱	已建立的使用者名稱稱，格式為：BASIC$<name>。 您可以登入Hologres管理主控台，在左側導覽列選擇執行個體列表，單擊目標執行個體ID，進入執行個體詳情頁面。單擊帳號管理，在使用者管理頁面，擷取使用者名稱稱。詳情請參見使用者管理。
   密碼	使用者對應的密碼。

5. 配置完成後，單擊右上方的發布 > 發布更新。

6. 發布完成後，單擊右上方的發布 > 運行，進入ChatBI應用開始聊天。