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

# 使用官方內建 Agent

到 Agent 市集挑一隻官方內建 Agent，從上傳資料、追問釐清到取得可下載的產出。

這一頁是給**所有成員**看的：怎麼在 <mark style="color:blue;">Agent 市集</mark> 找到適合的官方內建 Agent、怎麼跟它工作、以及卡住的時候該找誰。

如果你是組織管理者、要決定開通哪幾隻給團隊，請看 [啟用與管理](/built-in-agents/management.md)。

## 官方內建 Agent 怎麼運作 <a href="#how-it-works" id="how-it-works"></a>

不管是哪一隻官方內建 Agent，工作方式都是同一套：**你給素材與需求，它追問到細節夠清楚，再產出成果。**

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-07d152d3b983893788a7fe0c4b07580ceaa777f8%2Fbuilt-in-agents-flow.png?alt=media" alt="官方內建 Agent 的四步運作流程"><figcaption><p>官方內建 Agent 的四步運作流程</p></figcaption></figure>

### 1. 依開場白指引，輸入工作內容或上傳文件 <a href="#step-input" id="step-input"></a>

開始對話後，Agent 會先送出**開場白**，說明它能幫你做什麼、需要你提供什麼。照著開場白給資料就對了——可以直接打字描述需求，也可以上傳文件（合約、履歷、報表、會議錄音檔⋯⋯依 Agent 而定）。

### 2. Agent 提供選擇與建議，幫你釐清產出細節 <a href="#step-clarify" id="step-clarify"></a>

Agent 不會拿到資料就悶頭開工。它會回頭問你關鍵的決定——例如「這份面試題要出給幾年經驗的人？」「報告要條列還是敘述？」——並且**直接給你選項**，你點選或補一句話就好。

部分 Agent 還會在這一步**透過連接器取得外部資訊**（例如讀取你的行事曆、雲端硬碟或第三方系統的資料）再繼續。第一次用到時會請你授權。

{% hint style="info" %}
這一步不要跳過。你在確認問題上多花的 30 秒，會直接反映在產出的準確度上。
{% endhint %}

### 3. 產出草稿 <a href="#step-draft" id="step-draft"></a>

細節確認完，Agent 就把成果產出來。你可以直接在對話裡繼續要求修改——換語氣、補段落、改結構都可以，不需要重頭再來一次。

### 4. 選擇是否輸出成特定檔案格式 <a href="#step-export" id="step-export"></a>

草稿滿意之後，可以請 Agent 輸出成檔案。支援的格式依 Agent 而定，常見的有 Word、Excel、PDF、簡報。產出的檔案會出現在對話裡，點擊即可下載。

## 到 Agent 市集挑一隻 <a href="#browse-marketplace" id="browse-marketplace"></a>

{% stepper %}
{% step %}

### 進入 Agent 市集

登入後點左側 <mark style="color:blue;">Agent 市集</mark>。
{% endstep %}

{% step %}

### 切到「官方內建」分頁

市集上方有 <mark style="color:blue;">官方內建</mark> 與 <mark style="color:blue;">組織自建</mark> 兩個分頁，切到 <mark style="color:blue;">官方內建</mark>。
{% endstep %}

{% step %}

### 搜尋或用場景分類篩選

* **搜尋**：上方搜尋列可搜 Agent 名稱、描述或場景關鍵字
* **場景分類**：用分類標籤（人資、法務、醫療、製造業⋯⋯）縮小範圍，或選 <mark style="color:blue;">全部場景</mark> 看全部
  {% endstep %}
  {% endstepper %}

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-e7c5739da0ff636f3b10b32f29e6aee58903a598%2Fbuilt-in-agents-marketplace.png?alt=media" alt="Agent 市集的官方內建分頁"><figcaption><p>Agent 市集 → 官方內建：上方為分頁與場景分類，右上顯示已啟用數量</p></figcaption></figure>

卡片會分成兩區：

| 區塊                                   | 意思           | 卡片上有什麼                                                                          |
| ------------------------------------ | ------------ | ------------------------------------------------------------------------------- |
| <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>，沒有 <mark style="color:blue;">開始對話</mark> |

頁面右上角會顯示組織目前<mark style="color:blue;">已啟用</mark> 的 Agent 數量與上限，這個額度由組織管理者授權。

## 先預覽再決定 <a href="#preview" id="preview"></a>

不確定某隻 Agent 到底能做什麼？點卡片右上角的<mark style="color:blue;">預覽</mark>（眼睛圖示），**不用啟用就能看**。

視窗標題是<mark style="color:blue;">對話 × 導覽同步</mark>，分左右兩欄一起播放：

* **左欄**：回放一段<mark style="color:blue;">示範情境之一</mark>——從開場白、使用者提出需求，到 Agent 一步步完成
* **右欄&#x20;**<mark style="color:blue;">**導覽 · 這一步在做什麼**</mark>：對話播到哪一步，右欄就高亮 <mark style="color:blue;">STEP 01</mark>、<mark style="color:blue;">STEP 02</mark>⋯⋯，說明那一步在做什麼，並標出用到的能力

播完之後右欄會變成<mark style="color:blue;">導覽 · 點各步驟展開說明</mark>，每個步驟都可以點開細看；想再看一次就按<mark style="color:blue;">重新播放</mark>。

視窗底部還有兩項資訊：

* <mark style="color:blue;">**連接器**</mark>：這隻 Agent 會用到哪些第三方服務（如 Microsoft 365、Google Workspace）
* **啟用狀態**：未啟用的 Agent 會標示<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-e6b437a8d9e5ce5053cc4b75af755c55a1bb2416%2Fbuilt-in-agents-preview.png?alt=media" alt="官方內建 Agent 的預覽視窗"><figcaption><p>預覽視窗：左欄回放示範對話，右欄同步高亮對應的導覽步驟</p></figcaption></figure>

