# 搜尋測試

## 為什麼需要搜尋測試？ <a href="#why-search-testing" id="why-search-testing"></a>

1. **確保回應準確性**

* AI 助理的回應品質直接影響客戶滿意度
* 錯誤或不相關的答案會損害品牌信任度

2. **避免資訊遺漏**

* 避免重要產品細節或安全說明被忽略
* 優化知識庫的使用效率

3. **提升問答一致性**

* 確保相同問題在不同時間都能得到一致的答案
* 避免因知識庫更新導致的回應不穩定

透過搜尋測試與片段預覽功能，您可以即時查看 AI 助理使用的資料片段品質，確保您的問答水準。

## 如何開始？ <a href="#how-to-get-started" id="how-to-get-started"></a>

1. 進入知識庫頁面，選擇要查看的知識庫並進入設定

<div><figure><img src="/files/63XN0xKiCsHfNk0EE6DE" alt=""><figcaption></figcaption></figure> <figure><img src="/files/TpRnjNkF6sSZNtm8aHLZ" alt=""><figcaption></figcaption></figure></div>

2. 進入後點選搜尋測試，進入頁面

在對話框內輸入要搜尋的內容：「挑選露營區要注意什麼？」，按下搜尋鍵後，AI 助理就會根據您的對話內容搜尋最相關的文件。

<figure><img src="/files/GEu9KdNqVUVMGCR79o0y" alt=""><figcaption></figcaption></figure>

3. 查看搜尋結果

右側會出現 AI 助理回答時會檢索的片段，如圖共有 12 個片段（檢索片段數量設定請參考：[如何建立知識庫：基本設置](/km/km-basic-settings.md#jian-suo-pian-duan)）

<figure><img src="/files/sqyFSz8tNsFppNodm0g2" alt=""><figcaption></figcaption></figure>

右側為針對此問題回答時根據的檢索內容，每個片段會顯示：

* 字數：片段涵蓋的字數
* 命中次數：AI 助理在回答時參考此片段的次數 (只統計正式問答，測試問答不會納入命中次數計算中)

  命中次數越高代表使用者詢問較多關於此片段的問題。

搜尋測試會記錄過去的測試問答，您可以快速點選歷史記錄重新測試，確保相同議題能保持或提升資料參考品質。

<figure><img src="/files/pkLXFIYURrV7gYiUrA7t" alt=""><figcaption></figcaption></figure>

## 檢查知識片段品質 <a href="#check-chunk-quality" id="check-chunk-quality"></a>

透過搜尋測試，可以確定 AI 助理在推理時使用哪些片段，進而檢查這些片段的內容是否需要優化，如：

<figure><img src="/files/BnVf4Ru0KtEoLQkLjBs8" alt=""><figcaption></figcaption></figure>

若在搜尋結果中發現許多空白的片段，且這些空白片段都屬於「<mark style="color:blue;">初級露營.pdf</mark>」這個檔案，這時就能檢查「<mark style="color:blue;">初級露營.pdf</mark>」的檔案內容是否都正確，並在**正式上線前**即時更新。

## 依 Metadata 搜尋測試 <a href="#search-by-metadata" id="search-by-metadata"></a>

### 什麼是 Metadata 搜尋？ <a href="#what-is-metadata-search" id="what-is-metadata-search"></a>

Metadata（後設資料）搜尋功能讓您可以根據文件的屬性資訊進行精準查詢,而不僅限於文件內容本身。這項功能特別適合用於：

* **文件分類查詢**：依據文件類型、標籤、分類等資訊搜尋
* **屬性篩選**：根據文件建立時間、作者、來源等屬性過濾
* **精準定位**：快速找到符合特定條件的文件集合

### 如何使用 Metadata 搜尋？ <a href="#how-to-use-metadata-search" id="how-to-use-metadata-search"></a>

在搜尋測試頁面中，您可以：

1. **選擇搜尋模式**：切換至「Metadata 搜尋」模式
2. **指定搜尋條件**：輸入您要搜尋的 metadata 欄位和值
3. **查看搜尋結果**：系統會顯示符合 metadata 條件的文件片段

**搜尋範例：**

* 搜尋特定分類的文件：`category:產品說明`
* 搜尋特定時間範圍的文件：`date:2025-01`
* 搜尋特定作者的文件：`author:客服部`

### Metadata 搜尋的優勢 <a href="#metadata-search-advantages" id="metadata-search-advantages"></a>

**1. 更精準的結果**

* 直接針對文件屬性查詢，減少無關結果
* 適合需要精確篩選的場景

**2. 更快速的定位**

* 不需要全文檢索，快速找到目標文件
* 特別適合大量文件的知識庫

**3. 結合內容搜尋**

* 可與一般內容搜尋結合使用
* 先用 metadata 縮小範圍，再用內容搜尋精準定位

### 實際應用場景 <a href="#practical-use-cases" id="practical-use-cases"></a>

**場景 1：產品文件管理**

* 搜尋特定產品線的所有文件
* 範例：`product_line:露營裝備`

**場景 2：時間範圍查詢**

* 找出最近更新的文件
* 範例：`updated_date:2025-11`

**場景 3：文件類型篩選**

* 只查看特定類型的文件（如：操作手冊、FAQ 等）
* 範例：`doc_type:FAQ`

## 搜尋測試協助您 <a href="#what-search-testing-helps-you" id="what-search-testing-helps-you"></a>

### 定期測試重要問題 <a href="#regular-testing-key-questions" id="regular-testing-key-questions"></a>

* 建議經常測試核心業務相關問題
* 在知識庫更新後進行重新測試
* 記錄並比較測試結果的改善情況

### 識別內容空白點 <a href="#identify-content-gaps" id="identify-content-gaps"></a>

* 發現知識缺口：測試常見問題，找出完全沒有命中結果的查詢
* 範例：測試「帳篷防水等級說明」發現無相關片段 → 需補充防水規格文件

### 評估內容完整性 <a href="#evaluate-content-completeness" id="evaluate-content-completeness"></a>

* 檢查回答深度：確認AI回答是否涵蓋問題的所有面向
* 範例：查詢「露營安全注意事項」→ 檢查是否涵蓋天氣、野生動物、用火安全等各個層面

## 問題測試技巧 <a href="#query-testing-techniques" id="query-testing-techniques"></a>

您可以：

* 用不同方式詢問同一個問題
* 測試複雜情境和多重條件查詢
* 驗證專業術語和產品名稱的檢索效果

透過這些測試技巧，全面評估回覆的正確度及完整性。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maiagent.ai/km/test-search-result.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.