Bruge en klassis chatrobot som en færdighed i en Bot Framework-robot

Bemærk

Denne artikel indeholder oplysninger, der kun gælder for Copilot Studio klassiske chatrobotter. Denne funktion er ikke tilgængelig i den nye Copilot Studio oplevelse.

Når du bruger en klassisk chatbot som færdighed med en Bot Framework bot, bestemmer botten, om noget, brugeren siger, Bot Framework matcher den klassiske chatbots triggersætninger. Hvis der er et match, sender robotten Bot Framework samtalen til den klassiske chatrobot. Den klassiske chatbot udtrækker alle enheder og udløser det matchende emne.

Du kan også overføre en variabel til en Copilot Studio færdighed emne som input fra Bot Framework Composer og bruge de output, den returnerer.

Vigtige oplysninger

Du skal have en prøveversion eller fuld Copilot Studio licens for at bruge klassiske chatrobotter som færdigheder. Denne funktion er ikke tilgængelig med Teams-licensen Copilot Studio .

Sådan konfigurerer du din klassiske chatrobot som en færdighed:

1. Føj Bot Framework botten til tilladelseslisten for den klassiske chatrobot.

2. Download manifestet for færdigheder til den klassiske chatrobot.

3. Brug det downloadede færdighedsmanifest i Bot Framework Composer til at oprette en forbindelse mellem robotterne.

4. Brug emulatoren Bot Framework til at bekræfte, at robotten fungerer som en færdighed.

Forudsætninger

• Du skal vide, hvordan Bot Framework-færdigheder fungerer.
• Lær at bruge Bot Framework Composer.
• Lær at bruge færdigheder i Bot Framework Composer.
• Få din Bot Framework-bots app-id.

Føj din Bot Framework robot til tilladelseslisten for din klassiske chatrobot

Føj Bot Framework robottens app-id til tilladelseslisten for den klassiske chatrobot, du vil bruge som færdighed. Robotterne skal være i samme lejer.

1. Åbn den bot, der skal bruge færdigheden, i Bot Framework Composer. Vælg Konfigurer, og vælg derefter Udviklingsressourcer. Kopiér id'et i Microsoft App-id.

2. Åbn den klassiske chatrobot, du vil bruge som færdighed, i Copilot Studio den.

3. Vælg Indstillinger i navigationsmenuen, og vælg derefter Sikkerhed. Vælg derefter Liste over tilladte.

4. Vælg Tilføj tilladte opkalder.

5. Indsæt din Bot Framework-robots app-id, og vælg Næste.

   Advarsel

   En klassisk chatrobot kan ikke fungere som en færdighed for andre klassiske chatrobotter. Hvis du forsøger at føje et app-id, der tilhører en Power Virtual Agent-bot, til listen over tilladte, får du en fejlmeddelelse. Du kan kun tilføje et app-id for en Bot Framework-bot.

   Copilot Studio validerer Bot Framework robottens app-id og bekræfter, at den tilhører en robot i den samme lejer.

6. (Valgfrit) Tilføj et Vist navn for den robot, du har føjet til listen over tilladte.

7. Vælg Gem.

Bot Framework-robotten vises med vist navn, hvis du har angivet et, eller med app-id'et, hvis du ikke har indtastet et vist navn. Du kan altid slette eller redigere det ved at vælge ikonet til højre for robottens viste navn eller app-id.

Bemærk

De Bot Framework-robotter, der føjes til listen over tilladte, eksporteres ikke som en del af robotindholdet.

Download det klassiske chatbot-færdighedsmanifest til din klassiske chatbot

Bot Framework Robotter kan bruge et Copilot Studio færdighedsmanifest til at konfigurere en forbindelse til den klassiske chatrobot, der har produceret manifestet.

Alle klassiske chatbots har færdigheder manifester. Det er JSON-filer, der indeholder en færdigheds navn, en brugergrænseflade og udløserfraser.

En Bot Framework robot kan bruge et manifest for færdigheder til at vide, hvornår den klassiske chatrobot skal udløses (f.eks. som svar på noget, en bruger siger til den).

Copilot Studio færdighed manifester følger version 2.2 af Bot Framework færdighed manifestskemaet og består af intents.lu og manifest.json filer.

En Bot Framework bot kan beslutte på klassisk chatbot skal håndtere brugerens anmodning, baseret på manifestdataene. Det videregiver til den klassiske chatbot alt, hvad brugeren sagde. Derefter matcher den klassiske chatbot, hvad brugeren sagde til et Copilot Studio emne, udtrækker alle enheder, der er nødvendige for at udfylde pladser, og udløser Copilot Studio emnet.

Copilot Studio Færdighedsmanifester genereres og opdateres automatisk. En klassisk chatrobot har to færdigheder:

