在Copilot Studio 中設定使用的 Bot Framework 技能
Copilot Studio 可讓您使用 Bot Framework 技能來擴充副手。 如果您已在組織 (使用 Bot Framework SDK 和 pro-code 工具) 中特定案例建立並部署了副手,就可以將這些副手轉換為技能,並在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 中與您技能相關的應用程式註冊應設定為多租用戶設定。
流程動作和技能動作
下表將協助您判斷何時使用技能進行交談。
流程動作 | 技能動作 | |
---|---|---|
角色 | 副手作者可以建立可重複使用的流程,以嵌入到任何副手交談中 | 開發人員可以在自己的環境中建立、部署及主控自訂技能 |
交談 | 使用流程進行簡單、單輪作業。 例如,下訂單或取得訂單狀態。 | 使用技能進行複雜的多輪作業。 例如,排程召開會議或預訂航班。 |
回覆 | 使用流程來發出副手回覆。 例如,顯示個人化訊息或內嵌影像。 | 使用技能來發出任何支援的副手回覆。 例如,顯示調適型卡片或傳送隨機回覆。 |
動作 | 使用流程來觸發伺服器端單輪動作。 例如,呼叫 HTTP API 或觸發自訂連接器。 | 使用技能來觸發伺服器端和用戶端事件和動作。 例如,根據副手回覆瀏覽至頁面。 |
設定技能
首先,使用 Copilot Studio 來建立副手,並使用專業程式碼工具在組織中建立和部署技能。
在註冊技能之前,請提供副手的識別碼給您的技能開發人員,以授權副手呼叫技能中的動作。 進一步了解技能 allowlist。 您可以從新增技能視窗取得您的副手識別碼。
若要將技能新增至您的副手:
在導覽窗格中,展開設定,然後選取技能。
在技能頁面頂端選取新增技能。
複製您的副手識別碼,並將其提供給您的技能開發人員。
輸入技能資訊清單的 URL。 技能資訊清單包含您的副手在技能中觸發動作所需的資訊。
選取下一步開始驗證程序。 驗證成功後,您的技能將新增到副手中。 您現在可以在主題中使用這項技能。
合規性考量
為了保護使用者的隱私權,我們需要將技能註冊為登入使用者的 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 ) |
檢查您的副手是否已新增至技能允許清單。 |