> 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/tools/configure_tools.md).

# 爲 AI 助理配置工具

建立好的工具現在可以在 AI 助理設定中被選用，賦予您的 AI 助理更強大的能力。本指南將說明如何將您建立的工具配置給特定的 AI 助理。

## 配置工具 <a href="#configure-tools" id="configure-tools"></a>

### 1. 進入 AI 助理設定 <a href="#step-1-enter-ai-agent-settings" id="step-1-enter-ai-agent-settings"></a>

首先，請從左側導航欄進入「<mark style="color:blue;">AI 功能</mark>」區塊，然後點擊「<mark style="color:blue;">AI 助理</mark>」。這將顯示您帳戶中所有已建立的 AI 助理列表。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-ffd8bf73dbfce28eea2e1cd2d02f409cd0a9bceb%2F%E6%88%AA%E5%9C%96%202025-05-03%20%E6%99%9A%E4%B8%8A7.25.10.png?alt=media&amp;token=2f913178-032d-43ea-9091-c7d8d568bbef" alt="AI 助理列表頁面"><figcaption><p>找到您想要配置工具的 AI 助理</p></figcaption></figure>

### 2. 選擇要配置的 AI 助理 <a href="#step-2-select-ai-agent" id="step-2-select-ai-agent"></a>

在 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-345e60461acf7c053e4f49c7258c857b0c24448a%2F%E6%88%AA%E5%9C%96%202025-05-03%20%E6%99%9A%E4%B8%8A7.26.25.png?alt=media&amp;token=b71e7d09-c5eb-4c45-8ecd-05995be31903" alt="編輯 AI 助理按鈕"><figcaption><p>進入特定 AI 助理的設定頁面</p></figcaption></figure>

### 3. 切換 AI 助理的回答模式 <a href="#step-3-switch-qa-mode" id="step-3-switch-qa-mode"></a>

{% hint style="danger" %}
**重要前提：** 只有設定為 **Agent 模式** 的 AI 助理才能使用工具。如果您的 AI 助理處於其他模式（例如：一般(預設)回答模式），則無法為其配置或使用工具。
{% endhint %}

在 AI 助理的設定頁面中，切換到「<mark style="color:blue;">回答模式設定</mark>」頁面選項。

* **檢查**：確認當前選擇的模式是否為「<mark style="color:blue;">Agent 模式</mark>」
* **更改**：如果當前不是 Agent 模式，請將其**切換**為 Agent 模式。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-1499d143389cb8d71f818692f8ff2e9c7643a8eb%2F%E6%88%AA%E5%9C%96%202025-05-03%20%E6%99%9A%E4%B8%8A7.28.23.png?alt=media&amp;token=a144e183-cc37-414e-863d-9aa9ea6b1b82" alt="選擇 Agent 模式"><figcaption><p>確保 AI 助理已設定為 Agent 模式才能使用工具</p></figcaption></figure>

### 4. 切換到工具配置頁面 <a href="#step-4-go-to-tool-config-page" id="step-4-go-to-tool-config-page"></a>

在 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-cd68d5dadc21a838e4ed89db8f6cdf506d56e196%2F%E6%88%AA%E5%9C%96%202025-05-03%20%E6%99%9A%E4%B8%8A7.29.31.png?alt=media&amp;token=76af0fba-247c-4eee-b484-62e07306948d" alt="AI 助理設定中的工具頁面"><figcaption><p>找到工具配置頁面</p></figcaption></figure>

### 5. 選擇啟用的工具 <a href="#step-5-select-enabled-tools" id="step-5-select-enabled-tools"></a>

在此工具配置頁面，點選右上角「<mark style="color:blue;">➕ 選擇工具</mark>」按鈕，會開啟預先建置好的工具清單列表，並進行以下操作。

* **操作**：
  1. 瀏覽列表，找到您希望此 AI 助理能夠使用的工具。
  2. 勾選您想要啟用的工具旁邊的複選框。
  3. 您可以根據 AI 助理的任務和需求，選擇任意數量的工具。

{% hint style="info" %}
您可以選擇 MaiAgent 內建工具或您自行定義之工具
{% endhint %}

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-2c29034f2032a2b4a12405f3545707fc9d36b5f3%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-05%20171609.png?alt=media" alt="直接選擇工具介面"><figcaption><p>直接勾選希望此 AI 助理使用的工具</p></figcaption></figure>

