Dela via

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

  • Artikel

Copilot Studio låter dig utöka din handläggare 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 denna färdighet i en Copilot Studio-handläggare.

Obs

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-handläggare kan författare sömlöst utlösa färdighetsåtgärder i konversationer.

Förutsättningar

Viktigt

Copilot Studio-handläggare stöder endast färdigheter 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-handläggare, migrera den först till Composer 2.x innan du använder den som en färdighet.

Om du vill konfigurera en färdighet ska den associerade appregistreringen i Microsoft Entra ID:t för din färdighet anges till konfiguration för flera klientorganisationer.

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
Persona Handläggarförfattare kan skapa återanvändbara flöden för att bädda in i valfri handläggarkonversation. 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.
Response Använd flöden för att avge ett handläggarsvar. Du kan t.ex. visa ett personligt anpassat meddelande eller infogade bilder. Använd färdigheter för att avge alla handläggarsvar 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 handläggarsvaret.

Konfigurera en färdighet

Börja med att låta Copilot Studio skapa en handläggare samt använd förkodningsverktygen för att skapa och distribuera en färdighet inom din organisation.

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

Gör så här för att lägga till en färdighet i din handläggare:

  1. I navigeringsfönstret, expandera Inställningar och välj Färdigheter.

  2. Högst upp på sidan Färdigheter, välj Lägg till färdighet.

  3. Kopiera din handläggares ID och ange detta för din färdighetsutvecklare.

  4. Ange URL:en till färdighetsmanifestet. Ett färdighetsmanifest innehåller den information som din handläggare behöver för att utlösa åtgärder inom en färdighet.

  5. Välj Nästa för att starta valideringsprocess. När valideringen är klar läggs din färdighet till i din agent. 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 dessa kontroller garanteras efterlevnad, styrning och användbarhet hos den färdighet som läggs till i din handläggare. 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.
Denna färdighet har redan lagts till i din handläggare.
(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 handläggare kan ha högst 100 färdigheter.
(LIMITS_TOO_MANY_SKILLS)		 För många färdigheter har lagts till i en handläggare. 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.
Denna färdighet tillåter inte att din handläggare listas
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Kontrollera att din handläggare har lagts till i färdighetens lista över tillåtna.