> 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/use-in-maigpt.md).

# 在 MaiGPT 使用工作區

從檔案工作區開啟 MaiGPT 對話，讓 AI 自己找檔、整份讀完再回答；工作區指引、對話附件自動歸檔與 AI 產出自動存檔的運作方式。

把工作區掛進 MaiGPT 後，不必再一份一份上傳檔案：AI 會依你的問題自己找到檔案、整份讀完再回答，並標出資料來源。對話中上傳的附件與 AI 產出的檔案，也會自動存回檔案庫。

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

業務專員在「A1 上市提案」工作區按 <mark style="color:blue;">由此開始對話</mark>，先問「這個工作區裡有哪些檔案？」確認 AI 看得到的範圍，再問「幫我整理 Q3 報價單的方案差異」。AI 讀取報價單後列出比較表。客戶傳來新的需求文件，她直接拖進對話，系統提示「已歸檔至『A1 上市提案』」；接著請 AI 依規格書與新需求寫一份提案大綱 Word 檔，檔案自動存進她的暫存區，詳情裡標著來自哪個工作區、哪段對話。

***

## 從工作區開始對話 <a href="#start-chat" id="start-chat"></a>

### 1. 由此開始對話 <a href="#start-from-workspace" id="start-from-workspace"></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-9f16f323c0c88d68d18152cfccf04e075a7aaeaf%2Ffile-library-start-chat.png?alt=media" alt="工作區上方的由此開始對話按鈕"><figcaption><p>由此開始對話位於工作區清單上方</p></figcaption></figure>

### 2. 確認工作區已掛上 <a href="#workspace-mounted" id="workspace-mounted"></a>

MaiGPT 開啟後，輸入框下方會出現工作區標籤（例如「A1 上市提案」），代表這段對話已掛上該工作區。點選標籤旁的 <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-59acf502eacf4cb74dfc00e95e0571dbb0ceb44c%2Ffile-library-maigpt-mounted.png?alt=media" alt="MaiGPT 輸入框下方顯示已掛上的工作區標籤"><figcaption><p>輸入框下方的工作區標籤</p></figcaption></figure>

{% hint style="info" %}

* 一段對話一次掛一個工作區。
* 也可以在檔案詳情點選 <mark style="color:blue;">開始對話</mark>，或勾選多個檔案後按 <mark style="color:blue;">開始對話</mark>，只把選中的檔案帶進對話。
  {% endhint %}

***

## 讓 AI 讀檔回答 <a href="#ai-reads-files" id="ai-reads-files"></a>

掛上工作區後，可以直接用檔名或內容描述提問：

| 你可以這樣問             | AI 會做什麼               |
| ------------------ | --------------------- |
| 「這個工作區裡有哪些檔案？」     | 列出資料夾與檔案，讓你確認它看得到的範圍  |
| 「幫我整理 Q3 報價單的方案差異」 | 找到報價單、整份讀完後回答，並標出資料來源 |
| 「比較規格書和競品簡報的差異」    | 依需要讀取多份檔案再整理          |

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-76bfa236d19a88636d2fc0ca8ea7ce9a12f69af8%2Ffile-library-maigpt-read.png?alt=media" alt="AI 讀取 Q3 報價單後整理出方案比較表，輸入框上方顯示來自工作區的附件"><figcaption><p>AI 顯示讀取了哪份檔案；讀過的檔案會以附件形式標示「來自工作區」</p></figcaption></figure>

讀檔的規則：

* **每次最多讀 5 份檔案**。需要更多檔案時，可以分成幾次提問。
* **解析中或解析失敗的檔案讀不到**，等解析完成後再提問。
* **檔名不明確時**，AI 會先跟你確認要哪一份。
* **工作區超過 300 個項目時**，AI 會先看到資料夾層級的概要，再依問題往下找。
* 只有檢視權限的成員，AI 一樣能幫他讀檔，但不會替他修改檔案。

***

## 工作區指引 <a href="#workspace-guide" id="workspace-guide"></a>

每個工作區都有一份 <mark style="color:blue;">工作區指引</mark>，說明這個工作區放了什麼、各檔案的用途，AI 回答時會參考它。進入工作區後，點選上方工具列的 <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-7e44520401145484a5766f50ccee59803925f4eb%2Ffile-library-instructions-entry.png?alt=media" alt="工作區上方工具列，滑鼠停在文件圖示上顯示工作區指引提示"><figcaption><p>工作區指引位於由此開始對話右側的工具列</p></figcaption></figure>

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

