將工具新增至自訂代理程式

Note

本文描述由 標準線束驅動的代理或代理流程中使用的功能。

工具是讓你的客服能與外部系統互動的建構組件。 工具擴展了代理的功能,代理能根據使用者請求或自主觸發執行各種動作。 每個工具都代表代理程式可執行的特定功能。 例如,你可以為你的經紀人配備執行以下任務的工具:

  • 使用 Office 365 Outlook 連接器發送電子郵件
  • 請查看當前天氣狀況與預報
  • 從 Dataverse 讀取和寫入數據
  • 閱讀並向 Teams 發佈訊息

是代理程式裡的工具,還是外掛的功能?

您在 Copilot Studio 中新增的工具屬於您的代理程式。 你的代理人決定何時使用它們,而你則在 Copilot Studio 中管理它們。 Microsoft 365 Copilot 外掛則不同:它打包技能、工具(如 MCP 伺服器與代理程式),讓使用者能在支援的 Copilot 體驗中共同尋找、安裝和管理這些工具。

問題與範例 代理程式中的工具 Microsoft 365 Copilot 外掛程式
什麼時候用? 你設計的是單一代理程式體驗,工具只有在其中才有意義。 你希望人們能直接在他們已經工作的 Copilot 體驗中使用某個功能。
誰決定工具何時運轉? 您的代理程式編排、主題與設定。 Copilot,在每個支援的體驗中。
人們在哪裡使用它? 你發佈代理程式的管道,例如 Teams。 支援的 Copilot 體驗。 每個體驗都會使用它支援的插件部分。
誰來管理? Copilot Studio 裡的製作者。 Power Platform 的資料政策控制建立者可以新增哪些工具。 管理員在 Microsoft 365 系統管理中心 中。
Example Contoso 的 IT 服務台代理程式負責在 Teams 中建立工單並重設密碼。 Contoso 的客戶帳戶外掛包含了準備客戶簡報的技能,以及一個可在公司 CRM 中查詢帳戶的 MCP 伺服器。 銷售人員要求 Copilot「為 Fabrikam 準備一份簡介」。

範例:代理程式中的工具(Contoso IT 客服桌代理程式)

Contoso IT 會在 Copilot Studio 中建立代理程式,並將其發佈到 Teams。 代理程式使用 ServiceNow 連接器查詢並建立工單、代理程式流程在經理核准後重設密碼,以及摘要工單歷史的提示。 代理程式的主題與編排決定每個工具何時執行,密碼重設會先請使用者確認。 IT 團隊在 Copilot Studio 中管理代理人,而 Power Platform 的資料政策則控制建立者可以使用哪些連接器。 客服人員的工具之所以適合這裡,是因為它們只在 Contoso 從頭到尾設計的客服台對話中才有意義。

範例:一個外掛(Contoso 客戶帳戶外掛)

Contoso Sales 套裝一個外掛,內含一項技能,可依團隊範本撰寫客戶簡報;一個 MCP 伺服器,可在 Contoso CRM 中查詢帳戶;並可選擇性地加入一個用於帳戶審查的宣告式代理程式。 Contoso 會將外掛發佈給其組織,管理員則將外掛提供給Microsoft 365 系統管理中心的銷售團隊使用。 在支援的體驗中,賣家會要求 Copilot「為 Fabrikam 準備一份簡報摘要」。Copilot 會使用這項技能和 CRM 工具,賣家並不需要另開獨立代理程式。 第一次,他們會連結 CRM 帳戶。 外掛適合這裡,因為這項功能應該放在賣家已經使用的 Copilot 體驗裡,而管理員可以在同一個地方管理。

欲了解更多關於外掛的資訊,請參閱外掛程式。

將工具添加到代理程式的機制

Note

如果你預期的工具在 新增工具 面板中沒有,你組織的政策可能會限制你可用的工具。 請與系統管理員連絡以尋求協助。

您的代理人可以用兩種方式使用工具:

  • 生成式編排(自動):生成式編排預設為開啟。 你的代理程式會為每項請求挑選最適合的工具、主題或知識來源。

    範例:使用者輸入「我的筆記型電腦無法連接 VPN」,代理程式選擇 ServiceNow 工具來開啟工單。

  • 從主題(明確指定):你從主題中的節點呼叫工具。 如果您關閉生成式編排(經典模式),您的代理程式只會透過主題回應,但主題仍可呼叫工具。

您可以新增以下類型的工具:

工具類型 其功能是什麼
預建連接器 透過 Power Platform 連接器連線至數千個 Microsoft 服務 和非 Microsoft 服務中的其中一個。
自訂連接器 透過您定義的 Power Platform 連接器連接您自己的服務。 要讓您的代理程式使用它,連接器必須在整個組織中可被檢視並共享。
代理程式流程 執行一個或多個動作的流程。
Prompt 執行單回合模型提示。 它可以利用你提供的知識,生成程式碼來分析資料。
REST API 呼叫您從 REST API 中選擇的端點與方法。
模型內容通訊協定 (MCP) 連接至 MCP 伺服器並使用其工具與資源。
電腦應用 透過使用者介面操作網站與桌面應用程式:選擇按鈕、選單及輸入文字。

