使用情境
不同垂直行業的企業在日常分析看數時，常常會使用具有行業和企業特色的商務邏輯、分析思路等，並將這部分知識內容系統性地沉澱為企業專屬的知識體系。而通用AI大模型往往會依賴通用語義理解分析需求，產生的是具有普適性而非貼合企業專屬業務語境與分析習慣的分析結果。
您可以在Quick BI中接入企業已有知識庫，並在發起指令時開啟企業知識庫搜尋、指定分析思路，使小Q在思考過程中能夠調用知識庫內所包含的商務邏輯、分析思路等相關業務知識，輸出更貼合企業自身業務語言與管理邏輯的思考結果。本文將為您介紹如何在Quick BI中接入企業知識庫。
限制說明
進階版及專業版購買智能小Q功能後即可使用企業知識庫。
僅支援組織管理員在組織管理後台進行知識庫配置。
目前支援接入的知識庫類型如下：
知識庫類型
名稱
知識文檔
本地檔案、飛書文檔。
說明僅支援上傳格式為doc、pdf、xls、xlsx、csv的本地檔案，且大小需控制在10M以內。
第三方知識庫
阿里雲百鍊、通義點金、Dify。
功能入口
登入Quick BI的組織管理頁面，在左側導覽列中依次選擇智能小Q > 通用配置 > 知識庫管理員，進入企業知識庫頁面。
您可以在此以添加知識文檔或直連三方知識庫的形式串連企業知識內容，串連成功後即可使用AI召回業務知識，解析並學習重點內容（例如：分析思路、內容範本等），協助您在後續使用智能小Q能力時，能通過調用企業知識庫，擷取更精準、更符合企業實際業務情況的專屬分析結果。
操作步驟
您可以在Quick BI中接入知識文檔及第三方知識庫。
添加知識文檔
如果您所在的企業以本地檔案或線上文檔的形式儲存業務知識，那麼您需要選擇添加知識文檔，具體接入說明如下：
在企業知識庫頁面中，通過串連入口進入配置頁面。不同情況下的入口不同：
如果您從未接入過知識庫，此時企業知識庫頁面為空白態，您需要將滑鼠懸浮至添加知識文檔按鈕，並在下拉式清單中選擇文檔來源。
如果您已經接入過知識庫，此時企業知識庫頁面中將展示當前組織內已接入的所有知識庫及文檔，您需要點擊添加知識文檔按鈕，在添加知識文檔彈窗中選擇文檔來源。
在選擇文檔環節中選擇上傳的知識文件類型，並進行相關配置操作。
當知識文件類型為本地檔案時，您可以點擊或將檔案拖拽到地區 ① 上傳。
說明僅支援上傳格式為doc、pdf、xls、xlsx、csv的本地檔案，且大小需控制在10M以內。
建議上傳結構化資料，避免合併儲存格，以便於提升識別準確性。
如果您上傳的表格有多個sheet，我們將預設採用第一個sheet解析業務定義。
建議使用Chrome瀏覽器上傳。
當知識文件類型為飛書文檔時，您需要配置以下資訊：
配置內容
說明
飛書應用資訊
填入飛書應用的AppKey、AppSecret。
系統將自動為您讀取辦公軟體接入中已授權的飛書應用，您可以在下拉式清單中直接選擇，無需再次輸入應用授權資訊。
若您需要添加新的授權應用，可點擊添加新授權，並輸入待授權應用的AppKey、AppSecret。
請登入飛書開放平台，在已建立的企業自建應用的基礎資訊 > 憑證與基礎資訊頁面中擷取AppKey、AppSecret。
說明請確保授權的飛書應用具備docx:document、docx:document:readonly許可權，您可以聯絡您的飛書組織管理員，在飛書企業自建應用的開發配置 > 許可權管理中添加。
飛書文檔連結
填入飛書文檔的URL連結。
請登入飛書雲文檔，找到需要接入Quick BI的目的文件，複製並儲存分享連結。
說明請確保目的文件在擷取分享連結時，開啟了組織內擷取連結的人可閱讀許可權。
完成文檔配置後點擊串連測試，提示串連測試成功即可繼續選擇確定串連。
串連成功後，您可以在內容預覽環節查看到以下資訊並進行相關操作。
預覽內容
說明
地區 ①
文檔展示名稱
預設讀取原始文檔名作為展示名稱，您也可以根據實際需求自訂修改。該名稱將展示在企業知識庫頁面下的知識文檔列表中。
地區 ②
文檔連結
當知識文件類型為飛書文檔時，在此處將顯示飛書文檔的URL連結。點選連結旁邊的
表徵圖，即可在跳轉新視窗中查看當前文檔在飛書端的來源文件。地區 ③
文檔學習
本地文檔或飛書文檔串連後，系統將會對初始文檔內容進行解析，以識別出文檔本身包含的業務知識類型。可識別的類型包括：商務邏輯、分析思路以及內容範本。
解析完成後，您可以在文檔解析頁簽下，讓系統針對某一知識類型進行學習，以將文檔內容進一步提煉成企業內通用的商務規則。
商務邏輯：點擊商務邏輯卡片中的去學習，將基於當前文檔為您學習業務定義知識，完成後可於商務邏輯頁簽下查看詳情。關於商務邏輯各配置項的具體說明，請參見商務邏輯配置。
分析思路：點擊分析思路卡片中的去學習，將基於當前文檔學習企業分析思路，完成後可於分析思路頁簽下查看詳情。關於分析思路各配置項的具體說明，請參見分析思路配置。
內容範本：點擊內容範本卡片中的去學習，將基於當前文檔學習內容輸出模板，完成後可於內容範本頁簽下查看詳情。關於內容範本各配置項的具體說明，請參見內容範本配置。
說明您也可以點擊智能學習，由Quick BI根據文檔內容自動完成學習並提煉出相應類型的知識；若您不需要學習只需儲存文檔內容，直接點擊完成即可。
目前僅支援對3萬字元以內的內容進行知識類型學習。
學習完成後，需要選中知識類型前的複選框才表示啟用該知識，且文檔添加成功後，此處啟用的業務知識將會自動同步儲存至知識庫管理員的相應模組下。
點擊完成，添加成功後即可在企業知識庫頁面中查看到該知識文檔，您可以在此進行以下管理操作：
地區
可進行的操作
① 切換文件類型
切換查看當前組織下已接入的本地檔案、飛書文檔。
② 搜尋文檔
在列表右上方的搜尋方塊中輸入文檔名稱關鍵字，即可快速篩選、定位包含特定關鍵字的文檔。
③ 查看業務知識
若當前文檔已進行了相關知識類型的學習，文檔標題旁即會顯示對應表徵圖。您可以將滑鼠懸浮至表徵圖上，在彈窗中查看學習詳情。
支援在此：
點擊知識名稱（a），即可跳轉至對應的知識管理頁面下，查看具體的知識內容、按需進行管理操作。
點擊重新學習（b），即可跳轉至編輯知識文檔彈窗的對應知識頁簽下，系統將自動發起重新學習。
④ 編輯知識文檔
點擊文檔名稱，即可在編輯知識文檔彈窗中查看該文檔的解析內容及各類型業務知識的學習、啟用情況。
支援在此：
① 修改文檔展示名稱。
② 調整業務知識啟用狀態及內容：
③ 調整業務知識學習情況：
當您在接入文檔時，未對某一知識類型發起過學習操作，點擊去學習，系統將對該類業務知識進行學習。
當您在接入文檔時，已對某一知識類型發起過學習操作，但遇到知識內容需要更新的情況，例如：因線上文檔內容更新，同步後需要重新讀取，此時即可點擊重新學習，系統將對該類業務知識重新發起學習。
說明您也可以使用智能學習功能，由Quick BI根據文檔內容自動完成學習。
⑤ 飛書文檔同步
當您的飛書文檔在飛書端進行了內容更新，需要同步至Quick BI時，您可以在此進行同步操作：
點擊
表徵圖，即可手動觸發同步任務，同步飛書文檔中的最新內容。
點擊
表徵圖，在查看同步記錄彈窗中，查看當前文檔的同步處理記錄。
⑥ 更多操作
點擊
表徵圖，在下拉式清單中進行更多操作：
a：基於當前文檔內容，發起相關知識類型的學習。
b：當您不再需要使用該文檔時請點擊刪除，二次確認後即可移除該文檔。
⑦ 大量刪除
支援同時選中多個文檔，並進行大量刪除的操作。
表徵圖，即可在跳轉新視窗中查看當前文檔在飛書端的來源文件。串連第三方知識庫
如果您所在的企業以單獨採買並本地部署知識庫的形式儲存業務知識，那麼您需要選擇添加第三方知識庫，具體接入說明如下：
在企業知識庫頁面中，通過串連入口進入配置頁面。不同情況下的入口不同：
如果您從未接入過知識庫，此時企業知識庫頁面為空白態，您需要將滑鼠懸浮至串連第三方知識庫按鈕，並在下拉式清單中選擇需要接入的知識庫類型。
如果您已經接入過知識庫，此時企業知識庫頁面中將展示當前組織內已接入的所有知識庫及文檔，您需要點擊串連知識庫按鈕，在串連三方知識庫彈窗右側的知識庫列表中選擇需要接入的知識庫類型。
在串連知識庫環節中配置知識庫基礎資訊。不同知識庫所需填入的配置資訊不同：
阿里雲百鍊
配置項
說明
擷取方式
API Key
輸入阿里雲百鍊帳號所對應的AccessKey ID。
您可以按照下圖指引，通過阿里雲百鍊平台進入阿里雲使用者資訊頁面，擷取AccessKey ID。
Secret Key
輸入阿里雲百鍊帳號所對應的AccessKey Secret。
在阿里雲使用者資訊頁面點擊建立AccessKey，確認資訊後即可於彈窗中擷取AccessKey Secret。
說明當前視窗關閉後，無法重新查詢Secret，請妥善保管。若丟失AccessKey Secret，需建立新的AccessKey。
業務空間ID
輸入知識庫所在業務空間的ID。
在阿里雲百鍊平台，點擊業務空間旁的
表徵圖，選擇業務空間詳情，即可於彈窗中擷取當前業務空間的ID。
三方知識庫ID
輸入待串連知識庫的ID。
在阿里雲百鍊平台，左側導覽列選擇知識庫，在右側知識庫頁面中找到需接入Quick BI的目標知識庫，滑鼠懸浮至該知識庫並點擊ID旁的
表徵圖即可複製知識庫ID。
通義點金
配置項
說明
擷取方式
API Key
輸入通義點金帳號所對應的AccessKey ID。
在阿里雲使用者資訊頁面擷取當前帳號的AccessKey ID。
Secret Key
輸入通義點金帳號所對應的AccessKey Secret。
在阿里雲使用者資訊頁面點擊建立AccessKey，確認資訊後即可於彈窗中擷取AccessKey Secret。
說明當前視窗關閉後，無法重新查詢Secret，請妥善保管。若丟失AccessKey Secret，需建立新的AccessKey。
業務空間ID
輸入知識庫所在業務空間的ID。
通義點金控制台中暫不支援直接查看並擷取當前業務空間的ID。但同一業務空間，在通義點金的ID與阿里雲百鍊相同，因此您可以通過阿里雲百鍊擷取業務空間ID。
也可以通過瀏覽器內建的開發人員工具查詢到當前業務空間ID。
三方知識庫ID
輸入待串連知識庫的ID。
在通義點金平台，左側導覽列選擇資料中心 > 文件庫，在右側文件庫列表中找到待接入Quick BI的目的文件庫，點擊其ID欄左側
表徵圖即可複製文件庫ID。
Dify
配置項
說明
擷取方式
API Key
輸入Dify帳號所對應的API Key。
在Dify平台的知識庫頁面中，左側導航切換至API頁面。在該頁面中您可以查看到Dify提供的知識庫API文檔，並在API密鑰中管理可訪問知識庫API的憑據。
三方知識庫ID
輸入待串連知識庫的ID。
進入Dify平台的知識庫頁面，在當前頁面的URL地址中擷取知識庫ID。
完成資訊填寫後點擊串連測試，提示串連測試成功即可繼續選擇確定串連。
串連成功後，您可以在召回測試環節進行以下配置。
配置內容
說明
地區 ①
知識庫展示名稱
自訂輸入當前知識庫的展示名稱。
該名稱後續將展示於小Q對話方塊中的知識庫挑選清單，您可以根據知識庫的歸屬部門或實際業務意義命名，協助使用者快速識別和選擇知識庫。
地區 ②
召回設定
設定召回的Top K及自訂Score閾值，以控制從知識庫中檢索內容的數量和品質。
Top K：用於篩選與使用者問題相似性較高的文本片段的數量。數值越高，召回存在相關性的文本分段也就越多。
該參數預設值為3，上限值為10。
自訂Score閾值：用於設定文本片段篩選的相似性閾值。數值越高，說明對文本與問題要求的相似性要求越高，預期被召回的文本數量越少，結果也會相對更精準。
該參數預設為關閉狀態，開啟後可手動調整閾值，上限值為1。
地區 ③
測試文本
輸入測試文本以驗證知識庫的召回效果。
地區 ④
召回結果
在地區 ③ 中輸入測試文本並點擊測試後，即可在地區 ④ 中查看到召回結果。若結果不符合預期，您可以重新調整Top K及自訂Score閾值。
點擊某個召回結果卡片，可以查看該切片詳情。
點擊完成，添加成功後即可在企業知識庫頁面中查看到該知識庫，您可以在此進行以下操作：
① 停用知識庫：知識庫添加成功後預設為開啟狀態，點擊
表徵圖即可轉為停用。說明僅支援同時啟用10個知識庫。
② 編輯知識庫：點擊
表徵圖，即可在串連三方知識庫彈窗中修改知識庫資訊。③ 刪除知識庫：點擊
表徵圖，二次確認後即可刪除不再需要使用的知識庫。