實作技能以用於 Power Virtual Agents
適用于: SDK v4
技能是另一個 Bot 可以使用的 Bot。 如此一來,您就可以建立單一使用者面向 Bot,並使用一或多個技能加以擴充。 您可以在技能概觀中 深入瞭解一般技能,以及如何在實作技能中 建置技能 。 或者,虛擬助理範本包含一組 預先建置的技能 ,您可以自訂和部署,而不是從頭開始建置一個技能。
如果您預期您的技能將會從 Power Virtual Agents Bot 取用,則需要考慮您的技能有一些額外的限制。
資訊清單限制
Power Virtual Agents 會限制您在技能資訊清單 中 宣告的內容。
- 您只能宣告 100 個或更少的動作。
- 每個動作限制為 25 個或更少的輸入或輸出。
- 您無法將陣列類型用於輸入或輸出。
相同租使用者限制
為了確保在 Power Virtual Agents 內註冊自訂技能的合規性和適當的控管,您的技能 Bot 必須是 Microsoft Entra ID 中的已註冊應用程式。 新增技能時,我們會驗證技能的應用程式識別碼是否在已登入使用者的租使用者中,而技能端點是否符合已註冊的應用程式 Home Page URL
。
在 Power Virtual Agents 中將 Bot 註冊為技能之前,您必須確定針對 Bot,Azure 入口網站 中的首頁會設定為 Bot 的技能資訊清單 URL。
註冊技能期間執行的驗證
當使用者嘗試從其 Power Virtual Agents Bot 連線到您的技能時,他們必須先將 技能匯入 Power Virtual Agents 。 您的技能將經歷一系列驗證檢查。 其中一項檢查失敗可能會導致錯誤訊息,如下表所述。
驗證步驟 | 錯誤碼 | 錯誤訊息 | 描述或緩和措施 |
---|---|---|---|
資訊清單 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 |
檢查技能時發生錯誤。 | Power Virtual Agents 在傳送 EndOfConversation 活動至您的技能時收到未知的回應。 請確定您的技能正在執行並正確回應。 |
技能已獲授權 | ENDPOINT_HEALTHCHECK_UNAUTHORIZED |
此技能未將 Bot 列入允許清單。 | 檢查 Bot 是否已新增至技能的允許清單。 如需詳細資訊,請參閱 Power Virtual Agents 如何 設定技能 。 |