實踐：搭建知識庫問答助手
本篇以「為單位搭建一個基於內部制度文件嘅問答助手」為例，帶你行完由建立知識庫、召回驗證、編排對話流、調試測試到發佈上線嘅完整流程。適合首次喺 LanSphere 上搭建對話類應用嘅開發人員同管理員閱讀。
場景與價值
單位嘅規章制度、管理辦法通常散落喺多份文件中，日常諮詢高度依賴人工答疑：
- 員工遇到問題要翻多份文件，搵唔到、睇得慢；
- 人事行政部門反覆回答同類問題，佔用大量精力；
- 唔同人答覆口徑唔一致，容易引發爭議；
- 新文件下發後，舊答覆仲喺度流傳，資訊滯後。
將制度文件放入知識庫，讓對話流基於知識庫作答：員工隨時自助提問，答案有據可查、口徑統一，人事行政部門亦可以由重複答疑中解放出嚟。
你將搭建咩
一個「制度問答助手」對話流應用：員工喺對話中提問，應用由制度知識庫中檢索相關內容，由大模型組織語言回答並標註引用來源；查唔到嗰陣明確話知，唔編造。最終將應用發佈到應用廣場，並上架藍信客戶端「AI 助理市場」，全單位員工喺藍信中即可使用。
整體鏈路：知識庫（制度文件）→ 對話流（輸入 → 知識庫 → 大模型 → 回覆）→ 發佈（應用廣場 + 藍信 AI 助理）。
推薦流程
| 步驟 | 說明 |
|---|---|
| 1 建立知識庫 | 簡易模式上載制度 PDF，揀「通用文件問答」分段策略，向量索引 + 重排序模型 |
| 2 召回測試 | 用典型問題驗證召回片段、匹配度同來源，唔合格先調知識庫 |
| 3 編排對話流 | 輸入 → 知識庫（Top K 3、混合檢索）→ 大模型（約束提示詞）→ 回覆 |
| 4 設定對話功能 | 開場白、引用歸屬、敏感詞審查 |
| 5 調試測試 | 覆蓋「應該答啱」同「應該拒答」兩類用例，多輪追問驗證記憶 |
| 6 發佈上線 | 儲存 → 發佈到應用廣場 → 發佈到藍信 AI 助理 |
準備工作
| 項目 | 要求 |
|---|---|
| 平台角色 | 開發人員及以上（建立知識庫、編排對話流）；發佈到藍信 AI 助理需管理員及以上 |
| 資源歸屬 | 發佈到藍信僅限本人建立嘅應用，建議全程使用同一帳號操作 |
| 藍信綁定 | 發佈前確認帳號已綁定藍信（「個人中心 → 綁定藍信」） |
| 制度文件 | PDF 格式，單檔案唔超過 15MB（亦支援 DOCX、TXT、MD、XLSX、XLS、CSV 等） |
| 模型 | 對話大模型可用；向量模型（必選）同重排序模型（建議）已喺「模型列表」中設定，未設定請聯絡管理員 |
第一步：建立知識庫
- 進入「左側選單 → 知識庫」，點擊「建立知識庫」，構建模式選擇「簡易」（標準建立）。
- 基本資料：填寫名稱（必填，唔超過 30 字符，例如「單位制度知識庫」）同描述（選填）。
- 上載檔案：上載制度 PDF 檔案。
- 分段策略：選擇預設策略「通用文件問答」。該策略為父子分段·段落模式，子塊最大 512，適合制度條款呢類按段落組織嘅文件，唔使手動調整分段規則。
- 參數確認：父子分段模式下索引方式鎖定為「向量索引」；選擇向量模型（必選），建議同時選擇重排序模型以提升召回精度。
- 確認建立：頁面逐檔案顯示處理進度，全部成功後點擊「進入知識庫」。
注意：向量索引選定後唔支援切換返關鍵字索引；之後向該知識庫追加檔案嗰陣，自動沿用建立嗰陣嘅分段模式，唔可變更。
第二步：召回測試驗證知識庫
知識庫建立後先唔好急住編排應用，先做召回測試，確認「問得到、問得準」：
- 進入啱啱建立嘅知識庫，開啟召回測試功能（按頁面提示進入）。
- 輸入幾個典型問題，例如「年假有幾多日」「出差住宿標準係幾多」。
- 查看召回片段、匹配度同來源文件：
- 召回片段確實包含答案 → 知識庫可用，進入下一步；
- 召回片段唔相關或為空 → 先處理知識庫分段問題（見文末「驗證與調優」），唔好帶住問題上畫布。
提示：召回測試階段試多幾種問法（口語化問法、簡稱），呢啲就係員工真實嘅提問方式。
第三步：編排對話流
- 點擊「新建項目」，應用類型選擇「對話流」，填寫應用名稱（例如「制度問答助手」）。
- 進入「應用開發」頁籤嘅畫布，「輸入」節點預設存在，作為對話入口。
- 點擊新增「知識庫」節點，連接喺「輸入」節點之後：
- 關聯知識庫：選擇啱啱建立嘅「單位制度知識庫」；
- 檢索方式：選擇「混合檢索」（語義與關鍵字加權，對條款編號、專有名詞更友善）；
- Top K：保持預設 3；
- 已設定重排序模型嗰陣，可啟用以提升精度。
- 點擊新增「大模型」節點，連接喺「知識庫」節點之後。選擇對話模型，將知識庫節點嘅檢索結果作為上下文傳入，並編寫提示詞：
你係單位嘅制度問答助手，負責依據知識庫檢索結果回答員工關於規章制度嘅問題。
【知識庫檢索結果】
（此處插入知識庫節點嘅輸出變數）
請嚴格遵守以下規則：
1. 僅依據上方檢索結果回答，唔可以使用檢索結果以外嘅任何資訊。
2. 檢索結果中冇答案嗰陣，明確回覆「未喺現行制度文件中搵到相關規定」，
並建議員工諮詢人事行政部門，唔好編造條款或數字。
3. 回答末尾標註引用來源，格式：來源：《檔案名》相關章節。
4. 分條陳述，語言簡潔正式；與制度無關嘅問題，禮貌說明本助手僅解答制度問題。提示：提示詞中嘅上下文請透過畫布嘅變數選擇器插入知識庫節點嘅輸出變數，佔位寫法以實際變數名為準。
- 點擊新增「回覆」節點，連接喺「大模型」節點之後，回覆內容引用大模型節點嘅輸出。對話流透過「回覆」節點向用戶輸出訊息。
第四步：設定對話功能
喺對話流嘅功能設定中開啟以下能力（按頁面提示完成設定）：
| 功能 | 設定建議 | 作用 |
|---|---|---|
| 開場白 | 開啟，預設 2-3 個常見問題（例如「年假點樣申請？」） | 首次進入自動展示，引導員工提問 |
| 引用歸屬 | 開啟 | 回答標註引用嘅知識庫來源，增強可信度 |
| 敏感詞審查 | 開啟 | 對輸入同輸出做敏感內容審查，符合單位合規要求 |
第五步：調試與典型問題測試
- 使用整體調試進行多輪對話測試，每輪查看各節點嘅輸入、輸出同報錯；過往記錄可喺「調試歷史」中回睇。
- 按下表覆蓋兩類用例——應該答啱嘅要答準，應該拒答嘅要拒答：
| 類型 | 測試問題示例 | 預期表現 |
|---|---|---|
| 應該答啱 | 「年假有幾多日？點樣申請？」 | 依據制度文件分條回答，標註來源 |
| 應該答啱 | 「出差住宿標準係幾多？」 | 引用對應文件中嘅標準條款 |
| 應該答啱 | 「試用期幾耐？」（口語化問法） | 能召回相關條款並正確回答 |
| 應該拒答 | 「飯堂今日中午食咩？」 | 明講知識庫中冇相關規定，唔編造 |
| 應該拒答 | 「幫我寫一份年終總結」 | 禮貌說明僅解答制度相關問題 |
- 多輪追問測試：先問「年假有幾多日」，再追問「咁探親假呢」，確認多輪記憶正常、上下文唔會串。
第六步：儲存與發佈
- 儲存：點擊「儲存」，草稿僅本人可見。
- 發佈到應用廣場：儲存最新內容後，點擊「儲存」按鈕下拉 →「發佈到應用廣場」。上架後平台內全員（包括閱覽成員）可見可用，適合先細範圍試用、收集回饋。
- 發佈到藍信 AI 助理（需管理員及以上角色）：
- 進入應用詳情頁「發佈渠道」頁籤，選擇「藍信 AI 助理」渠道；
- 帳號已綁定藍信：確認彈出視窗後直接發佈；未綁定：按彈出視窗引導跳轉藍信授權認證中心，掃碼認證通過後自動執行發佈；
- 助理標題預設沿用應用名稱（唔超過 10 字）、描述預設沿用應用說明（唔超過 20 字），命名嗰陣請留意長度限制；
- 發佈後按鈕變為「已發佈」變灰，唔可以重複發佈；系統自動喺藍信側建立應用同機械人實例，上架藍信客戶端「AI 助理市場」。
員工側體驗：喺藍信「AI 助理市場」睇到助理頭像、標題同描述，點擊進入；首次使用需完成數據授權，同意授權後先可以對話；若拒絕就冇辦法使用，再次進入會重新推送授權卡片。
驗證與調優
上線後喺「對話日誌」頁籤查看真實提問，對回答標記好評/差評並新增標註回覆，按下表針對性調優：
| 現象 | 可能原因 | 調整方法 |
|---|---|---|
| 答非所問 | 召回片段唔相關 | 用召回測試覆查；調大 Top K；啟用重排序模型 |
| 編造答案（幻覺） | 提示詞約束唔夠 | 強化「僅依據知識庫回答、冇答案明講」規則；確認已開啟引用歸屬 |
| 已有條款查唔到 | 文件分段唔合理 | 查看分段結果；條款被截斷嗰陣調整分段策略後重建知識庫 |
| 回答冗長、離題 | 輸出未限定 | 喺提示詞中限定分條陳述同篇幅 |
驗收要點
- 制度類問題回答準確，內容與文件原文一致，末尾標註引用來源；
- 知識庫中冇嘅問題明確拒答，唔編造條款、唔編造數字；
- 多輪追問上下文連貫，引用歸屬正常展示；
- 藍信「AI 助理市場」中可見該助理，終端用戶完成數據授權後可正常對話。
擴展思路
- 開啟「檔案上載」，讓員工臨時上載一份文件參與問答；
- 開啟「推薦提問」，根據本輪回答自動推薦下一輪問題，提升連續使用體驗；
- 喺畫布中加入「意圖識別」節點，將制度諮詢與其他事務分流到唔同分支；
- 透過「發佈渠道 → API 存取」將問答能力接入單位內部系統。