> 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/maigpt/deep-research.md).

# Deep Research 深度研究

在 MaiGPT 擬定研究計畫、確認 Credits 預估與輸出形式，再閱讀研究報告

Deep Research 是 MaiGPT 的深度研究功能。輸入研究主題後，AI 會提出研究計畫，再依確認的方向搜尋、整理資料並產出報告，適合市場調查、競品分析與技術調研。

## 跟一般對話有什麼不同 <a href="#comparison-with-regular-chat" id="comparison-with-regular-chat"></a>

|      | 一般對話      | Deep Research       |
| ---- | --------- | ------------------- |
| 適合用途 | 快速問答與日常工作 | 需要搜尋、整理多個來源的研究      |
| 操作方式 | 輸入問題後取得回覆 | 先看研究計畫與成本預估，再選擇輸出形式 |
| 研究結果 | 對話回覆      | Canvas 文件、對話回覆或下載檔案 |
| 等待時間 | 通常較短      | 依主題範圍與搜尋情況而異        |

## 什麼時候用 <a href="#when-to-use" id="when-to-use"></a>

企業的企劃主管準備評估生成式 AI 導入方向。他在 MaiGPT 開啟 <mark style="color:blue;">深度研究</mark>，輸入「研究台灣企業導入生成式 AI 的現況、挑戰與成功案例」，先檢查研究計畫與預估 Credits，再選擇 <mark style="color:blue;">直接在對話中回覆</mark>。研究完成後，他便能在原對話閱讀整理好的內容與引用來源，作為後續討論的依據。

***

## 發起一次研究 <a href="#start-a-research" id="start-a-research"></a>

以下以不附加檔案的主題研究為例。

### 1. 開啟深度研究 <a href="#click-deep-research-button" id="click-deep-research-button"></a>

進入 <mark style="color:blue;">MaiGPT</mark> 的 <mark style="color:blue;">新對話</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-b4a5b4186a5735a0703c0669655cf5941a207a2b%2Fdeep-research-entry-prod.png?alt=media" alt="新增選單中的深度研究入口"><figcaption><p>在新增選單選擇「深度研究」</p></figcaption></figure>

{% hint style="info" %}
若看不到 <mark style="color:blue;">深度研究</mark>，請聯繫組織管理員確認您的 [MaiGPT 角色權限](/org/roles/maigpt-role-permissions.md)。
{% endhint %}

### 2. 輸入研究主題 <a href="#enter-research-topic" id="enter-research-topic"></a>

描述主題、範圍與報告用途，再點擊輸入框右下角的送出按鈕。想先確認方向時，可以明確要求「請先提出研究計畫，等我確認後再執行」。

| 較籠統     | 更具體                          |
| ------- | ---------------------------- |
| 「研究 AI」 | 「研究台灣企業導入生成式 AI 的現況、挑戰與成功案例」 |
| 「分析競品」  | 「比較三個指定產品的企業知識庫功能，整理適用情境」    |

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-07dfa96b10f6a93388c1fe3938e3660855ccb702%2Fdeep-research-input-prod.png?alt=media" alt="已啟用深度研究並填入研究主題的輸入框"><figcaption><p>確認「深度研究」已啟用，再送出研究主題</p></figcaption></figure>

### 3. 檢查計畫與成本預估 <a href="#review-research-plan" id="review-research-plan"></a>

閱讀 AI 提出的研究方向與預估 Credits。若範圍不合適，先在同一個對話提出調整要求；方向與預估都可接受，再進行下一步。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-28d9408e878f9d401a71f655e9c0fdfd99c044e6%2Fdeep-research-plan-estimate-prod.png?alt=media" alt="研究方向清單與預估 Credits 消耗"><figcaption><p>研究計畫附上成本預估；圖中金額僅為這次示範的估算</p></figcaption></figure>

### 4. 選擇輸出形式並確認開始 <a href="#choose-output-format" id="choose-output-format"></a>

在 <mark style="color:blue;">確認開始前，選擇研究報告的輸出形式</mark> 卡片點選一種格式：

