Översikt över händelseutlösare

Använd händelseutlösare för att få anpassade agenter att utföra handlingar eller anropa avsnitt som svar på något som händer. Till skillnad från ämnestriggers, som kräver input från en användare, tillåter händelsetriggers en agent att agera autonomt som svar på den specificerade händelsen.

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

Händelsetriggers kräver en vald händelse som genererar en trigger-payload och skickar den till agenten via en koppling. 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 utvecklare 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. Läs mer i Lägg 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 har passerat (en återkommande utlösare)

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

Händelseutlösande aktivitet räknas mot konsumtionen av Copilot Credit. Varje trigger-payload som en händelsetrigger skickar till en agent behandlas som ett meddelande från en användare, och agentens svar faktureras till Copilot Credits faktureringspriser. Till exempel skickar en återkommande trigger som aktiveras var tionde minut en trigger-payload till agenten var tionde minut.

För användare som har en Microsoft 365 Copilot-licens ger fotnot 1 i tabellen för Copilot Credits faktureringspriser fler detaljer. Agentflöden som en agent anropar medan den svarar på en trigger-payload förbrukar Copilot-krediter i standardtakt, även för användare i din organisation som har en Microsoft 365 Copilot-licens, och de blockeras när miljön inte har några Copilot-krediter tillgängliga.

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 fastställer 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 modifiera nyttolastinnehållet, 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ägg till eller ändra variabler eller strängoperatorer i en utlösarnyttolast och ändra befintliga nyttolastinstruktioner använda Power Automate.

Agentens instruktioner jämfört med nyttolastens instruktioner

Instruktioner för belastning är specifika för hur du ska reagera på ett event. 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å igenom skrivguiden och testa alltid alla ändringar du gör i din agent.

Anropa en åtgärd eller ett ämne

När en agent får en trigger-payload bestämmer instruktionerna du ger vilken åtgärd den utför eller vilket ämne den använder som svar, baserat på den information den har tillgänglig.

Din agent skapar inte en ny åtgärd eller ett nytt ämne direkt. Som författare till agenten måste du definiera de åtgärder eller ämnen som den kan välja mellan. Läs mer om att orkestrera agentbeteende med generativ AI.

Om din agent inte reagerar som förväntat, använd activity map för att se om den saknar någon viktig inmatningsinformation.

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

• Lägga till mer detaljerade instruktioner i triggarens nyttolast eller instruktioner för agenter. 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.
• Genom att lägga till i beskrivningarna av åtgärderna får agenten mer information för att avgöra när den ska aktiveras.
• 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 agenten 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 publicering, eftersom agenten reagerar automatiskt varje gång dess utlösare aktiveras efter att du publicerar en agent med en ny utlösare. På sidan Aktivitet kan du se en steg-för-steg-redogörelse över ditt agentens utlösare och reaktioner.

Lär dig hur du aktiverar utlösare vid testning.

Händelsetriggers kan bara använda agenttillverkarens autentiseringsuppgifter för autentisering (det vill säga de uppgifter du använde för att auktorisera anslutningarna) för en trigger. Dessa inloggningsuppgifter 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. Läs igenom dataskyddsguiden för agenter med triggers.

Autentisera åtgärder efter publicering

Om din agent inte är autentiserad för att utföra en åtgärd eller är inställd på att begära användarautentisering, skickar den ett meddelande till användaren och ber om inloggningsuppgifter. Om ett agentflöde inte kan ta emot information eller en åtgärd misslyckas kan agenten inte fortsätta sessionen. Om du vill att din agent ska fungera självständigt, konfigurera varje åtgärd med maker-autentisering som inte kräver användarinmatning. Du kan också instruera din agent att inte begära inloggningsuppgifter från användare.

Eftersom triggers använder maker-autentisering, var medveten om vilken data användare kan komma åt via en publicerad agent som har triggers. Läs igenom dataskyddsguiden för agenter med triggers.

Användning av aktivitet och kunskapskälla

Agenter som är inbyggda i Copilot Studio kan ansluta till Teams via kanaler. När du använder denna anslutning uppstår vissa fall i Teams där, beroende på vilken trigger som används och vilka verktyg agenten använder, kan det göra att vissa variabler som Activity.Text blir tomma. Denna tomhet uppstår eftersom vissa verktyg är aktiviteter av design. Activity.Text är en variabel som du kan använda för att logga vad din agent gör. Activity.Text har inte alltid tidigare meddelanden. I detta scenario, använd variabeln LastMessage.Text istället.

