Bruk en Power Virtual Agents-robot som en ferdighet

  • Artikkel

Merk

Dette emnet omfatter informasjon som bare gjelder den klassiske Power Virtual Agents-opplevelsen. Denne funksjonen er ikke tilgjengelig i den nye Power Virtual Agents-opplevelsen.

Når du bruker en Power Virtual Agents-robot som en ferdighet med en Bot Framework-robot, fastsetter Bot Framework-roboten om noe som brukeren sier, samsvarer med Power Virtual Agents-robotens utløseruttrykk. Hvis det er et samsvar, sendes diskusjonen til Power Virtual Agents-roboten av Bot Framework-roboten. Power Virtual Agents-roboten trekker ut alle enheter og utløser det samsvarende emne.

Du kan også sende en variabel til et Power Virtual Agents-ferdighetsemne som inndata fra Bot Framework Composer og bruke utdataene den returnerer.

Viktig

Du må ha en prøveversjon eller full Power Virtual Agents-lisens for å kunne bruke Power Virtual Agents-roboter som ferdigheter. Denne funksjonen er ikke tilgjengelig med Teams Power Virtual Agents-lisensen.

Slik konfigurerer du Power Virtual Agents-roboten som en ferdighet:

  1. Legg til Bot Framework-roboten i tillatelseslisten for Power Virtual Agents-roboten.
  2. Last ned ferdighetsmanifestet for Power Virtual Agents-roboten.
  3. Bruk det nedlastede ferdighetsmanifestet i Bot Framework Composer til å opprette en forbindelse mellom robotene.
  4. Bruk Bot Framework-emulatoren til å bekrefte at roboten fungerer som en ferdighet.

Forutsetning

Legge til Bot Framework-roboten i tillatelseslisten for Power Virtual Agents-roboten

Legg til Bot Framework-robotens app-ID i tillatelseslisten for Power Virtual Agents-roboten du vil bruke som en ferdighet. Robotene må være i samme leier.

  1. Åpne roboten som skal bruke ferdigheten, i Bot Framework Composer. Velg Konfigurer, og velg deretter Utviklingsressurser. Kopier ID-en i Microsoft-app-ID-en.

    Skjermbilde som viser hvor du finner app-ID-en for Bot Framework-roboten.

  2. Åpne roboten du vil bruke som en ferdighet, i Power Virtual Agents.

  3. Gå til Innstillinger og velg Sikkerhet på navigasjonsmenyen. Velg deretter Tillatelsesliste.

    Skjermbilde som viser Tillatelsesliste-flisen uthevet på Sikkerhet-siden.

  4. Velg Legg til tillatt oppringer.

    Skjermbilde som viser knappen Legg til tillatt oppringer uthevet øverst i panelet Administrer tillatelsesliste.

  5. Lim inn Bot Framework-robotens app-ID, og velg Neste.

    Skjermbilde som viser hvor du angir app-ID-en for Bot Framework-roboten.

    Forsiktig!

    En Power Virtual Agents-robot kan ikke fungere som en ferdighet for andre Power Virtual Agents-roboter. Hvis du prøver å legge til en app-ID som hører til en Power Virtual Agents-robot, i tillatelseslisten, får du en feilmelding. Du kan bare legge til en app-ID for en Bot Framework-robot.

    Power Virtual Agents validerer Bot Framework-robotens app-ID og bekrefter at den tilhører en robot i samme leier.

  6. (Valgfritt) Legg til et Visningsnavn for roboten du har lagt til i tillatelseslisten.

    Skjermbilde som viser hvor du legger til visningsnavn for roboten i tillatelseslisten.

  7. Velg Lagre.

Bot Framework-roboten vises med visningsnavnet hvis du angav et, eller med app-ID-en hvis du ikke angav et visningsnavn. Du kan slette eller redigere den når som helst, ved å velge ikonet til høyre for robotens visningsnavn eller app-ID.

Skjermbilde av panelet Administrer tillatelsesliste der redigerings- og sletteikonene for en tillatt robot vises.

Merk

Bot Framework-robotene som legges til i tillatelseslisten, blir ikke eksportert som en del av robotinnholdet.

Laste ned robotferdighetsmanifestet for Power Virtual Agents-roboten

Bot Framework-roboter kan bruke et Power Virtual Agents-ferdighetsmanifest til å konfigurere en tilkobling til roboten som laget manifestet.

Alle Power Virtual Agents-roboter har ferdighetsmanifester. Dette er JSON-filer som omfatter et navn, grensesnitt og utløseruttrykk for en ferdighet.