• Testmanifest: Gør det muligt for robotten Bot Framework at oprette forbindelse til testversionen af din klassiske chatrobot. Brug testmanifestet til at validere ændringer i din færdighed, inden du publicerer den.

  • Testmanifestet er straks tilgængeligt for alle nyoprettede klassiske chatrobotter.
  • Den opdateres automatisk for at afspejle ændringer, hver gang du gemmer din klassiske chatrobot.

• Publiceret manifest: Gør det muligt for robotten Bot Framework at oprette forbindelse til den publicerede version af din klassiske chatrobot.

  • Det publicerede manifest er kun tilgængeligt for klassiske chatrobotter, der er blevet publiceret mindst én gang.
  • Den opdateres automatisk for at afspejle ændringer, hver gang du udgiver din Helpdesk-medarbejder.

Bemærk

Det publicerede manifest er ikke tilgængeligt for klassiske chatrobotter, der aldrig er blevet publiceret.

Hvis du vil generere din robots Publiceret manifest,udgiv din klassiske chatbot.

Begge færdighedsmanifester vises i panelet Administrer liste over tilladte.

Færdighedsmanifesterne vises også på copilotens detaljeside. Vælg Indstillinger i navigationsmenuen, og vælg derefter Detaljer. På siden Detaljer vises andre metadata, herunder Miljø-id, Lejer-id og Robotapp-id.

Hvis du vil hente et manifest, skal du markere det. Den downloades som en .zip fil med navnet _<bot name>manifest for det publicerede manifest eller <robotnavn>test__manifest for testmanifestet .

Bemærk

Manifestet for færdigheder omfatter ikke systememner og Composer-dialogbokse, der føjes til en klassisk chatrobot. Det er kun emner, der er oprettet af copilotforfattere, og Composer-hensigtsudløsere, som forfattere føjer til robotten, der medtages.

Opret forbindelse til en Copilot Studio færdighed i Composer

Brug Copilot Studio manifester for færdigheder til at oprette en forbindelse til færdigheder i din Bot Framework robot i Composer.

1. Vælg Tilføj i et Bot Framework Composer-projekt, og vælg derefter Opret forbindelse til en færdighed.

2. Gå til og vælg et Copilot Studio manifest .zip arkiv, og vælg derefter Næste.

3. Vælg de emner eller hensigter i din klassiske chatrobot, som du vil føje til din Bot Framework robot, og vælg derefter Næste.

4. Gennemse og rediger udløserfraserne for din klassiske chatrobot, og vælg derefter Næste.

5. Kontrollér, at Brug organisator for projekter med flere robotter er valgt, og vælg derefter Fortsæt.

6. Kontrollér, at færdigheden Copilot Studio er føjet korrekt til din Bot Framework robot, og at der vises en ny udløser med navnet på din klassiske chatrobot i projektet i Composer.

Find emne i færdighedsmanifestet

Brug en hændelse til at udløse et Copilot Studio emne i færdigheden. Hvis du vil kalde et emne fra Composer, skal du referere til emnet efter navnet på den tilknyttede hændelse i færdighedsmanifestet.

1. Vælg handlingen Opret forbindelse til en færdighed.

2. Vælg Vis erfaringsmanifestunder Navn på færdighed.

3. Søg efter aktiviteter i manifestet. Denne ejendom indeholder indlejrede ejendomme, der repræsenterer de emner, der er tilgængelige i din klassiske chatrobot.

4. Find det emne, du vil kalde, og søg efter egenskaben navn for emnet. Når Copilot Studio færdigheden modtager en begivenhed med dette navn, udløser det emnet.

   I dette eksempel er dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d navnet på begivenhedsaktiviteten.

Ring til færdighed emne Copilot Studio

I stedet for at stole på, hvad en bruger siger for at udløse en Copilot Studio færdighed emne, kan du kalde det direkte. Du kan kun kalde Copilot Studio emner, der er angivet i færdighedsmanifestet, direkte.

1. Vælg Composer-oprettelseslærredet, vælg Tilføj, vælg Adgang til eksterne ressourcer, og vælg derefter Opret forbindelse til en færdighed.

2. På listen Dialogboksnavn for færdigheder skal du vælge din klassiske chatrobot.

3. Find begivenhedsaktivitetens navn på det klassiske chatrobot-emne , du vil ringe til. Kopiér værdien, men udelad anførselstegnene, og gem den, så den kan bruges i de næste trin.

4. Vælg Luk.

5. Vælg Vis kode i sektionen Aktivitet.

6. Skriv eller indsæt følgende kode. Erstat TOPIC_ACTIVITY_NAME med aktivitetsnavnet på emnets hændelse. Kontrollér, at der ikke er anførselstegn i egenskaben navn.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

Overføre en inputvariabel til en Copilot Studio færdighed emne

Bot Framework Komponist kan overføre en variabel til en Copilot Studio færdighed emne som input. Du kan få mere at vide om, hvordan du opretter Copilot Studio emner, der accepterer inputvariabler, under Arbejde med variabler.