När en agent anropar en kunskapskälla på grund av otillräckliga kontextledtrådar är den resulterande Activity.Text variabeln för den turen tom. Detta värde uppstår eftersom agenten inte konstruerar ett svar på naturligt språk när beslutet delegeras till kunskapskällan. Om du förväntar dig att variabeln Activity.Text ska vara användarens tidigare meddelande, som den vanligtvis är, använder du variabeln LastMessage.Text i stället. Variabeln Activity.Text plockar upp all aktivitet som ges till agenten.

Interaktion med utlösaren OnPlanComplete

Triggern OnPlanComplete är designad för att endast utföras efter att verktyget har slutfört sin operation. När en agent använder en kunskapskälla skrivs kunskapskällans utdata direkt in i aktiviteten. Eftersom variabeln Activity.Text ursprungligen var tom fylls aktiviteten med verktygsanvändningsdetaljer istället för ett samtalsmeddelande.

Detta beteende skiljer sig från scenarier där andra triggers, till exempel avsiktsbaserade eller naturliga språktriggers, aktiveras tidigare. I dessa fall innehåller aktiviteten vanligtvis redan ett konstruerat meddelande, så verktygsutdata ersätter eller definierar inte variabeln Activity.Text .

Skillnad mellan Teams- och Copilot Studio-beteende

Teams abstraherar eller normaliserar inte aktivitetsobjekt på samma sätt som Copilot Studio gör. Detta innebär följande:

• I Copilot Studio kan systemaktiviteter transformeras eller hanteras på ett sätt som döljer den här underliggande informationen.
• I Teams visas aktivitetsobjekt mer direkt, vilket gör denna skillnad mer synlig.

Denna skillnad leder till olika observerbara beteenden även när den underliggande agentlogiken är identisk.

Felsökning och begränsningar

Kvotbegränsningar

Om triggers aktiveras för ofta kan din agent använda fler resurser än vä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 triggers, eller triggers som återkommer oändligt. 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ö.

Dataskydd för agenter med utlösare

För närvarande kan händelseutlösare endast använda agentförfattarens autentiseringsuppgifter för autentisering. För att köra autonomt måste agenten använda dina inloggningsuppgifter för alla triggers och åtgärder som kräver autentisering.

Om du publicerar en agent med autentiserade händelsetriggers kan användare få tillgång till information eller be agenten utföra åtgärder genom att använda författarens inloggningsuppgifter. Om du konfigurerar en agent med en autentiserad händelseutlösare påminner Copilot Studio dig om denna begränsning innan du publicerar agenten.

Utlösarnyttolaster kan potentiellt innehålla känslig information som en agent kan mata ut på andra platser via åtgärder. Om du till exempel har skapat en agent som använder information från inkommande e-postmeddelanden för att fylla i nya rader i Dataverse-tabeller.

Administratörer kan blockera Copilot Studio-användare från att använda händelseutlösare med sina agenter. Läs mer i Konfigurera dataprinciper för agenter.

Bästa metoder för dataskydd

Så här förhindrar du användare från att komma åt känsliga data:

• Utvärdera om och hur agenter med händelsetriggers använder data och system som kräver autentisering.
• Förstå vilken information utlösare kan inkludera i sina payloads, och vilken information åtgärder ger genom att använda dessa payload-indata genom testning.
• Begränsa omfattningen av vad som aktiverar en trigger genom att använda triggerparametrarna och ge instruktioner till din agent om hur payloaddata ska hanteras.

Lösningsmedveten molnflödesdelning måste aktiveras

Du kan lägga till händelsetriggers till agenter endast i miljöer där solution-aware cloud flow sharing är aktiverat.

Om du inte kan lägga till triggers, och din organisations datapolicys tillåter triggers, kan din miljö ha detta alternativ avstängt. Kontakta administratören för din miljö om du vill aktivera lösningsmedveten molnflödesdelning.

Felsöka problem med anslutning

Agenter kanske inte kan köra alla anslutningar framgångsrikt. Om en agent upprepade gånger misslyckas med att anropa en anslutning bör du överväga att skapa ett Power Automate-flöde som använder den problematiska anslutningen för att slutföra åtgärden.