連接知識庫

開始前準備

知識庫讓助理先查找參考資料，再回答問題；這種方式也稱為 RAG。RosettaChat 目前連接 Marknest。

請準備 Marknest 的 API 服務基礎網址、可讀取目標內容的 API key，以及選填的資料夾 ID。使用你的 Marknest 服務提供的 API 位址，不要填行銷網站或文件分享網址；整合程式會自行加上 API 路徑。

整理知識內容

• 將常見問題、產品資訊與客服政策整理為主題清楚的條目。
• 寫明條件、例外與適用日期，移除互相矛盾的版本。
• 將要提供給助理的內容設為已發布；草稿不會被檢索。
• 建議使用專用資料夾，只放適合向訪客回答的資訊。資料夾能縮小查找範圍，但不能取代 API key 的存取權限限制。

原始內容在 Marknest 中管理與發布。RosettaChat 設定頁負責連接資料，不提供文件上傳編輯功能。

在 RosettaChat 中連接

1. 以工作空間擁有者身分進入 Settings → Web chat widget → AI assistant。
2. 選擇 Knowledge base (marknest)。
3. 在 Marknest 區塊填寫 API 服務基礎網址與 API key。
4. 填寫資料夾 ID，將查找範圍限於該資料夾。留空表示不加資料夾限制，仍受 API key 可存取範圍約束。
5. 先點選 Save AI settings。Test connection 使用已儲存設定，不會使用欄位中尚未儲存的內容。
6. 點選 Test connection，等待結果。
7. 若尚未啟用助理，點選 Enable bot，再建立新訪客對話，詢問指定資料夾中有答案的問題。

儲存過的 API key 不會再次顯示。只修改其他設定時，將 key 欄位留空會保留原本的 key；要更換時才填入新 key 並儲存。

預期結果

連線測試成功，而且實際訪客問題能取得符合已發布資料的回答。連線成功不代表指定資料夾一定有可搜尋的答案：連線探測不會驗證該資料夾範圍。

更新知識後，發布修改，等待 Marknest 完成可搜尋處理，再重測相關問題。不要因為已儲存原始文件，就假設回答會立刻改變。

發生問題時

連線錯誤時，檢查 API 服務網址、key 權限與服務狀態。連線成功卻找不到答案時，檢查發布狀態、資料夾 ID，以及資料是否確實包含答案。接著參考測試與排解問題。