AI 技能與測試知識庫
總覽
問答的四種狀態、可見性與同步狀態的差別，以及兩個管理頁面的分工
知識庫用來管理常見問題、須知與政策類問答。每一則問答由問題、答案、分類三個必填欄位構成，可另外加上標籤與參考連結。
新增或編輯不等於生效
儲存只會寫入草稿。問答必須經過同步才會進入檢索索引，聊天端才找得到。
兩個頁面的分工
| 頁面 | 路徑 | 負責 |
|---|---|---|
| 列表頁 | /knowledge-base | 瀏覽、篩選、批次操作、匯入、狀態切換 |
| 編輯頁 | /knowledge-base/{id}/edit | 單筆的內容編輯、AI 輔助、刪除 |
同步、上架、下架這三個動作兩個頁面都能做。列表頁適合一次處理多筆，編輯頁適合改完內容順手同步。
四種狀態
「同步狀態」欄位顯示的是這則問答與檢索索引的關係：
| 狀態 | 顯示文字 | 意義 |
|---|---|---|
| 草稿 | 未同步／草稿 | 只存在於管理端，尚未建立檢索索引 |
| 已建檢索 | 未同步／已建檢索 | 批次同步做到一半沒完成，需重跑批次 |
| 已同步 | 已同步 | 索引已建立且內容為最新 |
| 有變更 | 需重新同步 | 已同步過，但之後改過內容，索引還是舊的 |
另外有一個特例：套用黃金問句樣版後產生的問答，在答案填寫前會顯示 未同步／待填答案，且無法同步。
「未同步／已建檢索」這個狀態只會由批次同步中斷產生，單筆操作不會進到這裡。遇到時請重跑批次同步，單筆同步對它無效。
可見性與同步狀態是兩件事
列表頁有兩個容易混淆的欄位：
- 同步狀態：索引建了沒有、是不是最新的
- 可見性：上架中／下架中，也就是現在聊天檢索得不得到
一則問答可以「已同步」但「下架中」——索引存在，但被刻意關閉不讓它被檢索到。想暫時停用某則問答又不想刪掉，就用下架。
草稿不算上架
可見性顯示為「上架中」的條件是三者同時成立：已建立索引、已同步、未被下架。草稿即使沒被下架過，也一律顯示為下架中，因為它根本還沒有索引可以被檢索。
字數與格式上限
| 欄位 | 上限 |
|---|---|
| 問題 | 100 字 |
| 答案 | 300 字 |
| 參考連結標題 | 顯示寬度 20（全形計 2、半形計 1） |
| 參考連結 URL | 256 字元，且必須以 https:// 開頭 |
| 單次批次操作 | 20 筆 |
答案超過上限時，編輯頁會提供「產生拆條建議」，用 AI 把長答案拆成數則獨立問答。
用 MCP 管理知識庫
除了在後台操作，知識庫也可以讓外部的 AI 工具（例如 Claude Code、Codex、claude.ai）透過 MCP 連進來管理： 查詢問答、分類與標籤，建立、修改與刪除草稿，以及同步、上下架。
外部工具連線時要帶一把金鑰，在 MCP 伺服器金鑰 頁開立。 開立時可以限定這把金鑰能用哪些功能，例如只讓 AI 工具建立草稿，要不要同步由人決定。 透過 MCP 同步的內容，一樣會經過同步前的內容審查。