## 開始對話 <a href="#start-conversation" id="start-conversation"></a>

在 <mark style="color:blue;">已啟用</mark> 的卡片點 <mark style="color:blue;">開始對話</mark>，就會開一個新對話，接著照上面 [官方內建 Agent 怎麼運作](#how-it-works) 的四步走即可。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-e6c49722b3142666d8d3b41acf034df93873a6ae%2Fbuilt-in-agents-chat-greeting.png?alt=media" alt="官方內建 Agent 的開場白"><figcaption><p>步驟 1：開場白會直接告訴你要提供什麼；左下角迴紋針可上傳文件</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-11c5c23f061ab5d1fcf6a0def45732f89557f53b%2Fbuilt-in-agents-chat-confirm.png?alt=media" alt="Agent 追問釐清細節"><figcaption><p>步驟 2：Agent 以選項卡追問細節，右上角顯示還有幾題</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-9115e38c12d1c624667c4f206dc281aecdf77474%2Fbuilt-in-agents-chat-output.png?alt=media" alt="Agent 產出的草稿"><figcaption><p>步驟 3：細節確認完，Agent 產出結構化草稿</p></figcaption></figure>

## 生成回覆時回看前文 <a href="#review-during-generation" id="review-during-generation"></a>

Agent 正在產生長篇回覆時，你可以直接向上捲動回看前面的內容。畫面會停在你捲到的位置，不會被後續產生的文字拉走；當你捲到**最後一則提問的上方**，輸入框上方就會出現<mark style="color:blue;">回到最新</mark>。

### 使用情境 <a href="#generation-scroll-scenario" id="generation-scroll-scenario"></a>

人資專員請<mark style="color:blue;">職務說明撰寫</mark> Agent 產出一份完整的職務說明。回覆還在生成時，她想回頭確認前面給的職稱與部門有沒有寫錯，於是向上捲動——畫面停在原處，不會因為新文字出現而跳走。確認完之後她按<mark style="color:blue;">回到最新</mark>，畫面回到最後一則提問的位置，繼續看 Agent 把剩下的內容寫完。

### 操作方式 <a href="#generation-scroll-steps" id="generation-scroll-steps"></a>

{% stepper %}
{% step %}

### 1. 向上捲動 <a href="#scroll-up-during-generation" id="scroll-up-during-generation"></a>

在 Agent 產生回覆期間，用滑鼠滾輪、觸控手勢或拖曳捲軸向上捲動。
{% endstep %}

{% step %}

### 2. 在原地閱讀 <a href="#read-in-place" id="read-in-place"></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-32f18f3dd8ff2e1e82cc1ddcdf0e4bc658314a88%2Fbuilt-in-agents-back-to-latest.png?alt=media" alt="回覆生成期間向上捲動，輸入框上方顯示「回到最新」"><figcaption><p>回覆仍在生成（右上角顯示「思考回覆中」、右下角為「停止回覆」），向上捲動後輸入框上方出現「回到最新」</p></figcaption></figure>
{% endstep %}

{% step %}

### 3. 回到最新 <a href="#press-back-to-latest" id="press-back-to-latest"></a>

按<mark style="color:blue;">回到最新</mark>，畫面會回到最後一則提問的位置，並恢復自動跟隨最新內容。
{% endstep %}
{% endstepper %}

## 回到最近用過的 Agent <a href="#recently-used" id="recently-used"></a>

當你**至少跟一隻官方內建 Agent 對話過**之後，市集上方會多出<mark style="color:blue;">最近使用</mark> 一列，依你最後一次對話的時間由新到舊排序。點<mark style="color:blue;">繼續對話</mark> 就能接續上次的工作，不用再回分類裡翻。

{% hint style="info" %}
這一列只收**已啟用**且**你本人對話過**的 Agent。剛加入組織、還沒開始用的時候不會出現，屬正常。
{% endhint %}

## 官方內建 Agent 無法使用的情況 <a href="#unavailable-cases" id="unavailable-cases"></a>

三種情況看起來很像，但原因不同：

| 你看到的                                                                                                                           | 代表                                                            | 怎麼辦                                                   |
| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | ----------------------------------------------------- |
| Agent 在 <mark style="color:blue;">未啟用</mark> 區，只有 <mark style="color:blue;">預覽</mark> 沒有 <mark style="color:blue;">開始對話</mark> | 組織還沒開通這一隻                                                     | 聯絡組織管理者請他開通                                           |
| Agent 在 <mark style="color:blue;">已啟用</mark> 區，但顯示<mark style="color:blue;">無使用權限</mark>                                       | 組織開通了，但你不在這隻 Agent 的<mark style="color:blue;">開放對象</mark> 名單內 | 聯絡組織管理者，請他把你的角色／群組加進開放對象                              |
| 市集裡根本沒有 <mark style="color:blue;">官方內建</mark> 分頁                                                                               | 你們的方案不包含官方內建 Agent                                            | 需要升級方案，請洽業務團隊。見 [試用與訂閱方案](/others/trial-and-plans.md) |

{% hint style="info" %}
搜尋沒結果時，可以點<mark style="color:blue;">清除搜尋</mark> 看這個分類的全部 Agent，或點<mark style="color:blue;">清除已選</mark> 取消分類篩選。
{% endhint %}

如果某個分類完全沒有啟用中的 Agent，該區會顯示<mark style="color:blue;">此分類無啟用中的 Agent</mark> 與一顆<mark style="color:blue;">申請啟用</mark> 按鈕。這顆按鈕會把你帶到 [內建 Agent 管理](/built-in-agents/management.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 dynamically by asking a question.

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

```
GET https://docs.maiagent.ai/built-in-agents/use.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
