Översikt över händelseutlösare (förhandsversion)

Du kan konfigurera anpassade agent för att utföra åtgärder eller anropa ämnen som svar på något som händer med hjälp av händelseutlösare. Till skillnad från ämnesutlösare, som kräver indata från en användare, gör händelseutlösare att dina agent kan agera autonomt som svar på den definierade händelsen som inträffar.

Viktigt

Om du aktiverar händelseutlösare kan det påverka hur faktureringen beräknas. Läs mer om fakturering för generativt läge.

Obs

Den här funktionen är endast tillgänglig för agenter med generativ orkestrering aktiverad.

Så här fungerar en händelseutlösare

Händelseutlösare kräver en vald händelse som genererar en utlösarnyttolast och skickar den till agent via en anslutningsapp. Nyttolasten innehåller information om händelsen, inklusive variabler för specifika typer av data. När agenten tar emot nyttolasten, utför den de anvisningar som agentens skapare har angivit i agentens instruktioner samt de instruktioner som skickats via utlösarens nyttolast.

Agenter agerar endast baserat på författarens design och instruktioner. Du kan till exempel lägga till en utlösare för när en ny teammedlem läggs till och ange att svaret ska vara åtgärden skicka ett välkomstmeddelande till den nya medarbetaren med introduktionsresurser.

Händelseutlösare aktiveras baserat på händelser utanför agent. De skiljer sig från ämnesutlösare, som används för att aktivera ämnen eller åtgärder baserat på utlösande fraser som anges av användare.

Den här artikeln beskriver hur händelseutlösare fungerar, deras begränsningar och felsökningsstrategier. Mer information om hur du lägger till en händelseutlösare finns i Lägga till en händelseutlösare.

Andra exempel på händelseutlösare inkluderar:

• När ett objekt skapas i SharePoint
• När en fil skapas i OneDrive
• När en uppgift är klar i Planner
• En viss tid som passerat (en upprepningsutlösare )

Viktigt

Vilka utlösare som är tillgängliga beror på organisationens principer för dataförlustskydd, som konfigurerats av en Power Automate-administratör.

Fakturering och användning för händelseutlösare

Händelseutlösaraktivitet räknas mot förbrukningsenheter för användning och fakturering, inklusive i offentlig förhandsversion. Ett meddelande definieras som en begäran eller ett meddelande som skickas till agenten som utlöser en åtgärd eller ett svar från agenten. Detta inkluderar nyttolaster som skickas till agenter från händelseutlösare. En upprepningsutlösare som är inställd på att aktiveras var 10:e minut skickar till exempel en utlösarnyttolast som ett meddelande till en agent var 10:e minut.

För mer information, gå till Hantera Copilot Studio-meddelanden och kapacitet.

Utlösararbetsflödet

En utlösare är en del av ett arbetsflöde som innehåller flera delar:

1. En händelseutlösare registrerar att en viss händelse har inträffat.
2. Utlösaren skickar en nyttolast som innehåller information om händelsen och instruktioner.
3. Agenten har instruktioner för att välja en eller flera åtgärder eller ämnen baserat på nyttolasten.

Hitta utlösaren som passar din händelse

Copilot Studio har ett bibliotek med utlösare för en rad händelser som kan inträffa i Microsoft och partnertjänster. Utlösarkonfigurationen avgör parametrarna för den händelse som initierar utlösaren. Den bestämmer också innehållet i utlösarnyttolasten.

I de flesta utlösare kan du ange parametrar för händelsen som aktiverar utlösaren. Till exempel, i utlösaren När en rad läggs till, ändras eller tas bort för Dataverse, väljer du vilken tabells ändringar som aktiverar utlösaren.

Definiera utlösarens nyttolast

Utlösarnyttolasten är ett JSON- eller oformaterat textmeddelande som innehåller information om en händelse och skickas till din agent som ett meddelande. När du lägger till en utlösare kan du behålla standardnyttolastinnehållet för utlösaren eller lägga till egna instruktioner. Senare kan du ändra nyttolastens innehåll, inklusive att lägga till variabler och strängoperatorer, i Power Automate.

Till exempel, standardmeddelandet i utlösaren När en rad läggs till, ändras eller tas bort är utlösaren Använd innehåll från Body. När agent tar emot nyttolasten har den innehållet från raden och instruktioner för att använda innehållet.