| 選項                                              | 研究完成後的呈現方式                    |
| ----------------------------------------------- | ----------------------------- |
| <mark style="color:blue;">Canvas 文件</mark>      | 在 Canvas 預覽報告，可查看原始碼、全螢幕閱讀與下載 |
| <mark style="color:blue;">直接在對話中回覆</mark>       | 在原對話顯示報告，方便沿著對話閱讀             |
| <mark style="color:blue;">下載檔案（docx／PDF）</mark> | 產生可下載的 Word 與 PDF 檔案，方便留存或分享  |

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-cb6056fc0b61ec7f285956ff99da97fc9647af5a%2Fdeep-research-output-format-prod.png?alt=media" alt="研究報告的三種輸出形式選擇卡片"><figcaption><p>依報告用途選擇 Canvas、對話回覆或下載檔案</p></figcaption></figure>

{% hint style="warning" %}
**點選格式也會送出確認訊息。** 系統接著檢查可用額度，通過後開始研究；請先看完計畫與成本預估，再點選。選定後，卡片會保留已選的形式，不能在卡片上重新選擇。
{% endhint %}

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-b6d07b8fd0357eac5a994054c5357a655b7020c3%2Fdeep-research-format-selected-prod.png?alt=media" alt="已選定直接在對話中回覆的卡片"><figcaption><p>選定後，卡片只保留這次使用的輸出形式</p></figcaption></figure>

### 5. 等待研究結果 <a href="#wait-for-ai-completion" id="wait-for-ai-completion"></a>

開始後，對話會顯示 <mark style="color:blue;">研究進度</mark>。AI 會搜尋與整理資料，再產生報告。所需時間依研究範圍、來源與生成情況而異，請以實際進度為準。

***

## Credits 消耗預估與額度預檢 <a href="#credit-estimation" id="credit-estimation"></a>

Deep Research 可能進行多次搜尋與分析。計畫中的成本預估能幫助您決定是否繼續；確認執行時，系統再依預估檢查可用額度。

### 預估是怎麼算出來的 <a href="#how-estimation-works" id="how-estimation-works"></a>

* 優先取所在組織最近最多 20 次研究的實際消耗，以中位數估算。
* 組織沒有研究紀錄時，改用全平台近期研究的中位數；仍無紀錄時，使用系統設定的預設估算。
* 這是歷史用量參考，並非依本次主題報出的固定價格。實際消耗依搜尋與 Token 等用量計費，可能高於或低於預估。

{% hint style="warning" %}
**預估不是消費上限，也不保證整次研究不會遇到額度不足。** 確認前的檢查是根據當時的預估與餘額進行；後續實際用量仍可能超出估算。
{% endhint %}

### 研究計畫會附上預估成本 <a href="#estimate-in-plan" id="estimate-in-plan"></a>

AI 提出計畫時，會附上預估 Credits 與「實際消耗可能高於或低於預估」的說明。文字由 AI 生成，措辭與金額可能不同，請閱讀本次對話中的提示。

### 執行前的額度檢查 <a href="#quota-precheck" id="quota-precheck"></a>

確認執行後，系統會檢查組織錢包及這次使用適用的額度；任一適用額度不足，該次研究便不會開始：

