Overzicht van gebeurtenistriggers

Met behulp van Gebeurtenistriggers kunt u aangepaste agenten configureren om acties uit te voeren of onderwerpen aan te roepen als reactie op iets dat gebeurt. In tegenstelling tot onderwerptriggers, die invoer van een gebruiker vereisen, zorgen gebeurtenistriggers ervoor dat uw agent autonoom kan reageren op de gedefinieerde gebeurtenis die plaatsvindt.

Hoe gebeurtenistriggers werken

Gebeurtenistriggers vereisen een gekozen gebeurtenis die een triggerpayload genereert en deze via een connector naar agenten stuurt. De payload bevat informatie over de gebeurtenis, inclusief variabelen voor specifieke typen gegevens. Wanneer de agent de payload ontvangt, voert deze de door de agentauteur gegeven instructies en de instructies die via de triggerpayload zijn verzonden uit.

Agenten handelen uitsluitend op basis van het ontwerp en de instructies van hun auteur. U kunt bijvoorbeeld een trigger toevoegen voor wanneer een nieuw teamlid wordt toegevoegd en de reactie aanwijzen als de actie de nieuwe werknemer een welkomstbericht sturen met onboardingbronnen.

Gebeurtenistriggers worden geactiveerd op basis van externe gebeurtenissen voor de agent. Ze verschillen van onderwerptriggers, die worden gebruikt om onderwerpen of acties te activeren op basis van triggerzinnen die door gebruikers worden ingevoerd.

In dit artikel wordt uitgelegd hoe gebeurtenistriggers werken, wat hun beperkingen zijn en welke strategieën voor probleemoplossing er zijn. Zie Een gebeurtenistrigger toevoegen voor meer informatie over het toevoegen van een gebeurtenistrigger.

Andere voorbeelden van gebeurtenistriggers zijn:

• Wanneer een item is gemaakt in SharePoint
• Wanneer een bestand wordt gemaakt in OneDrive
• Wanneer een taak wordt voltooid in Planner
• Een bepaalde hoeveelheid tijd verstreken (een herhalingstrigger)

Facturering en gebruik voor gebeurtenistriggers

De activiteit van gebeurtenistriggers telt mee voor de verbruikseenheden voor gebruik en facturering. Een bericht wordt gedefinieerd als een aanvraag of bericht die/dat naar de agent wordt verzonden en een actie of een respons van de agent activeert. Dit omvat payloads die door gebeurtenistriggers naar agenten worden verzonden. Een terugkerende trigger die bijvoorbeeld is ingesteld op activering om de 10 minuten, stuurt elke 10 minuten een triggerpayload als bericht naar een agent.

Ga naar Factureringstarieven en -beheer voor meer informatie.

De triggerworkflow

Een trigger is een onderdeel van een workflow die uit meerdere onderdelen bestaat:

1. Een gebeurtenistrigger registreert dat een specifieke gebeurtenis heeft plaatsgevonden.
2. De trigger verzendt een payload met informatie over de gebeurtenis en instructies.
3. De agent heeft instructies om een of meer acties of onderwerpen te kiezen op basis van de payload.

De trigger zoeken die bij uw gebeurtenis past

Copilot Studio heeft een bibliotheek met triggers voor een reeks gebeurtenissen die kunnen optreden in services van Microsoft en partners. De triggerconfiguratie bepaalt de parameters van de gebeurtenis die de trigger activeert. Het bepaalt ook de inhoud van de triggerpayload.

Bij de meeste triggers kunt u parameters opgeven over de gebeurtenis die de trigger activeert. U selecteert bijvoorbeeld in de trigger Wanneer een rij wordt toegevoegd, gewijzigd of verwijderd voor Dataverse welke wijzigingen in de tabel de trigger activeren.

De triggerpayload definiëren

De triggerpayload is een JSON-bericht of een bericht in platte tekst dat informatie over een gebeurtenis bevat en als een bericht naar uw agent wordt verzonden. Wanneer u een trigger toevoegt, kunt u de standaardinhoud van de payload voor die trigger behouden of uw eigen instructies toevoegen. Later kunt u de inhoud van de payload aanpassen, met inbegrip van het toevoegen van variabelen en tekenreeksoperatoren, in Power Automate.

Het standaardbericht in de trigger Wanneer een rij wordt toegevoegd, gewijzigd of verwijderd is bijvoorbeeld Inhoud van Body gebruiken. Wanneer agent de payload ontvangt, bevat deze de inhoud van de rij en instructies om die inhoud te gebruiken.

U kunt instructies toevoegen die u naar uw agent kunt sturen in de payload. Deze instructies vertellen de agent wat hij moet doen als hij door de trigger wordt geactiveerd. Als u meerdere triggers hebt, kan elke triggerpayload specifieke en gedetailleerde instructies bevatten. Hierdoor kunt u voorkomen dat u lange en ingewikkelde instructies schrijft in de algemene instructies van de agent en dat u de agent in de war brengt over welke instructies op welke trigger van toepassing zijn.

