在 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。 您可以從新增技能視窗取得您的副手識別碼。
若要將技能新增至您的副手：
在導覽窗格中，展開設定，然後選取技能。
在技能頁面頂端選取新增技能。
複製您的副手識別碼，並將其提供給您的技能開發人員。
![在 [新增技能] 視窗側醒目提示副手識別碼的螢幕擷取畫面。](media/configuration-add-skills/skills-get-bot-id.png)
輸入技能資訊清單的 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) |
檢查您的副手是否已新增至技能允許清單。 |