En Bot Framework-robot kan bruke et ferdighetsmanifest til å finne ut når den skal utløse Power Virtual Agents-roboten (for eksempel som svar på noe en bruker sier til den).

Power Virtual Agents-ferdighetsmanifester følger versjon 2.2 av Bot Framework-ferdighetsmanifestskjemaet og består av filene intents.lu og manifest.json.

En Bot Framework-robot kan beslutte at en Power Virtual Agents-robot skal håndtere brukerens forespørsel, basert på manifestdataene. Den sender alt brukere sa, til roboten. Deretter samsvarer Power Virtual Agents-roboten det som brukere sa, med et Power Virtual Agents-emne, trekker ut enheter som trengs for sporutfylling og utløser Power Virtual Agents-emnet.

Power Virtual Agents-ferdighetsmanifester genereres og oppdateres automatisk. En Power Virtual Agents-robot har to ferdighetsmanifester:

  • Testmanifest: Gjør det mulig for Bot Framework-roboten å koble til testversjonen av Power Virtual Agents-roboten. Bruk testmanifestet til å validere endringer i ferdigheten før du publiserer den.

    • Testmanifestet er umiddelbart tilgjengelig for hver nyopprettede Power Virtual Agents-robot.
    • Det oppdateres automatisk for å gjenspeile endringene hver gang du lagrer roboten.

  • Publisert manifest: Gjør det mulig for Bot Framework-roboten å koble til den publiserte versjonen av Power Virtual Agents-roboten.

    • Det publiserte manifestet er bare tilgjengelig for Power Virtual Agents-roboter som har blitt publisert minst én gang.
    • Det oppdateres automatisk for å gjenspeile endringene hver gang du publiserer roboten.

Merk

Det publiserte manifestet er ikke tilgjengelig for Power Virtual Agents-roboter som aldri har vært publisert.

Hvis du vil generere robotens publiserte manifest, publiserer du Power Virtual Agents-roboten.

Begge ferdighetsmanifestene vises i panelet Administrer tillatelsesliste.

Skjermbilde av panelet Administrer tillatelsesliste som viser Power Virtual Agents-robotmanifestene.

Ferdighetsmanifestene vises også på Detaljer-siden for roboten. På navigasjonsmenyen velger du Innstillinger og deretter Detaljer. Detaljer-siden viser andre metadata, inkludert Miljø-ID, Leier-ID og Robotapp-ID.

Skjermbilde av Detaljer-siden som viser hvor du laster ned Power Virtual Agents-robotmanifestene.

Velg et manifest for å laste det ned. Det lastes ned som en ZIP-fil med etiketten <bot name>_manifest for Publisert manifest eller <bot name>_test_manifest for Testmanifest.

Skjermbilde som viser de to Power Virtual Agents-manifestene etter at de er lastet ned.

Merk

Ferdighetsmanifestet omfatter ikke systememner og Composer-dialogbokser som legges til en Power Virtual Agents-robot. Det er bare emner som ble opprettet av robotforfattere, og Composer-hensiktsutløsere som forfattere legger til roboten, som er inkludert.

Koble til en Power Virtual Agents-ferdighet i Composer

Bruk Power Virtual Agents-ferdighetsmanifester til å opprette en ferdighetstilkobling i Bot Framework-roboten i Composer.

  1. I Bot Framework Composer-prosjektet velger du Legg til og deretter Koble til en ferdighet.

    Skjermbilde av Bot Framework Composer som viser hvordan du kobler en Bot Framework-robot til en ferdighet.

  2. Bla gjennom til og velg et ZIP-arkivert Power Virtual Agents-manifest, og velg deretter Neste.

    Skjermbilde av Composer som viser hvor du kan velge en ZIP-arkivert Power Virtual Agents-ferdighet.

  3. Velg emnene, eller hensiktene, i Power Virtual Agents-roboten du vil legge til i Bot Framework-roboten, og velg deretter Neste.

    Skjermbilde av Composer som viser utvalget av Power Virtual Agents-emner.

  4. Se gjennom og rediger utløseruttrykkene for Power Virtual Agents-roboten, og velg deretter Neste.

    Skjermbilde av Composer som viser hvor du kan redigere utløseruttrykk for valgte emner.

  5. Kontroller at Bruk Orchestrator til prosjekter med flere roboter er valgt, og velg deretter Fortsett.

    Skjermbilde av Composer som viser Orchestrator aktivert.

  6. Kontroller at Power Virtual Agents-ferdigheten legges til i Bot Framework-roboten på riktig måte, og at en ny utløser med Power Virtual Agents-robotens navn vises i prosjektet i Composer.

    Skjermbilde av Composer etter at Power Virtual Agents-ferdigheten er lagt til.

