Utöka Microsoft 365 Copilot eller Copilot-agenter med anslutningsåtgärder (förhandsversion)

Med åtgärder för anslutningsprogram kan du definiera anslutningsprogram som kan anropas från AI-ytor i Power Platform. För åtgärder för anslutningsprogram måste du identifiera de åtgärder som har aktiverats för användning i Copilot. Du kan också samla in den information som krävs av stora språkmodeller för att kunna identifiera och använda plugin-programmet på ett effektivt sätt, till exempel sammanfattnings- och beskrivningsfält.

Förutsättningar

Vissa villkor måste uppfyllas för att utöka Microsoft-märkta copilot-funktioner med åtgärder för anslutningsprogram.

Allmänna krav

För alla Copilot-typer måste du ha autentiseringsuppgifter på skaparnivå, en copilot-licens och en Microsoft Teams-licens.

Obs

Förhandsversionsfunktionerna för att skapa konversationsstartare och adaptiva kort som en del av en åtgärd tas tillfälligt bort den 21 februari 2025. Dessa funktioner kan övervägas för framtida inkludering vid ett senare tillfälle.

Åtgärder kallades tidigare plugin-program. Dessa åtgärder kan användas i agenter. Tidigare skapade plugin-program är nu agenter. Se Microsoft 365 Copilot-bloggen för mer information.

Förutsättningar för Microsoft 365 Copilot säljagent och Microsoft 365 Copilot tjänstagent

För Microsoft 365 Copilot tjänstagent och Microsoft 365 Copilot tjänstagent, måste du vara inloggad i en miljö som innehåller den agent du vill utöka.

Förutsättningar för Microsoft 365 Copilot säljagent

• Salesforce-kunder måste vara inloggade i sin Dataverse-miljö. Den här miljön kallas vanligtvis msdyn_viva.
• Du måste logga in på Microsoft 365 Copilot säljagent via Outlook i den miljö som du vill utöka minst en gång innan du utökar.

Lägg till en anslutningsprogramåtgärd

Det krävs några steg för att lägga till en åtgärd för ett anslutningsprogram i en Microsoft-märkt copilot. I följande avsnitt finns anvisningar för hur du lägger till en åtgärd för anslutningsprogram i Microsoft 365 Copilot, Microsoft 365 Copilot för försäljning och Microsoft 365 Copilot för service.

Välj agenten och välj åtgärd för anslutningsprogram

1. På startsidan, välj Agenter.

   

2. På agentlistan i vänster navigering väljer du den Copilot-agent som du vill utöka.

   

   Översiktssidan för agent visas.

3. Välj fliken Åtgärder. Det visar en lista med åtgärder som redan finns i Copilot.

4. Välj sedan + Lägg till åtgärd.

   Du får en lista över alla åtgärdstyper som stöds för Copilot-agent.

   

5. Välj Anslutningsprogram om du vill utöka med en åtgärd för anslutningsprogram.

   Sidan Välj ditt anslutningsprogram visas. Du får en lista med tillgängliga anslutningsprogramstyper att välja mellan.

   Anslutningsprogram ansluter copilots till olika tjänster. Listan innehåller alla certifierade anslutningsprogram som erbjuds av Microsoft.

   Beroende på Copilot kan listan även komma att innehålla anpassade anslutningsprogram som finns i den aktuella miljön. Det finns ett sökfält för att hitta det anslutningsprogram du vill använda.

   Obs

   För närvarande går det inte att lägga till anpassade anslutningsprogram i Microsoft 365 Copilot tjänstagent.

Välj typ av anslutningsprogram och en lösning

1. Hitta din anslutningsprogramtyp med hjälp av sökfältet och välj den.

   

   Sidan Skapa en anpassad AI-åtgärd med ditt anslutningsprogram visas.

2. Skriv ett namn och en beskrivning för anslutningsprogrammet.

   Anslutningsprogrammets namn måste vara unikt. Som standard används namnet på den valda anslutningsprogramtypen. Du måste lägga till ytterligare definierande information för att se till att det både är ett unikt namn och att det är lätt att säga vad den gör för användare som vill aktivera den senare. Överväg att i beskrivningen inkludera de typer av åtgärder som tillåts, till exempel ”Med e-posttjänsten kan du hämta och skapa meddelanden”.

   

   Beskrivningen kan visas för dig om den finns i det valda anslutningsprogrammet. Beskrivningen används av Copilot-agent för att identifiera när åtgärden kan användas för att få svar tillbaka för användarbegäran. Ange så detaljerade och beskrivande uppgifter som möjligt. Ange specifik information med termer som du förväntar dig att användarna ska använda när de anropar åtgärden. Om du vill fortsätta med exemplet med posttjänst kan du ta med något av följande:

   ”Med e-posttjänsten kan du hämta listor över befintliga meddelanden, hämta mappar där meddelanden lagras, lista titlar på meddelanden och mappar, hämta meddelanden, uppdatera meddelanderubriker och brödtext samt ange prioritet för meddelanden.”

   Beskrivningen låter Copilot-agent veta att åtgärden ska användas utan att explicit behöva tala om det. Denna konversationsbaserade dirigering möjliggör en mer naturlig språkupplevelse.

