Dela via

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

  • Artikel

Obs

Den här artikeln innehåller endast information om Microsoft Copilot Studio klassisk chattrobotar. Den här funktionen är inte tillgänglig i den nya Microsoft Copilot Studio-upplevelsen.

När du använder en Microsoft Copilot Studio copilot som en färdighet med en Bot Framework robot, avgör Bot Framework roboten om något som användaren säger matchar Microsoft Copilot Studio copilot utlösarfraser. Om det finns en matchning kommer Bot Framework roboten skicka samtalet till Microsoft Copilot Studio robot. Microsoft Copilot Studio copilot extraherar alla entiteter och utlöser det matchande ämnet.

Du kan också skicka en variabel till en Microsoft Copilot Studio färdighetsämne som input från Bot Framework Composer och använda de utdata som returneras.

Viktigt!

Du måste ha en utvärderingsversion eller fullständig Microsoft Copilot Studio.licens för att använda Microsoft Copilot Studio robotar som en färdighet. Den här funktionen är inte tillgänglig med licensen Teams Microsoft Copilot Studio.

Så här anger du din Microsoft Copilot Studio copilot som en färdighet:

  1. Lägg till Bot Framework roboten till listan över tillåtna för Microsoft Copilot Studio copilot.
  2. Du hämtar färdighetsmanifestet för Microsoft Copilot Studio copilot.
  3. Använd det hämtade färdighetsmanifestet i Bot Framework Composer för att skapa en anslutning mellan robotar.
  4. Använd Bot Framework Emulator för att bekräfta att roboten fungerar som en färdighet.

Förutsättningar

Du lägger till Bot Framework roboten till listan över tillåtna för din Microsoft Copilot Studio copilot

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

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

    Skärmbild med information om var du kan hitta Bot Framework robotens app-ID.

  2. I Microsoft Copilot Studio, öppna den copilot du vill använda som färdighet.

  3. I navigeringsmenyn, under Inställningar, väljer du Säkerhet. Välj sedan Lista över tillåtna.

    Skärmbild som markerar panelen för listan över tillåtna på sidan Säkerhet.

  4. Välj Lägg till tillåten uppringare.

    Skärmbild som markerar knappen Lägg till tillåten uppringare högst upp på den en panel för Hantera lista över tillåtna.

  5. Klistra in din Bot Framework robots app-ID och välj Nästa.

    Skärmbild med information om var du anger Bot Framework robotens app-ID.

    Varning

    En Microsoft Copilot Studio copilot kan inte fungera som en färdighet för andra Microsoft Copilot Studio copilot. 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.

    Microsoft Copilot Studio verifierar Bot Framework robotens app-ID och bekräftar att den tillhör en robot i samma klientorganisation.

  6. (Tillval) Lägg till visningsnamn för den robot du har lagt till i listan över tillåtna.

    Skärmbild med information om var en visningsnamn för roboten i listan med tillåtna.

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

Skärmbild på panelen Hantera lista över tillåtna som visar redigerings- och borttagningsikoner för en tillåten robot.

Kommentar

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

Du hämtar copilot färdighetsmanifestet för Microsoft Copilot Studio copilot

Bot Framework robotar kan använda ett Microsoft Copilot Studio färdighetsmanifest för att konfigurera en anslutning till copilot som producerade manifestet.

Alla Microsoft Copilot Studio copilot 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 färdighetsmanifest för att veta när den ska utlösa Microsoft Copilot Studio roboten (till exempel som svar på något en användare säger till den).

Microsoft Copilot Studio färdighetsmanifest följer version 2.2 av Bot Framework färdighetsmanifestschema och består av filerna intents.lu och manifest.json.

En Bot Framework robot kan bestämma att Microsoft Copilot Studio copilot ska hantera användarens begäran, baserat på manifestdata. Den vidarebefordrar allt som användaren har sagt till copilot. Därefter matchar Microsoft Copilot Studio copilot vad användaren sa till ett Microsoft Copilot Studio ämne, extraherar alla entiteter som behövs för platsfyllning och utlöser Microsoft Copilot Studio ämnet.

Microsoft Copilot Studio färdighetsmanifest skapas och uppdateras automatiskt. En Microsoft Copilot Studio copilot har två färdighetsmanifest:

  • Testmanifest: Tillåter att Bot Framework roboten ansluter till testversionen av din Microsoft Copilot Studio copilot. Använd testmanifest för att verifiera ändringar i din färdighet innan du publicerar den.

    • Testmanifest är omedelbart tillgängligt för alla nyskapade Microsoft Copilot Studio robotar.
    • Den uppdateras automatiskt så att den återspeglar ändringarna varje gång du sparar i din copilot.

  • Publicerade manifest: Tillåter att Bot Framework roboten ansluter till den publicerade versionen av din Microsoft Copilot Studio copilot.

    • Det publicerade manifestet är endast tillgängligt för Microsoft Copilot Studio copilot som har publicerats minst en gång.
    • Den uppdateras automatiskt så att den återspeglar ändringarna varje gång du publicerar din copilot.