業務專員打開「A1 上市提案」的工作區指引，看到系統已依報價單與規格書整理好檔案地圖。她想讓 AI 回答報價時多一條提醒，於是按 <mark style="color:blue;">編輯</mark> 補上「報價以 Q3 報價單為準，有效期限已過時要提醒使用者」，先按輸入框下方的 <mark style="color:blue;">儲存</mark> 確認草稿，再按視窗右下角的 <mark style="color:blue;">儲存</mark>，畫面顯示「工作區指引已儲存」，指引旁也記下她的名字與更新時間。幾天後同事上傳了競品比較簡報，她再打開指引，看到系統提示已產生更新建議；她按 <mark style="color:blue;">套用建議</mark> 先看過新內容，確認後按 <mark style="color:blue;">儲存</mark>，指引就回到自動維護。

### 查看指引 <a href="#view-workspace-guide" id="view-workspace-guide"></a>

視窗上方顯示指引內容，右側顯示最後更新的資訊：

* **系統自動更新的指引**：只顯示 <mark style="color:blue;">上次更新：</mark> 與時間。
* **有人按右下角儲存過的指引**（包含套用建議後儲存）：時間前面會加上最後儲存者的姓名，例如「王小明・上次更新：2026-10-25 10:51:55」，直到下一次系統自動更新指引為止。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-863dd7cef93a69ce2a4ff8eee5c5de59227f8c8c%2Ffile-library-instructions-auto.png?alt=media" alt="工作區指引視窗，內容為系統整理的檔案地圖與調用策略，右上只顯示上次更新時間，右下儲存按鈕為停用"><figcaption><p>系統自動更新的指引只顯示更新時間；尚未修改時無法按儲存</p></figcaption></figure>

指引還沒有內容時（例如工作區還沒有檔案），會顯示「尚未設定工作區指引，按「重新產生」讓 AI 依現有檔案產生建議」。

### 編輯、儲存與取消 <a href="#edit-workspace-guide" id="edit-workspace-guide"></a>

修改指引分成兩步：先在視窗裡改好草稿，最後按右下角的 <mark style="color:blue;">儲存</mark> 才會真正寫入。

{% stepper %}
{% step %}

### 編輯草稿 <a href="#edit-draft" id="edit-draft"></a>

按 <mark style="color:blue;">編輯</mark>，內容會變成可輸入的文字框。改完後按文字框下方的 <mark style="color:blue;">儲存</mark>，只會更新視窗裡的草稿，還沒有寫入工作區。編輯中右下角的 <mark style="color:blue;">儲存</mark> 會停用，要先結束編輯。
{% endstep %}

{% step %}

### 確認後儲存 <a href="#save-guide" id="save-guide"></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-ad14cbc225db14aca341af562c15fb9c86acf3b4%2Ffile-library-instructions-draft.png?alt=media" alt="工作區指引視窗顯示加上回答原則段落的草稿，右下儲存按鈕可以點選"><figcaption><p>草稿改好後，右下角的儲存才能點選</p></figcaption></figure>
{% endstep %}
{% endstepper %}

改到一半不想要了，按 <mark style="color:blue;">取消</mark> 關閉視窗，草稿會直接丟棄，指引維持原本的內容。

* **手動儲存後不再自動覆蓋**：你儲存過的指引，之後檔案異動時系統不會直接改寫，而是產生更新建議，見下一節。
* **重新產生**：按 <mark style="color:blue;">重新產生</mark>，系統會依目前的檔案重寫一份放進草稿，顯示「已產生新的指引建議」。要按右下角的 <mark style="color:blue;">儲存</mark> 才會保留；按 <mark style="color:blue;">取消</mark> 就不會改動。

### 套用更新建議 <a href="#apply-suggestion" id="apply-suggestion"></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-7e38ed29321fc12ea3da0ce146cd3fcc53646480%2Ffile-library-instructions-pending.png?alt=media" alt="工作區指引視窗上方顯示偵測到檔案異動的黃色提示與套用建議按鈕，右側顯示最後儲存者姓名（已遮蔽）與上次更新時間"><figcaption><p>手動儲存過的指引遇到檔案異動時，改為提示更新建議</p></figcaption></figure>

