Les på engelsk

Del via

Konfigurer en Bot Framework-ferdighet for bruk i Copilot Studio

  • Artikkel

I Copilot Studio kan du utvide agenten 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 scenarier, kan du konvertere disse robotene til en ferdighet og registrere denne ferdigheten i en Copilot Studio-agent.

Obs!

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-agent, kan forfattere sømløst utløse ferdighetshandlinger i samtale.

Forutsetning

Viktig

Copilot Studio-agenter 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-agent, overfører du den først til 2.x før du bruker den som en ferdighet.

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

Flythandlinger og ferdighetshandlinger

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

Flythandlinger Ferdighetshandlinger
Personlig Agentforfattere kan bygge gjenbrukbare flyter for å bygges inn i en hvilken som helst agentsamtale. 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 agentsvar. Vis for eksempel en tilpasset melding eller innebygde bilder. Bruk ferdigheter til å sende eventuelle støttede agentsvar. 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 agentsvar.

Konfigurere en ferdighet

Bruk først Copilot Studio til å opprette en agent og opprette og distribuere en ferdighet ved hjelp av pro-kodeverktøy i organisasjonen.

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

Slik legger du til en ferdighet i agenten:

  1. Utvid Innstillinger i navigasjonsruten, og velg Ferdigheter.

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

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

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

  5. Velg Neste for å begynne valideringsprosessen. Når valideringen er vellykket, legges ferdigheten til for agenten. 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 agenten. 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 for agenten.
(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.
Agenten kan ha et maksimum på 100 ferdigheter.
(LIMITS_TOO_MANY_SKILLS)		 Det er for mange ferdigheter lagt til i en agent. 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 agenten din som tillatt
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Kontroller om agenten er lagt til i tillatelseslisten for ferdigheten.