Använd en klassisk chattrobot som en färdighet i en Bot Framework robot

Artikel
12/09/2024

Obs

Den här artikeln innehåller information som endast gäller för Copilot Studio klassiska chattrobotar. Den här funktionen är inte tillgänglig i den nya Copilot Studio upplevelsen.

När du använder en klassisk chatbot som en färdighetmed en Bot Framework robot Bot Framework , avgör roboten om något som användaren säger matchar den klassiska chatbotens utlösare fraser. Om Dit är en matchning skickar robot Bot Framework konversationen till den klassiska chattroboten. Den klassiska chattroboten extraherar alla enheter och utlöser det matchande ämnet.

Du kan också skicka en variabel till a Copilot Studio färdighet ämne som indata från Bot Framework Composer och använda de utdata som den returnerar.

Viktigt

Du måste ha en provperiod eller full Copilot Studio licens för att använda klassiska chattrobotar som färdigheter. Den här funktionen är inte tillgänglig med Teams-licensen Copilot Studio .

Så här ställer du in din klassiska chattrobot som en färdighet:

Bot Framework Lägg till roboten i listan över tillåtna för den klassiska chattroboten.
Ladda ned färdighetsmanifestet för den klassiska chattroboten.
Använd det nedladdade färdighetsmanifestet i Bot Framework Composer för att skapa en anslutning mellan robotarna.
Bot Framework Använd emulatorn för att bekräfta att roboten fungerar som en färdighet.

Förutsättningar

Lägg till din Bot Framework robot i listan över tillåtna för din klassiska chattrobot

Bot Framework Lägg till robotens app-ID i listan över tillåtna för den klassiska chattroboten som du vill använda som en färdighet. Robotar måste vara i samma klientorganisation.

I Bot Framework Composer öppnar du den robot som ska använda färdigheten. Välj Konfigurera och välj sedan Utvecklingsresurser. Kopiera ID:t i ID för Microsoft-app.
Öppna Copilot Studio den klassiska chattroboten som du vill använda som en färdighet.
I navigeringsmenyn, under Inställningar, väljer du Säkerhet. Välj sedan Lista över tillåtna.
Välj Lägg till tillåten uppringare.
Klistra in din Bot Framework robots app-ID och välj Nästa.

Varning

En klassisk chattrobot kan inte fungera som en färdighet för andra klassiska chattrobotar. Om du försöker lägga till ett app-ID som hör till en Power Virtual Agent robot i listan visas ett felmeddelande. Du kan endast lägga till ett app-ID för en Bot Framework robot.

Copilot Studio validerar Bot Framework robotens app-ID och bekräftar att den tillhör en robot i samma klientorganisation.
(Tillval) Lägg till visningsnamn för den robot du har lagt till i listan över tillåtna.
Välj Spara.

Den Bot Framework robot visas med dess visningsnamn om du angav ett, eller av dess app-ID om du inte angav ett visningsnamn.. Om du vill ta bort eller redigera den när som helst markerar du ikonen till höger om ikonens visningsnamn eller app-ID.

Kommentar

Bot Framework robotar som är tillagda i listan över tillåtna exporteras inte som en del av robotinnehållet.

Ladda ned manifestet för den klassiska chattrobotens färdigheter för din klassiska chattrobot

Bot Framework Robotar kan använda ett Copilot Studio färdighetsmanifest för att konfigurera en anslutning till den klassiska chattroboten som skapade manifestet.

Alla klassiska chattrobotar har färdighetsmanifest. Det här är JSON-filer som innehåller färdighetens namn, gränssnitt och utlösarfraser.

En Bot Framework robot kan använda ett färdighetsmanifest för att veta när den klassiska chattroboten ska utlösare (till exempel som svar på något som en användare säger till den).

Copilot Studio färdighet manifest följer version 2.2 av färdighet Bot Framework manifestschemat och består av intents.lu och manifest.json filer.

Arobot Bot Framework kan bestämma att den klassiska chattroboten ska hantera användarens begäran, baserat på manifestdata. Den skickar till den klassiska chatboten allt som användaren sa. Sedan matchar den klassiska chatboten vad användaren sa till ett Copilot Studio ämne, extraherar alla enheter som behövs för att fylla i facket och utlöser Copilot Studio ämnet.

Copilot Studio Färdighetsmanifest genereras och uppdateras automatiskt. En klassisk chattrobot har två färdigheter:

