為 Agent 配置工具

為 Agent 配置工具：在 Agent 設定頁選用已建立的 API／MCP 工具、關閉不需要的系統功能，以及啟用 MaiAgent 內建工具。

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

配置工具

1. 進入 Agent 設定

首先，請從左側導航欄進入「AI 功能」區塊，然後點擊「AI 助理」。這將顯示您帳戶中所有已建立的 Agent 列表。

Agent 列表：顯示名稱、大語言模型、回答模式等欄位，右上角有建立 Agent 按鈕，每列右側有操作按鈕

2. 選擇要配置的 Agent

在 Agent 列表中，找到您想要為其配置工具的 Agent，並點擊「編輯」按鈕，進入該 Agent 的詳細設定頁面。

3. 切換 Agent 的回答模式

重要前提： 只有設定為 Agent 模式 的 Agent 才能使用工具。如果您的 Agent 處於其他模式（例如：RAG 問答模式），則無法為其配置或使用工具。

在 Agent 的設定頁面中，點選左側導覽的「回答模式設定」。

檢查：確認當前選擇的模式是否為「Agent 模式」
更改：如果當前不是 Agent 模式，請將其切換為 Agent 模式。

4. 切換到工具配置頁面

在 Agent 的設定頁面中，點選左側導覽的「工具」。

Agent 設定頁：左側導覽選取工具，右側使用工具區塊列出已選的工具，右上角有選擇工具按鈕，右下角有儲存按鈕

5. 選擇啟用的工具

在此工具配置頁面，點選右上角「選擇工具」按鈕，會開啟預先建置好的工具清單列表，並進行以下操作。

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

您可以選擇 MaiAgent 內建工具或您自行定義之工具

選擇工具視窗：上方有搜尋欄與工具類型篩選，列出已選擇的工具與系統內建工具清單，每個工具前有勾選框

提示： 請確保只為 Agent 配置它確實需要且被授權使用的工具。配置過多不相關的工具可能會影響 AI 的判斷準確性和回應效率。

6. 檢視已選工具

在勾選完成後，您可以再次確認配置給 Agent 的工具，確保為此 Agent 配置了正確的工具。

控制系統功能

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

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

1. 進入進階設定

開啟要調整的 Agent，從設定頁左側選擇進階設定。

2. 調整系統功能

捲動到系統功能，依需要開啟或關閉下列功能：

搜尋對話歷史
取得訊息前後文
讀取純文字附件
解析附件內容
列出可用解析器
產生下載連結

關閉後，Agent 將無法再使用該功能，相關回答也可能受到影響。

讀取純文字附件或解析附件內容任一開啟時，在 Agent 模式下還會多一個「列出本對話檔案」工具：使用者幾輪前傳的文件與圖片、真人客服傳的檔案、以及 Agent 自己產出的檔案（Code Interpreter 輸出、Canvas 等），Agent 都能列出清單（檔名、類型、大小、上傳者、時間）並依類型、上傳者、檔名或時間篩選，再用解析工具重新打開文件或重看圖片。例如使用者先傳了一張收據，幾輪後問「剛剛那張收據金額多少？」，Agent 會先列出本對話檔案找到那張圖再回答；所有通路（LINE、Messenger、網頁、MaiGPT 等）都適用，只看得到本對話的檔案。兩個開關都關閉時沒有這個工具。