Kommentar

Det publicerade manifest är inte tillgängligt i Microsoft Copilot Studio copilot som aldrig har publicerats.

För att generera dina robots Publicerade manifest, måste du publicera din Microsoft Copilot Studio copilot.

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

Skärmbild på panelen Hantera lista över tillåtna som visar Microsoft Copilot Studio copilotmanifest.

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.

Skärmbild på informationssidan där du kan hämta Microsoft Copilot Studio copilotmanifesten.

Välj ett manifest om du vill hämta det. Det laddar ner en a .zip-fil märkt <robotnamn>_manifest för publicerat manifest eller <robotnamn>_testmanifest för testmanifestet.

Skärmbild med de två Microsoft Copilot Studio manifesten när de har hämtats.

Kommentar

Färdighetsmanifestet inkluderar inte systemämnen och Composer-dialoger som läggs till i en Microsoft Copilot Studio copilot. Endast ämnen som skapats av copilotförfattare och Composer-avsiktsutlösare som författare lägger till roboten ingår.

Anslut till en Microsoft Copilot Studio färdighet i Composer

Du kan använda Microsoft Copilot Studio färdighetsmanifest för att skapa en färdighetsanslutning i din Bot Framework robot i Composer.

  1. I ett Bot Framework Composer-projekt, välj Lägg till och sedan Anslut till en färdighet.

    Skärmbild på Bot Framework Composer som visar hur du ansluter en Bot Framework robot till en färdighet.

  2. Bläddra till och välj ett Microsoft Copilot Studio manifest zip-arkiv och välj Nästa.

    Skärmbild på Composer som visar var du kan välja ett komprimerat arkiv med Microsoft Copilot Studio färdighet.

  3. Välj vilka avsnitt eller avsikter i din Microsoft Copilot Studio copilot som du vill lägga till i din Bot Framework copilot och välj Nästa.

    Skärmbild på Composer som visar vilka avsnitt som har val av Microsoft Copilot Studio ämnen.

  4. Granska och redigera utlösarfraserna för Microsoft Copilot Studio copilot och välj Nästa.

    Skärmbild på Composer som visar var utlösarfraser för valda ämnen kan redigeras.

  5. Se till att Använd initierare för projekt med flera robotar markerats och välj Fortsätt.

    Skärmbild på Composer som visar att initieraren har aktiverats.

  6. Kontrollera att Microsoft Copilot Studio färdighet läggs till din Bot Framework robot korrekt och en ny utlösare med din Microsoft Copilot Studio copilot namn visas i projektet i Composer.

    Skärmbild av Composer efter att Microsoft Copilot Studio färdigheten har lagts till.

Leta upp ämne i färdighetsmanifestet

Använd en händelse för att utlösa Microsoft 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.

  1. Välj åtgärden Ansluta till en färdighet.

  2. Under Namn på färdighetsdialog, välj Visa färdighetsmanifest.

    Skärmbild på Composer, där färdighetsmanifestet visas.

  3. Hitta aktiviteter i manifestet. Den här egenskapen innehåller inkapslade egenskaper som representerar de ämnen som finns tillgängliga från din Microsoft Copilot Studio copilot.

    Skärmbild på ett färdighetsmanifest för egenskapen aktiviteter.

  4. Hitta ämnet du vill ringa och leta efter egenskapen name. När Microsoft Copilot Studio färdigheten tar emot en händelse med detta namn utlöses ämnet.

    I följande exempel heter händelseaktiviteten i dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

    Skärmbilden markerar Microsoft Copilot Studio ämnesnamnet i manifestet.

Anropa ett Microsoft Copilot Studio färdighetsämne

Istället för att förlita sig på vad en användare säger för att utlösa ett Microsoft Copilot Studio färdighetsämne kan du anropa det direkt. Du kan bara anropa Microsoft Copilot Studio ämnena direkt som finns med i färdighetsmanifestet.

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

    Skärmbild på Composer som visar hur du ansluter till en färdighet.

  2. I listan Namn på färdighetsdialog, välj din Microsoft Copilot Studio copilot.

    Skärmbild med information om var du ska välja din Microsoft Copilot Studio copilot.

  3. Leta upp händelseaktivitetens namn för Microsoft Copilot Studio robotämne du vill ringa. Kopiera värdet och klicka på citattecken och spara det så att det används i nästa steg.

  4. Välj Stäng.

  5. I avsnittet Aktivitet välj Visa kod.

    Skärmbild med information om var du väljer Visa kod.

  6. 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
]

    Skärmbild med information om var aktivitetshändelsekoden ska läggas till med Microsoft Copilot Studio ämnesnamn.

