Konfigurer en Bot Framework-ferdighet for bruk i Copilot Studio
Artikkel
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.
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.
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:
Utvid Innstillinger i navigasjonsruten, og velg Ferdigheter.
Velg Legg til ferdighet øverst på siden Ferdigheter.
Kopier kopilotens ID, og formidle dette til utvikleren av ferdigheten din.
Angi nettadressen til ferdighetsmanifestet. En ferdighets manifest inneholder informasjonen som kopiloten din trenger for å utløse handlinger innen en ferdighet.
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)