Oversigt over begivenhedsudløser

Brug event triggers til at få brugerdefinerede agenter til at udføre handlinger eller kalde emner som reaktion på noget, der sker. I modsætning til topic-triggere, som kræver input fra en bruger, tillader event triggers en agent at handle autonomt som reaktion på den specificerede begivenhed.

Sådan fungerer hændelsesudløsere

Hændelsestriggere kræver en valgt begivenhed, der genererer en trigger-payload og sender den til agenten via en connector. Nyttelasten indeholder oplysninger om hændelsen, herunder variabler for bestemte typer data. Når agenten modtager nyttedataene, udfører den de anvisninger, som agentforfatteren har angivet i agentens instruktioner, samt de instruktioner, der sendes gennem udløserens nyttedata.

Agenter handler kun baseret på deres forfatters design og instruktioner. Du kan f.eks. tilføje en udløser for, hvornår et nyt teammedlem tilføjes, og angiv svaret som handlingen Send den nye medarbejder en velkomstmeddelelse med onboardingressourcer.

Hændelsesudløsere aktiveres baseret på hændelser uden for agenten. De adskiller sig fra emneudløsere, som bruges til at aktivere emner eller handlinger baseret på udløserfraser, der er angivet af brugere.

I denne artikel forklares det, hvordan hændelsesudløsere fungerer, deres begrænsninger og fejlfindingsstrategier. Læs mere under Tilføj en begivenhedsudløser.

Andre eksempler på hændelsesudløsere omfatter:

• Når et element oprettes i SharePoint
• Når en fil oprettes i OneDrive
• Når en opgave er fuldført i Planner
• Der er gået et bestemt tidsrum (en gentagelsesudløser)

Fakturering og forbrug for hændelsesudløsere

Event trigger-aktivitet tæller med i forbruget af Copilot Credit. Hver trigger-payload, som en event trigger sender til en agent, behandles som en besked fra en bruger, og agentens svar faktureres til Copilot Credits-faktureringssatserne. For eksempel sender en recurrence trigger, der aktiveres hvert 10. minut, en trigger-payload til agenten hvert 10. minut.

For brugere med en Microsoft 365 Copilot-licens giver fodnote 1 i tabellen over Copilot Credits-faktureringssatser flere detaljer. Agentflows, som en agent kalder til, mens den reagerer på en trigger-payload, bruger Copilot Credits til standardprisen, selv for brugere i din organisation med en Microsoft 365 Copilot-licens, og de bliver blokeret, når miljøet ikke har Copilot Credits tilgængelige.

Arbejdsprocessen for udløser

En udløser er en del af en arbejdsproces, der indeholder flere dele:

1. En hændelsesudløser registrerer, at en bestemt hændelse fandt sted.
2. Udløseren sender en nyttelast, der indeholder oplysninger om hændelsen og instruktioner.
3. Agenten indeholder instruktioner til at vælge en eller flere handlinger eller emner baseret på nyttedata.

Find den udløser, der passer til din hændelse

Copilot Studio har et bibliotek med udløsere for en række hændelser, der kan forekomme i Microsoft- og partnertjenester. Udløserkonfigurationen bestemmer parametrene for den hændelse, der starter udløseren. Den fastlægger også indholdet af trigger-payloaden.

De fleste udløsere giver dig mulighed for at angive parametre om den hændelse, der aktiverer udløseren. I udløseren Når en række tilføjes, ændres eller slettes for Dataverse kan du f.eks. vælge, hvilken tabels ændringer der aktiverer udløseren.

Definer udløsernyttedata

Udløsernyttelasten er en JSON- eller almindelig tekstmeddelelse, der indeholder oplysninger om en hændelse og sendes til din agent som en meddelelse. Når du tilføjer en udløser, kan du beholde standardindholdet af nyttedata for den pågældende udløser eller tilføje dine egne instruktioner. Senere kan du ændre nyttedataindholdet, herunder tilføje variabler og strengoperatorer, i Power Automate.

