Del via

Bruge en klassisk chatrobot som en færdighed

  • Artikel

Vigtigt!

Power Virtual Agents-funktioner og -egenskaber er nu en del af Microsoft Copilot Studio, der følger vigtige investeringer i generativ AI og forbedrede integrationer på tværs af Microsoft Copilot.

Der refereres muligvis til nogle artikler og skærmbilleder i Power Virtual Agents, mens vi opdaterer dokumentation og undervisningsindhold.

Bemærk

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

Når du bruger en Microsoft Copilot Studio-copilot som en færdighed med en Bot Framework-bot, vil Bot Framework-botten afgøre, om noget, som brugeren siger, matcher Microsoft Copilot Studio-copilotens udløserfraser. Hvis der er sammenfald, vil Bot Framework-bot'en overføre samtalen til Microsoft Copilot Studio-bot'en. En Microsoft Copilot Studio-copilot udtrækker alle objekter og udløser det tilsvarende emne.

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

Vigtigt

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

Sådan konfigurerer du din Microsoft Copilot Studio-copilot som en færdighed:

  1. Tilføj Bot Framework-bot'en til listen over tilladte for Microsoft Copilot Studio-copilot.
  2. Download færdighedsmanifest for Microsoft Copilot Studio-copilot.
  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

Føj Bot Framework-robotten til listen over tilladte Microsoft Copilot Studio-copiloter

Føj Bot Framework-robottens app-id til listen over tilladte for den Microsoft Copilot Studio-copilot, 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.

    Skærmbillede, der viser, hvor du kan finde en Bot Framework-robots app-id.

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

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

    Skærmbillede, der viser feltet Liste over tilladte på siden Sikkerhed.

  4. Vælg Tilføj tilladte opkalder.

    Skærmbillede, hvor knappen Tilføj tilladte opkalder fremhæves øverst i panelet Administrer liste over tilladte.

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

    Skærmbillede, der viser, hvor du kan angive Bot Framework-robottens app-id.

    Advarsel

    En Microsoft Copilot Studio-copilot kan ikke fungere som en færdighed for andre Microsoft Copilot Studio-copiloter. 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.

    Microsoft 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.

    Skærmbillede, der viser, hvor du kan tilføje et vist navn for robotten på 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.

Skærmbillede af panelet Administrer liste over tilladte, der viser redigerings- og sletteikoner for en tilladt robot.

Bemærk

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

Downloade færdighedsmanifestet for din Microsoft Copilot Studio-copilot

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

Alle Microsoft Copilot Studio-copiloter har færdighedsmanifester. Det er JSON-filer, der indeholder en færdigheds navn, en brugergrænseflade og udløserfraser.

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

Microsoft 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 en Microsoft Copilot Studio-copilot skal håndtere brugerens forespørgsel på baggrund af manifestdataene. Den overfører alt det, som brugeren siger, til copiloten. Herefter matcher Microsoft Copilot Studio-copiloten det, brugeren har sagt, med et Microsoft Copilot Studio-emne, udtrækker de objekter, der er nødvendige for rubrikudfyldning, og udløser Microsoft Copilot Studio-emnet.

Microsoft Copilot Studio-færdighedsmanifester oprettes og opdateres automatisk. En Microsoft Copilot Studio-copilot har to færdighedsmanifester:

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

    • Testmanifestet er straks tilgængeligt for alle nyoprettede Microsoft Copilot Studio-robotter.
    • Det opdateres automatisk, så det afspejler ændringer, hver gang du gemmer din copilot.

  • Publiceret manifest: Tillader, at Bot Framework-robotten opretter forbindelse til den publicerede version af din Microsoft Copilot Studio-copilot.

    • Det publicerede manifest er kun tilgængeligt for Microsoft Copilot Studio-copiloter, der er publiceret mindst én gang.
    • Det opdateres automatisk, så det afspejler ændringer, hver gang du publicerer din copilot.

Bemærk

Det publicerede manifest er ikke tilgængeligt for Microsoft Copilot Studio-copiloter, der aldrig har været publiceret.

