SupaTalker 文件
知識庫

知識庫總覽

問答的四種狀態、可見性與檢索狀態的差別,以及兩個管理頁面的分工

知識庫用來管理常見問題、須知與政策類問答。每一則問答由問題答案分類三個必填欄位構成,可另外加上標籤、參考連結與圖片回覆訊息。

新增或編輯不等於生效

儲存只會寫入草稿。問答必須經過同步才會進入檢索索引,聊天端才找得到。

兩個頁面的分工

頁面路徑負責
列表頁/knowledge-base瀏覽、篩選、批次操作、匯入、狀態切換
編輯頁/knowledge-base/{id}/edit單筆的內容編輯、AI 輔助、刪除

同步、上架、下架這三個動作兩個頁面都能做。列表頁適合一次處理多筆,編輯頁適合改完內容順手同步。

四種狀態

「檢索狀態」欄位顯示的是這則問答與檢索索引的關係:

狀態顯示文字意義
草稿未同步/草稿只存在於管理端,尚未建立檢索索引
已建檢索未同步/已建檢索批次同步做到一半沒完成,需重跑批次
已同步已同步索引已建立且內容為最新
有變更需重新同步已同步過,但之後改過內容,索引還是舊的

另外有一個特例:套用黃金問句樣版後產生的問答,在答案填寫前會顯示 未同步/待填答案,且無法同步。

「未同步/已建檢索」這個狀態只會由批次同步中斷產生,單筆操作不會進到這裡。遇到時請重跑批次同步,單筆同步對它無效。

可見性與檢索狀態是兩件事

列表頁有兩個容易混淆的欄位:

  • 檢索狀態:索引建了沒有、是不是最新的
  • 可見性:上架中/下架中,也就是現在聊天檢索得不得到

一則問答可以「已同步」但「下架中」——索引存在,但被刻意關閉不讓它被檢索到。想暫時停用某則問答又不想刪掉,就用下架。

草稿不算上架

可見性顯示為「上架中」的條件是三者同時成立:已建立索引、已同步、未被下架。草稿即使沒被下架過,也一律顯示為下架中,因為它根本還沒有索引可以被檢索。

字數與格式上限

欄位上限
問題100 字
答案300 字
參考連結標題顯示寬度 20(全形計 2、半形計 1)
參考連結 URL256 字元,且必須以 https:// 開頭
單次批次操作20 筆

答案超過上限時,編輯頁會提供「產生拆條建議」,用 AI 把長答案拆成數則獨立問答。

本頁內容