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

Bemærk

Denne artikel gælder kun for klassiske chatbotter. Denne funktion er ikke tilgængelig i den nye Copilot Studio-oplevelse.

Når du bruger en klassisk chatrobot som en færdighed med en Bot Framework-robot, vil Bot Framework-robotten afgøre, om noget, som brugeren siger, matcher den klassiske chatrobots udløserfraser. Hvis der er sammenfald, vil Bot Framework-robotten overføre samtalen til den klassiske chatrobot. Den klassiske chatrobot udtrækker alle objekter og udløser det tilsvarende emne.

Du kan også overføre en variabel til et Copilot Studio-færdighedsemne som input fra Bot Framework Composer og bruge de output, der returneres.

Vigtige oplysninger

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

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

1. Føj Bot Framework-robotten til listen over tilladte klassiske chatrobotter.

2. Download færdighedsmanifestet for den klassiske chatrobot.

3. Brug det hentede færdighedsmanifest i Bot Framework Composer til at oprette en forbindelse mellem bot'erne.

4. Brug Bot Framework Emulator til at bekræfte, at bot'en 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 Bot Framework-robotten til listen over tilladte klassiske chatrobotter

Føj Bot Framework-robottens app-id til listen over tilladte 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.

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-robot, 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 kontrollerer, at det tilhører en robot, der er 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 Save.

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 chatrobot-færdighedsmanifest til din klassiske chatrobot

Bot Framework-robotter kan bruge et Copilot Studio-færdighedsmanifest til at konfigurere en forbindelse til den klassiske chatrobot, som producerede manifestet.

Alle klassiske chatrobotter har færdighedsmanifester. Et færdighedsmanifest er en JSON-fil, der indeholder færdighedens navn, grænseflade og udløserfraser.

En Bot Framework-robot kan bruge et færdighedsmanifest til at se, hvornår den skal udløse den klassiske chatrobot (for eksempel som svar på noget, en bruger siger til den).

Copilot Studio-færdighedsmanifester følger version 2.2 af Bot Framework-færdighedsmanifestskemaet og består filerne intents.lu og manifest.json.

En Bot Framework-robot kan bestemme, at den klassiske chatrobot skal håndtere brugerens forespørgsel på baggrund af manifestdataene. Den overfører alt det, som brugeren siger, til den klassiske chatrobot. Herefter matcher den klassiske chatrobot det, brugeren har sagt, med et Copilot Studio-emne, udtrækker de objekter, der er nødvendige for rubrikudfyldning, og udløser Copilot Studio-emnet.

Copilot Studio-færdighedsmanifester oprettes og opdateres automatisk. Den klassiske chatrobot har to færdighedsmanifester:

• Testmanifest: Tillader, at Bot Framework-robotten opretter forbindelse til testversionen af den klassiske chatrobot. Brug testmanifestet til at validere ændringer i din færdighed, inden du publicerer den.

  • Testmanifestet er straks tilgængeligt for hver nyoprettede klassiske chatrobot.
  • Det opdateres automatisk, så det afspejler ændringer, hver gang du gemmer den klassiske chatrobot.

• Publiceret manifest: Tillader, at Bot Framework-robotten opretter forbindelse til den publicerede version af den klassiske chatrobot.

  • Det publicerede manifest er kun tilgængeligt for den klassiske chatrobot, der er publiceret mindst én gang.
  • Det opdateres automatisk, så det afspejler ændringer, hver gang du publicerer din agent.

Bemærk

Det publicerede manifest er ikke tilgængeligt for den klassiske chatrobot, der aldrig har været publiceret.

Hvis du vil oprette din robots Publiceret manifest, skal du publicere den klassiske chatrobot.

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. Det downloades som en .zip-fil med navnet _<robotnavn>manifest for det Publicerede manifest eller <robotnavn>test__manifest for testmanifestet.

Bemærk

Færdighedsmanifestet medtages ikke i systememner og Composer-dialogbokse, der er føjet til den klassiske chatrobot. Det er kun emner, der er oprettet af copilotforfattere, og Composer-hensigtsudløsere, som forfattere føjer til robotten, der medtages.

Oprette forbindelse til en Copilot Studio-færdighed i Composer

Brug Copilot Studio-færdighedsmanifester til at oprette en færdighedsforbindelse 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. Søg efter og vælg et .zip-arkiv for et Copilot Studio-manifest, og vælg derefter Næste.

3. Vælg de emner eller formål i den klassiske chatrobot, du vil føje til din Bot Framework-robot, og vælg derefter Næste.

4. Gennemse og rediger udløserfraser til den 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 Copilot Studio-færdigheden er føjet korrekt til din Bot Framework-robot, og at en ny udløser med den klassiske chatrobots navn vises 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 egenskab indeholder indlejrede egenskaber, der repræsenterer de emner, som er tilgængelige i den 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 hændelse med dette navn, udløser det emnet.

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

