> 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/work/file-library/search-and-details.md).

# 搜尋、篩選與檔案詳情

在檔案庫跨空間搜尋檔案、依類型篩選、查看檔案詳情，以及批次移動、刪除與下載檔案。

檔案一多，不用記它放在哪：上方搜尋會跨所有你看得到的空間找檔案，結果標出所在位置，點一下就能開啟。

## 使用情境 <a href="#use-case" id="use-case"></a>

客戶來電詢問上一季的報價，業務專員只記得檔名有「報價」兩個字。她在檔案庫上方搜尋「報價」，結果列出「Q3 報價單.xlsx」，下方標著「我的檔案 › A1 上市提案」；點開後右側顯示檔案詳情，她直接按 <mark style="color:blue;">下載</mark> 附給客戶。

***

## 跨空間搜尋 <a href="#search" id="search"></a>

在檔案庫右上角的 <mark style="color:blue;">搜尋所有可見檔案</mark> 輸入關鍵字，按搜尋按鈕。結果會列出所有你有權限看到的空間中符合的檔案，每筆結果下方標示所在位置（空間 › 工作區 › 資料夾）。點選檔名即可開啟檔案詳情。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-ee3ba9e442d64fec672468a280fcfcce5677eb54%2Ffile-library-search.png?alt=media" alt="檔案庫搜尋「報價」的結果，檔名下方標示所在位置"><figcaption><p>搜尋結果標示「跨所有可見空間」與檔案所在位置</p></figcaption></figure>

{% hint style="info" %}
若只想在目前空間找工作區，可以使用清單上方的 <mark style="color:blue;">搜尋此空間的檔案工作區</mark>。
{% endhint %}

***

## 依類型篩選與切換檢視 <a href="#filter-and-view" id="filter-and-view"></a>

在工作區內點選 <mark style="color:blue;">類型：全部</mark>，可以多選要顯示的檔案類型（例如只看 Excel 或簡報）；未勾選任何類型時顯示全部。清單右上角可以切換 <mark style="color:blue;">列表檢視</mark> 與 <mark style="color:blue;">縮圖檢視</mark>。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0db83e06a2c1b2a6238460208de5df15083bc043%2Ffile-library-type-filter.png?alt=media" alt="類型篩選選單，可多選 PDF、Word、PowerPoint、Excel 等類型"><figcaption><p>類型可以多選；未勾選代表顯示全部</p></figcaption></figure>

***

## 檔案詳情 <a href="#file-details" id="file-details"></a>

點選檔名會在右側開啟檔案詳情，內容包括：

* **上方操作**：下載、移動、刪除
* <mark style="color:blue;">編輯</mark>、<mark style="color:blue;">上傳新版本</mark>：見 [線上編輯](https://docs.maiagent.ai/work/file-library/online-editing.md)；檔案改過之後還會出現 <mark style="color:blue;">版本</mark>，見 [版本紀錄與還原](https://docs.maiagent.ai/work/file-library/versions.md)
* **基本資訊**：大小、檔案位置、建立時間、建立者、更新時間、更新者、來源（例如 <mark style="color:blue;">上傳</mark>、<mark style="color:blue;">Agent 產出</mark>）；AI 產出的檔案另外顯示來源工作區與產出對話
* **檔案預覽**
* <mark style="color:blue;">開始對話</mark>：把這個檔案帶進新的 MaiGPT 對話

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-4bbb0a527a9155c2673bd54336c8d152358d2605%2Ffile-library-file-detail.png?alt=media" alt="檔案詳情側欄，上方有編輯與上傳新版本，下方為基本資訊、檔案預覽與開始對話按鈕"><figcaption><p>檔案詳情側欄</p></figcaption></figure>

***

## 批次操作 <a href="#batch-actions" id="batch-actions"></a>

勾選清單左側的核取方塊（或勾選標題列全選），上方會出現 <mark style="color:blue;">移動</mark>、<mark style="color:blue;">刪除</mark> 等操作。每次最多處理 **200** 個檔案。單一檔案也可以在該列的 <mark style="color:blue;">⋯</mark> 選單中 <mark style="color:blue;">下載</mark>、<mark style="color:blue;">重新命名</mark>、<mark style="color:blue;">移動到…</mark> 或 <mark style="color:blue;">刪除</mark>。

{% hint style="info" %}
刪除的檔案可以在工作區的 <mark style="color:blue;">版本紀錄</mark> 中還原，詳見 [版本紀錄與還原](https://docs.maiagent.ai/work/file-library/versions.md)。
{% endhint %}

***

## 相關頁面 <a href="#related" id="related"></a>

* [建立工作區與匯入檔案](https://docs.maiagent.ai/work/file-library/create-and-import.md)
* [在 MaiGPT 使用工作區](https://docs.maiagent.ai/work/file-library/use-in-maigpt.md)


---

# 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/work/file-library/search-and-details.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.
