所屬模組： Knowledge（可選）
Wireframe： 開啟互動原型 → 側邊欄「知識庫」（含搜尋、AI 問答、文件管理）

解決什麼問題

IT 知識存在資深工程師的腦袋裡。人一離職，知識就跟著走。新人遇到問題只能一直問同事，SOP 文件散落在共享資料夾，找不到、版本混亂、沒人維護。

核心能力

文件管理

上傳 PDF、Word、Markdown 文件，系統自動解析、切片、向量嵌入。支援批次上傳、處理狀態追蹤、版本控制。

支援格式：PDF (.pdf)、Word (.docx)、Markdown (.md)、純文字 (.txt)。單檔上限 50MB。

文件處理狀態：

狀態	說明
處理中	系統正在解析、切片、向量嵌入（背景執行，可離開頁面）
就緒	處理完成，文件可被搜尋和 AI 問答引用
錯誤	處理失敗（格式不支援、檔案損壞等），可點「重新處理」重試

文件 metadata（兩欄概念）：

欄位	性質	說明
分類	單選，必填	從預設 6 類擇一：政策 / SOP / 技術 / 教育訓練 / 法規 / 裁罰。使用者不可新增分類（避免 long tail，業界慣例）
標籤	多選，選填	使用者自訂字串陣列（可空）。多選且自由輸入，作為彈性補充

文件表格欄位：

欄位	說明
文件名稱	上傳時的檔案名稱（小字註記最近更新日期）
知識庫	所屬分區（內部 SOP / 技術文件 / 法規裁罰 / 外部法規 / 內部規範）
分類	1 個 badge（從預設 6 類擇一）
標籤	0 ~ N 個 badge；超過 2 個顯示前 2 + 「+N」省略
狀態	就緒 / 處理中 / 錯誤
版本	目前版本號（v1, v2, v3...）
操作	依狀態顯示不同操作（見下方）

文件操作（依狀態）：

狀態	主要操作	更多選單（⋯）
就緒	新版	下載 / 編輯資訊（名稱、分區、分類、標籤）/ 版本歷史 / 刪除
處理中	—（等待完成）	—
錯誤	重新處理	刪除

• 新版：上傳新版本的同一份文件 → 建立 v(N+1) → 重新解析/切片/嵌入 → 舊版標為歷史版本
• 版本歷史：查看所有版本清單，每個版本可下載或「恢復為目前版本」
• 刪除：移除文件（含所有版本），需二次確認「確定刪除？此操作無法復原」

版本控制行為：點「新版」→ 上傳新檔案 → 系統建立新版本（v1 → v2），舊版本保留在版本歷史中可查看和下載。目前版本是被搜尋和 AI 引用的唯一版本。

批次上傳：點「上傳文件」→ 支援拖曳多檔或資料夾 → 選擇目標知識庫分區 → 全部開始背景處理。

搜尋文件：搜尋範圍為文件名稱、分類、標籤，即時篩選表格。

知識庫分區

把文件分類到不同知識庫（如「內部 SOP」「法規裁罰」「技術文件」），每個知識庫可設定存取權限。

合規智能功能新增兩個專用分區：

• 外部法規：存放政府法規文件（金管會、央行、ISO 標準等），供 Compliance Agent 做法規差異比對
• 內部規範：存放公司內部 IT 規範文件，作為比對基準

兩個分區配合 AI Copilot 的法規差異比對指令使用，詳見 合規智能。

分區管理（KB-006）

「文件」tab 內 [管理知識庫分區] 按鈕點擊 → 開啟 modal-manage-partitions（沿用 admin modal 模式，不開新頁）。Modal 內提供：

• 分區列表：每列顯示分區名稱、文件數、可見角色 badge、[編輯] [刪除] action
• [+ 新增分區] 按鈕 → 開啟新增/編輯表單，欄位：
  • 分區名稱（必填）
  • 說明（選填）
  • 可見角色（multi-select：所有人 / IT 團隊 / IT 主管 / 管理員 / 自訂）
• 編輯：相同欄位表單預先填入現值
• 刪除：二次確認 modal，警示「分區內 N 份文件將移到『未分類』」；確認後文件 fallback，不級聯刪除文件

「未分類」系統預留分區：作為刪除分區後的 fallback 容器。「未分類」不顯示在分區列表，使用者不可編輯/刪除它。文件表格的「知識庫」欄可能顯示「未分類」字樣（識別用），但分區 badge 列表（搜尋 tab 上方）不出現「未分類」可選 badge。

空狀態與初次體驗

場景	觸發條件	顯示文案	CTA
KB 完全空	無分區 + 無文件	「知識庫是空的。上傳您的 SOP 文件，AI 才能回答問題和自動回覆 Email。」	[上傳文件] [了解更多]
有分區無文件	已建分區但分區內無文件	「此分區尚無文件，點上傳文件開始」	[上傳文件]
搜尋無結果	已搜尋但無命中	見「統一搜尋」段「找不到資料」處理	—

統一搜尋（Unified Search）

知識庫主頁只有一個搜尋框。使用者輸入問題後，系統同時做兩件事：用語意理解找出最相關的文件、再讓 AI 讀完文件整理出結構化答案。兩者同框出現——上方是 AI 答案，下方是來源文件列表。

不再要求使用者先決定「我是要搜文件還是要問 AI」，這對齊業界 unified search 模式（Notion AI、Guru、ServiceNow Now Assist）。

混合視圖佈局：

