Oversikt over hendelsesutløser

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.

Slik fungerer hendelsesutløsere

Hendelsestriggere krever en valgt hendelse som genererer en trigger-payload 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)

Fakturering og bruk for hendelsesutløsere

Hendelsesutløseraktivitet teller mot forbruksenheter for bruk og fakturering. 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 faktureringssatser og -administrasjon.

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 forekomme 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 modifisere 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.

Når du har opprettet en utløser, kan du add eller endre variabler eller strengoperatorer i en utløsernyttelast og endre eksisterende nyttelastinstruksjoner bruker 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 som skal kalles opp, kan du gå til Hvordan fungerer generativ iverksetting?

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

Publiseringsagenter 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 oversikt over agentens utløsere og reaksjoner på aktivitetssiden .

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 agentoppretterens legitimasjon for godkjenning (det vil si legitimasjonen du brukte til å godkjenne tilkoblingene) for utløseren. Dette kan tillate brukere av en agent å bruke agenten til å 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 agentens flyt blir avbrutt fordi den ikke kan motta informasjon, eller fordi en handling mislykkes, kan den ikke fortsette økten. Hvis du vil at agenten skal kjøre autonomt, må hver handling konfigureres med fungerende opprettergodkjenning som ikke krever brukerinndata. Du kan også instruere agenten om ikke å be om legitimasjon fra brukere.

Siden utløsere bruker opprettergodkjenning, må du være oppmerksom på hvilke data potensielle brukere kan få tilgang til gjennom en publisert agent som har utløsere. Se delen Databeskyttelse med utløsere hvis du vil ha mer informasjon.

Aktivitet og bruk av kunnskapskilder

Agenter bygget i Copilot Studio kan kobles til Teams via kanaler. Når du bruker denne tilkoblingen, oppstår det noen tilfeller i Teams hvor det, avhengig av triggeren som brukes og verktøyene agenten bruker, kan føre til at noen variabler som Activity.Text blir tomme. Denne tomheten oppstår fordi noen verktøy er aktiviteter etter design. Activity.Text er en variabel du kan bruke for å loggføre hva agenten din gjør. Men Activity.Text vil ikke alltid ha tidligere meldinger. I dette tilfellet bør du bruke variabelen LastMessage.Text i stedet.

Når en agent kaller en kunnskapskilde på grunn av utilstrekkelige kontekstledetråder, blir den resulterende Activity.Text variabelen for den turen stående tom. Denne tomme verdien oppstår fordi agenten ikke konstruerer et naturlig språk-svar når beslutningen delegeres til kunnskapskilden. Hvis du forventer at variabelen Activity.Text skal være brukerens forrige melding slik den vanligvis er, bør du bruke variabelen LastMessage.Text i stedet. Variabelen Activity.Text plukker opp enhver aktivitet som gis til agenten.

Interaksjon med utløseren OnPlanComplete

Triggeren OnPlanComplete er designet for å utføres kun etter at verktøyet har fullført sin operasjon. Når en kunnskapskilde brukes, skrives kunnskapskilden direkte inn i aktiviteten. Fordi variabelen Activity.Text opprinnelig var tom, ender aktiviteten opp med å bli fylt med verktøyets bruksdetaljer i stedet for en samtalemelding.

Denne atferden skiller seg fra situasjoner der andre triggere, for eksempel intensjonsbaserte eller naturlige språktriggere, utløses tidligere. I slike tilfeller inneholder aktiviteten vanligvis allerede en konstruert melding, så verktøyutdata erstatter eller definerer ikke variabelen Activity.Text .

Forskjellen mellom Teams og Copilot Studio-virkemåte

Teams abstraherer eller normaliserer ikke aktivitetsobjekter på samme måte som Copilot Studio gjør. Resultat:

• I Copilot Studio kan systemaktiviteter transformeres eller håndteres på en måte som skjuler denne underliggende detaljen.
• I Teams vises aktivitetsobjekter mer direkte, noe som gjør denne avviket mer synlig.

Denne forskjellen fører til ulike observerbare atferder selv når den underliggende agentlogikken er identisk.

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

Databeskyttelse for agenter med utløsere

For øyeblikket kan hendelsesutløsere bare bruke agentforfatterens legitimasjon for godkjenning. For at agenten skal kunne kjøre autonomt, må alle utløsere og handlinger som krever godkjenning, bruke oppretterens legitimasjon.

Hvis du publiserer en agent med godkjente hendelsesutløsere, kan det hende at brukere får tilgang til informasjon eller ber agenten om å utføre handlinger ved hjelp av forfatterens legitimasjon. Hvis skapere konfigurerer en agent med en autentisert hendelsestrigger, blir de minnet på denne begrensningen før de publiserer agenten.

Utløsernyttelaster kan potensielt inneholde sensitiv informasjon som en agent kan oppgi som utdata andre steder gjennom handlinger. Eksempel: Hvis du har laget en agent som bruker informasjon fra innkommende e-postmeldinger til å fylle ut nye rader i Dataverse-tabeller.

Administratorer kan blokkere Copilot Studio-brukere fra å bruke hendelsesutløsere med agentene sine. For mer informasjon, se Konfigurer datapolicyer for agenter.

Anbefalte fremgangsmåter for personvern

Slik hindrer du brukere i å få tilgang til sensitive data:

• Evaluer om og hvordan data og systemer som krever godkjenning, brukes av agenter med hendelsesutløsere.
• Forstå hvilke informasjonsutløsere kan inkludere i sine payloads, og hvilke informasjonshandlinger som produseres ved å bruke disse payload-inputene gjennom testing.
• Begrens omfanget av hva som aktiverer en utløser, med utløserparametrene, og gi instruksjoner til agenten din for hvordan nyttelastdata skal håndteres.

Løsningsavhengig skyflytdeling må være aktivert

Utviklere kan bare legge til hendelsesutløsere i agenter i miljøer der løsningsavhengig skyflytdeling er aktivert.

Hvis du ikke kan legge til triggere, og organisasjonens datapolicyer tillater triggere, kan miljøet ditt ha dette alternativet slått av. Kontakt administratoren for miljøet for å få løsningsavhengig skyflytdeling aktivert.

Feilsøking av koblingsproblemer

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