Skicka en indatavariabel till ett Microsoft Copilot Studio färdighetsämne

Bot Framework Composer kan skicka en variabel till ett Microsoft Copilot Studio färdighetsämne som indata. För att lära dig om hur du skapar Microsoft Copilot Studio ämnen som accepterar indatavariabler, se Arbeta med variabler.

Om du har ett Microsoft Copilot Studio ämne som kan få en indatavariabel som listas i ditt färdighetsmanifest dig, kan du skicka en Composer-variabel till den.

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

    Skärmbild på Composer som visar hur du ansluter till en färdighet.

  2. I listan Namn på färdighetsdialog, välj din Microsoft Copilot Studio copilot.

    Skärmbild med information om var du ska välja din Microsoft Copilot Studio copilot.

  3. Leta upp händelseaktivitetens namn för Microsoft Copilot Studio copilot-ämne du vill ringa. Kopiera värdet och klicka på citattecken och spara det så att det används i nästa steg.

  4. 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 en Microsoft Copilot Studio ämne inte har indata innehåller den ingen egenskap värde.

    Skärmbild på ett färdighetsmanifest för egenskapen value.

  5. Leta upp egenskapen definitions och leta upp en kapslad egenskap som $ref värdet du hittade i föregående steg. Notera namnen och typerna av Microsoft Copilot Studio ämnets indata. Du kommer att använda dem i nästa steg.

    Skärmbild på ett färdighetsmanifest för att hitta indatavariabler för ett Microsoft Copilot Studio ämne.

  6. Välj Stäng.

  7. I avsnittet Aktivitet välj Visa kod.

    Skärmbild med information om var du väljer Visa kod.

  8. 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 följande exempel används Composer-variabel dialog.storeLocationanvänds för att ge ett värde till indatavariabeln pva_StoreLocation i Microsoft Copilot Studio copilot ämne dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

    Skärmbild med information om var aktivitetshändelsekoden ska läggas till med Microsoft Copilot Studio indatavärde.

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

Det går att få utdata från ett Microsoft Copilot Studio färdighetsämne i Composer. Du kan lära dig skapa Microsoft Copilot Studio ämnen som returnerar utdata i Arbeta med variabler.

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

    Skärmbild på Composer som visar hur du ansluter till en färdighet.

  2. I listan Namn på färdighetsdialog, välj din Microsoft Copilot Studio copilot.

    Skärmbild med information om var du ska välja din Microsoft Copilot Studio copilot.

  3. Leta upp händelseaktivitetens namn för Microsoft Copilot Studio robotämne du vill ringa. Kopiera värdet och klicka på citattecken och spara det så att det används i nästa steg.

  4. 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 en Microsoft Copilot Studio ämne inte har utdata innehåller den ingen egenskap resultValue.

    Skärmbild på ett färdighetsmanifest för egenskapen resultValue property för ett Microsoft Copilot Studio ämne.

  5. Leta upp egenskapen definitions och leta upp en kapslad egenskap som $ref värdet du hittade i föregående steg. Notera namnen och typerna av Microsoft Copilot Studio ämnets utdatavariabler. Du kommer att använda dem i nästa steg.

    I följande exempel returnerar Microsoft Copilot Studio ämne två utdata av typen Sträng, pva_State och pva_Item.

    Skärmbild på ett färdighetsmanifest för att hitta utdatavariabler för ett Microsoft Copilot Studio ämne.

  6. Välj Stäng.

  7. I avsnittet Aktivitet välj Visa kod.

    Skärmbild med information om var du väljer Visa kod.

  8. 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
]

    Skärmbild med information om var aktivitetshändelsekoden ska läggas till med Microsoft Copilot Studio ämnesnamn.

  9. Under kodområdet anger du Egenskap till en Composer-variabel om du vill ta emot och lagra utdatavärdena från ett Microsoft Copilot Studio färdighetsämne.

    Skärmbild med information om var fältet Egenskap ska anges som dialog.skillResult.

  10. I Composer designyta, välj Lägg till, välj sedan Hantera egenskaper och välj Ange egenskaper.

    Skärmbild med information om var du väljer Ange egenskaper.

  11. 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 följande exempel extraheras dialog.skillResult.pvaState och dialog.skillResult.pvaItem extraheras till nya Composer-variabler dialog.State och dialog.Item.

    Skärmbild som visar utdatavärdena som sparats i dialog.State och dialog.Item i fönstret Composer ange egenskaper.

Testa din Microsoft Copilot Studio copilot som en färdighet med en Bot Framework robot

Använd Bot Framework Emulator för att testa att din Bot Framework robot is anropar Microsoft Copilot Studio copilot som färdighet.

Viktigt

Din Bot Framework robot måste läggas till i Microsoft Copilot Studio copilot lista över tillåtna för att färdighetsanslutningen ska fungera.

Mer information