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

發行項
04/10/2024

重要

在對生成式 AI 進行大量投資並增強 Microsoft Copilot 的整合後，Power Virtual Agents 的功能和特性現已成為 Microsoft Copilot Studio 的一部分。

當我們更新文件和培訓內容時，某些文章和螢幕擷取畫面可能會參考 Power Virtual Agents。

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 中使用之技能的限制和驗證

重要

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`)	檢查您的副手是否已新增至技能允許清單。

共用方式為