Konfigurere en ferdighet for bruk i Power Virtual Agents

  • Artikkel

Med Power Virtual Agents kan du utvide roboten 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 Power Virtual Agents-robot.

Merk

Du kan legge til en ferdighet fra Power Virtual Agents-appen i Microsoft Teams, men du trenger et frittstående Power Virtual Agents-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 Power Virtual Agents-robot, kan forfattere sømløst utløse ferdighetshandlinger i samtale.

Forutsetning

Viktig

Power Virtual Agents-forhåndsversjonen støtter bare ferdigheter som er bygd med Bot Framework SDK, versjon 4.12.0+.

Power Virtual Agents klassisk støtter bare ferdigheter som er bygget 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-robot, 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 AAD for ferdigheten din settes til Konfigurasjon med flere leiere.

Sammenligne bruk av flyter og ferdighetshandlinger

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

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

Konfigurere en ferdighet

Først oppretter du en Power Virtual Agents-robot og oppretter og distribuerer ferdigheten ved hjelp av pro-kodeverktøy i organisasjonen.

Før du registrerer ferdighetene, må du oppgi robotens ID til din ferdighetsutvikler for å autorisere roboten til å kalle opp handlinger i ferdigheten. Finn ut mer om ferdighets-tillatelseslisten.

Du kan hente robotens ID fra vinduet Legg til.

Legg til en ferdighet i roboten:

  1. Utvid Innstillinger-fanen på siden i Power Virtual Agents-portalen, og velg Ferdigheter.

    Velg innstillinger og deretter Ferdigheter.

  2. Velg Legg til ferdighet øverst på ferdighetssiden.

    Velg knappen Legg til ferdighet.

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

    Skjermbilde som uthever robot-ID-en på siden av vinduet Legg til ferdighet.

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

    Legg til nettadresse i manifestet for ferdighet.

  5. Velg Neste for å begynne valideringsprosessen. Når vellykket, legges ferdigheten til i roboten. 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 Azure Active Directory-leier.

Feilsøke 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 roboten. 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 Azure AD-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 Azure AD-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 på roboten.
(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.
Roboten din kan ha et maksimum på 100 ferdigheter.
(LIMITS_TOO_MANY_SKILLS)		 Det er for mange ferdigheter lagt til i en robot. 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 roboten din som tillatt
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Kontroller om roboten er lagt til i tillatelseslisten for ferdigheten. Finn ut mer om å legge til en ferdighet i tillatelseslisten.