工具是使您的 Agent 能夠與外部系統互動的建構塊。 工具擴充 Agent 的功能,使其能回應使用者請求或自主觸發程序執行各種動作。 每個工具代表 Agent 能執行的特定能力。 例如,您可以為您的 Agent 配備執行以下操作的工具:
- 使用 Office 365 Outlook 連接器發送電子郵件
- 請查看當前天氣狀況與預報
- 從 Dataverse 讀取與寫入資料
- 閱讀並向 Teams 發佈訊息
新增工具的機制
您可以透過新增一個或多個工具來擴充自訂 Agent 的功能。 您的 Agent 可以使用生成式協調工具自動回應使用者。 您也可以在主題內明確呼叫工具。
使用生成式業務流程 (預設情況下處於活動狀態),您的 Agent 可以自動選擇最合適的工具或主題,或跨知識進行搜索以回應使用者。 這種協調模式創造出更具動態且智慧的對話體驗。
在經典模式 (生成式業務流程已關閉) 下,Agent只能使用主題來回應使用者。 但是,您仍然可以設計 Agent 以從主題內明確叫用工具。
您可以使用多種機制為 Agent 新增工具:
-
連接器:透過 Power Platform 連接器連接專有 API 與服務,以擷取資料或執行操作。
- 預建連接器:從數千個來自 Microsoft 及非 Microsoft 服務的熱門 API 預設連線中選擇。
- 自訂連接器:定義與自訂服務或系統的連接,以啟用使用 Power Platform 連接器的自訂工具選項。 連接器需要組織的檢視和共用權限,Agent 才能使用連接器。
- Agent 流程:定義 Agent 流程,包含一項或多項需執行的行動。
- 提示:基於模型的單輪提示,可以引用您提供的知識並生成代碼來分析資料。
- REST API:定義一個與 REST API 的連線,並選擇一個或多個 API 端點與方法作為工具加入。
- 模型情境協定:連接 MCP 伺服器以存取工具與資源。
- 電腦使用:讓您的 Agent 能與任何具備圖形使用者介面的系統互動,無論是網站或桌面應用程式,選擇按鈕、選單,或在螢幕欄位輸入文字。
您還可以使用另外兩種機制,為 Agent 加入類似工具的行為:
- 技能:一組相關工具的容器。
- 用戶端工具:向用戶端傳送事件活動,以便用戶端執行動作並回傳回應。
欲了解更多技能與客戶工具資訊,請參閱相關內容區的連結。
在 Agent 層級建立並新增工具
直接在 Copilot Studio 內建新工具,能簡化開發流程,並確保與 Agent 妥善整合。 新增至 Agent 的工具可用於在整個 Agent 交談中的自動協調流程。
透過在左側導覽窗格中選擇 Agent 並從清單中選擇您的 Agent 來開啟您的 Agent。
前往您 Agent 的工具頁面。
選取新增工具。
在新增工具窗格中,選擇新工具。
從出現的清單中選擇您想新增的工具類型:
- 提示
- Agent 流程
- 電腦使用
- 自訂連接器
- 模型內容通訊協定
- REST API
執行針對您選擇的工具類型的設定步驟。 例如,如果您選擇提示詞,您必須執行以下步驟:
- 定義提示範本和指示
- 指定輸入參數
- 設定知識來源
- 集合回應格式與限制
選擇儲存或發佈 (視情況而定),以建立新工具。
選取 [新增並設定]。 這個工具會被加入您的 Agent 中。 工具的設定頁面會出現。 您可以在這裡查看並更改您的工具設定。
您可以在 Agent 的工具頁面看到這個新工具。
查看並更改您的工具設定
您可以隨時查看並編輯工具的設定:前往您的 Agent 工具頁面,從工具列表中選擇該工具。
工具的設定頁面會開啟。 詳細資訊分為三區段顯示:
- 詳細資料
- 輸入
- 完成
對於以 Agent 工具連接的 MCP 伺服器,設定頁面與其他工具類型不同。 細節區塊類似,但不是輸入與完成,而是工具與資源區塊,提供 MCP 伺服器可用工具與資源的資訊。 欲了解更多資訊,請參閱檢視現有 MCP 伺服器中的工具與資源。
詳細資料
詳細資訊區段可讓您設定有關工具的基本詳細資訊。
您可以在這裡查看並更新:
名稱:工具的名稱。 這個名字會出現在您的 Agent 工具清單中。 請選擇一個能清楚說明工具功能的名稱。
描述:工具的描述。 生成式編排依賴此描述來判斷 Agent 何時應該使用該工具。 寫下清晰、具體的描述,包括工具的功能以及何時使用。
其他詳細資料:
- 允許 Agent 動態決定何時使用該工具:當選擇此選項時,Agent 可使用生成式協調來決定何時使用該工具。 如果沒有選擇這個選項,Agent 只在主題明確呼叫時才會使用該工具。 (預設情況下,啟用生成式協調流程時會選擇此選項。)
- 執行前詢問終端使用者:在終端使用者聊天體驗中,在執行工具前詢問 Agent 進行確認。 此選項預設為否。
- 驗證方式:選擇工具使用使用者的 (終端使用者) 或建立者的 (建立者提供) 憑證。 預設情況下,使用者驗證會被套用。
- 說明:您可以選擇性地加入 Agent 在執行工具時顯示給使用者的工具描述。 這個描述讓使用者知道他們被要求驗證的是什麼。
輸入
在這裡,您可以查看和設定工具的輸入。 這些輸入用於收集使用者的資訊以填寫工具所需的輸入。 資訊以資料表形式顯示,每個輸入佔一行。
預設情況下,每個輸入的填寫使用欄值設定為使用 AI 動態填寫。 Agent 嘗試從可用上下文 (例如,從使用者的訊息) 中提取值。 如果沒有找到合適的值,它會產生一個問題來詢問使用者一個值。 選擇自訂可存取輸入收集和填寫的更細微的自訂:
- 顯示名稱與描述:輸入在使用者眼中的呈現方式。
- 識別方式:使用者回應如何被解讀,例如以文字串或映射到預先定義的實體。
- 重試邏輯:如果 Agent 未識別使用者陳述式中的實體,則可以再次詢問該問題。
- 輸入驗證:在使用者輸入上設定額外的驗證行為,超出實體類型的預設值。
您也可以選擇用明確的值覆寫輸入,而不是讓 Agent 提取它。 若要設定覆寫,請將填入使用設定為自訂值,然後輸入值、選取變數,或使用 Power Fx 公式。 如果輸入被覆蓋,Agent 不會要求使用者輸入值。
完成
在這裡,您可以選擇工具執行完成後要執行的操作。
您可以讓 Agent 根據使用者的查詢和工具的結果自動為使用者產生上下文回應。
或者,您可以選擇為您的工具編寫一個特定的、格式化的回應來返回。 您可以使用變數選擇器從工具中插入輸出變數的參考。 您也可以用 Power Fx 公式來格式化回應。
在執行後下,選擇工具執行後應如何回應使用者的幾個不同選項之一:
- 不回應 (預設):Agent 將工具輸出納入其回應中
- 使用生成式 AI 編寫回應:讓 AI 使用工具輸出來製作上下文回應
- 傳送特定回應:建立帶有變數插入的範本回應
- 傳送調適型卡片:使用按鈕和動作建立豐富的互動式回應
您也可以設定哪些輸出變數要提供給 Agent 和其他工具使用。
工具選擇和輸入收集
當您在 Copilot Studio 定義工具時,您也會提供描述其用途的資訊。 這些資訊讓 Agent 能判斷何時使用該工具。 工具說明也協助協調者利用生成式 AI 生成問題,根據需要收集輸入。 您的 Agent 可以用問題收集資訊,填補使用工具所需的輸入。 因此,您不需要手動編寫問題節點來收集所需的所有輸入,例如流程中的輸入。 Agent 協調器會在執行時幫您處理輸入收集。
Agent 會考慮多項因素來決定工具的選擇:
- 工具的名稱和描述
- 目前交談上下文
- 使用者意圖源自訊息
- 可用的輸入和輸出
- 交談中之前使用的工具
文在生成模式下,預設工具會將資訊回傳給 Agent。 透過工具回應,Agent 能產生對使用者查詢的情境回應。 或者,您可以指示工具始終立即回應,生成消息或創作顯式消息。
從主題內呼叫現有工具
您可以在主題內明確呼叫工具。 根據您的使用情況,您可能會將您的工具用作更廣泛主題的一部分,從而使用更多節點。 或者,像在天氣範例中那樣,您所需要的可能就只是將節點新增至主題。
要從主題中叫用工具:
在 Copilot Studio 中,前往您要編輯的 Agent 的主題頁面。
建立新的主題,並指定其名稱,例如取得天氣。
加入適當的觸發字詞。 延續前一步的天氣範例,觸發字詞可包括:
- 會下雨嗎
- 今日預報
- 取得天氣
- 天氣如何
選擇新增節點 (+),然後選擇新增工具。 從可用工具中選擇該工具。 有三個索引標籤顯示不同類型的工具:
- 基本工具
- 連接器
- 工具
您的動作節點現已新增至您的主題。
選取儲存。
MCP 連線資訊
對於 MCP 連接器,您可以查看 MCP 工具與資源的名稱及說明,這些都是由 MCP 連接器提供的。 工具與資源的資訊以表格形式顯示,每個工具各行一行。
工具認證考量
某些工具需要身份驗證才能正常工作,例如動態提示或其他調用 Dataverse API 的工具。 適當的驗證設定可確保安全性,同時保持流暢的使用者體驗。
工具始終在使用者上下文中的 Agent 執行階段執行,並且除非啟用驗證,否則無法執行。 支援兩種類型的身份驗證方法:
- 終端使用者信用: Agent 使用使用者的憑證與服務進行驗證。 此方法可確保使用者僅訪問他們有權查看的資料。
- Maker 提供的憑證:Agent 使用作者的憑證與服務進行認證。 使用此認證模式用於共享資源或使用者不需個別存取時。
測試您的工具
使用生成式協調時,編排器會在認為工具與使用者查詢相關時選擇。
或者,您可以從主題中呼叫現有工具。
在您的 Agent 中開啟或關閉某個工具
您可以從工具設定頁面開啟或關閉您的 Agent 的工具。 關閉工具會阻止 Agent 使用該工具,但工具仍與 Agent 連接,之後可以重新開啟。 當您在 Agent 中新增工具時,預設會開啟它。
要關閉 Agent 中的某個工具:
- 前往您的 Agent 並選擇工具頁面的 Agent。
- 選擇工具進入工具設定頁面。
- 在設定頁面頂端,使用啟用開關關閉該工具。
- 選取儲存以套用變更。
該工具仍會出現在 Agent 工具清單中,但已不再開啟。
從您的 Agent 中刪除一個工具
關閉工具會阻止該工具使用,但同時也讓您有彈性可以之後重新開啟。 您也可以更永久地從 Agent 身上移除某個工具。 若要從您的 Agent 中刪除一個工具:
- 前往您的 Agent 並選擇工具頁面的 Agent。
- 在工具清單中找到該工具,並將滑鼠移到工具名稱上。 選擇這三個點(...)。
- 選取刪除。 隨即出現確認視窗。
- 選取刪除以移除工具。
該工具會從 Agent 工具清單中消失。
注意
您只能從 Agent 工具頁面刪除工具。 您無法從 Copilot Studio 的主頁面刪除工具。