Konfigurer en Bot Framework-ferdighet for bruk i Copilot Studio

Med Copilot Studio kan du utvide kopiloten ved hjelp av Bot Framework-ferdigheter. Hvis du allerede har bygd og distribuert roboter i organisasjonen (ved hjelp av Bot Framework SDK og profesjonelle kodeverktøy) for bestemte scenarioer, kan du konvertere disse robotene til en ferdighet og registrere denne ferdigheten i en Copilot Studio-kopilot.

Merk

For å kunne legge til en ferdighet fra Copilot Studio-appen i Microsoft Teams må du ha et frittstående Microsoft Copilot Studio-abonnement.

Denne artikkelen er beregnet på systemansvarlige eller IT-medarbeidere som er kjent med Bot Framework-ferdigheter. Når en ferdighet er registrert med en Copilot Studio-kopilot, kan forfattere sømløst utløse ferdighetshandlinger i samtale.

Forutsetning

• Se gjennom begrensninger og validering for ferdigheter som brukes i Copilot Studio

Viktig!

Copilot Studio-kopiloter støtter bare ferdigheter som er bygd med Bot Framework SDK versjon 4.12.0+.

Klassiske chatroboter støtter bare ferdigheter som er bygd med Bot Framework SDK versjon 4.7+.

Hvis du bruker Bot Framework Composer, anbefaler vi på det sterkeste at du bruker Composer 2.x. Hvis du vil bruke en eksisterende Composer 1.x-kopilot, overfører du den først til 2.x før du bruker den som ferdighet.

Hvis du vil konfigurere en ferdighet, må den tilknyttede appregistreringen i Microsoft Entra ID for ferdigheten settes til Konfigurasjon med flere leiere.

Flythandlinger og ferdighetshandlinger

Tabellen nedenfor hjelper deg å avgjøre når ferdigheter skal brukes for en diskusjon.

	Flythandlinger	Ferdighetshandlinger
Personlig	Kopilotforfattere kan bygge gjenbrukbare flyter for å bygges inn i en hvilken som helst kopilotsamtale	Utviklere kan opprette, distribuere og drifte tilpassede ferdigheter i eget miljø
Diskusjon	Bruk flyter for enkle operasjoner med én vending. Du kan for eksempel legge inn en ordre eller få ordrestatus.	Bruk ferdigheter for kompliserte operasjoner med flere vendinger. Du kan for eksempel planlegge et møte eller en bestille en flyreise.
Response	Bruk flyter til å sende et kopilotsvar. Vis for eksempel en tilpasset melding eller innebygde bilder.	Bruk ferdigheter til å sende eventuelle støttede kopilotsvar. Vis for eksempel et dynamisk kort, eller send tilfeldige svar.
Handlinger	Bruk flyter til å utløse enkeltstegshandlinger på serversiden. Du kan for eksempel kalle en HTTP API eller utløse en egendefinert kobling.	Bruk ferdigheter til å utløse hendelser og handlinger på serversiden og klientsiden. Du kan for eksempel navigere til en side etter kopilotsvar.

Konfigurere en ferdighet

Bruk først Copilot Studio til å opprette en kopilot og opprett og distribuerer en ferdighet ved hjelp av prokodeverktøy i organisasjonen.

Før du registrerer ferdighetene, må du oppgi kopilotens ID til din ferdighetsutvikler for å autorisere kopiloten til å kalle opp handlinger i ferdigheten. Finn ut mer om ferdighets-tillatelseslisten. Du kan hente kopilotens ID fra vinduet Legg til en ferdighet.

Slik legger du til en ferdighet i kopiloten:

1. Utvid Innstillinger i navigasjonsruten, og velg Ferdigheter.

2. Velg Legg til ferdighet øverst på siden Ferdigheter.

3. Kopier kopilotens ID, og formidle dette til utvikleren av ferdigheten din.

   

