跳轉到

工具設定

工具（Tools）讓 Agent 可以做更多事情——查詢資料、搜尋網路、呼叫其他 Agent，甚至收集結構化資訊。

什麼是工具？

預設的 Agent 只能基於 Instruction 和對話內容回答問題。透過工具，Agent 可以：

  • 📚 查詢知識庫：從你上傳的文件或連接的資料來源取得資訊
  • 🌐 搜尋網路：取得即時資訊
  • 🤖 呼叫其他 Agent：分工處理不同任務
  • 📝 收集表單：引導用戶填寫結構化資料

在哪裡設定工具

  • 在 Agent Editor 左側面板中，在灰色底的區域（進階設定區）找到「工具」區塊，按下「新增工具」。
  • 如已新增工具，則可直接看到「工具名稱」，每個工具會有一個 Icon 代表該工具的類型，也可以點開一個工具，檢查此工具的設定。

前置準備

在新增某些工具前，你需要先準備對應的資源：

  • Knowledge Base：需要先在工作空間中連接資料來源（Notion、Google Drive 等）
  • Call Agent：需要先建立並發布至少一個 Agent

如果工作空間中沒有可用的資源，對應的工具選項會在工具選擇器中顯示為灰色並標註「所有 XX 都已選擇」，無法新增。

先準備資源

  • 建議先完成知識庫設定或 Agent 建立，再開始設定工具。

可用工具

工具 功能 詳細說明
Knowledge Base 查詢已連接的資料來源 Knowledge Base
Web Search 網路搜尋即時資訊 Web Search
Call Agent 呼叫其他 Agent 協助 Call Agent
Request Form 收集結構化表單資料 Request Form

新增工具

步驟 1：開啟工具選擇器

點擊「新增工具」按鈕，開啟工具選擇器，你將會看到一個選單。

步驟 2：選擇工具

工具選擇器會顯示可用的工具選項，按類型分組：

  • 知識庫：顯示工作空間中已連接但尚未選用的資料來源（如 Notion、Google Drive）
  • 網路搜尋：可直接選擇新增
  • 表單工具：可直接選擇新增
  • 代理工具：顯示工作空間中已建立但尚未選用的 Agent

你可以透過搜尋框快速找到特定工具，或直接從列表中選擇。

已選工具不會重複顯示

  • 工具選擇器會自動過濾掉已經添加的工具，避免重複選擇。
  • 例如，如果你已經添加了「Notion」知識庫，在工具選擇器中就不會再看到「Notion」選項。

工具選擇器

步驟 3：設定工具參數

每種工具有不同的設定項目，完成後點擊確認。

工具列表顯示方式

已添加的工具會顯示在「工具」區塊下方，按類型分組：

  • 📚 知識庫：顯示已選用的資料來源名稱（如 Notion、Google Drive）
  • 🌐 網路搜尋：顯示「網路搜尋」標籤，若有設定網域限制會顯示在標籤旁
  • 📝 表單工具：顯示表單標題
  • 🤖 代理工具：顯示目標 Agent 名稱和版本標籤

每個工具都可以展開查看詳細設定（如「調用指示」（When to Use）），也可以點擊刪除按鈕移除。

調用指示（When to Use）

每個工具都可以設定「調用指示（When to Use）」，告訴 Agent 何時以及如何使用這個工具。

範例：

當用戶詢問產品規格、價格或功能時，使用這個工具查詢產品知識庫。

只在用戶明確要求查詢最新消息時才使用網路搜尋。

工具數量限制

  • 總工具數量：最多 10 個
  • Call Agent：最多 5 個

這個限制是為了確保 Agent 能有效選擇和使用工具。

UI 提示

  • 當達到工具數量上限時，「新增工具」按鈕會被禁用。
  • 如果某類工具（如知識庫或代理工具）沒有可用資源，該選項會在工具選擇器中顯示為灰色並標註「所有 XX 都已選擇」。

讓 Copilot 提供建議

Copilot 可以根據你的需求建議應該加入哪些工具：

我的 Agent 需要回答產品問題，也要能查最新的市場資訊，
需要哪些工具？

Copilot 也可以建議如何寫「調用指示」（When to Use），可問 Copilot：

我加了一個產品知識庫的工具，幫我寫 When to Use

我建立了網路搜尋的工具，但沒有如預期被啟用，剛剛的情況是（描述問題），請幫我調整 When to Use

工具的執行順序

當 Agent 需要呼叫多個工具時：

  • 工具會依序執行，不是平行處理
  • Agent 會根據每個工具的結果決定下一步

常見問題

Agent 怎麼知道要用哪個工具？

Agent 會根據：1) 核心指示（Core Instruction）中的指示、2) 各工具的調用指示（When to Use）、3) 用戶的問題內容，自動判斷是否需要使用工具以及使用哪個。

工具沒有被使用怎麼辦？

可能原因：

  • When to Use 不夠清楚
  • 用戶問題沒有觸發工具使用條件
  • Instruction 沒有提到相關場景

嘗試調整 When to Use 或在 Instruction 中明確指示使用工具的時機。

可以讓工具自動執行嗎？

目前工具是由 Agent 根據對話內容判斷是否執行。如果希望每次對話都查詢知識庫，可以在 Instruction 中明確指示。

如果被選用的知識庫或 Agent 被刪除了怎麼辦？

系統會自動檢查並處理：

  • 如果被選用的知識庫在工作空間中被刪除，該工具會自動從 Agent 設定中移除
  • 如果被呼叫的 Agent 被刪除，該 Call Agent 工具會自動移除，並顯示通知訊息

建議定期檢查 Agent 的工具設定，確保所有工具都正常運作。

下一步

了解各工具的詳細設定：