Bruk en klassisk chatrobot som en ferdighet i en Bot Framework-robot

Artikkel
12/09/2024

Merk

Denne artikkelen inneholder informasjon som bare gjelder for Copilot Studio klassiske chatroboter. Denne funksjonen er ikke tilgjengelig i den nye Copilot Studio opplevelsen.

Når du bruker en klassisk chatbot som enferdighetmed enrobot Bot Framework , avgjør Bot Framework roboten om noe brukeren sier samsvarer med den klassiske chatbotens utløserfraser. Hvis Der er en match, denrobotsender Bot Framework samtalen til den klassiske chatboten. Den klassiske chatroboten trekker ut alle enheter og utløser det samsvarende emnet.

Du kan også sende en variabel til en Copilot Studio ferdighet emne som inndata fra Bot Framework Composer og bruke utdataene den returnerer.

Viktig!

Du må ha en prøveversjon eller full Copilot Studio lisens for å bruke klassiske chatroboter som kompetanser. Denne funksjonen er ikke tilgjengelig med Teams-lisensen Copilot Studio .

Slik konfigurerer du den klassiske chatroboten som en ferdighet:

Legg tilbot Bot Framework til tillatelseslisten for den klassiske chatboten.
Last ned manifestet for ferdigheter for den klassiske chatroboten.
Bruk manifestet for nedlastede ferdigheter i Bot Framework Composer til å opprette en forbindelse mellom robotene.
Bruk emulatoren Bot Framework til å bekrefte at roboten fungerer som en ferdighet.

Forutsetninger

Legg til roboten din Bot Framework i tillatelseslisten for den klassiske chatboten din

Legg tilrobotens Bot Framework app-ID til tillatelseslisten for den klassiske chatboten du vil bruke som en ferdighet. Robotene må være i samme leier.

Åpne roboten som skal bruke ferdigheten, i Bot Framework Composer. Velg Konfigurer, og velg deretter Utviklingsressurser. Kopier ID-en i Microsoft-app-ID-en.
I Copilot Studio åpner du den klassiske chatboten du vil bruke som en ferdighet.
Gå til Innstillinger og velg Sikkerhet på navigasjonsmenyen. Velg deretter Tillatelsesliste.
Velg Legg til tillatt oppringer.
Lim inn Bot Framework-robotens app-ID, og velg Neste.

Forsiktig!

En klassisk chatrobot kan ikke fungere som en ferdighet for andre klassiske chatroboter. 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.

Copilot Studio validerer Bot Framework robotens app-ID og bekrefter at den tilhører en robot i samme leier.
(Valgfritt) Legg til et Visningsnavn for roboten du har lagt til i tillatelseslisten.
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.

Merk

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

Last ned manifestet for klassiske chatbot-ferdigheter for den klassiske chatboten din

Bot Framework Roboter kan bruke et Copilot Studio manifest for ferdigheter til å konfigurere en tilkobling til den klassiske chatroboten som produserte manifestet.

Alle klassiske chatbots har manifester for ferdigheter. Dette er JSON-filer som omfatter et navn, grensesnitt og utløseruttrykk for en ferdighet.

En Bot Framework robot kan bruke et manifest for ferdigheter til å vite når den klassiske chatroboten skal utløses (for eksempel som svar på noe en bruker sier til den).

Copilot Studio ferdighet manifestene følger versjon 2.2 av Bot Framework ferdighet manifestskjemaet og består av intents.lu og manifest.json filer.

En Bot Framework robot kan bestemme at klassisk chatbot skal håndtere brukerens forespørsel, basert på manifestdataene. Den sender til den klassiske chatboten alt brukeren sa. Deretter matcher den klassiske chatboten det brukeren sa til et Copilot Studio emne, trekker ut alle enheter som trengs for å fylle spor, og utløser Copilot Studio emnet.

Copilot Studio Ferdighetsmanifester genereres og oppdateres automatisk. En klassisk chatrobot har to manifester for ferdigheter:

Testmanifest: Lar Bot Framework roboten koble til testversjonen av den klassiske chatroboten. Bruk testmanifestet til å validere endringer i ferdigheten før du publiserer den.
- Testmanifestet er umiddelbart tilgjengelig for alle nyopprettede klassiske chatroboter.
- Den oppdateres automatisk for å gjenspeile endringer hver gang du lagrer den klassiske chatroboten.
Publisert manifest: Lar roboten Bot Framework koble til den publiserte versjonen av den klassiske chatroboten.
- Det publiserte manifestet er bare tilgjengelig for klassiske chatroboter som er publisert minst én gang.
- Den oppdateres automatisk for å gjenspeile endringer hver gang du publiserer agent.

Notat

Publisert manifest er ikke tilgjengelig for klassiske chatroboter som aldri har blitt publisert.

For å generere robotens publiserte manifest,publiser din klassiske chatbot.

Begge ferdighetsmanifestene vises i panelet Administrer tillatelsesliste.

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

Velg et manifest for å laste det ned. Den lastes ned som en .zip fil merket _<robot navnemanifest> for det publiserte manifestet , eller < robot navn>test__manifest for testmanifestet .

Notat

Manifestet for ferdigheter inkluderer ikke systememner og Composer-dialogbokser som legges til i en klassisk chatrobot. Det er bare emner som ble opprettet av kopilotforfattere, og Composer-hensiktsutløsere som forfattere legger til roboten, som er inkludert.

Koble til en Copilot Studio ferdighet i Composer

Bruk Copilot Studio manifester for ferdigheter for å opprette en ferdighetsforbindelse i roboten din Bot Framework i Composer.