Standardmeddelelsen i udløseren Når en række tilføjes, ændres eller slettes er f.eks. Brug indhold fra Body. Når agenten modtager nyttelast, har den indholdet fra rækken og instruktioner til at bruge det indhold.

Du kan tilføje instruktioner, der skal sendes til din agent inde i nyttedata, der fortæller agenten, hvordan den skal handle, når den aktiveres af udløseren. Hvis du har flere udløsere, kan hver udløsernyttelast have specifikke og detaljerede instruktioner. Som følge heraf kan du undgå at skrive lang og kompliceret vejledning i agentens generelle instruktioner eller forvirre agenten om, hvilke instruktioner der gælder for hvilken udløser.

I udløserdataene Når en række tilføjes, ændres eller slettes, kan du f.eks. tilføje Send en oversigt over ændringerne i chatten. Når agenten modtager nyttedata, opsummeres ændringerne for brugeren i agentchatten.

Sørg dog for at undgå at skrive nyttelastinstruktioner, der kommer i konflikt med agentens generelle instruktioner. Konflikter i instruktioner kan forårsage fejl eller uventede resultater. Sørg for at teste alle ændringer, der involverer hændelsesudløsere.

Når du har oprettet en udløser, kan du tilføj eller rediger variabler eller strengoperatorer i en udløsernyttedata og redigere eksisterende nyttedatainstruktioner at bruge Power Automate.

Agentinstruktioner versus nyttedatainstruktioner

Instruktioner i nyttedata er specifikke for, hvordan du skal reagere på en hændelse. Du kan også bruge agentinstruktioner til at vise din agent, hvordan du håndterer oplysninger fra en udløser, og hvordan du handler, når den modtager udløsernyttedata, samt til at bestemme din agents generelle funktionsmåde. Hvis du f.eks. har en agent, der kontrollerer, om der er dublerede kontonavne i nye Dataverse-tabelrækker, kan vejledningen være: Når der tilføjes en ny række, skal du kontrollere, om det er en dubletkonto. Hvis der er en dublet, skal du oprette en opgave, der skal undersøges, og medtage oplysninger om ændringerne og dubletterne.

Agent-instruktioner fungerer dog muligvis ikke bedst i alle situationer. Hvis din agent har flere udløsere eller flere komplekse mål, skal du i stedet bruge instruktionerne i udløserens nyttedata.

Hvis du fortsætter det sidste eksempel, kan du tilføje en instruktion i udløsernyttedata til Søg efter dublerede kontonavne i den samme Dataverse-tabel. Når agenten modtager nyttedata, bliver den bedt om at søge efter dublerede kontonavne. Agentens generelle instruktioner siger derefter, Hvis der er en dublet, skal du oprette en opgave for at undersøge det og inkludere detaljer om ændringer og dubletter.

Oprettelse af instruktioner til agenter kræver øvelse. Gennemgå skrivevejledningen og test altid alle ændringer, du foretager på din agent.

Kalde en handling eller et emne

Når en agent modtager en trigger-payload, bestemmer de instruktioner, du giver, den handling eller det emne, den aktiverer som svar, baseret på de oplysninger, den har til rådighed.

Din agent opretter ikke en ny handling eller et nyt emne på stedet. Som agentforfatter skal du definere de handlinger eller emner, den kan vælge mellem. Få mere at vide i Orchestrate agent adfærd med generativ AI.

Hvis din agent ikke reagerer som forventet, brug aktivitetsoversigten for at se, om der mangler vigtige inputoplysninger.

Nogle forbedringer, du kan foretage i instruktionerne, omfatter:

• Tilføjelse af mere detaljerede instruktioner i udløsernyttedata eller agentinstruktioner. Din agent har muligvis brug for mere vejledning, f.eks. hvilke oplysninger der skal bruges i et bestemt inputfelt til handling.
• Herunder instruktioner i trigger-nyttedata.
• Instruer din agent i at kalde en bestemt handling eller et bestemt emne.
• Kontrol af, om der er modstridende instruktioner mellem udløsernyttedata og agentinstruktioner.
• Tilføjelse i beskrivelserne af handlingerne, så agenten har flere oplysninger til at bestemme, hvornår den skal kaldes.
• Tilføjelse af beskrivelser i handlingsinputfelterne for at hjælpe din agent med at udfylde parametrene korrekt. Hvis inputtene for en handling er de samme hver gang, kan du selv angive værdien.
• Kalder færre end 15 handlinger eller emner fortløbende. Komplekse agenter, der kører mange handlinger eller emner som en enkelt sekvens, kan have svært ved at køre dem pålideligt.