Testmanifest: Tillåter Bot Framework roboten att ansluta till testversionen av din klassiska chattrobot. Använd testmanifest för att verifiera ändringar i din färdighet innan du publicerar den.
- Testmanifestet är omedelbart tillgängligt för varje nyskapad klassisk chattrobot.
- Den uppdateras automatiskt för att återspegla ändringar varje gång du sparar din klassiska chattrobot.
Publicerat manifest: Tillåter Bot Framework roboten att ansluta till den publicerade versionen av din klassiska chattrobot.
- Det publicerade manifestet är endast tillgängligt för klassiska chattrobotar som har publicerats minst en gång.
- Den uppdateras automatiskt för att återspegla ändringar varje gång du publicerar din handläggare.

Obs

Det publicerade manifestet är inte tillgängligt för klassiska chattrobotar som aldrig har publicerats.

Om du vill generera robotens publicerade manifest publicerar du din klassiska chattrobot.

Båda färdighetsmanifesterna finns på panelen Hantera lista över tillåtna.

Färdighetsmanifest visas också på sidan Detaljer för copilot. I navigeringsmenyn väljer du Inställningar och väljer sedan Detaljer. På sidan Information visas andra metadata som Miljö-ID, Klientorganisations-ID och robot app-ID.

Välj ett manifest om du vill hämta det. Den laddas ned som en .zip fil med etiketten _<robot namnmanifestet> för det publicerade manifestet , eller < robot namn>test__manifest för testmanifestet .

Obs

Färdighetsmanifestet innehåller inte systemämnen och Composer-dialogrutor som läggs till i en klassisk chattrobot. Endast ämnen som skapats av copilotförfattare och Composer-avsiktsutlösare som författare lägger till roboten ingår.

Ansluta till en Copilot Studio färdighet i Composer

Använd Copilot Studio färdighetsmanifest för att skapa en färdighet-anslutning i din Bot Framework robot i Composer.

I ett Bot Framework Composer-projekt, välj Lägg till och sedan Anslut till en färdighet.
Bläddra till och Välj ett Copilot Studio manifest .zip arkivet och sedan Välj Nästa.
Välj de ämnen, eller avsikter, i din klassiska chattrobot som du vill lägga till i din Bot Framework robot och väljsedan Nästa.
Granska och redigera utlösare fraser för din klassiska chattrobot och välj sedan VäljNext .
Se till att Använd initierare för projekt med flera robotar markerats och välj Fortsätt.
Kontrollera att Copilot Studio färdigheten har lagts till i din Bot Framework robot korrekt och att en ny utlösare med namnet på din klassiska chattrobot visas i projektet i Composer.

Leta upp ämne i färdighetsmanifestet

Använd en händelse för att Utlösare ett Copilot Studio ämne i färdigheten. För att kalla ett specifikt ämne från Composer, referera till ämnet med på den associerade händelsen i färdighetsmanifestet.

Välj åtgärden Ansluta till en färdighet.
Under Namn på färdighetsdialog, välj Visa färdighetsmanifest.
Hitta aktiviteter i manifestet. Den här egenskapen innehåller kapslade egenskaper som representerar de ämnen som är tillgängliga i din klassiska chattrobot.
Hitta ämnet du vill ringa och leta efter egenskapen name. Copilot Studio När färdigheten tar emot en händelse med det här namnet utlöser den ämnet.

I det här exemplet är dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d namnet på händelseaktiviteten.

Ring en Copilot Studio färdighet ämne

Istället för att förlita dig på vad en användare säger för att Utlösare en Copilot Studio färdighet ämne kan du ringa det direkt. Du kan bara anropa Copilot Studio ämnen direkt som anges i färdighetsmanifestet.

