Konfigurera en Bot Framework färdighet för användning i Copilot Studio

Artikel
04/09/2024

Viktigt!

Power Virtual Agents-funktioner ingår nu i Microsoft Copilot Studio efter betydande investeringar i generativ AI och förbättrade integrationer mellan Microsoft Copilot.

Vissa artiklar och skärmbilder kan referera till Power Virtual Agents när vi uppdaterar dokumentation och utbildning.

Copilot Studio gör att du kan utöka copilot med hjälp av Bot Framework-färdigheter. Om du redan har skapat och distribuerat robotar i organisationen (med hjälp av Bot Framework SDK och Pro-Code-verktyg) för specifika scenarier kan du konvertera dessa robotar till en färdighet och registrera den i en Copilot Studio-copilot.

Kommentar

Du kan lägga till en färdighet från Copilot Studio-appen i Microsoft Teams, men du behöver en fristående Microsoft Copilot Studio-prenumeration.

Artikeln är avsedd för systemadministratörer eller IT-proffs som känner till Bot Framework-färdigheter. När en färdighet har registrerats med en Copilot Studio-copilot kan författare sömlöst utlösa färdighetsåtgärder i konversation.

Förutsättningar

Granska begränsningar och validering av kunskaper som används i Copilot Studio

Viktigt

Copilot Studio copilots stöder endast kunskaper som bygger på Bot Framework SDK version 4.12.0+.

Klassiska chattrobotar stöder endast kunskaper som bygger på Bot Framework SDK version 4.7+.

Om du använder Bot Framework Composer är det viktigt att du använder Composer 2.x. Om du vill använda en befintlig Composer 1.x copilot, migrera först den till Composer 2.x innan du använder den som färdighet.

Om du vill konfigurera en färdighet bör den associerade appregistreringen i Microsoft Entra ID för din färdighet ha konfiguration med flera innehavare.

Flödesåtgärder och färdighetsåtgärder

I följande tabell kan du avgöra när du ska använda färdigheter för en konversation.

	Flödesåtgärder	Färdighetsåtgärder
Profil	Copilot-författare kan skapa återanvändbara flöden för att bädda in i valfri copilot-konversation	Utvecklare kan skapa, distribuera och vara värd för anpassade färdigheter i sin egen miljö
Konversation	Använd flöden för enkla operationer med en enda sväng. Du kan till exempel placera en order eller visa orderstatus.	Använd färdigheter för komplexa, operationer med flera svängar. Till exempel schemalägga ett möte eller boka ett flyg.
Svar	Använd flöden för att avge ett copilot-svar. Du kan t.ex. visa ett personligt anpassat meddelande eller infogade bilder.	Använd färdigheter för att avge alla copilot-svar som stöds. Du kan t.ex. visa ett adaptiv kort eller skicka slumpmässiga svar.
Åtgärder	Använd flöden för att utlösa enstaka åtgärder på serversidan. Anropa till exempel ett HTTP API eller utlös en anpassad anslutning.	Använd färdigheter för att utlösa händelser och åtgärder på serversidan och på klientsidan. Du kan till exempel navigera till en sida efter i copilot-svaret.

Konfigurera en färdighet

Använd först Copilot Studio till skapa en copilot och skapa och distribuera en färdighet med hjälp av förkodningsverktyg inom din organisation.

Innan du registrerar färdigheten ska du ange copilot-ID:t för din färdighetsutvecklare för att auktorisera copilot för att anropa åtgärder i färdigheten. Läs mer om färdighetens lista över tillåtna. Du kan hämta din ID-handling för copilot från fönstret Lägg till en färdighet.

Så här lägger du till en färdighet till din copilot:

I navigeringsfönstret, expandera Inställningar och välj Färdigheter.
Högst upp på sidan Färdigheter, välj Lägg till färdighet.
Kopiera din copilot-ID och ange detta för din kompetensutvecklare.
Ange URL:en till färdighetsmanifestet. Ett färdighetsmanifest innehåller den information som copilot behöver för att utlösa åtgärder inom en färdighet.
Välj Nästa för att starta valideringsprocess. När valideringen är lyckad läggs din färdighet till i din copilot. Du kan nu använda den här färdigheten i dina ämnen.

