第 6 章文件怎麼寫才容易被查到

第 5 章解決「放什麼」;這一章解決「怎麼寫」——同樣的內容,寫法對了,檢索命中率天差地遠。

6.1 一份文件一個主題

不要把所有東西塞進一份 50 頁的大 PDF。 系統檢索的單位是「片段」,一份混雜產品、價格、政策、活動的大文件,切出來的片段主題混雜,容易互相干擾;而且日後更新(尤其優惠這種會過期的)要整份重傳。

建議的切分粒度就是第 5 章的清單:優惠一份、搭配推薦一份、每個流程的 SOP 各一份。會一起過期的內容放同一份,不會一起更新的內容分開放。

6.2 顧客怎麼問,文件就怎麼寫

檢索是拿顧客的原話去比對你的文件。所以:

關鍵名詞要出現在內文,不要只在你腦中:商品名、型號、活動名、「退貨」「保固」「配件」這些顧客會講的詞。
同義詞多寫幾個:顧客會說「壞了」「不能動」「沒反應」,故障排除文件的症狀描述就照這樣寫,不要只寫工程用語「無法啟動(E0)」。
內部代號要翻譯:文件裡只寫「方案 B」「Q3 檔期」,顧客問「夏季優惠」就對不上。內部代號可以保留,但顧客用語一定要同時出現。

進階:若你的場景充滿型號、規格編號這類精確名詞(例如零件販售),可考慮開啟 AI 助理的「關鍵字擴展搜尋」(《後台使用手冊》2-8),讓系統自動用同義詞擴大搜尋;一般口語場景不必開。

6.3 標題階層與段落要清楚

系統切片段時會參考文件結構。好的結構=每個片段自帶完整脈絡:

用清楚的標題階層(H1 產品名 → H2 主題 → 內文),不要通篇無標題的長文。
每個小節自成一體:小節內文要能獨立讀懂,不要寫「同上」「見前述」——片段被單獨取出時,「上」和「前述」就不見了。
更不要用「見第 X 節」代替答案:同樣的道理,而且問句配上章節指標特別容易被撿到、卻答不出東西。詳見 6.9。
表格記得帶表頭,每列的意思才完整。

6.4 表格與圖片的注意事項

價目表、規格對照、時效表這類「查某一格精確值」的內容,上傳時選「表格」類型,系統會逐列理解、認得數字與日期。
簡報和圖片直接上傳即可(不必轉 PDF),系統會逐頁「看圖」辨識,連圖表裡的數字都讀得到;頁數多會處理比較久。
有圖解的操作手冊選「操作手冊」:這個類型也是逐頁看圖(手冊多半靠步驟圖和截圖說明),所以流程圖、示意圖裡的資訊不會漏掉;代價是厚手冊解析時間較久。
注意:「常見問答 FAQ」「合約 / 法律文件」「表格」三種類型不會把文件裡內嵌的圖表轉成可搜尋文字。重要資訊如果只存在圖表裡,改選「操作手冊」,或把該頁另存成圖片上傳。
上傳完成後,用文件清單的「預覽段落」核對 AI 實際讀到了什麼(《後台使用手冊》1-1)——尤其是表格多、排版複雜的文件。

6.5 FAQ 的寫法

FAQ 是命中率最高的文件形式,因為「一問一答」跟顧客的提問天然同構。要點:

上傳時文件類型選「常見問答 FAQ」,讓系統把每組問答當成一個完整單位。
問題用顧客的話寫:「可以貨到付款嗎?」比「付款方式說明」容易命中。
一題一答,答案完整但不離題;相關的延伸資訊放到對應的專門文件(政策、SOP)去。
答案欄要寫答案,不要寫章節編號:「會費多少? → 見 3.4」這種寫法檢索上是無效的,還會排擠掉真正有答案的片段(6.9)。
不確定該收哪些題?儀表板的「AI 答不出的問題」清單就是顧客親自幫你列的題庫(見第 8 章)。

6.6 檔名怎麼取

檔名不會被 AI 唸給顧客聽。直接回覆顧客的訊息裡,AI 不會指名內部檔名或頁碼(只會描述資訊性質,例如「依保固政策」);給真人客服審核的草稿才會標detailed出處。所以檔名照你內部習慣取即可,不用擔心外洩。
但檔名要讓你自己好管理:建議「主題-版本或日期」,例如優惠活動-2026夏季.md、退貨SOP-v3.docx——日後更新、下架時一眼可辨。
同系列多型號的文件,檔名與內文都要能區分型號(X100規格書 vs X200規格書,內文開頭也寫明型號)。顧客要求「比較 X100 和 X200」時,AI 需要能分別鎖定兩份文件。

