實作在 Copilot Studio 中使用的技能
適用於： SDK v4
技能是另一個 Bot 可以使用的 Bot。 如此一來，您可以建立單一使用者面向 Bot，並使用一或多個技能加以擴充。 您可以在技能概觀中深入瞭解一般技能，以及如何在實作技能中建置技能。 或者，虛擬助理 範本包含一組預先建置的技能，您可以自定義和部署，而不是從頭開始建置一個技能。
如果您預期您的技能將會從 Copilot Studio Copilot 取用，則您必須考慮您的技能有一些其他限制。
指令清單限制
Copilot Studio 會限制您可以在技能指令清單中宣告的內容。
- 您只能宣告 100 個或更少的動作。
- 每個動作限制為25個或更少的輸入或輸出。
- 您無法將陣列型別用於輸入或輸出。
相同租使用者限制
為了確保在 Copilot Studio 中註冊自定義技能的合規性和適當的控管，您的技能 Bot 必須是 Microsoft Entra ID 中的已註冊應用程式。 新增技能時，我們會驗證技能的應用程式標識碼是否位於已登入使用者的租使用者中，而技能端點是否符合已註冊的應用程式 Home Page URL。
在 Copilot Studio 中將 Bot 註冊為技能之前，您必須先確定針對 Bot，Azure 入口網站 中的首頁會設定為 Bot 的技能指令清單 URL。
單一租使用者和多租使用者限制
Copilot Studio 先前已建立多租使用者 Entra ID 應用程式。 不過，現在它正在建立單一租使用者 Entra ID 應用程式。 若要讓技能根據新的單一租使用者 Entra ID 應用程式與代理程式正常運作，必須針對單一租用戶實例設定技能。 如需詳細資訊，請參閱 將現有的技能從多租用戶轉換成單一租使用者 或 將多租使用者技能更新為單一租使用者技能。
註冊技能時執行的驗證
當用戶嘗試從其 Copilot 連線到您的技能時，他們必須先將 技能匯入 Copilot Studio。 您的技能會經歷一系列驗證檢查。 其中一項檢查失敗可能會導致錯誤訊息，如下表所述。
| 驗證步驟 | 錯誤碼 | 錯誤訊息 | 描述或緩和措施 |
|---|---|---|---|
| 指令清單 URL 有效 |
URL_MALFORMED, URL_NOT_HTTPS |
連結無效;連結的開頭必須是 https:// | 將連結重新輸入為安全 URL。 |
| 指令清單可擷取 | MANIFEST_FETCH_FAILED |
我們遇到獲得技能指令清單的問題。 | 確認您的指令清單 URL 是指令清單的連結;請嘗試在網頁瀏覽器中開啟您的指令清單 URL。 如果 URL 在 10 秒內呈現頁面，請重新註冊您的技能。 |
| 指令清單是可讀取的 | MANIFEST_TOO_LARGE |
指令清單太大。 | 您的指令清單必須是 500 KB 或更少。 |
| 指令清單是可讀取的 | MANIFEST_MALFORMED |
資訊清單不相容。 | 檢查指令清單是否為有效的 JSON 檔案。 檢查指令清單是否包含必要的屬性，例如 name、 msaAppId等。 如需詳細資訊，請參閱指令清單限制。 |
| 尚未註冊技能 | MANIFEST_ALREADY_IMPORTED |
此技能已新增至您的機器人。 | 刪除技能並再次註冊。 |
| 指令清單端點和首頁網域相符 | MANIFEST_ENDPOINT_ORIGIN_MISMATCH |
您的技能端點不符。 | 您Microsoft Entra ID 應用程式的首頁 URL 網域和指令清單 URL 網域必須相符。 請參閱 相同租使用者限制 |
| 技能裝載於已登入使用者的租使用者中 | APPID_NOT_IN_TENANT |
若要新增技能，必須先註冊。 | 系統管理員必須將技能註冊到已登入用戶的組織中。 |
| 動作有限 | LIMITS_TOO_MANY_ACTIONS |
技能受限於 100 個動作。 | 技能資訊清單中定義的技能動作太多。 請移除動作，然後再試一次。 |
| 動作輸入參數有限 | LIMITS_TOO_MANY_INPUTS |
動作限制為 25 個輸入。 | 有太多技能動作輸入參數。 請移除參數，然後再試一次。 |
| 動作輸出參數有限 | LIMITS_TOO_MANY_OUTPUTS |
動作限制為 25 個輸出。 | 有太多技能動作輸出參數。 拿掉參數，然後再試一次。 |
| 技能計數有限 | LIMITS_TOO_MANY_SKILLS |
您的 Bot 最多可以有 25 個技能。 | 機器人中新增的技能太多。 請移除現有的技能，然後再試一次。 |
| 安全性令牌有效 | AADERROR_OTHER |
看起來事情出了問題。 | 取得安全性令牌以觸發技能時，可能會發生暫時性錯誤。 重試匯入技能。 |
| 技能狀況良好 |
ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED |
檢查技能時發生錯誤。 | Copilot Studio 在傳送 EndOfConversation 活動到您的技能時收到未知的回應。 請確定單一租使用者技能的應用程式註冊已部署到建立代理程式的相同租使用者。 |
| 技能已獲授權 | ENDPOINT_HEALTHCHECK_UNAUTHORIZED |
此技能尚未允許列出您的 Bot。 | 檢查您的 Bot 是否為技能的允許清單。 如需詳細資訊，請參閱 Copilot Studio 如何 設定技能。 |