4. Angi nettadressen til ferdighetsmanifestet. En ferdighets manifest inneholder informasjonen som kopiloten din trenger for å utløse handlinger innen en ferdighet.

5. Velg Neste for å begynne valideringsprosessen. Etter at valideringen er vellykket, legges ferdigheten til i kopiloten. Du kan nå bruke denne ferdigheten i emnene dine.

Overholdelsesvurderinger

For å beskytte personvernet til brukere krever vi at ferdigheter registreres som en app i den påloggede brukerens Microsoft Entra ID-leier.

Feilsøking av feil under registrering av ferdighet

En serie valideringskontroller gjøres mot nettadressen. Denne kontrollen sikrer overholdelse, styring og anvendelighet for ferdigheten som blir lagt til i kopiloten. Du må rette disse feilene før du registrerer en ferdighet.

Feilmelding	Feilsøke / løsning
Det oppstod en feil under henting av ferdighetsmanifestet. (MANIFEST_FETCH_FAILED)	Prøv å åpne manifestnettadressen i en nettleser. Hvis nettadressen gjengir siden innen 10 sekunder, må du registrere ferdigheten på nytt.
Manifestet er ikke kompatibelt. (MANIFEST_MALFORMED)	(a) Kontroller om manifestet er en gyldig JSON-fil. (b) Kontroller om manifestet inneholder nødvendige egenskaper, for eksempel (name, msaAppId, ett endpoint, activities/id, activities/description, activities/type (bare event eller message støttes)).
Det er ikke samsvar i endepunktene (MANIFEST_ENDPOINT_ORIGIN_MISMATCH)	Kontroller om ferdighetsendepunktene samsvarer med Microsoft Entra ID-programregistreringens Publisher domain (foretrukket) eller Home page URL-feltet. Lær mer om hvordan du angir startsiden for endepunkter.
Hvis du vil legge til en ferdighet, må den først registreres (APPID_NOT_IN_TENANT)	Kontroller om ferdighetens program-ID er registrert i organisasjonens Microsoft Entra ID-leier.
Koblingen er ikke gyldig. Koblingen må begynne med https:// (URL_MALFORMED, URL_NOT_HTTPS)	Angi koblingen på nytt som en sikker nettadresse.
Manifestet er for stort; (MANIFEST_TOO_LARGE)	Kontroller størrelsen på manifestet. Det må være mindre enn eller lik 500 kB.
Denne ferdigheten er allerede lagt til i kopiloten. (MANIFEST_ALREADY_IMPORTED)	Slett ferdigheten, og prøv å registrere den på nytt.
Ferdigheten er begrenset til 100 handlinger. (LIMITS_TOO_MANY_ACTIONS)	Det er for mange ferdighetshandlinger definert i ferdighetsmanifestet. Fjern handlinger, og prøv på nytt.
Handlinger er begrenset til 25 inndata. (LIMITS_TOO_MANY_INPUTS)	Det er for mange inndataparametere for ferdighetshandling. Fjern parametere, og prøv på nytt.
Handlinger er begrenset til 25 utdata. (LIMITS_TOO_MANY_OUTPUTS)	Det er for mange utdataparametere for ferdighetshandling. Fjern parametere, og prøv på nytt.
Kopiloten din kan ha et maksimum på 100 ferdigheter. (LIMITS_TOO_MANY_SKILLS)	Det er for mange ferdigheter lagt til i en kopilot. Fjern en eksisterende ferdighet, og prøv på nytt.
Det ser ut til at noe gikk galt. (AADERROR_OTHER)	Det oppstod en forbigående feil under validering av ferdigheten. Prøv på nytt.
Noe gikk galt under kontrollen av ferdigheten. (ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)	Kontroller om ferdighetsendepunktet er tilkoblet og svarer på meldinger.
Denne ferdigheten har ikke oppført kopiloten din som tillatt (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Kontroller om kopiloten er lagt til i tillatelseslisten for ferdigheten.