Använda åtgärder med anpassade copilots i Copilot Studio (förhandsversion)

Viktigt

Power Virtual Agents-funktioner ingår nu i Microsoft Copilot Studio efter betydande investeringar i generativ AI och förbättrade integrationer mellan Microsoft Copilot.

Vissa artiklar och skärmbilder kan referera till Power Virtual Agents när vi uppdaterar dokumentation och utbildning.

Du kan utöka funktionerna i din copilot genom att lägga till en eller flera åtgärder. Åtgärderna används av din copilot för att svara användarna automatiskt genom att använda generativa åtgärder eller anropa dem explicit inifrån ett ämne.

[Denna artikel är en förhandsversion av dokumentationen och kan komma att ändras.]

Grundläggande åtgärdstyper

Om du aktiverar generativt läge kan din copilot automatiskt välja den mest lämpliga åtgärden eller ämnet för att svara en användare vid körning.

I klassiskt läge kan en copilot bara använda ämnen för att svara användaren. Men du kan fortfarande utforma din copilot så att den kallar åtgärder explicit inifrån avsnitt.

Åtgärderna baseras på någon av följande huvudåtgärdstyper:

• Inbyggd anslutningsprogramåtgärd
• Anpassad anslutningsprogramåtgärd
• Power Automate molnflöde
• AI Builder prompter
• Bot Framework färdighet

Viktigt

Du kan inte använda konversationsåtgärder som skapats i Copilot Studio som åtgärder med anpassade copilots.

Varje grundläggande åtgärd innehåller ytterligare information som beskriver syftet och som gör att copilot kan använda generativa AI för att generera frågor. Dessa frågor krävs för att fylla de indata som behövs för att utföra åtgärden. Därför behöver du inte manuellt skriva frågenoder för att samla alla indata som behövs, till exempel indata i ett flöde. Indata hanteras åt dig under körning.

Åtgärder kan generera ett sammanhangsberoende svar på en användares fråga med hjälp av resultatet av åtgärden. Du kan också uttryckligen skapa ett svar på åtgärden.

Tips

När du använder genererade frågor från en åtgärd ska du informera dina användare om att en del av konversationen genereras av AI.

Lägg till exempel till ett extra meddelande i Konversationsstartsystemämne. Detta ämne bestämmer vilket meddelande som visas för dina användare när en ny konversation startar.

Lägg till en åtgärd

1. Öppna din anpassade copilot genom att välja Copilots i vänster navigeringsfönster och välja din copilot i listan.

2. Välj Åtgärder om du vill visa åtgärder för copilot.

3. Välj + Lägg till en åtgärd.

4. I guiden Välj en åtgärd (förhandsgranskning) söker du efter en åtgärd som du vill använda och markerar den.

   Standardlistan som visas har Power Automate-flöden och anpassade anslutningsprogram som är tillgängliga i din miljö. Den här listan innehåller vanliga förbyggda anslutningsprogram och Bot Framework färdigheter som är registrerade hos din copilot.

   

   Viktigt

   Vissa åtgärder skapade från AI-plugin-program, till exempel dynamiska prompter och de som baseras på Dataverse API:er kräver autentisering.

   

   Beroende på åtgärden konfigureras anslutningen automatiskt, enligt exemplet i exemplet. Alternativt måste du konfigurera anslutningen om instruktioner ges i guiden. Välj Nästa när anslutningen har konfigurerats.

   

5. Granska och göra ändringar i din konfiguration av plugin-åtgärder. Välj Avsluta för att lägga till åtgärden i din copilot.

   Klicka på Nästa.

Anropa en åtgärd

Om du har aktiverat generativa åtgärder anropas åtgärden automatiskt som svar på en relevant användarfråga.

Du kan också uttryckligen anropa en åtgärd från ett ämne.

Testa din åtgärd

Anropa en åtgärd

Din copilot väljer ut och kör åtgärden baserat på namn och beskrivning. Du kan skapa beskrivningar av hög kvalitet genom att använda det dedikerade spårningsläget för att se vilka åtgärder din copilot valt från generativa åtgärder.

Om du har lagt till en till ett ämne kan du testa den genom att ange ett meddelande som påminner om en av utlösarfraserna för ämne.

Du kan se en åtgärd som testas på den här skärmbilden:

Om du har lagt till en åtgärd i ämne kan du testa genom att utlösa ämne med en lämplig utlösarfras.

Konfigurera indata och utdata för en åtgärd

Ändra konfigurationen av åtgärden

Det finns många sätt att konfigurera din åtgärd. På det sista steget i åtgärdsguiden, anropas Granska och slutför kan du göra ändringar i din åtgärdskonfiguration genom att klicka på Redigera bredvid lämpligt avsnitt.

Åtgärdsinformation

Här kan du konfigurera information om din åtgärd, bland annat Modellens visningsnamn och Modellbeskrivning för åtgärden. Vanligtvis har namn och beskrivning fyllts i förväg efter den åtgärd du har valt.

Egenskaperna Visningsnamn och Beskrivning för varje indata hjälper copilot att förstå syftet med indata, skapa en lämplig fråga för användaren och identifiera rätt värde i en användares svar. Följande är till exempel standardnamnet och beskrivningen av platsinmatningsparametern för MSN Weather-anslutningsprogrammet.

• Namn: Plats
• Beskrivning: Platssökningsfrågan. Giltiga indata är Ort, Region, Delstat, Land, Landmärke, Postnummer, Latitud och Longitud

När du frågar användaren om en plats genererar copilot en fråga som liknar, Vilken plats vill du kontrollera vädret för? Du kan ange en stad, region, delstat, land, landmärke eller postnummer.

