Konfigurer en Bot Framework-færdighed til brug i Copilot Studio

Copilot Studio giver dig mulighed for at udvide din copilot ved hjælp af Bot Framework-færdigheder. Hvis du allerede har oprettet og installeret robotter i organisationen (ved hjælp af pro-kode-værktøjet Bot Framework-SDK) til bestemte scenarier, kan du konvertere disse robotter til en færdighed og registrere færdigheden i en Copilot Studio-copilot.

Bemærk

Du kan tilføje en færdighed inde fra Copilot Studio-appen i Microsoft Teams, men du skal have et separat Microsoft Copilot Studio-abonnement.

Denne artikel henvender sig til systemadministratorer eller IT-medarbejdere, der kender dine Bot Framework-færdigheder. Når en færdighed er registreret i en Copilot Studio-copilot, kan opretteren uden problemer udløse færdighedshandlinger i samtalen.

Forudsætninger

• Gennemgå begrænsninger og validering for de færdigheder, der bruges i Copilot Studio

Vigtigt!

Copilot Studio-copiloter understøtter kun færdigheder, der er bygget ved hjælp af Bot Framework SDK version 4.12.0+.

Classic -chatrobotter understøtter kun færdigheder, der er bygget ved hjælp af Bot Framework SDK version 4.7+.

Hvis du bruger Bot Framework Composer, anbefales det på det kraftigste, at du bruger Composer 2.x. Hvis du vil bruge en eksisterende Composer 1.x-copilot, skal du først migrere den til Composer 2.x, før du bruger den som færdighed.

Hvis du vil konfigurere en færdighed, skal den tilknyttede apptilmelding i Microsoft Entra ID for dine færdigheder konfigureres til flere arkitekturer.

Flowhandlinger og færdighedshandlinger

I følgende tabel kan du se, hvornår du skal bruge færdigheder i en samtale.

	Flow-handlinger	Færdighedshandlinger
Karakter	Copilot-oprettere kan bygge genanvendelige flows, som kan integreres i en hvilken som helst copilot-samtale	Udviklere kan oprette, udrulle og være vært for brugerdefinerede færdigheder i deres eget miljø
Samtale	Brug flows til simple operationer med et enkelt skift. Du kan f.eks. afgive en ordre eller hente ordrestatus.	Brug af færdigheder i forbindelse med komplekse handlinger med flere skift. Du kan f.eks. planlægge et møde eller reservere en flybillet.
Response	Brug flow til at sende et copilot-svar. Du kan f.eks. vise en personlig meddelelse eller indbyggede billeder.	Brug færdigheder til at sende et hvilket som helst understøttet copilot-svar. Du kan f.eks. vise et tilpasset kort eller sende tilfældige svar.
Handlinger	Brug flows til at udløse en handling med et enkelt skift på serversiden. Du kan f.eks. kalde en HTTP API eller udløse en brugerdefineret connector.	Brug færdigheder til at udløse hændelser og handlinger på serversiden og klientsiden. Du kan f.eks. navigere til en side som følge af copilotens svar.

Konfigurere en færdighed

Du skal først bruge Copilot Studio til at oprette en copilot og oprette og udrulle færdigheden ved hjælp af de professionelle kodeværktøjer i din organisation.

Før du registrerer færdigheden, skal du oplyse udvikleren af dine færdigheder om copilotens id for at autorisere copiloten til at kalde handlinger i færdigheden. Få mere at vide om listen med tilladelser for færdigheder. Du kan få din copiloters id fra vinduet Tilføj en færdighed.

Føj en færdighed til din copilot:

1. Udvid Indstillinger i navigationsruden, og vælg Færdigheder.

2. Øverst på siden med færdigheder skal du vælge Tilføj færdighed.

3. Kopiér din copilots id, og giv det til din udvikler af færdigheder.

   

4. Angiv URL-adressen for færdighedsmanifestet. Et færdighedsmanifest indeholder de oplysninger, som din copilot skal bruge for at udløse handlinger i en færdighed.