Hvis du vil oprette din robots Publiceret manifest, skal du publicere din Microsoft Copilot Studio-copilot.

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

Skærmbillede af panelet Administrer liste over tilladte, der viser Microsoft Copilot Studio-copilotmanifesterne.

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.

Skærmbillede af siden Detaljer, der viser, hvor du kan hente Microsoft Copilot Studio-copilotmanifesterne.

Hvis du vil hente et manifest, skal du markere det. Det downloades som en .zip-fil med navnet <bot name>_manifest for det Publicerede manifest eller <bot name>_test__manifest for testmanifestet.

Skærmbillede, der viser de to Microsoft Copilot Studio-manifester, efter at de er hentet.

Bemærk

Færdighedsmanifestet medtages ikke i systememner og Composer-dialogbokse, der er føjet til en Microsoft Copilot Studio-copilot. 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 Microsoft Copilot Studio-færdighed i Composer

Brug Microsoft 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.

    Skærmbillede af Bot Framework Composer, der viser, hvordan du opretter forbindelse mellem en Bot Framework-robot og en færdighed.

  2. Søg efter og vælg et .zip-arkiv for et Microsoft Copilot Studio-manifest, og vælg derefter Næste.

    Skærmbillede af Composer, der viser, hvor du skal vælge et zip-arkiv med en Microsoft Copilot Studio-færdighed.

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

    Skærmbillede af Composer, der viser valg af Microsoft Copilot Studio-emner.

  4. Gennemse og rediger udløserfraser til din Microsoft Copilot Studio-copilot, og vælg derefter Næste.

    Skærmbillede af Composer, der viser, hvor udløserfraser for valgte emner skal redigeres.

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

    Skærmbillede af Composer, der viser, at organisatoren er slået til.

  6. Kontrollér, at Microsoft Copilot Studio-færdigheden er føjet korrekt til din Bot Framework-robot, og at en ny udløser med din Microsoft Copilot Studio-copilots navn vises i projektet i Composer.

    Skærmbillede af Composer, når Microsoft Copilot Studio-færdigheden er tilføjet.

Find emne i færdighedsmanifestet

Brug en hændelse til at udløse et Microsoft 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.

    Skærmbillede af Composer, der fremhæver, hvor færdighedsmanifestet skal vises.

  3. Søg efter aktiviteter i manifestet. Denne egenskab indeholder indlejrede egenskaber, der repræsenterer de emner, som er tilgængelige i din Microsoft Copilot Studio-copilot.

    Skærmbillede af et færdighedsmanifest, der fremhæver egenskaben Aktiviteter.

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

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

    Skærmbilleder, der fremhæver Microsoft Copilot Studio-emnenavnet i manifestet.

Kald et Microsoft Copilot Studio-færdighedsemne

I stedet for at bruge, hvad en bruger siger, til at udløse et Microsoft Copilot Studio-færdighedsemne, kan du kalde det direkte. Du kan kun kalde Microsoft 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.

    Skærmbillede af Composer, der viser, hvordan du opretter forbindelse til en færdighed.

  2. Vælg din Microsoft Copilot Studio-copilot på listen Navn på færdighed-dialogboks.

    Skærmbillede, der viser, hvor du skal vælge din Microsoft Copilot Studio-copilot.

  3. Find navnet på hændelsesaktiviteten for det Microsoft Copilot Studio-botemne, 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.

    Skærmbillede, der viser, hvor du skal vælge Vis kode.

  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
]

    Skærmbillede, der viser, hvor koden til aktivitetshændelsen skal tilføjes med Microsoft Copilot Studio-emnets navn.

Overføre en inputvariabel til et Microsoft Copilot Studio-færdighedsemne

Bot Framework Composer kan overføre en variabel til et Microsoft Copilot Studio-færdighedsemne som input. Du kan få mere at vide om, hvordan du opretter Microsoft Copilot Studio-emner, der accepterer inputvariabler, under Overføre variabler mellem emner.