Överväganden gällande efterlevnad

För att skydda användarnas integritet kräver vi att färdigheter ska registreras som en app i den inloggade användarens Microsoft Entra ID-klientorganisation.

Felsökning av fel under färdighetsregistrering

En serie verifieringskontroller görs mot URL:en. Med de här kontrollerna garanteras efterlevnad, styrning och användbarhet hos den färdighet som läggs till i copilot-funktionen. Du måste åtgärda felen innan du registrerar en färdighet.

Felmeddelande	Felsöka/Åtgärd
Det gick inte att hämta färdighetsmanifestet. (`MANIFEST_FETCH_FAILED`)	Försök att öppna manifest-URL:en i en webbläsare. Om URL:en återger sidan inom 10 sekunder omregistrerar du din färdighet.
Manifestet är inte kompatibelt. (`MANIFEST_MALFORMED`)	(a) Kontrollera om manifestet är en giltig JSON-fil. (b) Kontrollera om manifestet innehåller obligatoriska egenskaper Till exempel (`name`, `msaAppId`, enskild `endpoint`, `activities`/`id`, `activities`/`description`, `activities`/`type` (endast `event` eller `message` stöds)).
Slutpunkterna stämmer inte överens (`MANIFEST_ENDPOINT_ORIGIN_MISMATCH`)	Kontrollera att din färdighets slutpunkt överensstämmer med Microsoft Entra ID programregistrering `Publisher domain` (föredragen) eller `Home page URL`-fält. Läs mer om att ställa in startsidan för slutpunkter.
Om du vill lägga till en färdighet måste du först registrera den (`APPID_NOT_IN_TENANT`)	Kontrollera om din färdighets program-ID är registrerat i organisationens Microsoft Entra ID-innehavare.
Länken är ogiltig. Länken måste börja med https:// (`URL_MALFORMED`, `URL_NOT_HTTPS`)	Ange länken igen som en säker URL.
Manifestet är för stort, (`MANIFEST_TOO_LARGE`)	Kontrollera manifestets storlek. Det måste vara mindre än eller lika med 500 KB.
Den här färdigheten har redan lagts till i copilot. (`MANIFEST_ALREADY_IMPORTED`)	Ta bort färdigheten och försök registrera igen.
Färdigheten är begränsad till 100 åtgärder. (`LIMITS_TOO_MANY_ACTIONS`)	Det finns för många färdighetsåtgärder definierade i färdighetsmanifest. Ta bort åtgärderna och försök igen.
Åtgärderna är begränsade till 25 ingångar. (`LIMITS_TOO_MANY_INPUTS`)	Det finns för många indataparametrar för färdighetsåtgärder. Ta bort parametrar och försök igen.
Åtgärderna är begränsade till 25 utgångar. (`LIMITS_TOO_MANY_OUTPUTS`)	Det finns för många utdataparametrar för färdighetsåtgärder. Ta bort parametrar och försök igen.
Din copilot kan ha högst 100 färdigheter. (`LIMITS_TOO_MANY_SKILLS`)	För många färdigheter har lagts till i en copilot. Ta bort en befintlig färdighet och försök igen.
Det verkar som om ett fel har inträffat. (`AADERROR_OTHER`)	Ett tillfälligt fel uppstod när färdigheten validerades. Försök igen.
Det gick inte att kontrollera färdigheten. (`ENDPOINT_HEALTHCHECK_FAILED`, `HEALTH_PING_FAILED`)	Kontrollera om färdighetens slutpunkt är online och svarar på meddelanden.
Den här färdigheten tillåter inte att lista din copilot (`ENDPOINT_HEALTHCHECK_UNAUTHORIZED`)	Kontrollera att copilot har lagts till i färdighetens lista över tillåtna.