┌─────────────────────────────────────────┐
│ 🔍 [搜尋框]                  [純文件搜尋 ☐] │
├─────────────────────────────────────────┤
│ 🤖 AI 答案（預設展開，可摺疊）              │
│  - 結構化回答 + 來源引用 [1][2]            │
│  - [👍 有幫助] [👎 沒幫助] [重新生成] [追問] │
├─────────────────────────────────────────┤
│ 📄 來源文件（top 5 卡片）                   │
│  - 標題 / 知識庫 / 相關度 / 摘要 / [展開全文]│
└─────────────────────────────────────────┘

純文件搜尋 toggle：輸入框旁的勾選框，預設 off。

• off（預設）：出 AI 答案 + 文件列表混合視圖（適合一般查找）
• on：跳過 LLM，只列文件（適合資深工程師查原文 / 省 LLM 算力 / 加快回應）

搜尋規格：

項目	定義
搜尋方式	向量餘弦相似度（cosine similarity）為主；偵測到精確查詢特徵時混合精確比對
自動偵測精確模式	系統自動偵測（不讓使用者切）：雙引號包圍 "..." / 代碼 pattern [A-Z]{3,}-\d+（CVE、RFC、INC）/ 法條編號（§ N 或「第 N 條」）/ 短英數字 ≤5 字（如 0x80072746）→ 觸發精確比對 + 語意混合排序
結果數量	文件列表 top 5 卡片（相關度 > 50%），不足 5 筆則顯示全部符合的
排序	精確命中視為相關度 ≥95%，排最前；其餘按 cosine similarity 由高到低
分區篩選	點擊知識庫分區 badge 篩選範圍（單選：全部 / 特定分區）。切換後即時重新搜尋
結果卡片欄位	文件標題、所屬知識庫、相關度 %、更新日期、內容摘要（前 150 字）
展開完整文件	原地展開文件全文（收合/展開 toggle），不跳頁

AI 答案規格（RAG）：

AI 讀完最相關的 KB 文件片段後，整理結構化回答——有步驟、有結論、附來源引用。像問一個讀過所有 SOP 的資深同事。

技術原理（RAG = Retrieval-Augmented Generation）：

1. Retrieval：用語意搜尋 + 自動精確偵測找到最相關的 KB 文件片段
2. Augmentation：把文件片段作為 AI 的參考 context
3. Generation：AI 根據「問題 + 文件片段」產生結構化回答

AI 不是憑空回答，是只根據 KB 文件內容回答。如果 KB 沒有相關資料，AI 顯示「目前知識庫中沒有相關資料，建議提交工單由 IT 團隊協助」而不是瞎猜（負向約束 PM-005）。

項目	定義
搜尋範圍	預設搜全部 KB。如果分區 badge 有選定，AI 答案也尊重該分區設定
回答格式	依 Prompt 範本產生結構化回答，附來源引用（文件名 + 相關度）
來源引用	最多引用 3 個來源，標示 [1][2][3] 和相關度，編號對應下方文件卡片
串流顯示	5 秒內開始串流顯示
追問	[追問] 按鈕觸發同 session 多輪對話，AI 記住前一輪 context；新答案接續顯示於原 AI 答案下方（不開新頁）
找不到資料	顯示「目前知識庫中沒有相關資料，建議提交工單由 IT 團隊協助」
重新生成	用相同問題重新搜尋 KB + 重新產生回答（可能因 KB 更新而得到不同結果）
回饋	👍 有幫助 / 👎 沒幫助，記錄到回饋資料庫供 AI 品質追蹤
個人歷史	MVP 不提供獨立歷史 UI（KB-013 已標 P2 Phase 2）。同 session 追問已涵蓋；查找上週問題請重新搜尋（KB 內容可能已更新，重搜更有價值）

和 AI Copilot 的差別：

	Knowledge unified search	AI Copilot（右下角浮動面板）
資料範圍	只搜 KB 文件	KB + 事件 + 工單 + CMDB + 監控
使用位置	知識庫頁面	任何頁面都能叫出
視圖	AI 答案 + 來源文件同框混合視圖	對話流為主，需要時展開引用
定位	知識庫專用的精準查找與問答	全系統的智慧操作助手

結構化應答

IT 管理員可以設定 Prompt 範本，讓 AI 照特定格式回答。例如：分列「外部規範」「內部程序」「建議事項」。

使用者場景

新進 IT 人員小王遇到使用者反映「VPN 連不上」：

1. 打開知識庫，在搜尋框輸入「VPN 連不上 0x80072746」
2. 系統同時觸發語意搜尋 + 自動偵測到 0x80072746 為錯誤碼 → 觸發精確比對
3. 同畫面看到：上方 AI 整理的結構化排錯步驟（附 [1][2] 來源引用）+ 下方 3 篇相關 SOP 文件卡片
4. AI 答案不夠細節，點「追問：第 3 步的憑證如何重匯？」AI 接續回答
5. 按步驟排除問題，覺得回答有幫助，點「👍 有幫助」

版本規劃

版本	功能
v0.1 MVP	文件上傳 + 語意搜尋 + AI 問答 + 來源引用 + 回饋（👍/👎）+ 排程自動匯入（需 Automation 模組）
v0.2	知識庫分區 + 版本控制 + 分類（單選 6 類）+ 標籤（多選自訂）
v0.3	結構化應答 + 個人問答歷史（KB-013，視客戶回饋決定）+ 回饋分析報表
v1.0	Preventive Agent（重複事件模式辨識）