| 檢查項目   | 檢查什麼                  | 詳細說明                                                      |
| ------ | --------------------- | --------------------------------------------------------- |
| 組織錢包   | 可用 Credits 是否足以支付預估消耗 | [Credits 說明](/others/credits.md)                          |
| 個人額度   | 成員的可用額度（有設定時）         | [成員 Credits 額度](/others/credits/member-credit-quota.md)   |
| 角色共用額度 | 成員所屬角色的可用共用額度（有設定時）   | [角色額度](/others/credits/member-credit-quota.md#role-quota) |
| 對話平台額度 | 這次對話所屬平台的可用額度（有設定時）   | [對話平台 Credits 額度](/others/credits/inbox-credit-quota.md)  |

### 被擋下時會發生什麼 <a href="#blocked-experience" id="blocked-experience"></a>

* AI 會提示額度不足；依提示聯繫組織管理員處理。
* 研究不會開始，原對話與研究計畫會保留在等待確認的階段。
* 額度補足後，在同一個對話請 AI 繼續執行，例如「額度已補足，請依剛才的計畫開始研究」，不必重打主題。

### 額度不足時誰該做什麼 <a href="#insufficient-quota-actions" id="insufficient-quota-actions"></a>

| 您的身分  | 該做什麼                              |
| ----- | --------------------------------- |
| 一般成員  | 將不足額提示告知組織管理員，說明研究用途與預估消耗         |
| 組織管理員 | 依提示檢查組織錢包、個人、角色或對話平台額度，再按組織預算安排處理 |

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

#### Q：看到預估成本，就代表已經扣除這筆金額嗎？ <a href="#faq-estimate-no-charge" id="faq-estimate-no-charge"></a>

不會直接扣除預估金額。**估算與額度檢查本身不收費，但產生研究計畫、確認對話等 AI 回覆仍可能消耗 Credits。** 因此，研究尚未開始或被額度檢查擋下，不代表整段對話完全免費。

#### Q：為什麼實際消耗比預估高（或低）？ <a href="#faq-estimate-vs-actual" id="faq-estimate-vs-actual"></a>

預估採用歷史研究成本；本次搜尋次數、來源長度與 Token 用量不同，實際消耗也會不同。

#### Q：被擋下後補了額度，要重新發起研究嗎？ <a href="#faq-resume-after-topup" id="faq-resume-after-topup"></a>

不用。回到原對話，請 AI 依已確認的計畫繼續執行即可。

#### Q：為什麼沒有看到成本預估？ <a href="#faq-no-estimate-shown" id="faq-no-estimate-shown"></a>

未啟用 Credits 計費的部署環境不會提供成本預估。若暫時無法取得預估，仍會依既有可用額度規則檢查；未顯示估算不代表免費。

***

## 閱讀與匯出報告 <a href="#read-and-export-report" id="read-and-export-report"></a>

### 閱讀報告 <a href="#read-report" id="read-report"></a>

研究完成後，依先前選擇的形式開啟結果。閱讀結論時，也請檢查報告提供的引用來源與適用範圍。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-2041d9a320de86a843311e2dee943608fbe6c25d%2Fdeep-research-report-chat-prod.png?alt=media" alt="直接在對話中顯示的研究報告開頭"><figcaption><p>選擇對話回覆後，完成的報告可在原對話閱讀；圖為報告開頭節錄</p></figcaption></figure>

選擇 <mark style="color:blue;">Canvas 文件</mark> 時，報告會出現在 Canvas 面板。點擊右上角的 <mark style="color:blue;">全螢幕檢視</mark> 可放大閱讀；<mark style="color:blue;">切換到程式碼模式</mark> 會顯示 Markdown 原始內容，再點擊 <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-11cbf4f3f94ea32b66f5f5e3909d3fd32d25bd4a%2Fdeep-research-canvas-preview-prod.png?alt=media" alt="研究報告在 Canvas 全螢幕預覽中顯示"><figcaption><p>Canvas 全螢幕預覽保留報告標題、內文與上方操作按鈕</p></figcaption></figure>

### 修改報告 <a href="#edit-report" id="edit-report"></a>

本頁研究輸出的 Markdown Canvas 提供預覽、原始碼查看與下載，**不提供直接打字編輯**。若要手動修改報告，可下載原始 Markdown 檔案，或在開始研究前選擇 <mark style="color:blue;">下載檔案（docx／PDF）</mark>，再用對應的編輯工具修改下載的 Word 檔案。

需要額外搜尋或分析時，可在對話提出後續問題；新的 AI 回覆仍會依實際用量計費。

### 匯出 <a href="#export" id="export"></a>

選擇 <mark style="color:blue;">下載檔案（docx／PDF）</mark> 時，報告完成後還會顯示 <mark style="color:blue;">正在產生下載檔案…</mark>。等待檔案產生完成，再點擊對應檔案的 <mark style="color:blue;">下載</mark>。若選擇 Canvas，點擊面板右上角的 <mark style="color:blue;">下載</mark>，再選擇 <mark style="color:blue;">原始格式 (.md)</mark> 或 <mark style="color:blue;">PDF 文件</mark>。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-d5982518ba62074eebf39c8dc9a3c34244a1dc9f%2Fdeep-research-file-downloads-prod.png?alt=media" alt="完成研究後可下載 Word 與 PDF 檔案"><figcaption><p>檔案產生完成後，分別點擊 Word 或 PDF 檔案旁的「下載」</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-fb03d6723986b955c93a2b65a523306d3eff9944%2Fdeep-research-canvas-download-menu-prod.png?alt=media" alt="Canvas 的原始 Markdown 與 PDF 下載選單"><figcaption><p>Canvas 下載選單提供原始 Markdown 與 PDF 文件</p></figcaption></figure>

## 下一步 <a href="#next-steps" id="next-steps"></a>

* [了解 Canvas 畫布](/work/maigpt/canvas.md)
* [查看 Credits 與消耗紀錄](/others/credits.md)
* [回到 MaiGPT 總覽](/work/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/maigpt/deep-research.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.