Du kan lägga till instruktioner som ska skickas till din agent i nyttolasten som styr agent om hur den ska agera när den aktiveras av utlösaren. Om du har flera utlösare kan varje utlösarnyttolast ha specifika och detaljerade instruktioner. Som ett resultat kan du undvika att skriva lång och komplicerad vägledning i agentens allmänna instruktioner eller förvirra agenten om vilka instruktioner som gäller för vilken utlösare.

Till exempel, i utlösarnyttolasten När en rad läggs till, ändras eller tas bort kan du lägga till Skicka en sammanfattning av ändringarna i chatten. När agenten tar emot nyttolasten sammanfattas ändringarna för användaren i agentchatten.

Undvik emellertid att skriva nyttolastinstruktioner som strider mot agentens allmänna instruktioner. Konflikter i instruktioner kan orsaka fel eller oväntade resultat. Se till att testa alla ändringar som rör händelseutlösare.

När du har skapat en utlösare kan du lägga till eller ändra variabler eller strängoperatorer i en utlösarnyttolast och ändra befintliga nyttolastinstruktioner genom att använda Power Automate.

Agentens instruktioner jämfört med nyttolastens instruktioner

Nyttolastinstruktioner är specifika för hur du ska reagera på en händelse. Du kan även använda agentinstruktioner för att styra hur agenten ska hantera information från en utlösare och hur den ska agera när den tar emot en utlösarnyttolast, samt för att fastställa agentens allmänna beteende. Till exempel för en agent som söker efter dubbletter av kontonamn i nya Dataverse-tabellrader, kan instruktionerna vara: När en ny rad läggs till, kontrollera om det är ett dubblettkonto. Om det finns en dubblett skapar du en Att göra-uppgift för att undersöka och inkluderar information om ändringarna och dubbletterna.

Men agentens instruktioner kanske inte fungerar bäst för alla situationer. Om din agent har flera utlösare eller flera komplexa mål bör du använda instruktionerna i utlösarnyttolast i stället.

Om du fortsätter med det sista exemplet kan du lägga till en instruktion i utlösarnyttolast för att leta efter dubbletter av kontonamn i samma Dataverse-tabell. När agent tar emot nyttolasten instrueras den att leta efter dubbletter av kontonamn. Agentens allmänna instruktioner säger sedan Om det finns en dubblett, skapa en att göra-uppgift för att undersöka och inkludera detaljer om ändringarna och dubbletterna.

Det kräver övning att skapa instruktioner för agenter. Gå till skrivvägledning för fler tips och testa alltid alla ändringar du gör i din agent.

Anropa en åtgärd eller ett ämne

När en agent tar emot en utlösarnyttolast avgör de instruktioner du ger den vilken åtgärd eller vilket ämne den anropar som svar, baserat på den information som finns tillgänglig.

Din agent skapar inte en ny åtgärd eller ett nytt ämne på plats. Som författare till agenten måste du definiera de åtgärder eller ämnen som den kan välja mellan. Om du vill veta hur din agent avgör vilken åtgärd eller vilket ämne du ska välja går du till Hur fungerar generativt läge?

Om din agent inte reagerar som förväntat kan du använda aktivitetskarta för att se om den saknar någon viktig indatainformation.

Några förbättringar som du kan göra i instruktionerna är:

• Lägga till mer detaljerade instruktioner i utlösarnyttolasten eller instruktioner för agenten. Din agent kan behöva mer vägledning, till exempel vilken information som ska användas i ett specifikt inmatningsfält för åtgärd.
• Inkludera instruktioner i utlösarnyttolasten.
• Instruera din agent att anropa en specifik åtgärd eller ett specifikt ämne.
• Kontrollera om det finns motstridiga instruktioner mellan utlösarens nyttolast och agentens instruktioner.
• Lägger till i beskrivningarna av åtgärderna, så agenten har mer information för att avgöra när den ska anropas.
• Lägga till beskrivningar i åtgärdens inmatningsfält för att hjälpa din agent att fylla i parametrarna korrekt. Om en åtgärds indata är desamma varje gång kan du ange värdet själv.
• Anropa färre än 15 åtgärder eller ämnen i följd. Komplexa agenter som kör många åtgärder eller ämnen som en enda sekvens kan ha svårt att köra dem på ett tillförlitligt sätt.

