共用方式為


向自訂 Agent 新增工具

工具是使您的 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 交談中的自動協調流程。

  1. 透過在左側導覽窗格中選擇 Agent 並從清單中選擇您的 Agent 來開啟您的 Agent。

  2. 前往您 Agent 的工具頁面。

  3. 選取新增工具

  4. 新增工具窗格中,選擇新工具

  5. 從出現的清單中選擇您想新增的工具類型:

    • 提示
    • Agent 流程
    • 電腦使用
    • 自訂連接器
    • 模型內容通訊協定
    • REST API

    螢幕擷取畫面顯示新增工具類型選擇,要加入 Agent

  6. 執行針對您選擇的工具類型的設定步驟。 例如,如果您選擇提示詞,您必須執行以下步驟:

    • 定義提示範本和指示
    • 指定輸入參數
    • 設定知識來源
    • 集合回應格式與限制
  7. 選擇儲存發佈 (視情況而定),以建立新工具。

  8. 選取 [新增並設定]。 這個工具會被加入您的 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 能產生對使用者查詢的情境回應。 或者,您可以指示工具始終立即回應,生成消息或創作顯式消息。

提示

使用工具生成的問題時,請告知使用者 AI 生成了一些對話。

例如,在交談開始系統主題中新增額外的訊息。 此主題會決定新對話開始時要向使用者顯示的訊息。

從主題內呼叫現有工具

您可以在主題內明確呼叫工具。 根據您的使用情況,您可能會將您的工具用作更廣泛主題的一部分,從而使用更多節點。 或者,像在天氣範例中那樣,您所需要的可能就只是將節點新增至主題。

要從主題中叫用工具:

  1. 在 Copilot Studio 中,前往您要編輯的 Agent 的主題頁面。

  2. 建立新的主題,並指定其名稱,例如取得天氣

  3. 加入適當的觸發字詞。 延續前一步的天氣範例,觸發字詞可包括:

    • 會下雨嗎
    • 今日預報
    • 取得天氣
    • 天氣如何
  4. 選擇新增節點 (+),然後選擇新增工具。 從可用工具中選擇該工具。 有三個索引標籤顯示不同類型的工具:

    • 基本工具
    • 連接器
    • 工具

    您的動作節點現已新增至您的主題。

  5. 選取儲存

MCP 連線資訊

對於 MCP 連接器,您可以查看 MCP 工具與資源的名稱及說明,這些都是由 MCP 連接器提供的。 工具與資源的資訊以表格形式顯示,每個工具各行一行。

工具認證考量

某些工具需要身份驗證才能正常工作,例如動態提示或其他調用 Dataverse API 的工具。 適當的驗證設定可確保安全性,同時保持流暢的使用者體驗。

工具始終在使用者上下文中的 Agent 執行階段執行,並且除非啟用驗證,否則無法執行。 支援兩種類型的身份驗證方法:

  • 終端使用者信用: Agent 使用使用者的憑證與服務進行驗證。 此方法可確保使用者僅訪問他們有權查看的資料。
  • Maker 提供的憑證:Agent 使用作者的憑證與服務進行認證。 使用此認證模式用於共享資源或使用者不需個別存取時。

測試您的工具

使用生成式協調時,編排器會在認為工具與使用者查詢相關時選擇。

或者,您可以從主題中呼叫現有工具

在您的 Agent 中開啟或關閉某個工具

您可以從工具設定頁面開啟或關閉您的 Agent 的工具。 關閉工具會阻止 Agent 使用該工具,但工具仍與 Agent 連接,之後可以重新開啟。 當您在 Agent 中新增工具時,預設會開啟它。

要關閉 Agent 中的某個工具:

  1. 前往您的 Agent 並選擇工具頁面的 Agent。
  2. 選擇工具進入工具設定頁面。
  3. 在設定頁面頂端,使用啟用開關關閉該工具。
  4. 選取儲存以套用變更。

該工具仍會出現在 Agent 工具清單中,但已不再開啟。

從您的 Agent 中刪除一個工具

關閉工具會阻止該工具使用,但同時也讓您有彈性可以之後重新開啟。 您也可以更永久地從 Agent 身上移除某個工具。 若要從您的 Agent 中刪除一個工具:

  1. 前往您的 Agent 並選擇工具頁面的 Agent。
  2. 在工具清單中找到該工具,並將滑鼠移到工具名稱上。 選擇這三個點(...)。
  3. 選取刪除。 隨即出現確認視窗。
  4. 選取刪除以移除工具。

該工具會從 Agent 工具清單中消失。

注意

您只能從 Agent 工具頁面刪除工具。 您無法從 Copilot Studio 的主頁面刪除工具