另外兩種選項能讓你的代理程式呈現類似工具的行為:

Azure Bot Service 技能功能會讓你的代理人能使用 Azure Bot Service 機器人的相關工具。 用戶端工具會將事件活動傳送給用戶端應用程式,用戶端應用程式會執行動作並回傳回應。

Note

由標準 harness 驅動的代理程式技能稱為 Azure Bot Service 技能。 它們與代理技能不同,後者可新增到由 GitHub Copilot harness 驅動的代理程式。

在代理程式層級建立和新增工具

當您將工具新增至代理人時,您的代理人可以在任何對話中自動使用它。

  1. 在 Copilot Studio 中,選取「代理程式」,然後選取您的代理程式。

  2. 前往代理程式的工具頁面。

  3. 選取 [新增工具]。

  4. 選擇工具類型。 若要查看所有類型,包括 REST API 和自訂連接器,請選擇 「查看全部」。

    Note

    如果您的組織封鎖某種工具類型,您無法選取該類型。 如需更多資訊,請參閱「 被貴組織政策封鎖的工具」。

  5. 設定此工具。 步驟依類型而定。 例如,對於提示工具,撰寫提示說明、選擇模型,並透過選擇 + 新增內容來新增輸入參數。 你可以向提示助理尋求協助,或從提示範本開始。

  6. 選擇 儲存,然後選擇 新增並設定。

    工具的設定頁面隨即開啟,工具現在會出現在代理程式的工具頁面上。

    將新工具新增至代理程式時,所選擇的新工具類型的螢幕擷取畫面。

    Note

    如果你的組織因為資料政策封鎖了某個工具,你就無法選擇它。 在「 被貴組織政策封鎖的工具」中了解更多。

  7. 執行針對您選擇的工具類型的設定步驟。 例如,如果你選擇 提示,請執行以下步驟:

    • 定義提示指令
    • 選取模型
    • 指定輸入參數(選擇 + 新增內容)

    你也可以輸入「 提示助理 」欄位來獲得協助。

    作為替代方案,可使用預先定義的範本,透過選取「 提示範本」來建立提示。

  8. 選取 [儲存 ] 以建立新的工具。

  9. 選擇 新增並設定。 這個工具已添加到您的代理程式中。 工具的設定頁面會出現。 請在此查看並變更您的工具設定。

你的新工具 會出現 在代理人的工具頁面上。

被組織政策封鎖的工具

管理員可以使用治理政策限制 Copilot Studio 中可用的工具與連接器。 當資料原則阻擋工具時,該工具會在 「新增工具 」窗格中顯示不可用。 若要查看是哪個原則阻擋了它,請點選工具旁的資訊圖示。 如果您需要被封鎖的工具,請聯絡您的管理員。

管理員在Microsoft 365 系統管理中心中管理外掛,包括其中的技能與 MCP 伺服器。 Power Platform 的資料政策仍控制建立者在 Copilot Studio 中可新增哪些工具。

如需詳細資訊,請參閱 設定客服專員的資料原則。

查看並更改您的工具設定

若要檢視或變更工具的設定,請前往您代理程式的 工具 頁面並選取該工具。 設定頁面包含三個區塊:詳細資訊、輸入,以及 完成。

MCP 伺服器有不同的設定頁面。 它不是 輸入 和 完成,而是有 工具 和 資源 區段,列出 MCP 伺服器所提供的內容。 如需更多資訊,請參閱「將您的代理程式連接至現有的 MCP 伺服器」。

Details

Setting 需知事項
Name 會出現在代理程式的工具清單中。 用一個能說明工具功能名稱的名稱。
Description 生成式編排會利用描述來決定何時使用該工具。 說明這個工具的功能以及何時使用。
允許代理程式動態決定何時使用該工具 選取此選項後,您的代理程式可自行使用此工具。 取消選取時,您的代理程式只會在某個主題呼叫該工具時使用該工具。 當生成式編排啟用時,預設選取。
執行前請先詢問終端使用者 在工具執行前請使用者確認。 預設為「否」。
Authentication 使用使用者憑證(預設為終端使用者)或製作者憑證(製作者提供的憑證)執行工具。
驗證說明 Optional. 告訴使用者他們被要求登入的內容。

範例:Contoso IT 將密碼重設流程描述為「在主管核准後重設使用者密碼。 當使用者被鎖定或請求重設密碼時使用。它也會將 「執行前詢問終端使用者 」設為 「是」。

Inputs

輸入就是你的工具所需的數值。 每個輸入會以表格中的一列顯示。

預設情況下,「填入方式」設定為 「使用 AI 動態填入」。 您的代理會嘗試找出對話中的每個值,例如使用者的訊息。 如果找不到該值,就會詢問使用者。

