使用手冊

知識庫

「知識庫」（/knowledge）管理 ai 節點會引用的內容。結構是 知識集 → 來源 → 版本；只有已發布的版本會被檢索，每次發布都留紀錄，可回滾。

建立知識集

1. 按 新增知識集（/knowledge/sets/new），填 名稱與 說明。
2. 知識集屬於單位；ai 節點在設定時選用一個或多個知識集。

新增來源

1. 按 新增來源（/knowledge/sources/new），選 知識集（setId）與 種類（kind：文字或網址）。
2. 填 標題（title）；網址來源填 uri 並可設 重新抓取（小時）（refreshHours）；文字來源直接貼 content。
3. 可設 有效期（validFrom / validTo，例如僅本學期有效的規定）、負責人（owner）、備註（note）。
4. 按 建立：系統切段（chunk）並建立 草稿 v1；「已建立草稿 v1（N 段）。發布後才會被檢索。」

版本：編輯、發布、回滾、封存

編輯

來源頁按 編輯（/knowledge/sources/{id}/edit）改 content 並填 note；儲存建立新草稿版本。內容與現行版本相同時不會建立新版本。

發布

在版本列選 發布 vN（POST /knowledge/sources/{id}/publish，欄位 version）；需要 approver 角色。發布時以單位設定的 embedding provider 建索引，之後可被檢索。

回滾

選較舊的版本按 回復（/rollback）：「已回復並發布 vN」。

封存

封存（/archive）讓來源停止被檢索，保留歷史。

試搜尋

來源頁的 試搜尋（q）顯示引擎會引用哪些段落與分數，用來檢查切段品質。