Oversikt over hendelsesutløser (forhåndsversjon)

Du kan konfigurere egendefinerte agenter slik at de utfører handlinger eller kaller opp emner som svar på noe som skjer, ved hjelp av hendelsesutløsere. I motsetning til emneutløsere, som krever inndata fra en bruker, gjør hendelsesutløsere at agenten din kan handle autonomt som respons på den definerte hendelsen som oppstår.

Viktig!

Aktivering av hendelsesutløsere kan påvirke hvordan fakturering beregnes. Finn ut mer om fakturering for generativ modus.

Notat

Denne funksjonen er bare tilgjengelig for agenter med generativ orkestrering aktivert.

Slik fungerer hendelsesutløsere

Hendelsesutløsere krever en valgt hendelse som genererer en utløsernyttelast og sender den til agenten via en kobling. Nyttelasten inneholder informasjon om hendelsen, inkludert variabler for bestemte typer data. Når agent mottar nyttelasten, kjører den instruksjonene som agentforfatteren har angitt i agentens instruksjoner, og instruksjoner som sendes via utløsernyttelasten.

Agenter handler bare basert på forfatterens utforming og instruksjoner. Du kan for eksempel legge til en utløser for når et nytt teammedlem legges til, og angi at responsen skal være handlingen send den nyansatte en velkomstmelding med innføringsmateriell.

Hendelsesutløsere aktiveres basert på hendelser utenfor agenten. De er forskjellige fra emneutløsere, som brukes til å aktivere emner eller handlinger basert på utløseruttrykk som er angitt av brukere.

Denne artikkelen forklarer hvordan hendelsesutløsere fungerer, begrensningene deres og feilsøkingsstrategier. Hvis du vil ha mer informasjon om hvordan du legger til en hendelsesutløser, kan du se Legge til en hendelsesutløser.

Andre eksempler på hendelsesutløsere omfatter følgende:

• Når et element opprettes i SharePoint
• Når en fil opprettes i OneDrive
• Når en oppgave fullføres i Planner
• En angitt tid gått (en gjentakelsesutløser)

Viktig!

Hvilke utløsere som er tilgjengelige, avhenger av organisasjonens policyer for hindring av datatap, konfigurert i Power Automate av en administrator.

Fakturering og bruk for hendelsesutløsere

Hendelsesutløseraktivitet teller mot forbruksenheter for bruk og fakturering, inkludert i offentlig forhåndsversjon. En melding er definert som enhver forespørsel eller melding sendt til agenten som utløser en handling eller et svar fra agenten. Dette inkluderer nyttelast sendt til agenter fra hendelsesutløsere. En gjentakelsesutløser som er satt til å aktiveres hvert 10. minutt, sender for eksempel en utløsernyttelast som en melding til en agent hvert 10. minutt.

Hvis du vil ha mer informasjon, kan du gå til Administrer Copilot Studio-meldinger og -kapasitet.

Utløserarbeidsflyten

En utløser er én del av en arbeidsflyt som inneholder flere deler:

1. En hendelsesutløser registrerer at en bestemt hendelse har oppstått.
2. Utløseren sender en nyttelast som inneholder informasjon om hendelsen og instruksjoner.
3. Agenten har instruksjoner om å velge en eller flere handlinger eller emner basert på nyttelasten.

Finn utløseren som passer for hendelsen

Copilot Studio har et bibliotek med utløsere for en rekke hendelser som kan oppstå i Microsoft og partnertjenester. Utløserkonfigurasjonen bestemmer parameterne for hendelsen som starter utløseren. Den bestemmer også innholdet i utløsernyttelasten.

De fleste utløsere lar deg angi parametere om hendelsen som aktiverer utløseren. I utløseren Når en rad legges til, endres eller slettes for Dataverse, velger du for eksempel hvilke endringer i tabellen som skal aktivere utløseren.

Definer utløsernyttelasten

Utløsernyttelasten er en JSON- eller ren tekstmelding som inneholder informasjon om en hendelse og sendes til agenten som en melding. Når du legger til en utløser, kan du beholde standard nyttelastinnhold for utløseren, eller legge til dine egne instruksjoner. Senere kan du endre nyttelastinnholdet, inkludert å legge til variabler og strengoperatorer, i Power Automate.

Standardmeldingen i utløseren Når en rad legges til, endres eller slettes er for eksempel Bruk innhold fra Body. Når agenten mottar nyttelasten, har den innholdet fra raden og instruksjoner for å bruke dette innholdet.