I Composer designyta, välj Lägg till och sedan Få tillgång till externa resurser och välj sedan Anslut till en färdighet.
I listan över namn på färdigheter i dialogrutan Välj din klassiska chattrobot.
Leta reda på händelseaktivitetens namn för det klassiska chattrobot-ämne som du vill anropa. Kopiera värdet och klicka på citattecken och spara det så att det används i nästa steg.
Välj Stäng.
I avsnittet Aktivitet välj Visa kod.
Skriv eller klistra in följande kod. Ersätt TOPIC_ACTIVITY_NAME med ämne aktivitetsnamn för händelsen. Kontrollera att det inte finns några citattecken i name egenskapen.
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```

Skicka en indatavariabel till en Copilot Studio färdighet ämne

Bot Framework Composer kan skicka en variabel till a Copilot Studio färdighet ämne som indata. Information om hur du skapar Copilot Studio ämnen som accepterar indatavariabler finns i Arbeta med variabler.

Om ett Copilot Studio ämne som kan ta emot en indatavariabel finns med i ditt färdighets manifest kan du skicka en Composer-variabel till det.

I Composer designyta, välj Lägg till och sedan Få tillgång till externa resurser och välj sedan Anslut till en färdighet.
I listan över namn på färdigheter i dialogrutan Välj din klassiska chattrobot.
Leta reda på händelseaktivitetens namn för det klassiska chattrobot-ämne som du vill anropa. Kopiera värdet och klicka på citattecken och spara det så att det används i nästa steg.
Hitta ämnets value egenskap. Egenskapen value innehåller egenskapen $ref. Kopiera det värdet och spara det för att använda i nästa steg.

Varning

Om ett Copilot Studio ämne inte har indata har det ingen värdeegenskap .
Leta upp egenskapen definitions och leta upp en kapslad egenskap som $ref värdet du hittade i föregående steg. Anteckna namnen och typerna av Copilot Studio ämnets indata. Du kommer att använda dem i nästa steg.
Välj Stäng.
I avsnittet Aktivitet välj Visa kod.
Skriv eller klistra in följande kod. Ersätt dessa värden:
1. Ersätt TOPIC_ACTIVITY_NAME med ämne aktivitetsnamn för händelsen.
2. Ersätt PVA_INPUT_VARIABLE med en indatavariabel från ämne.
3. Ersätt COMPOSER_INPUT_VARIABLE med en Composer-variabel som ger ett värde.
```
[Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]
```
I det här exemplet ger variabeln dialog.storeLocation Composer ett värde till indatavariabeln pva_StoreLocation i det klassiska ämnet dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16 chattrobot.

Ta emot en utdatavariabel från en Copilot Studio färdighet ämne

Det är möjligt att ta emot utdata från en Copilot Studio färdighet ämne i Composer. Information om hur du skapar Copilot Studio ämnen som returnerar utdata finns i Arbeta med variabler.

I Composer designyta, välj Lägg till och sedan Få tillgång till externa resurser och välj sedan Anslut till en färdighet.
I listan över namn på färdigheter i dialogrutan Välj din klassiska chattrobot.
Hitta händelseaktivitetens namn för ditt klassiska chattrobot-ämne som du vill ringa. Kopiera värdet och klicka på citattecken och spara det så att det används i nästa steg.
Hitta ämnets resultValue egenskap. Egenskapen resultValue innehåller egenskapen $ref. Kopiera det värdet och spara det för att använda i nästa steg.

Varning

Om ett Copilot Studio ämne inte har utdata har det ingen resultValue egenskap.
Leta upp egenskapen definitions och leta upp en kapslad egenskap som $ref värdet du hittade i föregående steg. Anteckna namnen och typerna för Copilot Studio ämnets utdatavariabler. Du kommer att använda dem i nästa steg.

I det här exemplet returnerar ämne Copilot Studio två utdata av typen String,pva_State och pva_Item.
Välj Stäng.
I avsnittet Aktivitet välj Visa kod.
Skriv eller klistra in följande kod. Ersätt TOPIC_ACTIVITY_NAME med ämne aktivitetsnamn för händelsen. Kontrollera att det inte finns några citattecken i name egenskapen.
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```
Under kodområdet ställer du in Egenskap till en Composer-variabel för att ta emot och lagra utdatavärdena från färdighet ämne Copilot Studio .
I Composer designyta, välj Lägg till, välj sedan Hantera egenskaper och välj Ange egenskaper.
Ange Egenskap till ett Composer-värde som ska lagra det extraherade värdet. Ange sedan Värde till Composer variabeln du lagrade ämnets utdata i.

I det här exemplet extraheras utdatavärdena från dialog.skillResult.pvaState och dialog.skillResult.pvaItem till den nya dialogrutan för Composer-variabler . Tillstånd och dialog. Artikel.

Testa din klassiska chatbot som en färdighet med en Bot Framework robot

Bot Framework Använd emulatorn för att testa att din Bot Framework robot anropar en klassisk chattrobot korrekt som en färdighet.

Viktigt

Din Bot Framework robot måste läggas till i den klassiska chattrobotens lista över tillåtna för att färdighetsanslutningen ska fungera.

Dela via