I Bot Framework Composer-prosjektet velger du Legg til og deretter Koble til en ferdighet.
Bla til og Velg et Copilot Studio manifest .zip arkiv, og deretter Velg Neste.
Velg emnene, eller intensjonene, i den klassiske chatroboten som du vil legge til i Bot Framework roboten, og Velg deretter Neste.
Se gjennom og rediger utløseruttrykkene for den klassiske chatroboten, og Velg deretter Neste.
Kontroller at Bruk Orchestrator til prosjekter med flere roboter er valgt, og velg deretter Fortsett.
Kontroller at Copilot Studio ferdigheten er lagt til i roboten din Bot Framework på riktig måte, og at en ny utløser med navnet på den klassiske chatroboten vises i prosjektet i Composer.

Finn emnet i ferdighetsmanifestet

Bruk en hendelse til å utløse et Copilot Studio 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.

Velg handlingen Koble til en ferdighet.
Velg Vis ferdighetsmanifest under Navn på ferdighetsdialog.
Finn activities i manifestet. Denne egenskapen inneholder nestede egenskaper som representerer emnene som er tilgjengelige i den klassiske chatroboten.
Finn emnet du vil kalle opp, og se etter egenskapen name for det. Når Copilot Studio ferdigheten mottar en hendelse med dette navnet, utløser den emnet.

I dette eksemplet er dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d navnet på hendelsesaktiviteten.

Ring en Copilot Studio ferdighet emne

I stedet for å stole på hva en bruker sier til utløser en Copilot Studio ferdighet emne, kan du kalle det direkte. Du kan bare kalle Copilot Studio emner som er oppført i manifestet for ferdigheter, direkte.

Velg Legg til på redigeringslerretet for Composer, velg Tilgang til eksterne ressurser, og velg deretter Koble til en ferdighet.
I listen Dialogboksnavn for ferdigheter Velg den klassiske chatboten din.
Finn navnet på hendelsesaktiviteten for det klassiske chatrobot-emnet du vil ringe. Kopier verdien, utelat anførselstegnene, og lagre den for å bruke den i de neste trinnene.
Velg Lukk.
Velg Vis kode i Aktivitet-delen.
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
]
```

Sende en inndatavariabel til en Copilot Studio ferdighet emne

Bot Framework Composer kan sende en variabel til en Copilot Studio ferdighet emne som inndata. Hvis du vil lære hvordan du oppretter Copilot Studio emner som godtar inndatavariabler, kan du se Arbeide med variabler.

Hvis et emne som kan motta en inndatavariabel, er oppført i manifestet Copilot Studio for ferdigheter, kan du sende en Composer-variabel til det.

Velg Legg til på redigeringslerretet for Composer, velg Tilgang til eksterne ressurser, og velg deretter Koble til en ferdighet.
I listen Dialogboksnavn for ferdigheter Velg den klassiske chatboten din.
Finn navnet på hendelsesaktiviteten for det klassiske chatrobot-emnet du vil ringe. Kopier verdien, utelat anførselstegnene, og lagre den for å bruke den i de neste trinnene.
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 Copilot Studio emne ikke har inndata, har det ikke en verdiegenskap .
Finn egenskapen definitions, og se etter en nestet egenskap som samsvarer med $ref-verdien du fant i forrige trinn. Legg merke til navnene og typene på Copilot Studio emnets inndata. Du skal bruke dem i de neste trinnene.
Velg Lukk.
Velg Vis kode under Aktivitet-delen.
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 dette eksemplet gir Composer-variabelen dialog.storeLocation en verdi til inndatavariabelen pva_StoreLocation i det klassiske chatrobot-emnet dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Motta en utdatavariabel fra en Copilot Studio ferdighet emne

Det er mulig å motta utdata fra en Copilot Studio ferdighet emne i Composer. Hvis du vil lære hvordan du oppretter Copilot Studio emner som returnerer utdata, kan du se Arbeide med variabler.

Velg Legg til på redigeringslerretet for Composer, velg Tilgang til eksterne ressurser, og velg deretter Koble til en ferdighet.
I listen Dialogboksnavn for ferdigheter Velg den klassiske chatboten din.
Finn navnet på hendelsesaktiviteten for det klassiske chatrobot-emnet du vil ringe. Kopier verdien, utelat anførselstegnene, og lagre den for å bruke den i de neste trinnene.
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 Copilot Studio emne ikke har utdata, vil det ikke ha en resultValue-egenskap .
Finn egenskapen definitions, og se etter en nestet egenskap som samsvarer med $ref-verdien du fant i forrige trinn. Legg merke til navnene og typene for Copilot Studio emnets utdatavariabler. Du skal bruke dem i de neste trinnene.

I dette eksemplet returnerer emne Copilot Studio to utdata av typen String,pva_State og pva_Item.
Velg Lukk.
Velg Vis kode i Aktivitet-delen.
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
]
```
Under kodeområdet setter du Egenskap til en Composer-variabel for å motta og lagre utdataverdiene fra Copilot Studio ferdighet emne.
Velg Legg til og deretter Behandle egenskaper i redigeringslerretet for Composer, og velg deretter Angi egenskaper.
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 dette eksemplet trekkes utdataverdiene fra dialog.skillResult.pvaState og dialog.skillResult.pvaItem ut i den nye dialogboksen Composer-variabler . Tilstand og dialog. Gjenstand.

Test din klassiske chatbot som en ferdighet med en Bot Framework robot

Bruk emulatoren Bot Framework til å teste at roboten din Bot Framework kaller en klassisk chatbot som en ferdighet.

Viktig!

Roboten din Bot Framework må legges til i den klassiske chatbotens tillatelsesliste for at ferdigheten skal fungere.

Del via