Hvis et Copilot Studio emne, der kan modtage en inputvariabel, er angivet i dit færdighedsmanifest, kan du overføre en Composer-variabel til det.

1. Vælg Composer-oprettelseslærredet, vælg Tilføj, vælg Adgang til eksterne ressourcer, og vælg derefter Opret forbindelse til en færdighed.

2. På listen Dialogboksnavn for færdigheder skal du vælge din klassiske chatrobot.

3. Find begivenhedsaktivitetens navn på det klassiske chatrobot-emne , du vil ringe til. Kopiér værdien, men udelad anførselstegnene, og gem den, så den kan bruges i de næste trin.

4. Find egenskaben værdi for emnet. Egenskaben værdi indeholder egenskaben $ref. Kopiér denne værdi, og gem den, så den kan bruges i næste trin.

   Advarsel!

   Hvis et Copilot Studio emne ikke har input, har det ikke en værdiegenskab .

5. Find egenskaben for definitioner, og søg derefter efter en indlejret egenskab , der svarer til den $ref-værdi, du fandt i forrige trin. Bemærk navnene og typerne af Copilot Studio emnets input. Du skal bruge dem i de næste trin.

6. Vælg Luk.

7. Vælg Vis kode i sektionen Aktivitet.

8. Skriv eller indsæt følgende kode. Erstat disse værdier:

   1. Erstat TOPIC_ACTIVITY_NAME med aktivitetsnavnet på emnets hændelse.
   2. Erstat PVA_INPUT_VARIABLE med en inputvariabel fra dit emne.
   3. Erstat COMPOSER_INPUT_VARIABLE med Composer-variablen, der giver en værdi.

   [Activity
       Type = event
       Name = TOPIC_ACTIVITY_NAME
       Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
   ]
   

   I dette eksempel giver variablen dialog.storeLocation Composer en værdi til inputvariablen pva_StoreLocation i det klassiske chatrobot-emne dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Modtag en outputvariabel fra en Copilot Studio færdighed emne

Det er muligt at modtage output fra en Copilot Studio færdighed emne i Composer. Du kan få mere at vide om, hvordan du opretter Copilot Studio emner, der returnerer output, under Arbejde med variabler.

1. Vælg Composer-oprettelseslærredet, vælg Tilføj, vælg Adgang til eksterne ressourcer, og vælg derefter Opret forbindelse til en færdighed.

2. På listen Dialogboksnavn for færdigheder skal du vælge din klassiske chatrobot.

3. Find navnet på begivenhedsaktiviteten til det klassiske chatrobot-emne , du vil ringe til. Kopiér værdien, men udelad anførselstegnene, og gem den, så den kan bruges i de næste trin.

4. Find egenskaben resultValue for emnet. Egenskaben resultValue indeholder egenskaben $ref. Kopiér denne værdi, og gem den, så den kan bruges i næste trin.

   Advarsel!

   Hvis et Copilot Studio emne ikke har output, har det ikke en resultValue-egenskab .

5. Find egenskaben for definitioner, og søg derefter efter en indlejret egenskab , der svarer til den $ref-værdi, du fandt i forrige trin. Bemærk navnene og typerne af Copilot Studio emnets outputvariabler. Du skal bruge dem i de næste trin.

   I dette eksempel returnerer emne Copilot Studio to output af typen String,pva_State og pva_Item.

6. Vælg Luk.

7. Vælg Vis kode i sektionen Aktivitet.

8. Skriv eller indsæt følgende kode. Erstat TOPIC_ACTIVITY_NAME med aktivitetsnavnet på emnets hændelse. Kontrollér, at der ikke er anførselstegn i egenskaben navn.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

9. Under kodeområdet skal du indstille Egenskab til en Composer-variabel for at modtage og gemme outputværdierne fra Copilot Studio færdighed emne.

10. Vælg Tilføj i Composer-oprettelseslærredet, vælg Administrer egenskaber, og vælg derefter Angiv egenskaber.

11. Angiv Egenskab til den Composer-værdi, hvor den udpakkede værdi skal lagres. Angiv derefter Værdi til Composer-variablen, du har gemt i emnets output.

    I dette eksempel udtrækkes outputværdierne fra dialog.skillResult.pvaState og dialog.skillResult.pvaItem til den nye dialogboks Composer-variabler . Tilstand og dialog. Vare.

Test din klassiske chatbot som en færdighed med en Bot Framework bot

Brug emulatoren Bot Framework til at teste, at din Bot Framework robot kalder en klassisk chatrobot korrekt som en færdighed.

Vigtige oplysninger

Din Bot Framework robot skal føjes til den klassiske chatrobots tilladelsesliste, for at færdighedsforbindelsen kan fungere.

Flere oplysninger

• Oversigt over færdigheder
• Færdighedsmanifest
• Bot Framework Composer-dokumentation
• Færdigheder i Composer
• Oprette forbindelse til en ekstern færdighed i Composer
• Teste en færdighed i Emulator