{% hint style="info" %}
**提示：** 請確保只為 AI 助理配置它確實需要且被授權使用的工具。配置過多不相關的工具可能會影響 AI 的判斷準確性和回應效率。
{% endhint %}

### 6. 檢視已選工具 <a href="#step-6-review-selected-tools" id="step-6-review-selected-tools"></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-134d2bdec06fd4fe5b051f78484e174f738378d9%2F%E6%88%AA%E5%9C%96%202025-05-03%20%E6%99%9A%E4%B8%8A7.31.49.png?alt=media&amp;token=6cc13092-fdc8-4f2b-9dae-c5b2e6a9065d" alt="已選工具概覽"><figcaption><p>確認已為 AI 助理配置了正確的工具</p></figcaption></figure>

## 控制系統功能 <a href="#control-system-functions" id="control-system-functions"></a>

除了自行選擇的工具，AI 助理也有預設開啟的系統功能，例如搜尋目前對話的歷史訊息、讀取附件及產生下載連結。您可以依每個 AI 助理的工作需要個別關閉，減少不必要的 token 使用，也讓助理的行為更容易預期。

例如，客服主管建立一個只回答常見問題、不處理附件的 AI 助理。她進入該助理的進階設定，關閉附件讀取與解析功能並儲存；之後這個助理仍能回答知識庫問題，但不會再嘗試解析顧客上傳的檔案。

{% stepper %}
{% step %}

### 1. 進入進階設定 <a href="#open-advanced-settings" id="open-advanced-settings"></a>

開啟要調整的 AI 助理，從設定頁左側選擇 <mark style="color:blue;">進階設定</mark>。
{% endstep %}

{% step %}

### 2. 調整系統功能 <a href="#adjust-system-functions" id="adjust-system-functions"></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-c9c94f6d31a9899182ab5b66fa1269ecbff5cfa7%2Fai-agent-system-functions.png?alt=media" alt="AI 助理進階設定中的系統功能開關"><figcaption><p>依 AI 助理的用途開啟或關閉系統功能</p></figcaption></figure>
{% endstep %}

{% step %}

### 3. 儲存設定 <a href="#save-system-functions" id="save-system-functions"></a>

點擊右下角 <mark style="color:blue;">儲存</mark>，讓設定生效。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
清單中的後四項功能只在 <mark style="color:blue;">Agent 模式</mark> 生效。若這些開關無法操作，請先到 <mark style="color:blue;">回答模式設定</mark> 切換為 Agent 模式。
{% endhint %}

### 7. 💾 儲存 AI 助理設定 <a href="#step-7-save-ai-agent-settings" id="step-7-save-ai-agent-settings"></a>

完成工具的選擇後，**請務必記得**點擊「<mark style="color:blue;">儲存</mark>」按鈕，以保存您對 AI 助理設定所做的更改。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-f2179c3324fdc342b39515dd6990f39ff70e38fb%2F%E6%88%AA%E5%9C%96%202025-05-03%20%E6%99%9A%E4%B8%8A7.33.17.png?alt=media&amp;token=1c62f022-f64e-4a48-a4d6-64f947572ff3" alt="儲存 AI 助理設定按鈕"><figcaption><p>點擊「儲存」以應用工具配置更改</p></figcaption></figure>

## 配置 MaiAgent 內建工具 <a href="#configure-maiagent-builtin-tools" id="configure-maiagent-builtin-tools"></a>

MaiAgent 內建四種 AI 圖像生成工具，您可以根據您的需求套用給 AI 助理使用，不需額外設置：

{% hint style="info" %}
四種工具比較請參考：[MaiAgent 內建 AI 圖像生成工具](/tools/ai-image-generation-guide.md)
{% endhint %}

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-84ad24514cbde2c5beee4fdba44b8e5d2db3f18e%2Fimage%20(7)%20(1).png?alt=media&amp;token=2d7b2f6d-da4c-4cc0-80a3-8b5e11644d87" alt=""><figcaption></figcaption></figure>

***

現在，您選擇的 AI 助理已經擁有了使用這些已啟用工具的能力。在與該助理互動時，如果觸發了相關的場景，AI 就會嘗試呼叫這些工具來完成任務或獲取信息。


---

# 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/tools/configure_tools.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.