Du kan också ändra alternativet Identifiera som till en specifik enhetstyp, beroende på indata som samlas in, vilket kan hjälpa copilot att exakt extrahera ett värde från en användares svar.

Som standard är varje indata inställd på Fyll dynamiskt med det bästa alternativet. Copilot försöker fylla i värdet från tillgängligt sammanhang, som att extrahera ett värde från användarens meddelande. Om inget lämpligt värde hittas genereras en fråga för att be användaren om ett värde. Du kan åsidosätta en indata med ett värde istället för att fråga användaren. För att åsidosätta, ändra listrutan Hur kommer copilot att fylla denna indata? till Ange ett värde och ange sedan ett värde. Detta värde kan vara ett bokstavligt värde, en befintlig variabel eller en Power Fx-formel.

Du kan kontrollera copilot-beteende när du begär ett värde eller verifierar en användares svar genom att konfigurera ytterligare egenskaper för indata.

Utdata

Som standard konfigureras åtgärden så att ett sammanhangsbaserat svar genereras automatiskt för en användare, baserat på frågan och resultatet av åtgärden. Till exempel, om en användare frågar "Vad är den aktuella temperaturen i London?", genereras ett kontextuellt svar med GPT, till exempel "Den nuvarande temperaturen i London är 9 grader Celsius".

Du kan också välja att skapa ett specifikt svar för att åtgärden ska returneras. Som med bekräftelseredigeraren kan du infoga referenser till utdatavariabler från åtgärden med hjälp av variabelväljaren, som som visas i det här exemplet.

Anropa ett flöde inifrån ett ämne

Du kan uttryckligen anropa en åtgärd inifrån ett ämne, ungefär som att anropa andra åtgärdstyper som Power Automate Flows. Beroende på ditt användningsfall kan du använda ditt flöde som en del av ett bredare ämne, som använder fler noder. Eller som i väderexemplet lägga kan allt du behöver vara att lägga till en enda åtgärdsnod till ett ämne.

För att anropa ett flöde inifrån ett ämne:

1. Gå till sidan Ämnen i Copilot Studio för copiloten som du vill redigera.

2. Skapa ett nytt ämne och kalla det Hämta väder.

3. Lägg till följande utlösande fraser:

   • kommer det att regna
   • dagens prognos
   • hämta väder
   • hur är vädret

   

4. Välj Lägg till nod (+) och välj sedan Anropa en åtgärd. Växla till fliken Plugin-åtgärder (förhandsgranskning) och välj den åtgärd du skapat tidigare, Hämta väderprognos.

   

5. Noden Plugin-åtgärden (förhandsgranska) har nu lagts till i ämnet.

   

6. Välj Spara.

Åsidosätta indata när en åtgärd anropas från ett ämne

Som standard, när din åtgärd körs, genererar din copilot frågor för användaren att fylla i de nödvändiga indata. Du kanske vill åsidosätta en eller flera indata och ange ett explicit värde i stället för att be användaren. Du kan åsidosätta i konfigurationen för plugin-åtgärd i avsnittet Indata. Du kan också endast åsidosätta värden när åtgärden används från ett visst ämne:

1. Välj Ange värde på noden och välj den indata du vill åsidosätta.

   

2. Ange värdet för indata genom att skriva ett värde, välja en variabel eller använda en formel.

   

Nu när indata har åsidosatts frågar copilot inte användaren om ett värde.

Aktivera autentisering för AI-åtgärder

Vissa åtgärder, när de skapas baserat på AI-åtgärder, kräver autentisering för att fungera korrekt, till exempel dynamisk prompt eller andra som anropar en Dataverse API.

Åtgärder körs alltid i Microsoft Copilot-körningen i slutanvändarkontexten och kan inte köras om inte autentisering har aktiverats. Två typer av autentiseringsmetoder stöds:

1. Gå till egenskaperna för anslutningsprogramåtgärden.

2. Under Slutanvändarautentisering, välj Copilot autentisering av författarna.

3. Publicera och testa upplevelsen i copilot testfönstret, eller i en önskad kanal.

   

Använda flödesåtgärder med autentiseringsuppgifter för slutanvändare

Flödesåtgärder kan konfigureras till autentiseringsuppgifter för slutanvändare. Om du använder flödet i en kanal som stöds kräver detta ingen speciell konfiguration i din copilot-dialogruta, och slutanvändare kommer att kunna hantera deras sina anslutningar för ett visst flöde i en tillhandahållen erfarenhet.

Autentisering för åtgärder som baseras på plugin-program i biblioteket

När de skapas baserat på AI-plugin-program kräver åtgärder autentisering för att fungera korrekt. Detta ses oftast med åtgärder baserade på prompter eller andra som anropar Dataverse API:er. Åtgärder baserade på plugin-program körs alltid i slutanvändarkontexten och kan inte köras om inte autentisering har aktiverats. Två typer av autentiseringsmetoder stöds:

• Integrerad autentisering (Teams och Power Apps): Du kan använda den här autentiseringsmetoden om du vill publicera din copilot i en Teams-kanal. Den här metoden fungerar även för copilots som är inbäddade i någon Power Platform-app som använder tokens som är byggda med PPAPI-standarden.

• Manuell autentisering (tredjepart copilots): Den här autentiseringsmetoden innebär att en Microsoft Entra ID-anslutning konfigureras.

Så här skapar du en manuell autentiseringsanslutning:

1. Konfigurera Microsoft Entra ID-app.

2. Ställ in manuell autentisering för din Copilot Studio copilot.

3. Tillåt att din app använder delegering till hämta en token för användarens räkning. Var noga med att lägga till eventuella nödvändiga omfattningar.