Du kan legge til instruksjoner som skal sendes til agenten, i nyttelasten som styrer handlingene til agenten når den aktiveres av utløseren. Hvis du har flere utløsere, kan hver utløsernyttelast ha spesifikke og detaljerte instruksjoner. Som et resultat kan du unngå å skrive lang og komplisert veiledning i agentens generelle instruksjoner eller forvirre agenten om hvilke instruksjoner som gjelder for hvilken utløser.

I en utløsernyttelast av typen Når en rad legges til, endres eller slettes, kan du for eksempel legge til Send et sammendrag av endringene i chatten. Når agenten mottar nyttelasten, oppsummerer den endringene for brukeren i agentchatten.

Unngå imidlertid å skrive nyttelastinstruksjoner som er i konflikt med agentens generelle instruksjoner. Konflikter i instruksjoner kan forårsake feil eller uventede resultater. Sørg for å teste alle endringer som involverer hendelsesutløsere.

Etter at du har opprettet en utløser, kan du legge til eller endre variabler eller strengoperatorer i en utløsernyttelast og endre eksisterende nyttelastinstruksjoner ved hjelp av Power Automate.

Agentinstruksjoner i forhold til nyttelastinstruksjoner

Nyttelastinstruksjoner er spesifikke for hvordan det skal reageres på en hendelse. Du kan også bruke agentinstruksjoner til å styre hvordan agenten skal håndtere informasjon fra en utløser, hva den skal gjøre når den mottar en utløsernyttelast, og til å fastsette den generelle funksjonaliteten til agenten. Når det gjelder en agent som for eksempel ser etter dupliserte kontonavn i nye Dataverse-tabellrader, kan instruksjonene være som følger: Når en ny rad legges til, kontrollerer du om den er en duplisert konto. Hvis det finnes et duplikat, oppretter du et gjøremål for å undersøke og tar med detaljer om endringene og duplikatene.

Det kan imidlertid hende at agentinstruksjoner ikke fungerer best for alle situasjoner. Hvis agenten har flere utløsere eller komplekse mål, bør du bruke instruksjonene i utløsernyttelasten i stedet.

Hvis vi fortsetter det siste eksemplet, kan du legge til en instruksjon i utløsernyttelasten om å Se etter dupliserte kontonavn i samme Dataverse-tabell. Når agent mottar nyttelasten, blir den bedt om å se etter dupliserte kontonavn. Agentens generelle instruksjoner sier da følgende: Hvis det finnes et duplikat, oppretter du et gjøremål for å undersøke og tar med detaljer om endringene og duplikatene.

Skriving av instruksjoner for agenter krever øvelse. Gå til skriveveiledning hvis du vil ha flere tips, og test alltid alle endringer du gjør i agenten.

Kall opp en handling eller et emne

Når en agent mottar en utløsernyttelast, bestemmer instruksjonene du oppgir den, handlingen eller emnet den kaller som svar, basert på informasjonen den har tilgjengelig.

Agenten oppretter ikke en ny handling eller et nytt emne på stedet. Som agentforfatter må du definere handlingene eller emnene den kan velge mellom. Hvis du vil vite hvordan agenten avgjør hvilken handling eller hvilket emne du skal kalle, kan du gå til Hvordan fungerer generativ modus?

Hvis agenten ikke reagerer som forventet, kan du bruke aktivitetskartet for å se om det mangler viktig inndatainformasjon.

Her er noen forbedringer du kan gjøre i instruksjonene:

• Legg til mer detaljerte instruksjoner i utløsernyttelasten eller agentinstruksjonene. Agenten trenger kanskje mer direksjon, for eksempel hvilken informasjon som skal brukes i et bestemt inntastingsfelt for handling.
• Inkludert instruksjoner i utløsernyttelasten.
• Be agenten om å kalle opp en bestemt handling eller et bestemt emne.
• Se etter motstridende instruksjoner mellom utløsernyttelast og agentinstruksjoner.
• Legg til beskrivelsene av handlingene, slik at agenten har mer informasjon for å fastsette når den skal kalles opp.
• Legg til beskrivelser i inndatafeltene for handling for å hjelpe agenten å fylle ut parameterne riktig. Hvis inndataene for en handling er de samme hver gang, kan du angi verdien selv.
• Oppkalling av færre enn 15 handlinger eller emner etter hverandre. Komplekse agenter som kjører mange handlinger eller emner som én enkelt sekvens, kan slite med å kjøre dem på en pålitelig måte.