Hvis din agent stadig kæmper for at kalde den forventede handling, kan du overveje at tilføje et Power Automate flow, der opfylder dit mål som en handling for din agent.

Publicering af agenter med hændelsesudløsere

Før du publicerer din agent med en ny hændelsesudløser, reagerer agenten ikke automatisk på udløseren. Sørg for at teste agenten grundigt før udgivelse, for efter du har udgivet en agent med en ny trigger, reagerer din agent automatisk hver gang dens triggere aktiveres. Du kan se en trinvis post over din agents udløsere og reaktioner på siden Aktivitet .

Lær hvordan du aktiverer triggere under test.

Hændelsestriggere kan kun bruge agentproducentens legitimationsoplysninger til autentificering (altså de legitimationsoplysninger, du brugte til at godkende forbindelserne) til en trigger. Disse adgangsoplysninger kan gøre det muligt for brugere af en agent at bruge agenten til at få adgang til data og systemer. Gennemgå databeskyttelsesvejledningen for agenter med triggere.

Godkendelse af handlinger efter publicering

Hvis din agent ikke er autentificeret til at udføre en handling eller er sat op til at anmode om brugergodkendelse, sender den en besked til brugeren med anmodning om legitimationsoplysninger. Hvis en agentflow ikke kan modtage information, eller en handling fejler, kan agenten ikke fortsætte sessionen. Hvis du vil have din agent til at køre autonomt, kan du konfigurere hver handling med maker authentication, der ikke kræver brugerinput. Du kan også instruere din agent i ikke at anmode om legitimationsoplysninger fra brugerne.

Da triggere bruger maker-autentificering, skal du være opmærksom på, hvilke data brugerne kan få adgang til gennem en offentliggjort agent, der har triggers. Gennemgå databeskyttelsesvejledningen for agenter med triggere.

Aktivitet og brug af videnskilder

Agenter, der er indbygget i Copilot Studio, kan oprette forbindelse til Teams via kanaler. Når du bruger denne forbindelse, opstår der nogle tilfælde i Teams, hvor det, afhængigt af triggeren og de værktøjer, agenten bruger, kan forårsage nogle variable , som for eksempel Activity.Text tomme. Denne tomhed opstår, fordi nogle værktøjer er designet til at være aktiviteter. Activity.Text er en variabel, du kan bruge til at logge, hvad din agent laver. Activity.Text Men der er ikke altid tidligere beskeder. I dette scenarie skal du bruge LastMessage.Text-variablen i stedet.

Når en agent kalder en knowledge source på grund af utilstrækkelige kontekstuelle ledetråde, er den resulterende Activity.Text-variabel for den pågældende omgang tom. Denne værdi opstår, fordi agenten ikke konstruerer et naturligt sprog-svar, når beslutningen delegeres til videnskilde. Hvis du forventer, at variablen Activity.Text ikke er brugerens tidligere besked, som den typisk er, så brug variablen LastMessage.Text i stedet. Variablen Activity.Text opfanger enhver aktivitet, der gives til agenten.

Interaktion med udløseren OnPlanComplete

Triggeren OnPlanComplete er designet til kun at blive udført, efter at værktøjet har fuldført sin operation. Når en agent bruger en videnskilde, skrives outputtet fra videnskilden direkte ind i aktiviteten. Fordi variablen Activity.Text oprindeligt var tom, ender aktiviteten med at blive fyldt med værktøjets brugsdetaljer i stedet for en samtalebesked.