6.7 反例對照:同一份優惠,難查版 vs 好查版

難查版(內部簽呈式)

Q3 檔期調整案
依行銷部 0715 會議決議,方案 B 折扣值調整為 0.88,
適用 SKU 清單如附件,執行期間依公告。

問題:沒有「優惠 / 活動 / 折扣幾折」等顧客字眼、沒有商品名(只有 SKU 附件)、沒有明確期限。顧客問「現在有什麼優惠」,相關程度大概率不夠。

好查版

# 2026 夏季優惠活動(7/1–8/31)
除濕機全系列 88 折。
- 適用型號:D80、D120、D200
- 舉例:D80 原價 8,990 → 活動價 7,911
- 活動至 2026/8/31 止,線上線下同步

改了三件事:標題與內文用顧客字眼(優惠、活動、88 折)、寫出具體型號、期限明確。內容一模一樣,命中率完全不同。

6.8 會過期的資訊獨立成檔

優惠、檔期、限量名額、季節性服務——凡是有截止日的內容,獨立成一份文件,並在內文寫明起訖日期。三個理由:

到期後只要更新或刪掉這一份,不動其他文件。
內文有日期,AI 講活動時會連期限一起講,顧客不會誤會。
過期忘了下架是「AI 講錯話」最常見的原因(見第 8 章的維護節奏)。

6.9 不要只放「路徑對照表」:答案要就地寫完

有一種寫法看起來很貼心,實際上會反效果:在文件最後做一張「顧客可能問 → 請見第 X 節」的導引表,想幫 AI 指路。這種表對 AI 沒有幫助,多數情況還會扣分。

三個原因:

AI 追不到「第 X 節」。 系統交給 AI 的是查到的幾個片段,不是整份文件(1.1 第 2 步)。片段裡寫著「詳見 3.4」,但 3.4 的內容在另一個片段裡,那一段不保證會被一起撿回來——而 AI 沒辦法自己「翻到 3.4 節」,它手上就只有撿回來的那幾段。
它會排擠掉真正有答案的片段。 這張表逐字寫著顧客會問的句子,相關程度算起來特別高,很容易排到最前面;但系統一次只挑最相關的幾段,被指標佔掉的名額,就是原本要給「有答案那一段」的名額。等於拿一個指標,換掉一個答案。
章節編號可能被講給顧客聽。 檔名和頁碼 AI 不會唸出來(6.6),但寫在內文裡的「第 3.4 節」屬於文件內容,AI 是有可能照著講的。顧客手上沒有你的文件,收到一句「請參考第 3.4 節」等於什麼都沒拿到。

這不是在說「對照表不好」。 第 5 章建議的故障排除對照表、規格對照表都很好用,差別在每一列有沒有帶著答案。判斷方法只有一句話:

把這一列單獨剪下來,拿給一個沒看過這份文件的人,他答得出來嗎?

「不能開機 → 檢查電源線與插座 → 換一條電源線試」——剪下來也答得出來 ✅

「可以退貨嗎? → 見 3.2 退換貨政策」——剪下來什麼都沒有 ❌

改法:把指標換成答案。

難查版(只有指標)

| 顧客可能問 | 請見章節 |
|---|---|
| 可以退貨嗎? | 3.2 退換貨政策 |
| 運費誰付? | 3.2.1 運費規則 |

好查版(就地寫完)

Q:可以退貨嗎?幾天內?
商品到貨後 7 天內可申請退貨,商品需保持全新未使用、包裝與配件齊全。
申請方式:客服信箱 [email protected],或線上表單 https://example.com/return

Q:退貨運費誰付?
商品瑕疵或出貨錯誤:運費由本公司負擔。
個人因素退換貨:單程運費 100 元由顧客負擔。

兩點補充:

跨文件的指路也一樣。「詳見《退換貨政策》那份文件」對 AI 的幫助有限。真正需要的那兩三句,直接抄一份過來比較穩。
文件開頭的「目錄」不用刪。 純粹列章節名稱的目錄不會扣分——它不長得像顧客的問題,相關程度通常不高,不會來搶名額。會扣分的是「問句 + 章節指標」的組合:問句讓它很好命中,指標讓它答不出東西。

最後回答一個常見疑慮:同一個事實在兩個地方各寫一次,是可以的。 FAQ 段寫一次、政策全文再寫一次,成本只是多幾行字,換到的是「不管撿到哪一段都答得出來」。代價是改的時候兩邊都要改——所以會變動的數字(價格、天數、費率)請一併列進 8.4 的連動更新清單。

第 6 章 文件怎麼寫才容易被查到