3. Under Lösning visa en rullgardinsmeny alla tillgängliga lösningar i den aktuella miljön. Välj lösningen som du vill använda. Mer information om vad lösningar är och varför de är till nytta för dig finns i Lösningsbegrepp.

   

   Lösningen väljs automatiskt om du har en föredragen lösning eller om det valda anslutningsprogrammet redan finns i lösningen. Det går antingen att välja en lösning eller lämna den tom. Om du lämnar lösningen tom skapas en lösning åt dig med åtgärdsnamn och standardutgivare. Om du lagrar åtgärden i en lösning blir det enkelt att flytta den mellan olika miljöer.

   Obs

   Standardlösningen eller Common Data Service (CDS) standardlösningen visas inte som ett alternativ i det här fallet eftersom vi rekommenderar att du har en anpassad lösning för enkel hantering. För mer information, se: Standardlösning jämfört med anpassad lösning.

4. Välj en lösning och välj sedan Nästa.

   Sidan Välj och konfigurera plugin-åtgärd visas. Den här sidan visar alla åtgärder tillgängliga för att lägga till i anslutningsprogrammet. Du kan välja och konfigurera de åtgärder du vill att copilot stöder, en åt gången. Ett sökfält ingår för att hjälpa dig hitta den åtgärd du vill välja. Det finns ingen gräns för antalet åtgärder som går att välja för anslutningsprogrammet.

   

Lägg till åtgärder i anslutningsprogrammet

Nu måste du välja bland tillgängliga åtgärder som ska läggas till i anslutningsprogrammet.

Obs

Anslutningsprogram kör endast de åtgärder som du specifikt väljer och konfigurerar här. Om en åtgärd inte finns med på listan är den inte tillgänglig. Det går inte att lägga till eller ta bort åtgärder från ett anslutningsprogram från åtgärdsguiden Copilot Studio.

1. Välj en åtgärd för att fortsätta. Sidan Konfigurera din plugin-åtgärd visas för den valda åtgärden.

   

2. Ange ett namn och beskrivning för din åtgärd. Namnet behöver inte vara unikt i det här fallet. Dessa värden kommer troligen att fyllas i åt dig från anslutningsprogram. Precis som med beskrivningen av anslutningsprogrammet rekommenderar vi att du anger en detaljerad beskrivning så att agenten vet när den måste anropa den specifika åtgärden. Beskrivningen gör det lättare att välja en åtgärd som ska köras på ett mer naturligt språk. Om en åtgärd till exempel är ”Lista meddelandemappar” kan du använda:

   ”Lista meddelandemappar låter dig få en lista över alla meddelandemappar som är tillgängliga från e-posttjänsten. Den här åtgärden hämtar alla mappar och placerar dem i en listvy och returnera dem till dig.

   Åtgärdsbeskrivningen beskriver sammanhanget som ”lista meddelandemappar”, ”skaffa”, ”alla”, ”hämta”, ”lista”, ”posttjänst”, ”retur”, ”mappar” och ”vy”. Din copilot kan använda dessa kontexter för att identifiera när åtgärden är den rätta för en viss användarbegäran.

3. Välj Nästa när du har slutfört sidan. Sidan Granska dina åtgärdsparametrar visas.

4. Välj Nästa för at fortsätta.

   Den här åtgärden tar dig tillbaka till sidan Välj och konfigurera plugin-åtgärd. Du kan visa den nya åtgärden som du valt.

   

5. Välj en annan åtgärd och upprepa föregående åtgärdskonfigurationssteg om du vill.

   Det går även att välja Nästa. Skärmen Granska, testa och publicera åtgärden visas.

   

   Sidan Granska, testa och publicera åtgärden visar information om alla konfigurationssteg fram till den här punkten. Du kan granska dem och sedan testa åtgärden innan du publicerar.

Testa

Nu när ditt anslutningsprogram har konfigurerats kan du testa det.

Obs

För närvarande Microsoft 365 Copilot-tjänstagenten tillåter inte att du testar inifrån guiden för att skapa anslutningsåtgärder. För tillfället måste användarna publicera åtgärden och sedan kan de verifiera att den fungerar i Microsoft 365 Copilot-tjänstagent direkt efter att en administratör har aktiverat den.

1. Välj den befintliga anslutningen i rullgardinsmenyn eller välj + Ny anslutning om du saknar anslutning.

   Om du väljer + Ny anslutning öppnas en guide där det går att lägga till information såsom användarnamn, lösenord för att skapa anslutningen. När du är klar kan du välja den nya anslutningen från rullgardinsmenyn.