Om din agent fortfarande har svårt att anropa den förväntade åtgärden kan du överväga att lägga till ett Power Automate-flöde som uppfyller ditt mål som en åtgärd för din agent.

Publicera agenter med händelseutlösare

Innan du publicerar din agent med en ny händelseutlösare reagerar agenten inte automatiskt på den utlösaren. Se till att du testar agenten noggrant innan du publicerar den, eftersom när du har publicerat en agent med en ny utlösare reagerar din agent automatiskt varje gång dess utlösare aktiveras. Du kan se en steg-för-steg-registrering av agentens utlösare och reaktioner på sidan Aktivitet.

Mer information om hur du aktiverar utlösare under testning finns i Testa en utlösare.

Händelseutlösare kan bara använda agentförfattarens autentiseringsuppgifter för autentisering (det vill säga de autentiseringsuppgifter som du använde för att auktorisera anslutningarna) för utlösaren. Detta kan göra det möjligt för användare av en agent att använda agenten för att komma åt data och system med samma auktorisering. Mer information finns i Felsökning och begränsningar.

Autentisera åtgärder efter publicering

Om din agent saknar autentisering för att utföra en åtgärd eller är konfigurerad för att begära användarautentisering skickar den ett meddelande till användaren som ber om autentiseringsuppgifter. Om en agents flöde avbryts på grund av att den inte kan ta emot information eller om en åtgärd misslyckades kan den inte fortsätta sessionen. Om du vill att din agent ska köras autonomt måste varje åtgärd konfigureras med fungerande autentisering som inte kräver användarindata. Du kan också instruera din agent att inte begära autentiseringsuppgifter från användare.

Agenter kanske inte kan köra alla anslutningsprogram framgångsrikt. Om en agent upprepade gånger misslyckas med att anropa en anslutningsapp bör du överväga att skapa en Power Automate flödesåtgärd som använder den problematiska anslutningsappen för att slutföra åtgärden.

Felsökning och begränsningar

Kvotbegränsningar

Om utlösare aktiveras för ofta kan din agent använda fler resurser än förväntat. Din agent kan sedan överskrida kvotgränserna för tjänstbelastningen och tjänsten kan begränsas.

Administratörer kan övervaka resursanvändningen via Power Platform. De kan också blockera händelseutlösare från att användas i en miljö.

Så här undviker du att överskrida kvotgränserna:

• Var försiktig när du lägger till mycket frekventa utlösare eller utlösare som återkommer på obestämd tid. En upprepningsutlösare aktiveras till exempel när en viss tid passerar. Ju kortare tid mellan aktiveringarna, desto mer resurser använder utlösaren.
• Håll reda på hur många utlösare som är aktiva i en miljö.

Utlösare kan endast använda autentiseringsuppgifter för skapare

För närvarande kan händelseutlösare endast använda agentförfattarens autentiseringsuppgifter för autentisering. Om du publicerar eller delar en agent med autentiserade händelseutlösare kan användarna komma åt information eller uppmana agenten att utföra åtgärder med författarens autentiseringsuppgifter.

För att förhindra användare från att komma åt eller ändra skyddade data eller system bör du överväga om och hur data och system som kräver autentisering används av agenter med händelseutlösare. Författare bör vara medvetna om när de delar eller publicerar agenter som innehåller händelseutlösare.

Administratörer kan också blockera Copilot Studio användare från att använda händelseutlösare med sina agenter. Mer information finns i Blockera händelseutlösare.

Begränsningar vid användning av kunskapskällor med händelseutlösare

Agenter kan inte referera till vissa kunskapskällor som svar på en händelseutlösare. Vissa kunskapskällor kräver en agent för att tillhandahålla autentisering för åtkomst, men agenter kan inte tillhandahålla den autentiseringen autonomt.

Undvik dessa kunskapskällor när de refereras till som svar på en händelseutlösare:

• SharePoint
• Dataverse
• Grafanslutningsprogram
• AI Builder prompter

Referera till dessa kunskapskällor som svar på en händelseutlösare i stället:

• Offentliga webbplatser
• Ladda upp filer
• Företagsdata som använder anslutningsprogram