Hvis et Microsoft 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.

    Skærmbillede af Composer, der viser, hvordan du opretter forbindelse til en færdighed.

  2. Vælg din Microsoft Copilot Studio-copilot på listen Navn på færdighed-dialogboks.

    Skærmbillede, der viser, hvor du skal vælge din Microsoft Copilot Studio-copilot.

  3. Find navnet på hændelsesaktiviteten for det Microsoft Copilot Studio-copilotemne, 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 Microsoft Copilot Studio-emnet ikke har input, indeholder den ikke egenskaben værdi.

    Skærmbillede af et færdighedsmanifest, der fremhæver 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 Microsoft Copilot Studio-emnets input. Du skal bruge dem i de næste trin.

    Skærmbillede af et færdighedsmanifest, der fremhæver, hvor du kan finde inputvariabler for et Microsoft Copilot Studio-emne.

  6. Vælg Luk.

  7. Vælg Vis kode i sektionen Aktivitet.

    Skærmbillede, der viser, hvor du skal vælge Vis kode.

  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 Microsoft Copilot Studio-copilotemnet dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

    Skærmbillede, der viser, hvor koden til aktivitetshændelsen skal tilføjes med en Microsoft Copilot Studio-inputværdi.

Modtag en outputvariabel fra et Microsoft Copilot Studio-færdighedsemne

Det er muligt at modtage output fra et Microsoft Copilot Studio-færdighedsemne i Composer. Du kan få mere at vide om, hvordan du opretter Microsoft Copilot Studio-emner, der returnerer output, under Overføre variabler mellem emner.

  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.

    Skærmbillede af Composer, der viser, hvordan du opretter forbindelse til en færdighed.

  2. Vælg din Microsoft Copilot Studio-copilot på listen Navn på færdighed-dialogboks.

    Skærmbillede, der viser, hvor du skal vælge din Microsoft Copilot Studio-copilot.

  3. Find navnet på hændelsesaktiviteten til dit Microsoft Copilot Studio-robotemne, 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 Microsoft Copilot Studio-emnet ikke har output, indeholder det ikke egenskaben resultValue.

    Skærmbillede af et færdighedsmanifest, der fremhæver egenskaben resultValue for et Microsoft Copilot Studio-emne.

  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 Microsoft Copilot Studio-emnets outputvariabler. Du skal bruge dem i de næste trin.

    I følgende eksempel returnerer Microsoft Copilot Studio-emnet to outputtyper af typen Streng, pva_State og pva_Item.

    Skærmbillede af et færdighedsmanifest, der fremhæver, hvor du kan finde outputvariabler for et Microsoft Copilot Studio-emne.

  6. Vælg Luk.

  7. Vælg Vis kode i sektionen Aktivitet.

    Skærmbillede, der viser, hvor du skal vælge Vis kode.

  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
]

    Skærmbillede, der viser, hvor koden til aktivitetshændelsen skal tilføjes med et Microsoft Copilot Studio-emnenavn.

  9. Angiv Egenskab til Composer-variablen under kodeområdet, så outputværdierne fra Microsoft Copilot Studio-færdighedslisten modtages og lagres.

    Skærmbillede af, hvor feltet Egenskab skal angives til dialog.skillResult.

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

    Skærmbillede, der viser, hvor du skal vælge 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 følgende eksempel udtrækkes outputværdierne fra dialog.skillResult.pvaState og dialog.skillResult.pvaItem til nye Composer-variabeler dialog.State og dialog.Item.

    Skærmbillede, der fremhæver de outputværdier, der er gemt i dialog.State og dialog.Item i Composer-vinduet Angiv egenskaber.

Teste din Microsoft Copilot Studio-copilot som en færdighed med en Bot Framework-copilot

Brug Bot Framework Emulator til at teste, at din Bot Framework-robot kalder en Microsoft Copilot Studio-copilot som en færdighed korrekt.

Vigtigt

Din Bot Framework-robot skal være tilføjet på Microsoft Copilot Studio-copilotens liste over tilladte, for at færdighedsforbindelsen fungerer.

Flere oplysninger