2. När du är klar med att välja en anslutning väljer du Testa åtgärd.

3. När du ser ett meddelande om att åtgärden är redo att testas väljer du Öppna för att testa för att öppna copilot-chatten i ett nytt fönster. Öppna den utfällbara menyn för att se åtgärden och slå på den.

   Åtgärden visas med en bägarikon under det valda anslutningsprogrammet med formatet Testa åtgärdsnamn.

4. Du kan nu testa plugin-program genom att prova de prompter som du förväntar dig att en användare ska använda. Du kan också använda kommandot –developer on om du vill ha mer information om promptkörning. När du är nöjd med resultatet återgår du till Copilot Studio-fönstret.

Publicera

1. Välj Publicera när du har testat klart.

   En sida visar att anslutningsprogrammet håller på att publiceras. När det har slutförts visas en sida som anger att anslutningsprogrammet har publicerats.

2. Välj Gå till informationssidan för att visa information om det publicerade anslutningsprogrammet.

   Obs

   Nu när anslutningsappen har publicerats måste en administratör aktivera den innan den kan användas i agenten. Om du inte ser anslutningsappen kontrollerar du att anslutningsappen är aktiverad i agenten via Microsoft administrationscenter eller sidan Copilot Studio-agenter. När anslutningsappen är korrekt aktiverad visas den i den utfällbara menyn. Det här steget kan ha en fördröjning på upp till 24 timmar första gången du utför det.

3. Du kan också enkelt flytta ett anslutningsprogram från en miljö till en annan med hjälp av en lösning. För att göra detta väljer du Exportera lösning på informationssidan. När du exporterar lösningen kan du exportera anslutningsprogrammet.

   

4. Ändra versionsnumret om det behövs och välj om lösningen måste vara hanterad eller ohanterad.

   • Hanterad innebär att du inte förväntar dig att göra ytterligare ändringar i lösningen.
   • Ohanterad innebär att du vill göra ändringar i lösningen i målmiljön.

5. När lösningen har slutförts visas ett grönt meddelande med alternativ för att ladda ned lösningen och spara den som en .zip-fil i systemet.

   Kommentar

   Du måste inte välja publicera i lösningspanelen.

6. Gå tillbaka till agentsidan Åtgärder i Copilot Studio och välj Importera lösning i målmiljön.

   

7. Bläddra och välj .zip-filen för den exporterade lösningen och välj Nästa för att fortsätta. Du kan se anslutningsprogrammet som visas på listan Åtgärder.

Ta bort en åtgärd för ett anslutningsprogram

Om du behöver ta bort en åtgärd för ett anslutningsprogram utför du följande procedur.

Leta upp lösningen som används av åtgärden för anslutningsprogrammet

Proceduren för att ta bort en åtgärd för ett anslutningsprogram utförs i Power Apps Maker portal. Du behöver dock den lösning som används för åtgärden för anslutningsprogrammet i Copilot Studio.

1. Öppna Copilot Studio.

2. Välj den miljö som används för att skapa åtgärden för anslutningsprogrammet.

3. Under Agenter väljer du den agent där åtgärden för anslutningsprogrammet skapades.

4. Välj fliken Åtgärder för att visa listan över åtgärder som är associerade med agenten.

5. Välj den åtgärd du vill ta bort och anteckna namnet på lösningen.

   

Ta bort ett anslutningsprogram i Power Apps Maker Portal

1. Gå till Maker Portal (https://make.powerapps.com) och välj den miljö som du använde i Copilot Studio för att skapa åtgärder.

2. Välj lösningar från det vänstra navigeringsfönstret om du vill visa en lista över lösningar i miljön.

3. Leta reda på den lösning som du använde för att skapa åtgärden och välj den.

   En lista med objekt som är associerade med lösningen visas.

4. Leta reda på den åtgärd för anslutningsprogram som du vill ta bort. Åtgärden är av typen AIPlugin.

   Tips!

   Om du inte ser åtgärden i lösningen flyttar du åtgärden från tillståndet utkast till klar tillstånd genom att publicera den.

5. Innan du tar bort åtgärden måste du ta bort beroendet för den i tabellen AICopilot_AIPlugin. Välj först Avancerat>Visa beroenden.

   

   Beroendena för åtgärden för anslutningsprogrammet visas.

6. För posten AICopilot_AIPlugin i beroendelistan väljer du Ta bort.

   

7. Gå tillbaka till listan över objekt och ta bort åtgärden genom att välja Ta bort>Ta bort från den här miljön.

   

8. Ta bort alla åtgärder av typen AIPluginOperation i tabellen genom att välja Ta bort>Ta bort från den här miljön.

   

9. Gå tillbaka till Copilot Studio för att kontrollera att åtgärden har tagits bort från vyn Åtgärder för Copilot.

Obs

Den här proceduren tar bort åtgärden från listan Åtgärder, men tar inte bort någon anslutning som skapats till datakällan.