Bijvoorbeeld, in een triggerpayload Wanneer een rij wordt toegevoegd, gewijzigd of verwijderd, kunt u Een samenvatting van de wijzigingen in de chat verzamelen toevoegen. Wanneer agent de payload ontvangt, worden de wijzigingen voor de gebruiker samengevat in de agentchat.

Vermijd echter het schrijven van payloadinstructies die conflicteren met de algemene instructies van de agent. Conflicten in instructies kunnen fouten of onverwachte resultaten veroorzaken. Zorg ervoor dat u alle wijzigingen test die betrekking hebben op gebeurtenistriggers.

Nadat u een trigger hebt gemaakt, kunt u variabelen of tekenreeksoperatoren toevoegen of wijzigen in een triggerpayload en bestaande payloadinstructies wijzigen met behulp van Power Automate.

Agentinstructies versus payloadinstructies

Payload-instructies zijn specifiek gericht op hoe er op één gebeurtenis moet worden gereageerd. U kunt de instructies van agent ook gebruiken om uw agent te laten weten hoe deze moet omgaan met informatie van een trigger en hoe deze moet handelen bij het ontvangen van een payload. Ook kunt u hiermee het algemene gedrag van uw agent bepalen. Bijvoorbeeld, voor een agent die controleert op dubbele accountnamen in nieuwe Dataverse-tabelrijen, kunnen de instructies zijn: Wanneer een nieuwe rij wordt toegevoegd, controleer dan of het een dubbel account is. Als er een duplicaat is, maak dan een To Do-taak om dit te onderzoeken en neem details op over de wijzigingen en duplicaten.

De agentinstructies werken echter mogelijk niet in alle situaties. Als uw agent meerdere triggers of meerdere complexe doelen heeft, moet u in plaats daarvan instructies in de triggerpayload gebruiken.

Als we het laatste voorbeeld voortzetten, kunt u een instructie toevoegen aan de triggerpayload om te zoeken naar dubbele accountnamen in dezelfde Dataverse-tabel. Wanneer de agent de payload ontvangt, krijgt deze de opdracht om te zoeken naar dubbele accountnamen. De algemene instructies van agent luiden dan: Als er een duplicaat is, maak dan een taak om dit te onderzoeken en neem details op over de wijzigingen en duplicaten.

Het opstellen van instructies voor agenten vergt oefening. Ga naar schrijftips voor meer tips en test altijd alle wijzigingen die u aanbrengt in uw agent.

Een actie of onderwerp aanroepen

Wanneer een agent een triggerpayload ontvangt, bepalen de instructies die u doorgeeft welke actie of welk onderwerp de payload als reactie hierop aanroept, op basis van de beschikbare informatie.

Uw agent maakt niet ter plekke een nieuwe actie of onderwerp aan. Als de agentontwerper moet u de acties of onderwerpen definiëren waaruit kan worden geselecteerd. Ga naar Hoe werkt generatieve indeling? om te leren hoe uw agent bepaalt welke actie of welk onderwerp moet worden aangeroepen.

Als uw agent niet reageert zoals verwacht, kunt u de activiteitenkaart gebruiken om te zien of er belangrijke invoerinformatie ontbreekt.

Enkele verbeteringen die u in de instructies kunt aanbrengen, zijn:

• Het toevoegen van meer gedetailleerde instructies aan de triggerpayload of agentinstructies. Mogelijk heeft uw agent meer instructies nodig, bijvoorbeeld welke informatie de agent in een specifiek invoerveld moet gebruiken voor een actie.
• Inclusief instructies in de triggerpayload.
• Geef uw agent de opdracht om een specifieke actie of onderwerp op te roepen.
• Controleren op conflicterende instructies tussen triggerpayload en agentinstructies.
• Het toevoegen van beschrijvingen aan de acties, zodat de agent meer informatie heeft om te bepalen wanneer deze moet worden aangeroepen.
• Het toevoegen van beschrijvingen aan de invoervelden van de actie, zodat de agent de parameters correct kan invullen. Als de invoer voor een actie telkens hetzelfde is, kunt u de waarde zelf instellen.
• Het aanroepen van minder dan 15 acties of onderwerpen na elkaar. Complexe agenten die veel acties of onderwerpen in één keer uitvoeren, kunnen problemen hebben met een betrouwbare uitvoering.

Als uw agent nog steeds moeite heeft met het aanroepen van de verwachte actie, overweeg dan om een Power Automate-stroom toe te voegen die uw doel vervult als een actie voor uw agent.

Publicatieagenten met gebeurtenistriggers

Voordat u uw agent publiceert met een nieuwe gebeurtenistrigger, reageert de agent niet automatisch op die trigger. Zorg ervoor dat u de agent grondig test voordat u deze publiceert, want nadat u een agent hebt gepubliceerd met een nieuwe trigger, reageert uw agent automatisch telkens wanneer de triggers worden geactiveerd. U ziet een stapsgewijze record van de triggers en reacties van uw agent op de pagina Activiteit .

Ga naar Een trigger testen voor informatie over het activeren van triggers tijdens het testen.