Finn emnet i ferdighetsmanifestet

Bruk en hendelse til å utløse et Power Virtual Agents-emne i ferdigheten. Hvis du vil kalle opp et bestemt emne fra Composer, bruker du navnet på den tilknyttede hendelsen i ferdighetsmanifestet til å henvise til emnet.

  1. Velg handlingen Koble til en ferdighet.

  2. Velg Vis ferdighetsmanifest under Navn på ferdighetsdialog.

    Skjermbilde av Composer som viser hvor ferdighetsmanifestet skal vises.

  3. Finn activities i manifestet. Denne egenskapen inneholder nestede egenskaper som representerer emnene i Power Virtual Agents-roboten.

    Skjermbilde av et ferdighetsmanifest der egenskapen activities er uthevet.

  4. Finn emnet du vil kalle opp, og se etter egenskapen name for det. Når Power Virtual Agents-ferdigheten mottar en hendelse med dette navnet, utløses emnet.

    I følgende eksempel er navnet på hendelsesaktiviteten dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

    Skjermbilde der Power Virtual Agents-emnenavnet er uthevet i manifestet.

Kall opp et Power Virtual Agents-ferdighetsemne

I stedet for å være avhengig av hva en bruker sier, for å utløse et Power Virtual Agents-ferdighetsemne, kan du kalle det opp direkte. Du kan bare kalle opp Power Virtual Agents-emner direkte som er oppført i ferdighetsmanifestet.

  1. Velg Legg til på redigeringslerretet for Composer, velg Tilgang til eksterne ressurser, og velg deretter Koble til en ferdighet.

    Skjermbilde av Composer som viser hvordan du kobler til en ferdighet.

  2. Velg Power Virtual Agents-roboten i listen Navn på ferdighetsdialog.

    Skjermbilde som viser hvor du velger Power Virtual Agents-roboten.

  3. Finn navnet på hendelsesaktiviteten for Power Virtual Agents-robotemnet du vil kalle opp. Kopier verdien, utelat anførselstegnene, og lagre den for å bruke den i de neste trinnene.

  4. Velg Lukk.

  5. Velg Vis kode i Aktivitet-delen.

    Skjermbilde som viser hvor du velger Vis kode.

  6. Skriv inn eller lim inn følgende kode. Erstatt TOPIC_ACTIVITY_NAME med emnets navn på hendelsesaktivitet. Kontroller at det ikke er anførselstegn i egenskapen name.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

    Skjermbilde som viser hvor du legger til aktivitetshendelseskoden med Power Virtual Agents-emnenavnet.

Send en inndatavariabel til et Power Virtual Agents-ferdighetsemne

Bot Framework Composer kan sende en variabel til et Power Virtual Agents-ferdighetsemne som inndata. Hvis du vil vite hvordan du oppretter Power Virtual Agents-emner som godtar inndatavariabler, kan du se Sende variabler mellom emner.

Hvis et Power Virtual Agents-emne som kan motta en inndatavariabel, er oppført i ferdighetsmanifestet, kan du sende en Composer-variabel til det.

  1. Velg Legg til på redigeringslerretet for Composer, velg Tilgang til eksterne ressurser, og velg deretter Koble til en ferdighet.

    Skjermbilde av Composer som viser hvordan du kobler til en ferdighet.

  2. Velg Power Virtual Agents-roboten i listen Navn på ferdighetsdialog.

    Skjermbilde som viser hvor du velger Power Virtual Agents-roboten.

  3. Finn navnet på hendelsesaktiviteten for Power Virtual Agents-robotemnet du vil kalle opp. Kopier verdien, utelat anførselstegnene, og lagre den for å bruke den i de neste trinnene.

  4. Finn egenskapen value for emnet. Egenskapen value inneholder en forekomst av egenskapen $ref. Kopier denne verdien, og lagre den for å bruke den i de neste trinnene.

    Advarsel!

    Hvis et Power Virtual Agents-emne ikke har inndata, har det ikke egenskapen value.

    Skjermbilde av et ferdighetsmanifest der egenskapen value er uthevet.

  5. Finn egenskapen definitions, og se etter en nestet egenskap som samsvarer med $ref-verdien du fant i forrige trinn. Noter deg navnene og typene for inndataene for Power Virtual Agents-emnet. Du skal bruke dem i de neste trinnene.

    Skjermbilde av et ferdighetsmanifest som viser hvor du finner inndatavariabler for et Power Virtual Agents-emne.

  6. Velg Lukk.

  7. Velg Vis kode under Aktivitet-delen.

    Skjermbilde som viser hvor du velger Vis kode.

  8. Skriv inn eller lim inn følgende kode. Erstatt disse verdiene:

    1. Erstatt TOPIC_ACTIVITY_NAME med emnets navn på hendelsesaktivitet.
    2. Erstatt PVA_INPUT_VARIABLE med en inndatavariabel fra emnet.
    3. Erstatt COMPOSER_INPUT_VARIABLE med en Composer-variabel som gir en verdi.
    [Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]

    I eksemplet nedenfor gir Composer-variabelen dialog.storeLocation en verdi for inndatavariabelen pva_StoreLocation i Power Virtual Agents-robotemnet dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

    Skjermbilde som viser hvor du legger til aktivitetshendelseskoden med en Power Virtual Agents-inndataverdi.