Hvis agenten fortsatt sliter med å kalle den forventede handlingen, bør du vurdere å legge til en Power Automate-flyt som oppfyller målet ditt, som en handling for agenten.

Publiser agenter med hendelsesutløsere

Før du publiserer agenten med en ny hendelsesutløser, reagerer ikke agenten automatisk på denne utløseren. Pass på at du tester agenten grundig før publisering, for etter at du har publisert en agent med en ny utløser, reagerer agenten automatisk hver gang utløserne aktiveres. Du kan se en trinnvis registrering av agent utløsere og reaksjoner på Aktivitet-siden.

Hvis du vil ha informasjon om hvordan du aktiverer utløsere under testing, kan du gå til Teste en utløser.

Hendelsesutløsere kan bare bruke agentforfatterens legitimasjon for godkjenning (det vil si legitimasjonen du brukte til å godkjenne tilkoblingene) for utløseren. Dette kan tillate brukere av en agent å bruke agenten for å få tilgang til data og systemer som bruker den samme autorisasjonen. Hvis du vil ha mer informasjon, kan du gå til Feilsøking og begrensninger.

Autentisering av handlinger etter publisering

Hvis agenten mangler godkjenning til å utføre en handling eller er konfigurert slik at den ber om brukergodkjenning, sender den en melding til brukeren og ber om legitimasjon. Hvis flyten i agenten blir avbrutt fordi den ikke kan motta informasjon eller en handling mislyktes, kan den ikke fortsette økten. Hvis du vil at agenten skal kjøre autonomt, må hver handling konfigureres med en fungerende godkjenning som ikke krever brukerinndata. Du kan også instruere agenten om ikke å be om legitimasjon fra brukere.

Det kan hende at agenter ikke kan kjøre alle koblinger. Hvis en agent gjentatte ganger ikke kaller en kobling, bør du vurdere å opprette en Power Automate-flythandling som bruker den problematiske koblingen til å fullføre handlingen.

Feilsøking og begrensninger

Kvotebegrensninger

Hvis utløsere aktiveres for ofte, kan agenten bruke flere ressurser enn forventet. Agenten kan da overskride kvotegrensene for tjenesten, og tjenesten kan begrenses.

Administratorer kan overvåke ressursbruken gjennom Power Platform. De kan også blokkere hendelsesutløsere fra å bli brukt i et miljø.

Slik unngår du å overskride kvotegrensene:

• Vær forsiktig når du legger til svært hyppige utløsere, eller utløsere som gjentas på ubestemt tid. En gjentakelsesutløser aktiveres for eksempel når det har gått en angitt tid. Jo mindre tid det går mellom aktiveringer, desto flere ressurser bruker utløseren.
• Hold oversikt over hvor mange utløsere som er aktive i et miljø.

Utløsere kan bare bruke utviklerlegitimasjon

For øyeblikket kan hendelsesutløsere bare bruke agentforfatterens legitimasjon for godkjenning. Hvis du publiserer eller deler en agent med godkjente hendelsesutløsere, kan det hende at brukerne får tilgang til informasjon eller ber agenten om å utføre handlinger ved hjelp av forfatterens legitimasjon.

For å hindre brukere i å få tilgang til eller endre beskyttede data eller systemer, må du vurdere om og hvordan data og systemer som krever godkjenning, brukes av agenter med hendelsesutløsere. Forfattere bør være oppmerksomme når de deler eller publiserer agenter som inneholder hendelsesutløsere.

Administratorer kan også blokkere Copilot Studio-brukere fra å bruke hendelsesutløsere med agentene sine. Hvis du vil ha mer informasjon, kan du gå til Blokkere hendelsesutløsere.

Begrensninger ved bruk av kunnskapskilder med hendelsesutløsere

Agenter kan ikke referere til enkelte kunnskapskilder som svar på en hendelsesutløser. Noen kunnskapskilder krever at en agent gir godkjenning for å få tilgang, men agenter kan ikke gi denne godkjenningen selv.

Unngå disse kunnskapskildene når det refereres til som svar på en hendelsesutløser:

• SharePoint
• Dataverse
• Diagramkoblinger
• AI Builder-spørsmål

Henvis til disse kunnskapskildene som svar på en hendelsesutløser i stedet:

• Offentlige nettsteder
• Opplastede filer
• Bedriftsdata ved hjelp av koblinger