5. Vælg Næste for at starte valideringsprocessen. Når valideringen er vellykket, føjes dine færdigheder til din copilot. Du kan nu bruge denne færdighed i dine emner.

Overvejelser vedrørende overholdelse af angivne standarder

For at beskytte brugernes privatliv kræver vi, at færdighederne registreres som en app i den bruger, der er logget på den pågældende brugers Microsoft Entra ID-lejer.

Foretag fejlfinding i forbindelse med registrering af færdigheder

Der foretages en række valideringskontroller i forhold til URL-adressen. Disse kontroller sikrer, at den færdighed, der tilføjes din copilot, overholder angivne standarder, styring og er brugervenlige. Du skal rette disse fejl, inden du registrerer en færdighed.

Fejlmeddelelse	Lokalisering af fejl/afhjælpning
Der opstod problemer under hentning af færdighedens manifest (MANIFEST_FETCH_FAILED).	Prøv at åbne manifestets URL-adresse i en webbrowser. Hvis URL-adressen gengiver siden inden for 10 sekunder, skal du registrere din færdighed igen.
Manifestet er ikke kompatibelt. (MANIFEST_MALFORMED)	(a) Kontrollér, om manifestet er en gyldig JSON-fil. (b) Kontrollér, om manifestet indeholder nødvendige egenskaber , f.eks. (name, msaAppId, enkelt endpoint, activities/id, activities/description, activities/type (kun event eller message understøttes)).
Der er en uoverensstemmelse i slutpunkterne (MANIFEST_ENDPOINT_ORIGIN_MISMATCH)	Kontrollér, om din færdigheds slutpunkt svarer til Microsoft Entra ID-ansøgningsregistreringens Publisher domain (anbefales) eller Home page URL-felt. Få mere at vide om, hvordan du indstiller startsiden for slutpunkter.
Hvis du vil tilføje en færdighed, skal den først registreres (APPID_NOT_IN_TENANT)	Kontrollér, om din færdigheds ansøgnings-id er registreret i organisationens Microsoft Entra ID-lejer.
Linket er ikke gyldigt. Linket skal begynde med https:// (URL_MALFORMED, URL_NOT_HTTPS)	Angiv linket igen som en sikker URL-adresse.
Manifestet er for stort (MANIFEST_TOO_LARGE)	Kontrollér størrelsen på manifestet. Det skal være mindre end eller lig med 500 KB.
Denne færdighed er allerede tilføjet til din copilot. (MANIFEST_ALREADY_IMPORTED)	Slet færdigheden, og prøv at udføre registreringen igen.
Færdigheden må højst indeholde 100 handlinger. (LIMITS_TOO_MANY_ACTIONS)	Der er angivet for mange færdighedshandlinger i færdighedsmanifestet. Fjern handlinger, og prøv igen.
Handlinger er begrænset til 25 input. (LIMITS_TOO_MANY_INPUTS)	Der er for mange inputparametre for færdighedshandlinger. Fjern parametre, og prøv igen.
Handlinger er begrænset til 25 output. (LIMITS_TOO_MANY_OUTPUTS)	Der er for mange outputparametre for færdighedshandlinger. Fjern parametre, og prøv igen.
Din copilot kan højst have 100 færdigheder. (LIMITS_TOO_MANY_SKILLS)	Der er tilføjet for mange færdigheder for en copilot. Fjern en eksisterende færdighed, og prøv igen.
Det ser ud til, at noget gik galt. (AADERROR_OTHER)	Der opstod en midlertidig fejl under valideringen af din færdighed. Prøv igen.
Noget gik galt under kontrollen af din færdighed. (ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)	Kontrollér, om din færdigheds slutpunkt er online og reagerer på meddelelser.
Denne færdighed har angivet din copilot som ikke tilladt (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Kontrollér, om din copilot er blevet føjet til listen for tilladte færdigheder.