Oversigt over hændelsesudløser (forhåndsversion)

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.

Vigtige oplysninger

Brug af hændelsesudløsere er en offentlig prøveversionsfunktion. Brug af hændelsesudløsere er gratis for forhåndsdeltagere, men kræver meddelelser, der tæller med i dine forbrugskvoter. Forhåndsversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Bemærk

Denne funktion er kun tilgængelig for agenter, hvor generativ orkestrering er aktiveret.

Sådan fungerer hændelsesudløsere

Hændelsesudløsere kræver en valgt hændelse, der genererer udløsernyttedata og sender dem 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, der er angivet af agentforfatteren i agentens instruktioner og 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 angive 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 der oprettes en fil i OneDrive
• Når en opgave er fuldført i Planner
• Der er gået et bestemt tidsrum (en gentagelsesudløser )

Vigtige oplysninger

Hvilke udløsere, der er tilgængelige, afhænger af din organisations politikker til forebyggelse af datatab, der er konfigureret af Power Automate en administrator.

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 bestemmer også indholdet af udløserdataene.

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-meddelelse eller almindelig tekstmeddelelse, der indeholder oplysninger om en hændelse. Nyttedata 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 indholdet af nyttedata, 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 nyttedata, har den indholdet fra rækken og instruktioner til at bruge indholdet.

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, uden at du behøver at skrive lange og komplicerede vejledninger 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.

Undgå dog at skrive instruktioner til nyttedata, der er 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øje eller ændre variabler eller strengoperatorer i udløsernyttedata og ændre eksisterende nyttedatainstruktioner ved hjælp af 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.

Helpdesk-medarbejder 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 udløsernyttedata, bestemmer de instruktioner, du har givet den, den handling eller det emne, den reagerer med. Din vejledning giver din agent mulighed for at vælge en handling eller et emne 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 den skal kalde, skal du gå til Hvordan fungerer generativ tilstand?

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 udløserens 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 håndtere at køre dem pålideligt.

Hvis din agent stadig har svært ved 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 oversigt over agentens 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 agentforfatterens 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 Helpdesk-medarbejder 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 Helpdesk-medarbejder-flow afbrydes, fordi det ikke kan modtage oplysninger, eller en handling mislykkedes, kan det ikke fortsætte sessionen. Hvis Helpdesk-medarbejder skal køre autonomt, skal hver handling konfigureres med fungerende godkendelse, der ikke kræver brugerinput. Du kan også instruere din Helpdesk-medarbejder om ikke at anmode om legitimationsoplysninger fra brugere.

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

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

Udløsere kan kun bruge udviklerens legitimationsoplysninger

I øjeblikket kan hændelsesudløsere kun bruge agentforfatterens legitimationsoplysninger til godkendelse. Hvis du publicerer eller deler 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.

For at forhindre brugere i at få adgang til eller ændre beskyttede data eller systemer skal du nøje overveje, om og hvordan data og systemer, der kræver godkendelse, bruges af agenter med hændelsesudløsere. Forfattere skal være opmærksomme, når de deler eller udgiver agenter, der indeholder hændelsesudløsere.

Administratorer kan også blokere Copilot Studio-brugere fra at bruge hændelsesudløsere sammen med deres agenter. Du kan finde flere oplysninger ved at gå til Blokere hændelsesudløsere.

Begrænsninger ved brug af videnkilder sammen med hændelsesudløsere

Agenter kan ikke referere til visse videnkilder som svar på en hændelsesudløser. Nogle videnkilder kræver, at en agent giver godkendelse for at få adgang, men agenter kan ikke levere denne godkendelse autonomt.

Undgå disse videnkilder, når der henvises til dem som svar på en hændelsesudløser:

• SharePoint
• Dataverse
• Graf-connectorer
• AI Builder-prompter

Henvis i stedet til disse videnkilder som svar på en hændelsesudløser:

• Offentlige websteder
• Uploadede filer
• Virksomhedsdata vha. connectorer