Gebeurtenistriggers kunnen alleen de inloggegevens van de agentmaker gebruiken voor verificatie (dat wil zeggen, de inloggegevens die u hebt gebruikt om de verbindingen te autoriseren) voor uw trigger. Hierdoor kunnen gebruikers van een agent de agent mogelijk gebruiken om toegang te krijgen tot gegevens en systemen met dezelfde autorisatie. Ga naar Probleemoplossing en beperkingen voor meer informatie.

Acties verifiëren na publicatie

Als uw agent geen verificatie heeft om een actie uit te voeren of is geconfigureerd om gebruikersverificatie te vragen, wordt er een bericht naar de gebruiker gestuurd waarin om inloggegevens wordt gevraagd. Als de stroom van een agent wordt onderbroken omdat er geen informatie kan worden ontvangen of omdat een actie is mislukt, kan de sessie niet worden voortgezet. Als u wilt dat uw agent autonoom wordt uitgevoerd, moet elke actie worden geconfigureerd met werkende maker-authenticatie waarvoor geen gebruikersinvoer nodig is. U kunt uw agent ook opdracht geven om geen inloggegevens van gebruikers op te vragen.

Omdat triggers gebruikmaken van makerauthenticatie, moet u weten welke gegevens potentiële gebruikers kunnen raadplegen via een gepubliceerde agent met triggers. Voor meer informatie gaat u naar de sectie Gegevensbescherming met triggers.

Probleemoplossing en beperkingen

Quotumlimieten

Als triggers te vaak worden geactiveerd, kan het zijn dat uw agent meer resources gebruikt dan verwacht. Uw agent kan dan de quotumlimieten voor de servicebelasting overschrijden en uw service wordt mogelijk beperkt.

Beheerders kunnen het resourcegebruik monitoren via Power Platform. Ze kunnen ook voorkomen dat Gebeurtenistriggers blokkeren wordt gebruikt in een bepaalde omgeving.

Om te voorkomen dat de quotumlimieten worden overschreden:

• Wees voorzichtig wanneer u triggers toevoegt die zeer frequent voorkomen, of die oneindig vaak voorkomen. Een herhalingstrigger wordt bijvoorbeeld geactiveerd wanneer een bepaalde tijd is verstreken. Hoe korter de tijd tussen activeringen, hoe meer resources de trigger gebruikt.
• Houd bij hoeveel triggers er in een omgeving actief zijn.

Gegevensbescherming voor agenten met triggers

Momenteel kunnen gebeurtenistriggers alleen de referenties van de auteuragent gebruiken voor verificatie. Om de agent autonoom te laten werken, moeten alle triggers en acties waarvoor authenticatie vereist is, gebruikmaken van de inloggegevens van de maker.

Als u een agent publiceert met geverifieerde gebeurtenistriggers, kunnen gebruikers mogelijk toegang krijgen tot informatie of de agent ertoe aanzetten acties uit te voeren met behulp van de referenties van de auteur. Als makers een agent configureren met een geverifieerde gebeurtenistrigger, worden ze aan deze beperking herinnerd voordat ze de agent publiceren.

Trigger-payloads kunnen mogelijk gevoelige informatie bevatten die een agent kan uitvoeren in andere locaties via acties. Stel dat u bijvoorbeeld een agent hebt gebouwd die informatie uit binnenkomende e-mails gebruikt om nieuwe rijen in Dataverse-tabellen in te vullen.

Beheerders kunnen Copilot Studio-gebruikers voorkomen dat gebeurtenistriggers gebruiken met hun agenten. Voor meer informatie, zie Configuratie van gegevensbeleid voor agenten.

Best practices voor bescherming van persoonsgegevens

Om te voorkomen dat gebruikers toegang krijgen tot gevoelige gegevens:

• Evalueer of en hoe gegevens en systemen waarvoor authenticatie vereist is, worden gebruikt door agents met gebeurtenistriggers.
• Zorg dat u weet welke informatie triggers in hun payloads kunnen opnemen en welke informatieacties uitvoeren via die payload-invoer door middel van testen.
• Beperk de omvang van wat een trigger activeert met behulp van de triggerparameters en geef uw agent instructies over hoe deze payload-gegevens moet verwerken.

Oplossingsbewust delen van cloudstromen moet worden ingeschakeld

Makers kunnen alleen gebeurtenistriggers toevoegen aan agenten in omgevingen waar delen van oplossingsbewuste cloudstromen is ingeschakeld.

Als je geen triggers kunt toevoegen en de databeleid van je organisatie triggers toestaat, kan deze optie in je omgeving uitgeschakeld zijn. Neem contact op met de beheerder van uw omgeving om oplossingsgericht delen van cloudstromen in te schakelen.

Problemen met connectoren oplossen

Agenten kunnen mogelijk niet elke connector met succes uitvoeren. Als een agent herhaaldelijk een connector niet kan aanroepen, overweeg dan om een Power Automate-stroomactie te maken die de actie voltooit met de problematische connector.