> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/serve/daily-operations/reply/inbox-search.md).

# 收件匣搜尋

快速搜尋與過濾收件匣對話

### 功能簡介 <a href="#feature-introduction" id="feature-introduction"></a>

收件匣搜尋功能讓您能快速找到特定的對話記錄，無需手動翻閱大量對話列表。透過關鍵字搜尋，您可以即時過濾出相關的對話內容，大幅提升客服工作效率。

{% hint style="info" %}
此功能支援即時搜尋（輸入即搜尋），並自動保存最近的搜尋記錄，方便快速重複查詢。
{% endhint %}

***

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

#### 基本搜尋 <a href="#basic-search" id="basic-search"></a>

1. **進入收件匣頁面**
   * 點選左側選單「<mark style="color:blue;">客服對話</mark>」
   * 點選「<mark style="color:blue;">所有對話</mark>」或選擇特定對話平台
2. **輸入搜尋關鍵字**
   * 在收件匣上方的搜尋框中輸入關鍵字
   * 系統會即時顯示符合的對話列表
3. **檢視搜尋結果**
   * 對話列表會自動過濾，只顯示包含關鍵字的對話；點開對話後再往上捲找到該則訊息

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-413479b6d7c4cc8a391ea42178872b089bdee8a6%2Finbox-search-results.png?alt=media" alt="在對話中搜尋訊息輸入關鍵字後，對話清單只剩下包含該關鍵字的一則對話"><figcaption><p>輸入關鍵字後，清單只留下符合的對話</p></figcaption></figure>

#### 搜尋範圍 <a href="#search-scope" id="search-scope"></a>

系統會搜尋以下欄位：

* 訊息內容（使用者訊息、AI 回覆與客服回覆）
* 對話標題（重新命名過的名稱）

聯絡人姓名不在搜尋範圍內；要找某位客戶的對話，請用下方的 <mark style="color:blue;">依聯絡人篩選</mark>。

{% hint style="warning" %}
在左欄選了某個對話平台時，只會搜尋該平台的對話；要跨平台搜尋，請先點最上方的「所有對話」。
{% endhint %}

***

### 進階搜尋技巧 <a href="#advanced-search-tips" id="advanced-search-tips"></a>

#### 使用篩選條件 <a href="#using-filters" id="using-filters"></a>

除了關鍵字搜尋，還可以點搜尋框旁的篩選按鈕，組合以下條件（說明見 [所有對話：搜尋與篩選](/serve/daily-operations/reply.md#search-and-filter)）：

1. **依狀態篩選**：處理中、已解決、排隊中，可複選
2. **依聯絡人篩選**：只看某位聯絡人的對話
3. **依聯絡人標籤篩選**：依聯絡人身上的標籤
4. **依對話標籤篩選**：依對話本身的標籤

#### 搜尋組合範例 <a href="#search-combination-examples" id="search-combination-examples"></a>

**範例一：找還沒結案的發票問題**

```
搜尋關鍵字：發票
依狀態篩選：處理中
```

**範例二：查某位客戶的歷史對話**

```
依聯絡人篩選：王小明
依狀態篩選：已解決
```

***

### 應用情境 <a href="#use-cases" id="use-cases"></a>

#### 情境一：客服品質監控 <a href="#use-case-customer-service-quality-monitoring" id="use-case-customer-service-quality-monitoring"></a>

**需求**：主管需要檢視包含「退費」關鍵字的所有對話，評估處理品質

**操作方式**：

1. 在搜尋框輸入「退費」
2. 設定時間範圍為「最近 7 天」
3. 逐一檢視搜尋結果，確認處理是否符合標準

#### 情境二：問題追蹤 <a href="#use-case-issue-tracking" id="use-case-issue-tracking"></a>

**需求**：使用者回報某個問題，需要找出相關的歷史對話記錄

**操作方式**：

1. 輸入使用者名稱或關鍵問題描述
2. 查看過往對話記錄
3. 了解問題發生經過與處理情況

#### 情境三：效能分析 <a href="#use-case-performance-analysis" id="use-case-performance-analysis"></a>

**需求**：分析特定產品的諮詢量與問題類型

**操作方式**：

1. 搜尋產品名稱關鍵字
2. 匯出搜尋結果（如系統支援）
3. 分析常見問題與改善方向

***

### 常見問題 <a href="#faq" id="faq"></a>

#### Q：搜尋速度會受對話數量影響嗎？ <a href="#faq-search-speed-affected-by-volume" id="faq-search-speed-affected-by-volume"></a>

**A**：系統使用高效能搜尋技術，即使對話數量龐大，也能在 1-2 秒內返回結果。但建議適當使用時間範圍篩選，以獲得最佳體驗。

#### Q：搜尋是否區分大小寫？ <a href="#faq-case-sensitive-search" id="faq-case-sensitive-search"></a>

**A**：不區分。輸入「退貨」或「退貨」都會得到相同結果。

#### Q：可以同時搜尋多個關鍵字嗎？ <a href="#faq-multiple-keywords" id="faq-multiple-keywords"></a>

**A**：可以。輸入多個關鍵字（以空格分隔），系統會搜尋包含任一關鍵字的對話。

範例：輸入「退貨 退款」會搜尋包含「退貨」或「退款」的對話。

#### Q：搜尋歷史會保存嗎？ <a href="#faq-search-history-saved" id="faq-search-history-saved"></a>

**A**：系統會保存最近的搜尋關鍵字，方便您快速重複查詢。搜尋歷史會在瀏覽器中保存，清除瀏覽器資料會同時清除搜尋歷史。

#### Q：為什麼搜尋不到某些對話？ <a href="#faq-conversation-not-found" id="faq-conversation-not-found"></a>

**A**：可能原因：

* 對話已被刪除或封存
* 您沒有該對話的存取權限（受角色權限限制）
* 關鍵字拼寫錯誤，或關鍵字只出現在聯絡人姓名（姓名不在搜尋範圍）
* 篩選條件沒有清除，例如狀態篩選只勾了「已解決」

***

### 注意事項 <a href="#notes" id="notes"></a>

{% hint style="info" %}
**權限說明**

搜尋結果會受到您的角色權限限制：

* 只能搜尋您有權存取的對話平台
* 只能搜尋您有權存取的 Agent 相關對話
* 組織擁有者可以搜尋所有對話
  {% endhint %}

{% hint style="warning" %}
**效能建議**

* 避免使用過於常見的關鍵字（如「你好」、「謝謝」），會返回過多結果
* 善用狀態與標籤篩選，縮小搜尋範圍
* 處理完的對話標成「已解決」，再搭配狀態篩選就不會混在一起
  {% endhint %}

***

### 相關功能 <a href="#related-features" id="related-features"></a>

{% hint style="info" %}
**延伸功能**

* [所有對話的功能](/serve/daily-operations/reply.md)
* [對話查看器](/serve/daily-operations/reply/conversation-viewer.md)
* [Agent 監控](/build/agent-ops/evaluations.md#ai-agent-monitoring)
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/serve/daily-operations/reply/inbox-search.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.