Denne adfærd adskiller sig fra scenarier, hvor andre triggere, for eksempel intentionsbaserede eller naturlige sprogtriggere, aktiveres tidligere. I de tilfælde indeholder aktiviteten typisk allerede en konstrueret besked, så værktøjsoutput erstatter eller definerer ikke variablen Activity.Text .

Forskel mellem Teams- og Copilot Studio-funktionsmåde

Teams abstrakte eller normaliserer ikke aktivitetsobjekter på samme måde, som Copilot Studio gør. Derfor gælder følgende:

• I Copilot Studio kan systemaktiviteter blive transformeret eller håndteret på en måde, der skjuler denne underliggende detalje.
• I Teams vises aktivitetsobjekter mere direkte, hvilket gør denne uoverensstemmelse mere synlig.

Denne forskel fører til forskellige observerbare adfærdsmønstre, selv når den underliggende agentlogik er identisk.

Fejlfinding og begrænsninger

Kvotagrænser

Hvis triggere aktiveres for ofte, kan din agent bruge flere ressourcer end forventet. Din agent kan derefter overskride kvotegrænserne for tjenestebelastning, og din tjeneste kan blive begrænset.

Administratorer kan overvåge ressourceforbruget gennem Power Platform. De kan også blokere hændelsesudløsere, så de ikke kan bruges i et miljø.

Sådan undgår du at overskride kvotegrænserne:

• Vær forsigtig, når du tilføjer meget hyppigt forekommende udløsere eller udløsere, der gentages uendeligt. En gentagelsesudløser aktiveres f.eks., når der går et bestemt tidsrum. Jo mindre tid der går mellem aktiveringerne, jo flere ressourcer bruger udløseren.
• Hold styr på, hvor mange udløsere der er aktive i et miljø.

Databeskyttelse for agenter med udløsere

I øjeblikket kan hændelsesudløsere kun bruge agentforfatterens legitimationsoplysninger til godkendelse. For at køre autonomt skal agenten bruge dine legitimationsoplysninger til alle triggere og handlinger, der kræver autentificering.

Hvis du offentliggør en agent med autentificerede hændelsestriggere, kan brugerne få adgang til information eller bede agenten om at udføre handlinger ved at bruge forfatterens legitimationsoplysninger. Hvis du konfigurerer en agent med en autentificeret begivenhedstrigger, minder Copilot Studio dig om denne begrænsning, før du udgiver agenten.

Udløsernyttedata kan muligvis indeholde følsomme oplysninger, som en agent kan sende til andre placeringer via handlinger. Hvis du f.eks. har bygget en agent, der bruger oplysninger fra indgående mails til at udfylde nye rækker i Dataverse-tabeller.

Administratorer kan blokere Copilot Studio-brugere fra at bruge hændelsesudløsere med deres agenter. Få mere at vide under Konfigurer datapolitikker for agenter.

Bedste praksis for databeskyttelse

Sådan forhindrer du brugere i at få adgang til følsomme data:

• Vurder om og hvordan agenter med hændelsestriggere bruger data og systemer, der kræver autentificering.
• Forstå hvilke oplysninger triggere kan indeholde i deres payloads, og hvilke oplysninger handlinger outputter ved at bruge disse payload-input gennem test.
• Indsnævr omfanget af, hvad der aktiverer en trigger ved at bruge triggerparametrene, og giv din agent instruktioner om, hvordan den skal håndtere payload-data.

Løsningsbaseret deling af cloudflow skal være slået til

Du kan kun tilføje hændelsesudløsere til agenter i miljøer, hvor solution-aware cloud flow sharing er slået til.

Hvis du ikke kan tilføje triggere, og din organisations datapolitikker tillader triggere, kan dit miljø have denne mulighed slået fra. Kontakt miljøadministratoren for at slå løsningsbaseret clouddeling til.

Fejlfinding af connectorproblemer

Agenter kan muligvis ikke køre alle connectorer korrekt. Hvis en agent gentagne gange ikke kan kalde en connector, kan du overveje at oprette en Power Automate flowhandling der bruger den problematiske connector til at fuldføre handlingen.