Oversigt over hændelsesudløser

Du kan konfigurere brugerdefinerede agenter til at udføre handlinger eller kalde emner som svar på noget, der sker, ved hjælp af hændelsesudløsere. I modsætning til emneudløsere, som kræver input fra en bruger, giver hændelsesudløsere din agent mulighed for at handle autonomt som reaktion på den definerede hændelse, der indtræffer.

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. Du kan finde flere oplysninger om tilføjelse af en hændelsesudløser under Tilføje en hændelsesudlø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

Aktivitet, der udløser hændelser, tæller med i forbrugsenheder til brug og fakturering. En meddelelse defineres som enhver anmodning eller meddelelse, der sendes til agenten, der udløser en handling eller et svar fra agenten. Dette omfatter nyttedata, der sendes til agenter fra hændelsesudløsere. En gentagelsesudløser, der er angivet til at blive aktiveret hvert 10. minut, sender f.eks. en udløsernyttelast som en meddelelse til en agent hvert 10. minut.

Du kan få flere oplysninger ved at gå til Faktureringspriser og administration.

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. Gå til skrivevejledning for flere tip, og test altid alle ændringer, du foretager i din agent.

Kalde en handling eller et emne

Når en agent modtager en udløsernyttelast, bestemmer de instruktioner, du giver den, den handling eller det emne, den kalder 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. Hvis du vil vide, hvordan din agent bestemmer, hvilken handling eller hvilket emne der skal kaldes, skal du gå til Hvordan fungerer generativ orkestrering?

Hvis din agent ikke reagerer som forventet, kan du bruge aktivitetskortet til 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, for når du publicerer en agent med en ny udløser, reagerer din agent automatisk, hver gang udløserne aktiveres. Du kan se en trinvis post over din agents udløsere og reaktioner på siden Aktivitet .

Du kan finde oplysninger om aktivering af udløsere under test ved at gå til Test en udløser.

Hændelsesudløsere kan kun bruge agentudviklerens legitimationsoplysninger til godkendelse (dvs. de legitimationsoplysninger, du brugte til at godkende forbindelserne) for din udløser. Dette kan give brugere af en agent mulighed for at bruge agenten til at få adgang til data og systemer ved hjælp af den samme autorisation. Du kan finde flere oplysninger under Begrænsninger og fejlfinding.

Godkendelse af handlinger efter publicering

Hvis din agent mangler godkendelse til at udføre en handling eller er konfigureret til at anmode om brugergodkendelse, sender den en meddelelse til brugeren, hvor brugeren bliver bedt om legitimationsoplysninger. Hvis et agent-flow afbrydes, fordi det ikke kan modtage oplysninger, eller en handling mislykkedes, kan det ikke fortsætte sessionen. Hvis agenten skal køre autonomt, skal hver handling konfigureres med fungerende oprettergodkendelse, der ikke kræver brugerinput. Du kan også instruere din agent om ikke at anmode om legitimationsoplysninger fra brugere.

Da udløsere bruger udviklergodkendelse, skal du være opmærksom på, hvilke data potentielle brugere kan få adgang til via en publiceret agent, der har udløsere. Du kan finde flere oplysninger under Databeskyttelse med udløsere.

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. Men Activity.Text vil ikke altid have tidligere beskeder. I dette scenarie bør du bruge variablen LastMessage.Text i stedet.

Når en agent kalder en videnskilde på grund af utilstrækkelige kontekstledetråde, efterlades den resulterende Activity.Text variabel for den tur tom. Denne tomme værdi opstår, fordi agenten ikke konstruerer et naturligt sprog-svar, når beslutningen delegeres til videnskilden. Hvis du forventer, at variablen Activity.Text er brugerens tidligere besked, som den typisk er, bør du bruge 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 videnskilde bruges, skrives videnskildens output 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. Som følge heraf:

• 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.

Begrænsninger og fejlfinding

Kvotagrænser

Hvis udløsere aktiveres for ofte, kan din agent ende med at 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 hyppige udløsere eller udløsere, der gentager sig på ubestemt tid. 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. Hvis agenten skal kunne køre autonomt, skal alle udløsere og handlinger, der kræver godkendelse, desuden bruge udviklerens legitimationsoplysninger.

Hvis du publicerer en agent med godkendte hændelsesudløsere, kan brugerne muligvis få adgang til oplysninger eller bede agenten om at udføre handlinger ved hjælp af forfatterens legitimationsoplysninger. Hvis skaberne konfigurerer en agent med en autentificeret begivenhedstrigger, bliver de mindet om denne begrænsning, før de offentliggør 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. For yderligere information, se Konfigurer datapolitikker for agenter.

Bedste praksis for databeskyttelse

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

• Evaluer, om og hvordan data og systemer, der kræver godkendelse, bruges af agenter med hændelsesudløsere.
• Forstå, hvilke informationstriggere der kan inkludere i deres payloads, og hvilke informationshandlinger der produceres ved hjælp af disse payload-input gennem test.
• Begræns omfanget af, hvad der aktiverer en udløser, ved hjælp af udløserparametrene, og giv din agent instruktioner i, hvordan nyttedata skal håndteres.

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

Udviklere kan kun føje hændelsesudløsere til agenter i miljøer, hvor løsningsbaseret deling af cloudflow 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.