閱讀英文

共用方式為

在 Copilot Studio 中設定使用的 Bot Framework 技能

  • 發行項

Copilot Studio 讓您可以使用 Bot Framework 技能擴充您的代理程式。 如果您已經在組織中為特定情境建置和部署了機器人 (使用 Bot Framework SDK 和專業程式碼工具)，則可以將這些機器人轉換為技能並在 Copilot Studio 代理程式中註冊該技能。

注意

若要在 Microsoft Teams 的 Copilot Studio 應用程式中新增技能，您必須擁有 Microsoft Copilot Studio 獨立訂閱。

本文適用於系統管理員或熟悉 Bot Framework 技能的 IT 專業人員。 在向 Copilot Studio 代理程式註冊技能後，作者就能在交談中無縫地觸發技能動作。

先決條件

重要

Copilot Studio 代理程式只支援使用 Bot Framework SDK 版本 4.12.0+ 所建立的技能。

傳統聊天機器人只支援使用 Bot Framework SDK 版本 4.7+ 所建立的技能。

如果您使用的是 Bot Framework Composer，強烈建議您使用 Composer 2.x。 如果要使用現有的 Composer 1.x 代理程式，請先將其移轉到 Composer 2.x，然後才能將其用作技能。

若要設定技能，應將技能的 Microsoft Entra ID 中的關聯應用程式註冊設定為多租用戶設定。

流程動作和技能動作

下表將協助您判斷何時使用技能進行交談。

流程動作 技能動作
角色 代理程式作者可以建立可重複使用的流程以嵌入到任何代理程式對話中。 開發人員可以在自己的環境中建立、部署和託管自訂技能。
交談 使用流程進行簡單、單輪作業。 例如，下訂單或取得訂單狀態。 使用技能進行複雜的多輪作業。 例如，排程召開會議或預訂航班。
回應 使用 Flows 發出代理程式回應。 例如，顯示個人化訊息或內嵌影像。 使用技能來發出任何受支援的代理程式回應。 例如，顯示調適型卡片或傳送隨機回覆。
動作 使用流程來觸發伺服器端單輪動作。 例如，呼叫 HTTP API 或觸發自訂連接器。 使用技能來觸發伺服器端和用戶端事件和動作。 例如，在代理程式回應時導覽到某個頁面。

設定技能

首先，使用 Copilot Studio 建立代理程式，並使用專業程式碼工具建立和部署技能到您的組織中。

在註冊技能之前，請向您的技能開發人員提供代理程式的 ID，以授權代理程式呼叫技能中的動作。 進一步了解技能 allowlist。 您可以從新增技能視窗取得代理程式的 ID。

若要為您的代理程式新增技能：

  1. 在導覽窗格中，展開設定，然後選取技能。

  2. 在技能頁面頂端選取新增技能。

  3. 複製您的代理程式 ID 並將其提供給您的技能開發人員。

  4. 輸入技能資訊清單的 URL。 技能清單包含代理程式觸發技能內的動作所需的資訊。

  5. 選取下一步開始驗證程序。 驗證成功後，您的技能將被新增到您的代理程式中。 您現在可以在主題中使用這項技能。

合規性考量

為了保護使用者的隱私權，我們需要將技能註冊為登入使用者的 Microsoft Entra ID 租用戶中的應用程式。

疑難排解技能註冊期間的錯誤

針對 URL 進行一系列驗證檢查。 這些檢查可確保新增到您的代理程式的技能的合規性、治理性和可用性。 您必須在註冊技能之前修正這些錯誤。

錯誤訊息 疑難排解/風險降低
取得技能資訊清單時遇到問題。
(MANIFEST_FETCH_FAILED)		 嘗試在網頁瀏覽器中開啟您的資訊清單 URL。 如果 URL 在 10 秒內呈現頁面，請重新註冊您的技能。
資訊清單不相容。
(MANIFEST_MALFORMED)		 (a) 確認此資訊清單是否為有效的 JSON 檔案。
(b) 確認此資訊清單是否包含必要屬性
例如 (name、msaAppId、單一 endpoint、activities/id、activities/description、activities/type (僅支援 event 或 message))。
您的端點不相符
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 請檢查您的技能端點是否符合您 Microsoft Entra ID 的應用程式註冊 Publisher domain (偏好) 或 Home page URL 欄位。 深入了解有關設定端點的首頁。
若要新增某技能，您必須先為其註冊
(APPID_NOT_IN_TENANT)		 檢查您的技能應用程式識別碼是否已在您組織的 Microsoft Entra ID 租用戶中註冊。
結無效；連結必須以 https:// 開頭
(URL_MALFORMED、URL_NOT_HTTPS)		 重新輸入連結做為安全 URL。
資訊清單太大；
(MANIFEST_TOO_LARGE)		 檢查資訊清單的大小。 必須小於或等於 500KB。
此技能已新增至您的代理程式。
(MANIFEST_ALREADY_IMPORTED)		 請刪除技能，然後再試一次註冊。
技能受限於 100 個動作。
(LIMITS_TOO_MANY_ACTIONS)		 技能資訊清單中定義的技能動作太多。 請移除動作，然後再試一次。
動作限制為 25 個輸入。
(LIMITS_TOO_MANY_INPUTS)		 有太多技能動作輸入參數。 請移除參數，然後再試一次。
動作限制為 25 個輸出。
(LIMITS_TOO_MANY_OUTPUTS)		 有太多技能動作輸出參數。 請移除參數，然後再試一次。
您的代理程式最多可以擁有 100 項技能。
(LIMITS_TOO_MANY_SKILLS)		 代理程式中新增的技能太多。 請移除現有的技能，然後再試一次。
似乎發生錯誤。
(AADERROR_OTHER)		 驗證您的技能時發生暫時性錯誤。 重試。
檢查技能時發生錯誤。
(ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)		 檢查您的技能端點是否已上線，並回應訊息。
此技能尚未將您的代理程式列入允許名單
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 檢查您的代理程式是否已新增至技能允許清單。