Overzicht van gebeurtenistriggers (preview)

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.

Belangrijk

Het gebruik van gebeurtenistriggers is een openbare previewfunctie. Het gebruik van gebeurtenistriggers is gratis voor deelnemers aan de preview, maar vereist wel berichten die meetellen voor uw gebruiksquota . Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar voorafgaand aan een officiële release, zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

Notitie

Deze functie is alleen beschikbaar voor agenten met generatieve orkestratie ingeschakeld.

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 soorten 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)

Belangrijk

Welke triggers beschikbaar zijn, hangt af van het beleid voor het voorkomen van gegevensverlies van uw organisatie, dat in Power Automate door een beheerder is geconfigureerd.

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.

Vind de trigger die bij uw evenement past

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

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.

Definieer de trigger-payload

De trigger-payload is een JSON-bericht (een bericht in platte tekst) met informatie over een gebeurtenis. De payload wordt naar uw agent verzonden als een bericht. 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 gebruik inhoud van Body. 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, zonder dat u lange en ingewikkelde instructies hoeft te schrijven in de algemene instructies van de agent of 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 agent-chat.

Vermijd echter het schrijven van payload-instructies die conflicteren met de algemene instructies van 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.

Agent instructies versus payload instructies

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 trigger-payload 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 aan om dit te onderzoeken en neem details op over de wijzigingen en duplicaten.

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

Een actie of onderwerp aanroepen

Wanneer een agent een trigger-payload ontvangt, bepalen de instructies die u hebt gegeven welke actie of welk onderwerp als reactie wordt aangeroepen. Met uw instructies kan uw agent een actie of onderwerp selecteren op basis van de beschikbare informatie.

Uw agent maakt niet ter plekke een nieuwe actie of onderwerp aan. Als auteur van agent moet u de acties of onderwerpen definiëren waaruit geselecteerd kan worden. Ga naar Hoe werkt de generatieve modus? 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:

• Meer gedetailleerde instructies toevoegen aan de trigger-payload of agent-instructies. 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 trigger-payload.
• Geef uw agent de opdracht om een specifieke actie of onderwerp op te roepen.
• Controleren op conflicterende instructies tussen triggerpayload en agentinstructies.
• Voeg beschrijvingen toe aan de acties, zodat agent meer informatie heeft om te bepalen wanneer deze moet worden aangeroepen.
• Voeg beschrijvingen toe aan de invoervelden van de actie, zodat agent de parameters correct kan invullen. Als de invoer voor een actie elke keer hetzelfde is, kunt u de waarde zelf instellen.
• Minder dan 15 acties of onderwerpen achter elkaar aanroepen. Complexe agenten die veel acties of onderwerpen in één keer uitvoeren, kunnen lastig zijn om op betrouwbare wijze uit te voeren.

Als uw agent nog steeds moeite heeft met het aanroepen van de verwachte actie, overweeg dan om een Power Automate flow 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 elke keer dat de triggers worden geactiveerd. Een stapsgewijs overzicht van de triggers en reacties van uw agent vindt u op de pagina Activiteiten.

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

Gebeurtenistriggers kunnen alleen de inloggegevens van de agent-auteur 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 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 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 authenticatie waarvoor geen invoer van de gebruiker nodig is. U kunt uw agent ook opdracht geven om geen inloggegevens van gebruikers op te vragen.

Agenten kunnen mogelijk niet elke connector succesvol 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.

Probleemoplossing en beperkingen

Quotumlimieten

Als triggers te vaak worden geactiveerd, kan het zijn dat uw agent meer bronnen 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 verstrijkt. Hoe korter de tijd tussen activeringen, hoe meer bronnen de trigger gebruikt.
• Houd bij hoeveel triggers er in een omgeving actief zijn.

Triggers kunnen alleen maker-referenties gebruiken

Momenteel kunnen gebeurtenistriggers alleen de inloggegevens van de auteur agent gebruiken voor authenticatie. Als u een agent publiceert of deelt met geverifieerde gebeurtenistriggers, kunnen gebruikers mogelijk toegang krijgen tot informatie of de agent ertoe aanzetten acties uit te voeren met behulp van de inloggegevens van de auteur.

Om te voorkomen dat gebruikers toegang krijgen tot beveiligde gegevens of systemen of deze kunnen wijzigen, moet u zorgvuldig overwegen of en hoe gegevens en systemen waarvoor authenticatie vereist is, worden gebruikt door agenten met gebeurtenistriggers. Auteurs moeten hier rekening mee houden bij het delen of publiceren van agenten die gebeurtenistriggers bevatten.

Beheerders kunnen ook gebeurtenistriggers blokkeren voor Copilot Studio-gebruikers met hun agenten. Ga voor meer informatie naar Gebeurtenistriggers blokkeren.

Beperkingen bij het gebruik van kennisbronnen met gebeurtenistriggers

Agenten kunnen niet naar bepaalde kennisbronnen verwijzen als reactie op een gebeurtenistrigger. Voor sommige kennisbronnen is een agent vereist om authenticatie voor toegang te bieden, maar agenten kunnen die authenticatie niet autonoom bieden.

Vermijd deze kennisbronnen wanneer ernaar wordt verwezen als reactie op een gebeurtenistrigger:

• SharePoint
• Dataverse
• Grafiekconnectors
• AI Builder-prompts

Verwijs in plaats daarvan naar deze kennisbronnen als reactie op een gebeurtenistrigger:

• Openbare websites
• Geüploade bestanden
• Ondernemingsgegevens via connectors