Motta en utdatavariabel fra et Power Virtual Agents-ferdighetsemne

Det går an å motta utdata fra et Power Virtual Agents-ferdighetsemne i Composer. Hvis du vil vite hvordan du oppretter Power Virtual Agents-emner som returnerer utdata, kan du se Sende variabler mellom emner.

  1. Velg Legg til på redigeringslerretet for Composer, velg Tilgang til eksterne ressurser, og velg deretter Koble til en ferdighet.

    Skjermbilde av Composer som viser hvordan du kobler til en ferdighet.

  2. Velg Power Virtual Agents-roboten i listen Navn på ferdighetsdialog.

    Skjermbilde som viser hvor du velger Power Virtual Agents-roboten.

  3. Finn navnet på hendelsesaktiviteten for Power Virtual Agents-robotemnet du vil kalle opp. Kopier verdien, utelat anførselstegnene, og lagre den for å bruke den i de neste trinnene.

  4. Finn egenskapen resultValue for emnet. Egenskapen resultValue inneholder en $ref-egenskap. Kopier denne verdien, og lagre den for å bruke den i de neste trinnene.

    Advarsel!

    Hvis et Power Virtual Agents-emne ikke har utdata, har det ikke en resultValue-egenskap.

    Skjermbilde av et ferdighetsmanifest der egenskapen resultValue er uthevet for et Power Virtual Agents-emne.

  5. Finn egenskapen definitions, og se etter en nestet egenskap som samsvarer med $ref-verdien du fant i forrige trinn. Noter deg navnene og typene for utdatavariablene for Power Virtual Agents-emnet. Du skal bruke dem i de neste trinnene.

    I følgende eksempel returnerer Power Virtual Agents-emnet to utdata av typen String, pva_State og pva_Item.

    Skjermbilde av et ferdighetsmanifest som viser hvor du finner utdatavariabler for et Power Virtual Agents-emne.

  6. Velg Lukk.

  7. Velg Vis kode i Aktivitet-delen.

    Skjermbilde som viser hvor du velger Vis kode.

  8. Skriv inn eller lim inn følgende kode. Erstatt TOPIC_ACTIVITY_NAME med emnets navn på hendelsesaktivitet. Kontroller at det ikke er anførselstegn i egenskapen name.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

    Skjermbilde som viser hvor du legger til aktivitetshendelseskoden med et Power Virtual Agents-emnenavn.

  9. Under kodeområdet setter du Egenskap til en Composer-variabel for å motta og lagre utdataverdier fra Power Virtual Agents-ferdighetsemnet.

    Skjermbilde som viser hvor Egenskap-feltet skal settes til dialog.skillResult.

  10. Velg Legg til og deretter Behandle egenskaper i redigeringslerretet for Composer, og velg deretter Angi egenskaper.

    Skjermbilde som viser hvor du velger Angi egenskaper.

  11. Sett Egenskap til Composer-verdien som skal lagre den uttrukne verdien. Deretter angir du Verdi i Composer-variabelen som du lagret emnets utdata i.

    I følgende eksempel blir utdataverdiene fra dialog.skillResult.pvaState og dialog.skillResult.pvaItem trukket inn i de nye Composer-variablene dialog.State og dialog.Item.

    Skjermbilde som viser utdataverdiene som er lagret i dialog.State og dialog.Item i vinduet Angi egenskaper i Composer.

Test Power Virtual Agents-roboten som en ferdighet med en Bot Framework-robot

Bruke Bot Framework-emulatoren til å teste at Bot Framework-roboten kaller opp en Power Virtual Agents-robot som en ferdighet på riktig måte.

Viktig

Bot Framework-roboten må legges til i Power Virtual Agents-robotens tillatelsesliste for at ferdighetstilkoblingen skal fungere.

Finn ut mer