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