Kald et Copilot Studio-færdighedsemne

I stedet for at bruge, hvad en bruger siger, til at udløse et Copilot Studio-færdighedsemne, 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. Vælg den klassiske chatrobot på listen Navn på færdighed.

3. Find navnet på hændelsesaktiviteten for den klassiske chatrobot, du vil kalde. 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 et Copilot Studio-færdighedsemne

Bot Framework Composer kan overføre en variabel til et Copilot Studio-færdighedsemne 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 sende Composer-variablen 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. Vælg den klassiske chatrobot på listen Navn på færdighed.

3. Find navnet på hændelsesaktiviteten for den klassiske chatrobot, du vil kalde. 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 Copilot Studio-emnet ikke har input, indeholder den ikke egenskaben værdi.

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 på 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 det følgende eksempel angiver Composer-variablen dialog.storeLocation en værdi til inputvariablen pva_StoreLocation i den klassiske chatrobots emne dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Modtag en outputvariabel fra et Copilot Studio-færdighedsemne

Det er muligt at modtage output fra et Copilot Studio-færdighedsemne 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. Vælg den klassiske chatrobot på listen Navn på færdighed.

3. Find navnet på hændelsesaktiviteten for den klassiske chatrobots emne, du vil kalde. 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 Copilot Studio-emnet ikke har output, indeholder det ikke egenskaben resultValue.

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 på og typerne af Copilot Studio-emnets outputvariabler. Du skal bruge dem i de næste trin.

   I følgende eksempel returnerer Copilot Studio-emnet to outputtyper af typen Streng, 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. Angiv Egenskab til Composer-variablen under kodeområdet, så outputværdierne fra Copilot Studio-færdighedslisten modtages og lagres.

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 nye Composer-variabeler dialog.State og dialog.Item.

Teste den klassiske chatrobot som en færdighed med en Bot Framework-robot

Brug Bot Framework Emulator til at teste, at din Bot Framework-robot kalder den klassiske chatrobot som en færdighed korrekt.

Vigtige oplysninger

Din Bot Framework-robot skal være tilføjet på den klassiske chatrobots liste over tilladte, for at færdighedsforbindelsen fungerer.

Opdatere en Bot Framework-robot med flere lejere til en robot med en enkelt lejer

I følgende illustration vises scenariet, hvor en Bot Framework-robot, der er bygget på Bot Framework-SDK, kalder en klassisk chatrobot for at bruge den som en færdighed.

Både Bot Framework-robotten og den klassiske chatrobot har en Microsoft Entra ID-appregistrering, som Azure Bot-forekomsterne refererer til. Disse Microsoft Entra ID-appregistreringer blev oprettet som multiprofil. Bot Framework-robotten anmoder om et token fra Bot Framework-lejeren og bruger dette token til at godkende Copilot Studio med Azure Bot Service. Copilot Studio bruger den samme mekanisme til at kontakte Bot Framework-robotten.

Registreringen af Copilot Studio-chatrobotten oprettes nu som en enkelt lejer, så denne kommunikation fungerer ikke længere. Microsoft Entra ID nægter at oprette tokens til programmet for registreringer af enkelt-lejer, der ikke er i samme lejer.

Derudover validerer Copilot Studio det indgående token og afviser anmodninger fra lejere, den ikke forventer, f.eks. det lejer-id, hvor den klassiske chatrobots programregistrering blev oprettet.

For at løse dette problem er der to mulige rettelser.

Klassiske chatrobotter i samme lejer som Bot Framework-robotten

I scenarier, hvor Copilot Studio-chatrobotten allerede er installeret i samme lejer som Bot Framework-robotten og kun bruges af denne robot, skal du opdatere robotten til en enkelt-lejer-konfiguration og derefter geninstallere din Bot Framework-robot. Du kan finde flere oplysninger om, hvordan du konfigurerer en Bot Framework-robot til en enkelt lejer, under Klargøre og publicere en robot.

Copilot Studio-chatrobot, der ikke kan opdateres til en enkelt lejer

I scenarier, hvor Copilot Studio-chatrobotten allerede er installeret i samme lejer som Bot Framework-robotten, men robotten ikke kan opdateres som enkelt lejer, skal du opdatere koden i Bot Framework-robotten for at oprette tokenet til at kommunikere med Copilot Studio-chatrobotten. Tokenet skal oprettes for den lejer, hvor Copilot Studio-chatrobotten også blev oprettet. Derudover skal svaret accepteres, hvilket sandsynligvis kræver, at du følger trinnene i Konvertere en eksisterende færdighed fra multiprofil til en enkelt lejer.

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