1. 按提示中的 <mark style="color:blue;">套用建議</mark>，建議內容會放進草稿讓你先看過，此時還沒有寫入。
2. 確認沒問題，按右下角的 <mark style="color:blue;">儲存</mark>。套用後指引會回到自動維護，之後的檔案異動會直接更新；在系統下一次自動更新之前，指引旁仍會顯示你的姓名與儲存時間。
3. 想先修改建議內容，可以按 <mark style="color:blue;">編輯</mark> 調整後再儲存；這樣會當成一次手動儲存，指引不會回到自動維護。

{% hint style="warning" %}
手動儲存不會清除這則更新建議：不論是修改建議後儲存，還是沒處理建議就直接編輯儲存，視窗上方的提示都會繼續顯示。這時如果再按 <mark style="color:blue;">套用建議</mark>，會用建議內容蓋掉你剛才儲存的修改，請先確認再套用。
{% endhint %}

{% hint style="info" %}
如果你在看建議的期間，系統又依新的檔案異動更新了建議，按 <mark style="color:blue;">儲存</mark> 時會顯示「建議已更新，請確認最新內容後再儲存」，視窗會載入最新內容，請重新確認後再套用。
{% endhint %}

### 權限 <a href="#workspace-guide-permissions" id="workspace-guide-permissions"></a>

* 需要該空間的編輯權限，才會看到 <mark style="color:blue;">編輯</mark>、<mark style="color:blue;">重新產生</mark>、<mark style="color:blue;">套用建議</mark> 與 <mark style="color:blue;">儲存</mark>。
* 只有檢視權限的成員可以開啟工作區指引查看內容，但不能修改。

***

## 對話附件自動歸檔 <a href="#attachment-filing" id="attachment-filing"></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-60f0cee512442e5ac7af7f17e10970707b979354%2Ffile-library-attachment-archived.png?alt=media" alt="對話上傳附件後顯示已歸檔至 A1 上市提案，並提供還原按鈕"><figcaption><p>歸檔提示會保留到你處理為止</p></figcaption></figure>

想放到別的工作區，直接在訊息裡說明，例如「這份放到客戶案工作區」。若找不到該工作區或你沒有寫入權限，檔案會留在目前的工作區，並告訴你原因。

***

## AI 產出自動存檔 <a href="#agent-output" id="agent-output"></a>

AI 在對話中產出的文件、圖片與影片，會自動存進你 <mark style="color:blue;">我的檔案</mark> 中的 <mark style="color:blue;">暫存區</mark>，不用另外下載整理。

* **右側 Output 清單**：對話右側面板的 <mark style="color:blue;">Output</mark> 會依時間列出這段對話的產出，可以預覽與下載；點選 <mark style="color:blue;">在檔案庫開啟</mark> 會跳到檔案所在的資料夾並開啟檔案詳情。
* **檔案詳情**：在暫存區開啟產出檔，詳情會標示 <mark style="color:blue;">來源</mark> 為 <mark style="color:blue;">Agent 產出</mark>，並顯示 <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-c3c1a0b7ec28751ead6ea10af6e7f3b9e17cb43b%2Ffile-library-output-panel.png?alt=media" alt="MaiGPT 右側面板的 Output 清單列出 AI 產出的 Word 檔"><figcaption><p>右側面板的 Output 清單</p></figcaption></figure>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-868b4ed5cd33dc10a9f3f72c4446812e16fe4fce%2Ffile-library-agent-output-detail.png?alt=media" alt="暫存區檔案詳情，來源為 Agent 產出，並顯示來源工作區與產出對話"><figcaption><p>產出檔詳情標示來源工作區與產出對話</p></figcaption></figure>

{% hint style="info" %}
要長期保存的產出，可以從暫存區移到正式的工作區。
{% endhint %}

***

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

* [讓 AI 修改、整理檔案](https://docs.maiagent.ai/work/file-library/ai-edit.md)
* [版本紀錄與還原](https://docs.maiagent.ai/work/file-library/versions.md)
* [AI 對話](https://docs.maiagent.ai/work/maigpt/chat.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/use-in-maigpt.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.
