# Release Note

## PrivStation 產品更版功能介紹 (v1.3.0~4.0.0)

## 各版本更版內容：

### CaiGunn 4.3.0 - 組織與機器人 DashBoard

本次更版新增「Dashboard 儀表板功能」，協助使用者快速掌握整個組織與個別機器人的使用狀況與效能指標。

詳細功能說明可參考官網幫助中心文章：[https://www.apmic.ai/help-center/dashboard](https://www.apmic.ai/help-center/dashboard) ＆PrivStation Documentation 中 CaiGunn Dock 的「組織與機器人 DashBoard」章節內容  


### PrivAI 2.3.0 - 圖片低解析模式

本次更版新增「使用快速模式時，圖片改為使用OCR來進行解析」＆「高解析模式加上fallback 機制」2項功能。

- 快速模式下改為使用「不需 GPU 算力」的傳統 OCR 進行圖片解析，以達到降低 GPU 依賴，提升解析速度的效果。

- 使用高解析模式但遇到圖片解析失敗的情況時，會使用快速模式再解析一次該圖片（fallback機制）。詳細說明可參照 PrivStation Documentation 中 PrivAI 的「分頁策略 ＆文件解析模式優化策略 (PDF)」章節內容。  
    

---

### CaiGunn 4.4.0 - 全文閱讀 ＆ 對話中上傳文件

本次更版於知識管理前台新增「全文閱讀」檢索模式、「對話中上傳文件」功能，大幅提升處理複雜長文的能力，並強化終端使用者的即時交互體驗。

詳細功能說明可參考官網幫助中心文章：[https://www.apmic.ai/post/caigunn-4-4-0](https://www.apmic.ai/post/caigunn-4-4-0)＆PrivStation Documentation 中 CaiGunn Dock 的「知識管理介面」章節內容。

### PrivAI 2.4.0 - 全文閱讀 ＆ 對話中上傳文件

本次更版新增「全文閱讀」＆「對話中上傳文件」之相關功能

全文閱讀：

- 新增 Parse file API（全文檢索），使用者可單獨取得檔案純文字內容（如 OCR 結果），無須等待 RAG 流程，提升效能與彈性。詳細說明可參照 PrivStation Documentation 中 PrivAI 的「單一檔案轉換」章節內容。

- 優化 Download file 的 Parse result（全文檢索），讓非工程師也能下載純文字檔案結果、直接查看解析成果，有效提升 POC 與客戶 demo 成效。詳細說明可參照 PrivStation Documentation 中 PrivAI 的「下載檔案」章節內容。

對話中上傳文件：

- 新增在 message 引用 file（對話中上傳文件），使用者可於對話過程中即時插入上傳的檔案，提升互動彈性與應用延展性。詳細說明可參照 PrivStation Documentation 中 PrivAI 的「Chat Completions」章節內容。

- upload file API 支援自動 parse（對話中上傳文件）上傳文件時可直接指定是否立即 parse，減少 API 數量與整合成本。詳細說明可參照 PrivStation Documentation 中 PrivAI 的「上傳檔案」章節內容。

---

### CaiGunn 4.5.0 -  多輪記憶、Top10 QA & 效果測試/歷史紀錄頁面改版

本次更版新增以下功能：

- 多輪記憶 - Summary 模式上線

- Bot Dashboard - 新增自動統計近 7 天最常被詢問的問題，詳細說明可參考 PrivStation Documentation 中 CaiGunn Dock 的「組織與機器人 DashBoard」章節內容。

- 效果測試頁＆歷史紀錄頁面改版，詳細說明可參考 PrivStation Documentation 中 CaiGunn Dock 的「效果測試」＆「歷史聊天記錄」章節內容。

以上更版功能說明可參考官網幫助中心文章：[https://www.apmic.ai/post/caigunn-4-5-0](https://www.apmic.ai/post/caigunn-4-5-0)

### PrivAI 2.5.0 - 多輪記憶 

本次更版新增多輪記憶-Summary 功能，並對快速模式進行優化

多輪記憶：

- 新增 **Summary 功能：**

    - 對話可依上下文自動整理主題摘要，支援跨輪回應一致性。

    - 可設定每次回覆是否檢查此輪與summary是否相關，若相關則帶入摘要（限 500 字）。

    - 開發者可自定是否啟用 Summary 模式，以及檢查條件。提升模型在 FAQ、客服等多輪應答場景下的體驗與準確度。

    詳細說明可參照 PrivStation Documentation 中 PrivAI 的「Chat Completions」章節內容。

快速模式優化：  
快速模式與高解析模式改為分開排隊，修正過去快速模式被高解析模式阻塞的問題。現在快速模式將獨立執行，不再等待高解析模式完成，真正實現輕量快速 commit 流程。

---

### CaiGunn 4.6.0 -  Bot Dashboard TOP10 Files

本次更版新增以下功能：

- BotDashboard - TOP10 Files：新增機器人熱門檔案 TOP10 統計模組。詳細說明可參考 PrivStation Documentation 中 CaiGunn Dock 的「組織與機器人 DashBoard」章節內容。

- 問答集資料來源可視化：詳細說明可參考 PrivStation Documentation 中 CaiGunn Dock 的「問答集」章節內容。

- 歷史對話紀錄 - 搜尋功能補強：搜尋框可支援 email 與使用者 ID 查找。詳細說明可參考 PrivStation Documentation 中 CaiGunn Dock 的「歷史聊天記錄」章節內容。

### PrivAI 2.6.0 -  Commit 優化

本次更版內容為進行Commit 優化補丁-提升 Commit 程序穩定性，避免 edge case 中觸發錯誤造成卡件或資源浪費。

---

### CaiGunn 4.7.0 -  知識管理整合前台 & 機器人類別

本次更版新增以下功能：

- 新增「組織知識管理整合前台」，功能說明請參考官網幫助中心文章：[https://www.apmic.ai/help-center/orgkmfrontend](https://www.apmic.ai/help-center/orgkmfrontend) 或 PrivStation Documentation 中 CaiGunn Dock 的「知識管理介面」章節內容。

- 機器人分類管理正式上線，功能說明請參考官網幫助中心文章：[https://www.apmic.ai/help-center/robotclassification](https://www.apmic.ai/help-center/robotclassification) 或PrivStation Documentation 中 CaiGunn Dock 的「組織與權限管理」章節內容。

### PrivAI 2.7.0 - State 重整

本次更版進行以下調整：

- 拔除file API 的state 欄位。

- 重構 fileset file state：在 GET /filesets/{id}/files 回傳每個 file 在該 fileset 中的實際 commit 狀態，值為：draft / queued / processing / completed / failed。

- parse result 拆品質維度：state 納入於 file.metadata.parse_result.HQ/LQ/STD.state 中，獨立記錄各解析品質狀態。

- 欄位調整與清理：

    - GET File response 中移除不應該出現的 used_quality。

---

### CaiGunn 5.0.0 & 5.1.0  - 大改版：組織資產/機器人重構/指令版本管理& API 權限管理

5.0.0 本次更版新增以下功能：

- 新增「組織知識庫」，重構知識資產治理流程，詳細說明可參考 PrivStation Documentation 中 CaiGunn Dock 的「組織知識庫」章節內容。

- 機器人調校與測試頁面重構上線，詳細說明可參考 PrivStation Documentation 中 CaiGunn Dock 的「效果測試」章節內容。

- 機器人指令版本管理功能正式上線，詳細說明可參考 PrivStation Documentation 中 CaiGunn Dock 的「機器人指令」章節內容。

5.1.0 本次更版新增以下功能：

- API 權限管理與外部 Parse 串接功能上線，詳細說明可參考 PrivStation Documentation 中 CaiGunn Dock 的「組織知識庫」章節內容。

### PrivAI 2.8.0 & 2.9.0 -  權限機制 &**高解析排隊演算法**

2.8.0 本次更版新增以下功能：

- **大量文件 Commit 優化 - commit per file 加入 semaphore / batch 機制** :避免同時大量 commit 導致上游服務過載（如 MinIO、Hasura、Embedding 模型服務），導入限流控制機制，分批提交單一 file 的處理任務。

- **大量文件 Commit 優化 -統一延長 timeout 設定**:針對 commit 任務常因 timeout 過短而提前失敗的問題，全面將以下模組的 timeout 統一延長至 **48 小時**：

    - PrivAI CheckCommitTimeout

    - PrivAI commit_fileset consumer timeout

- **大量文件 Commit 優化 - PrivAI 優化記憶體使用 - 提早釋放 Cache & 強制 GC**

    - Commit 過程中會產生大量暫存內容（Parse result, Chunks, Embedding Cache）。

    - 此次調整為：**當單一 file commit 任務完成時即清除對應 cache，避免持續佔用記憶體**。

    - 減少記憶體占用與 OOM 風險，強化穩定性。  
    

- **Post Prompt API 錯誤訊息補強**

    增強 prompt API 的錯誤回傳訊息，協助使用者更清楚了解錯誤成因與排除方式，尤其在格式錯誤與欄位缺漏時。

2.9.0 本次更版新增以下功能：

重新調整系統處理文件的順序與方式，避免使用者在建立知識版本時感覺「一直卡住、不知道在等什麼」，讓整體解析流程更順、更可預期。

**新增的處理方式：**

- 系統會依照「處理成本高低」來安排順序：

    - **處理時間短、負擔較小的檔案會先完成**，讓使用者能更快看到成果。

    - **需要較多資源、較花時間的檔案會被有序安排處理**，而不是全部擠在一起。

- 系統會輪流處理每一個 fileset/parse工作，所以在只有一顆 olmocr 的情況下比較不會被卡在單一 fileset

- 快速通道機制，在多顆的時候，可以有一個專屬通道處理工作量（總檔案大小）比較小的fileset/parse 工作，讓小檔案、demo、測試比較不會被大檔案卡住

---

### CaiGunn 5.2.0- 特殊檔案模式

5.2.0 本次更版新增以下功能：

- 知識庫擴充「特殊檔案模式」設定與上傳，功能說明請參考PrivStation Documentation 中 CaiGunn Dock 的「組織知識庫」章節內容。

---

### CaiGunn 5.3.0- 新增外部 Agent 機器人

5.3.0 本次更版新增以下功能：

- **新增「Agent 類型管理」**

    組織層級可建立與管理外部 Agent 類型（URL / Headers / agent_name），讓企業或 SI 能以標準方式接入自家工具、工作流或專用模型，並可被重複套用與統一治理。功能說明請參考PrivStation Documentation 中 CaiGunn Dock 的「Agent 類型管理」章節內容。

- **支援建立「Agent 類型機器人」**

    在新增機器人時可選擇「一般機器人」或「Agent 類型機器人」。Agent 類型機器人會直接使用外部 Agent 回覆，並在相關頁面清楚標示其回覆不一定依據知識資料，避免使用者誤判回覆來源。功能說明請參考PrivStation Documentation 中 CaiGunn Dock 的「Agent 類型管理」章節內容。

- **新增機器人種類標籤**

    在機器人列表與 KM 前台清楚標示機器人種類（一般 / Agent），讓管理者與使用者能快速辨識機器人的能力邊界與行為特性。

### PrivAI 3.0.0- 支援呼叫 MCP 工具

本次3.0.0 更新聚焦於 **AI Agent 擴充能力、開發體驗優化，以及文件解析穩定性提升**，重點如下：

- **支援呼叫 MCP 工具**

    - PrivAI 的 Chat Completions API 現已支援 **MCP（Model Context Protocol）**

    - 開發者可在 API 請求中指定 **MCP tool**，讓 AI Agent 在對話過程中呼叫外部工具與服務

    - 可進一步支援企業內部系統存取、工作流程串接，以及外部資料來源整合

    - 使 PrivAI 從模型 API 進一步擴展為 **可整合多種工具的 AI Agent 平台**

    - 詳細說明可參照 PrivStation Documentation 中 PrivAI 的「Chat Completions」章節內容

- **Commit Fileset Error Message 優化**

    - 強化 Commit Fileset API 在各類失敗情境下的錯誤訊息內容

    - 提升錯誤說明的清楚度與可讀性

    - 協助開發者更快速定位問題並完成除錯

- **修正** `NoneType` **object has no attribute** `clear` **錯誤**

    - 在特定表格處理情境下，若遇到可修復的格式問題，系統將改以 fallback 或 edge case 處理方式繼續執行

    - 降低因單一格式異常而導致整體解析失敗的情況

- **修正表格圖片高解析解析問題**

    - 當圖片包含表格內容時，高解析流程送入 OlmOCR 可能出現錯誤的問題已修復，確保表格圖片可正常解析。

---

### CaiGunn 5.4.0- 支援呼叫 MCP 工具

5.4.0 本次更版新增以下功能：

- **機器人層級新增 MCP 管理功能**

    讓 bot Owner/Editor 可在後台設定與管理可用的 MCP 工具清單，為每個機器人建立獨立的工具權限範圍。功能說明請參考PrivStation Documentation 中 CaiGunn Dock 的「MCP 管理」章節內容。

- **支援在調校與測試頁、知識管理前台對話中選用 MCP 工具**

    使用者可在對話時指定使用哪些工具，並在回覆中看到工具調用過程與結果，提升可測試性與透明度。功能說明請參考PrivStation Documentation 中 CaiGunn Dock 的「MCP 管理」章節內容。

- **歷史對話紀錄可追蹤 MCP 工具使用情況**

    每一輪對話會記錄實際使用的工具，方便回溯、稽核與問題排查。

### PrivAI 3.1.0- **支援使用複數 filesets 進行 RAG 問答**

本次 3.1.0 更新聚焦於 **RAG 檢索範圍擴展** 與 **表格型資料的檢索品質優化**，讓系統在多知識來源整合與複雜表格理解上有更穩定的表現。

- **支援使用複數 Filesets 進行 RAG 問答**

    - Chat Completions API 現已支援同時指定多個 filesets

    - 讓機器人可跨不同主題資料來源進行整合檢索與回答

    - 適用於需要彙整多份知識庫內容的實際業務情境

- **優化 chunk 切分邏輯：表格標題與內容合併處理**

    - 確保表格標題與表格內容被保留在同一個 chunk 中

    - 避免因資訊拆分而造成模型誤解或回答不完整  
    

- **表格拆分時每個 chunk 都保留標題資訊**

    - 當大型表格需拆分為多個 chunk 時，每段內容都會保留對應標題

    - 提升模型對表格欄位與內容語意的理解能力

---

### CaiGunn 5.5.0- 組織切換 ＆知識可追溯性優化

5.5.0 本次更版新增以下功能：

- 新增 **組織切換功能**  
    擁有多組織權限的使用者可在同一帳號下快速切換工作上下文。

- **優化機器人調校體驗**

    在調校與測試頁中，新增每次回覆的 **測試組合資訊**，清楚顯示當次使用的知識版本、指令版本與模型，方便比較不同測試結果的差異。

- **優化知識版本管理**

    當知識版本內有檔案已被刪除時，系統會明確標示該版本 **無法使用**，協助管理者理解原因並避免誤套用。

- 統一前後台的 **檢索資料顯示樣式與邏輯**，讓訓練、測試與終端使用體驗更一致。:

---

### CaiGunn 5.6.0- 可不使用或使用複數知識版本進行問答

5.6.0 本次更版新增以下功能：

- 支援在調校與測試時 **同時選用多個知識版本進行 RAG**，讓機器人可整合多個知識來源，而不需要為了不同組合重複建版。

- 單次最多可選擇 **5 個知識版本**，並在引用資料中清楚標示來源知識版本，方便追蹤回答依據。

- 支援 **不選擇任何知識版本** 的機器人建立、測試與發布流程，讓使用者可建立純 Prompt 或純模型互動的機器人。

- 將多數表格頁面的 **時間篩選預設值調整為全部時間**，減少因預設時間範圍造成的資料誤判

### PrivAI 3.3.0- 報告模板建立

本次更新聚焦於 **報告模板建立流程整合** 與 **模板生成狀態管理**，讓系統可從上傳 PDF 開始，自動完成模板解析、結構確認與撰寫指引生成，作為後續報告生成流程的基礎。

- **新增報告模板建立 API**

    - 支援透過已上傳的 PDF 檔案建立報告模板

    - 自動串接 Document Converter、Template Extractor 與 Outline Generator

    - 完成從模板解析、slot 結構抽取到撰寫指引生成的流程

- **支援模板確認與內容更新流程**

    - 使用者可在解析完成後確認或調整 Jinja HTML 與 slot 結構

    - 模板完成後可更新模板名稱、模板內容、slot 定義、撰寫指引與 metadata

    - 讓模板建立流程具備可檢查、可修正、可維護的操作彈性

- **新增非同步處理、狀態機與 webhook 通知**

    - 支援 `parsing_template`、`pending_confirm`、`generating_guidelines`、`completed`、`failed` 等狀態

    - PDF 解析與撰寫指引生成皆以非同步方式執行

    - 當模板待確認、建立完成或流程失敗時，可透過 webhook 主動通知 caller

### PrivAI 3.3.0- **撰寫指引及大綱生成**

本次更新聚焦於 **撰寫指引自動生成** 與 **章節大綱結構化輸出**，讓系統可在模板結構抽取完成後，自動產生後續報告生成所需的章節規範與 slot 填寫說明。

- **新增 Outline Generator Workflow**

    - 支援根據 Template Extractor 產出的 Jinja template 與 slot 範例內容，自動生成撰寫指引

    - 產出內容可用於 Checkpoint 2，讓使用者確認章節架構與撰寫規範

    - 同時作為 Phase 2 Report Generation Agent 逐章節生成內容的依據

- **支援全局撰寫指引生成**

    - 自動分析模板用途、報告定位、目標受眾與整體語氣

    - 可生成跨章節一致性規則，例如術語統一、格式要求、資料時效性與禁止推測等限制

    - 協助後續報告生成維持一致的內容風格與品質

- **支援章節式大綱與 slot 對應說明**

    - 依照模板章節順序產生各章節撰寫指引

    - 每個章節可包含章節目的、內容結構、必要資料、RAG 查詢方向與章節間依賴關係

    - 針對章節內的每個 slot 產生對應說明，明確定義應填入的內容類型與寫作方向

### PrivAI 3.3.0- **基本對話模式下移除 context 中的 chunk ID**

本次更新聚焦於**基本對話模式的使用體驗優化**。系統將減少向一般使用者呈現不必要的內部技術資訊，在保留知識來源可追溯性的同時，進一步區分一般使用者與管理者的使用情境，讓 AI 回答更自然、清楚，並專注於知識內容與實際問題本身。

#### 基本對話模式更簡潔自然

- 回答內容不再顯示內部資料編號、路徑或其他技術標記。

- 降低技術資訊對閱讀體驗的干擾，讓使用者更容易理解回答重點。

- 優化知識內容的呈現方式，使回答更接近自然語言表達。

#### 知識管理模式維持完整引用功能

- 知識管理模式仍保留既有的引用與來源追蹤機制。

- 管理者可持續查看回答所依據的知識內容，方便進行資料確認與管理。

- 一般使用者則會看到更友善的來源描述，不會接觸內部資料結構。

---

### CaiGunn 6.0.0- 新增報告生成機器人與生成報告

6.0.0 本次更版新增以下功能：

#### 報告模板管理

- 知識庫新增「報告模板」Tab，讓管理者可以集中管理同一知識庫內可用的報告模板。

- 知識檔案詳細頁新增「以此檔案製作報告模板」入口，讓使用者可以直接把既有 PDF 文件轉換成可重複使用的報告模板。

- 支援報告模板製作狀態顯示，讓使用者能清楚知道模板正在產生、已完成或失敗，避免操作後不確定系統是否有處理。

- 支援報告模板失敗原因與重試流程，讓使用者在模板建立失敗時可以理解原因並重新嘗試。

- 新增報告模板編輯頁，讓管理者可以調整模板名稱、全局撰寫指引與各章節撰寫指引。

- 支援模板編輯後儲存，讓管理者可以把模板轉換成可驅動模型生成的規格，而不只是單純保存原始文件。

#### 報告生成機器人

- 新增報告生成機器人，讓使用者可以以機器人為單位管理報告產出流程，統一管理報告列表與可用報告模板。

- 新增報告列表，讓使用者可以追蹤已建立的報告任務、生成狀態與建立紀錄，降低報告產出流程中的資訊散落問題。

- 新增可用報告模板頁面，讓報告機器人可以清楚呈現可使用的模板清單，避免使用者每次都需要從整個組織或知識庫中重新尋找模板。

- 支援在報告生成機器人中新增報告生成任務，讓使用者可以先保存模板、參考資料、指令與模式設定，之後再回來繼續完成報告。

- 支援報告草稿保存機制，讓使用者在企業常見的中斷情境下，不會因離開頁面或暫停作業而遺失已設定的資料範圍。

- 新增報告內容生成與編輯流程，讓使用者可以先產出可編輯的報告內容，並在套版前逐段校對、修改與確認引用來源。

- 新增報告內容引用查看能力，讓使用者可以確認每段內容參考了哪些資料，降低報告生成中的幻覺與誤用風險。

- 新增報告套版、預覽與下載流程，讓使用者在確認內容後，可以套用企業模板產出正式報告，並於下載前預覽完整成果。

- 新增報告生成懶人模式，讓使用者可以略過內容審閱流程，直接產出已套版的報告檔案，再進一步下載與編輯。

---

### CaiGunn 6.1.0- **組織與權限調整＆優化報告生成機器人體驗**

6.1.0 本次更版新增以下功能：

#### **組織與權限管理**

- 調整機器人列表權限顯示邏輯，讓沒有查看或操作權限的機器人不再出現在列表中，避免使用者看到不應接觸的機器人資訊。

#### **優化報告生成機器人體驗**

- 新增報告生成機器人的可用知識檔案頁，讓使用者能更清楚掌握報告生成時可使用的知識來源。

### CaiGunn 6.2.0- 資料庫搜尋

6.2.0 本次更版新增以下功能：

#### **資料庫搜尋能力**

- 新增組織知識庫中的「資料庫」管理頁籤，讓管理者可以集中新增、查看與維護組織可使用的資料庫資源。

- 新增機器人「可用資源」設定頁，整合知識版本、資料庫與 MCP 工具，讓管理者可以清楚控管每個機器人可使用的資料來源與工具。

- 新增前台 KM 與後台測試頁的「資料庫搜尋」開關，讓使用者可以用自然語言查詢已授權的資料庫資料。

- 新增查詢條件確認流程，讓使用者在系統執行資料庫查詢前，先確認模型理解出的查詢條件與 SQL，降低誤查資料的風險。

- 新增後台歷史對話紀錄中的資料庫搜尋來源資訊，讓管理者可以查看該次回答是否使用資料庫搜尋、產生了什麼查詢條件、SQL 與查詢結果。

- 保留資料庫搜尋回答的依據內容，讓管理者可在事後追蹤回答錯誤究竟來自問題理解、SQL 產生、資料庫結果，或最終回答整理。

#### **優化報告生成機器人體驗**

- 新增報告生成機器人的可用知識檔案頁，讓使用者能更清楚掌握報告生成時可使用的知識來源。

### CaiGunn 6.3.0- 模型回答可顯示外部圖片

6.3.0 本次更版新增以下功能：

- 新增外部圖片 URL 渲染能力，讓模型透過工具取得圖片時，可直接在回答中顯示圖片與來源資訊，不需要使用者另外點開連結。

- 新增圖片來源標示與載入失敗處理，讓使用者能辨識圖片來源，並在外部圖片失效時仍保有完整回答閱讀體驗。

- 新增回答圖片 Gallery 檢視，讓使用者可點擊回答中的圖片放大查看、多圖切換，並查看圖片基本資訊。

- 支援前台對話頁、後台測試與調校頁、歷史對話紀錄中的圖片顯示與 Gallery 檢視。

### CaiGunn 6.5.0- 知識庫＆資料庫搜尋可**顯示圖片**

6.5.0 本次更版新增以下功能：

- 過去模型引用知識庫時僅能呈現純文字段落，若知識庫文件內包含流程圖、架構圖、產品規格圖或數據圖表，使用者無法直觀對照。現在模型在檢索知識庫版本內直接上傳的圖片時，能直接將圖片渲染於的前台對話框與訓練者後台，提供「圖文對照」的精準回答。

- 使用者無需再根據文字引用的檔名，額外開啟知識庫找尋原始圖檔，直接在對話流程中就能取得答案與視覺憑證。

- 支援將來自 DB Search 結果的圖片 URL 於前台與後台對話介面中直接渲染，提升資料檢索與展示的直觀性。讓企業能將現有商品庫、圖片等結構化資料庫即時呈現於對話中，確保資訊時效性與視覺化檢索體驗。

### CaiGunn 6.6.0- **知識庫成員權限隔離控制**

6.6.0 本次更版新增以下功能：

- 強化知識庫（KS）權限管理機制：知識庫列表僅顯示使用者擁有權限的知識庫（無權限項目不顯示、亦無法透過連結進入），並將管理員權限標籤統一為四種角色標示，滑鼠移入時顯示說明提示（tooltip）。

### CaiGunn 6.7.0- **Mermaid 圖表工具與回答圖片顯示**

6.7.0 本次更版新增以下功能：

- 新增 Mermaid 圖表渲染 MCP 工具，讓 Agent／機器人可將 Mermaid 語法轉換為可視化圖表圖片。

- 新增工具生成圖片的渲染能力，機器人透過上述工具產生圖表後，可直接在回答中顯示圖片與來源資訊，不需要使用者自行複製語法或另外開連結查看。

- 新增圖片來源標示與載入失敗處理，讓使用者能辨識圖片來源，並在圖片載入失敗時仍保有完整回答閱讀體驗。

- 新增回答圖片 Gallery 檢視，讓使用者可點擊回答中的圖表放大查看、多圖切換，並查看圖片基本資訊。

- 支援前台對話頁、後台測試與調校頁、歷史對話紀錄中的圖表顯示與 Gallery 檢視。

### CaiGunn 6.9.0- 優化後台導覽 & 生成問答集可自選文件生成

6.9.0 本次更版新增以下功能：

- 層級辨識：組織層 sidebar 改為淺色，與知識庫層、機器人層的深色 sidebar 做出視覺區隔，讓使用者能更清楚辨識目前所在層級。

- 導覽方式統一：知識庫層導覽由原本的 tab 改為 sidebar，與機器人層的呈現邏輯一致，減少切換層級時需要重新適應介面的困擾。

- 新增麵包屑：知識庫層與機器人層所有頁面新增麵包屑（建版頁除外），顯示「知識庫／機器人列表 > 頁面名稱」，可點擊直接返回列表頁。

- 快速返回入口：深色 sidebar 頂部新增「返回組織」按鈕，依所在層級分別返回知識庫列表或機器人列表，減少返回上一層所需的操作步驟。

- 生成問答集可自選文件生成：使用者於生成問答集前可自行勾選特定資料後再生成問答集，讓生成的問答集內容更聚焦、準確。

### PrivAI 4.0.0- 報告生成（Beta）

本次更新聚焦於 **報告生成流程上線** 與 **報告模板建立能力強化**，延續 3.3.0 的報告模板與撰寫指引，讓系統可依已完成的模板與指定的知識版本自動產生完整報告，經使用者確認後套回模板版面並匯出 PDF。

- **新增報告生成 API（Beta）**

    - 依報告模板的撰寫指引，逐章節檢索指定 Fileset 的資料並生成報告草稿

    - 可透過 `prompt` 描述本次報告的任務，例如報告期間、關注重點或特定需求，作為各章節檢索方向與撰寫內容的依據

    - 可透過 `expert_model` 指定章節撰寫與章節整合階段使用的模型

    - 各章節完成後，系統會統一整合全部章節，處理術語一致與段落銜接

- **支援草稿確認與模板填充**

    - 草稿生成後，使用者可檢視或修改各章節內容，確認後系統將內容填入模板並產生完整報告頁面

    - 個別章節生成失敗不會中斷整份報告，可在確認草稿時以人工內容補上

- **支援匯出 PDF 與報告管理**

    - 完成的報告可匯出為 PDF 檔案，並透過檔案 API 下載

    - 新增取得報告與刪除報告 API

- **非同步處理、狀態追蹤與 webhook 通知**

    - 支援 `generating_draft`、`pending_review`、`filling_template`、`completed`、`failed` 等狀態

    - 草稿生成完成、報告完成或流程失敗時，可透過 webhook 主動通知 caller

    - 失敗的報告可帶入相同的報告 ID 重新執行；套版階段失敗時可重新確認草稿

- **報告模板建立改進**

    - 提升以頁數較多的 PDF 建立報告模板時的穩定性

    - 模板產生的 HTML 版面不需連線外部資源即可正確呈現樣式

詳細說明可參照 PrivStation Documentation 中 PrivAI 的「報告生成」與「建立報告模板」章節內容。

### PrivAI 4.0.0- 混合檢索與文件解析強化

本次更新聚焦於 **RAG 檢索品質提升** 與 **文件解析能力強化**，讓知識庫在專有名詞、編號等精確字詞的查詢上更準確，並提升 PDF、圖片與試算表等格式的解析品質。

- **RAG 支援混合檢索（關鍵字＋語意）**

    - Chat Completions 與資料參考搜尋同時進行關鍵字檢索與語意檢索，合併兩者結果後再進行排序

    - 改善專有名詞、編號等精確字詞的查詢命中率

    - 4.0.0 之前已完成 Commit 的知識版本，仍以原本的語意檢索方式運作

- **高解析模式改用新一代 OCR 引擎**

    - PDF 與圖片的高解析辨識改用新一代 OCR 引擎，提升掃描文件與複雜版面的辨識品質

    - 修正部分 PDF 辨識結果與原文不符的問題

- **PDF 圖表自動產生文字描述**

    - 以高解析模式解析 PDF 時，文件中的圖表會自動產生文字描述並納入知識內容

    - 使用者可透過問答檢索到圖表中的資訊，不再僅限於文件中的文字

- **試算表與圖片解析修正**

    - 修正 `.ods` 檔案無法解析的問題

    - 修正資料量較大的 Excel 檔案解析失敗的問題

    - 修正圖片中沒有可辨識文字時的解析錯誤，改為回報明確的失敗原因

詳細說明可參照 PrivStation Documentation 中 PrivAI 的「資料參考搜尋」、「上傳檔案」與「分頁策略 ＆ 文件解析模式優化策略 (PDF)」章節內容。

### PrivAI 4.0.0- Chat Completions 強化

本次更新聚焦於 **多模態輸入** 與 **錯誤處理完整度**，讓 Chat Completions 可直接處理圖片，並在串流模式與 MCP 工具呼叫發生問題時提供更清楚、可預期的回應。

- **支援圖片輸入（多模態）**

    - `messages` 的 `content` 新增 `image_url` 內容區塊，可傳入 https 圖片連結或 data URL

    - 所選模型不支援圖片輸入、或單次請求圖片數量超過模型上限時，回傳明確的錯誤代碼（`CHAT_004`、`CHAT_005`）

- **串流模式錯誤處理**

    - 串流開始前發生的錯誤，改以一般 HTTP 錯誤回應回傳

    - 串流開始後發生的錯誤，會先送出帶有錯誤資訊的 SSE 事件，再以 `data: [DONE]` 結束串流

    - 無法歸類的上游服務錯誤統一回傳 `CHAT_006`

- **串流模式回傳** `reasoning_content`

    - 修正使用推理模型時，串流模式未回傳 `reasoning_content` 的問題

- **MCP 工具錯誤處理**

    - MCP 工具執行失敗時，錯誤訊息會交回模型，由模型決定如何回覆，不會讓整個請求失敗

- **檢索相關錯誤代碼**

    - 查詢文字過長、檢索服務暫時無法使用時，Chat Completions 與資料參考搜尋回傳明確的錯誤代碼（`CHAT_001`～`CHAT_003`）

    - 資料參考搜尋與 Chat Completions 一致，僅接受 `completed` 或 `partial_failed` 狀態的知識版本，其他狀態回傳 409

    - 資料參考搜尋回傳的每個段落一律帶有 `chunk_role`；問答集段落補上 `file_id`

詳細說明可參照 PrivStation Documentation 中 PrivAI 的「Chat Completions」、「Tool Calling 與 MCP 整合」、「資料參考搜尋」與「錯誤代碼說明-Chat」章節內容。

### PrivAI 4.0.0- API 管理功能調整與穩定性提升

本次更新聚焦於 **管理類 API 的操作彈性** 與 **知識版本處理穩定性**，補齊多項 API 的參數與限制，並提升大量檔案處理時的可靠度。

- **API Key 更新改用 PATCH**

    - 更新、停用與啟用 API Key 改用 `PATCH /v1/api-keys/{id}`

    - 原 `PUT` 方法仍可運作但已標記為 deprecated，建議改用 `PATCH`

    - 詳細說明可參照 PrivStation Documentation 中 PrivAI 的「更新 ／ 停用 ／ 啟用 API Key」章節內容

- **知識版本管理改進**

    - 複製知識版本時可透過 Request Body 的 `id` 指定新知識版本的 ID，詳細說明可參照「複製知識版本」章節內容

    - 狀態為 `queued` 或 `processing` 的知識版本無法刪除（`FILESET_021`），需等待處理結束或先取消 Commit，詳細說明可參照「刪除知識版本」章節內容

- **問答集生成改進**

    - 錯誤回應改為統一的錯誤代碼格式，新增檔案內容超過可處理長度時的 `QA_003`

    - 生成問答時略過圖示與標誌類圖片的描述，減少無意義的問答內容

    - 詳細說明可參照 PrivStation Documentation 中 PrivAI 的「問答集生成」章節內容

- **模型資訊新增輸入長度上限欄位**

    - 取得所有模型 API 新增 `max_input_characters` 欄位，提供各模型建議的輸入字元數上限（僅供參考，並非強制限制）

    - 詳細說明可參照 PrivStation Documentation 中 PrivAI 的「取得所有模型」章節內容

- **穩定性提升**

    - 重新設計知識版本 Commit 與檔案解析的背景處理流程，提升大量檔案同時處理時的穩定性

    - 改善取消 Commit 後的處理中止與狀態一致性

---