若要控制輸入的收集方式,請選擇 「自訂」。 您可以設定:

  • 顯示名稱 和 描述:輸入內容在使用者眼中的呈現方式。
  • 識別為:如何解讀使用者的答案,例如以文字或預設實體形式解讀。
  • 重試邏輯:如果代理程式無法辨識答案,是否該再問一次。
  • 輸入驗證:除了實體類型預設值之外,還有額外的檢查。

若要跳過詢問使用者,請將 「使用 Fill with」 設為 「自訂」值,然後輸入數值、選取變數,或撰寫 Power Fx 公式。

Note

重新整理連接器動作後,其輸出類型可能仍處於未解析狀態,直到你輸入所有必要的輸入。 輸入數值,儲存主題,然後再次檢查輸出變數。

Completion

選擇工具執行後的處理方式。 在 執行後,選擇以下選項之一:

  • 不回應(預設):您的代理程式會在自己的回應中包含工具的輸出。
  • 用生成式 AI 撰寫回應:AI 根據工具的輸出來撰寫回應。
  • 傳送特定回應:您撰寫回應範本並插入輸出變數。 你可以用 Power Fx 格式化它。
  • 寄送自適應卡片:您寄送一張包含按鈕和動作的互動卡片。

您也可以選擇代理程式及其他工具可以使用的輸出變數。

工具選擇和輸入收集

您的代理人會根據以下條件決定是否使用某項工具:

  • 工具名稱與描述。
  • 到目前為止的對話。
  • 使用者所要求的是什麼。
  • 工具所擁有的輸入與輸出。
  • 已在對話中使用過的工具

Note

如果回應必須完全重現工具輸出,例如連結或卡片內容,請使用「以變數插入 方式傳送特定回應 」或 「傳送自適應卡片」。 僅在工具已傳送使用者可見訊息時使用「不回應」功能。 使用生成式 AI 撰寫回應, 可能會重新表述工具的輸出內容,且可能無法完全保留連結或卡片內容。

設定哪些輸出變數要提供給代理程式及其他工具使用。

你的代理也會利用工具的描述來撰寫問題,收集缺失的輸入,因此你不需要為每個問題新增問題節點。

預設情況下,工具會將其結果傳回您的代理程式,您的代理程式接著撰寫回應。 您也可以讓工具直接回應使用者。

Tip

當你的客服人員提出 AI 生成的問題時,請讓使用者知道 AI 撰寫了部分對話內容。 例如,將訊息新增至 「對話開始」 系統主題。

從主題內呼叫現有工具

當你希望工具在對話的特定時刻執行時,使用主題。

  1. 在 Copilot Studio 中,前往您的代理程式的主題頁面。

  2. 建立主題並命名,例如「 建立工單」。

  3. 加入觸發詞,例如「開啟工單」、「回報問題」以及「我需要 IT 協助」。

  4. 選取「新增節點」(+),然後選擇「新增工具」。

  5. 選取工具。 工具會分組在 「基本工具」、「 連接器」和 「工具 」標籤上。

  6. 選取 [儲存]。

MCP 連接器資訊

關於 MCP 連接器,您可以查看 MCP 連接器所提供的 MCP 工具與資源名稱與說明。 工具與資源的資訊以表格形式呈現,每個工具各有一行。

工具驗證的考量因素

有些工具,例如提示程式或呼叫 Dataverse 的工具,需要驗證。 您的代理程式會在使用者的情境中執行工具,而工具在未啟用驗證時不會執行。 請選擇以下方法之一:

  • 終端使用者憑證:使用者只會獲得他們被允許查看的資料。
  • Maker 提供的憑證:工具會使用你的憑證。 此方法適用於共享資源,或當使用者不需自行存取時。

測試您的工具

透過使用生成式協調,您的代理程式會在判斷工具符合請求時使用該工具。 若要測試,請提出一個該工具應能處理的問題。 以下範例中,Contoso IT 輸入「I's locked out of my account」,並檢查代理是否要求確認,然後執行密碼重設流程。 你也可以透過從主題呼叫工具來測試它。

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

新工具預設為開啟。 關閉工具會阻止代理使用該工具,但仍保持連接狀態,方便日後重新開啟。

  1. 前往您代理程式的 Tools 頁面並選擇該工具。

  2. 在設定頁面頂端,使用 「啟用」 切換。

  3. 選取 [儲存]。

從您的 Agent 中刪除一個工具

  1. 前往您的代理程式工具頁面。

  2. 將滑鼠移到該工具上,然後選取三個點(…)。

  3. 選取 [刪除],然後再次選取 [刪除] 以確認。

Tip

您只能從代理程式的工具頁面刪除工具,不能從 Copilot Studio 主工具頁面刪除工具。

代理中工具的限制

  • 透過生成式編排,代理程式最多可擁有 128 種工具。 為了達到最佳效果,建議使用 25 到 30。
  • 在多代理協調中,每個子代理可以擁有自己的 128 種工具。