Voeg triggers toe aan een agent (GitHub Copilot) (preview)

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Gebruik triggers om autonome agenten te creëren die worden aangestuurd door de GitHub Copilot harness. Autonome agenten draaien wanneer een gebeurtenis plaatsvindt in een verbonden dienst. Een agent kan bijvoorbeeld reageren wanneer een item in SharePoint wordt aangemaakt, een e-mail binnenkomt of een gepland tijdstip aanbreekt.

De trigger stuurt gebeurtenisdetails naar de agent. De instructies en tools van je agent bepalen wat de agent met die gegevens doet.

Notitie

Het framework dat wordt gebruikt om deze agent te bouwen, gebruikt gebruiksgebaseerde facturering. Het gebruiken, bouwen, testen en evalueren van agenten kan Copilot Credits kosten. Lees meer in Overzicht van gebruiksgebaseerde facturering.

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Voordat je een trigger toevoegt

Voordat je een trigger toevoegt:

Voeg een trigger toe en configureer deze

  1. Open de agent in Copilot Studio.

  2. Selecteer Triggers.

    Screenshot van het configuratiepaneel van de agent in Copilot Studio met het gedeelte Triggers gemarkeerd, waarop triggers zoals Chatten met de agent en Nieuwe e-mail te zien zijn.

  3. Selecteer de trigger.

  4. Configureer de trigger:

    1. Configureer de verbinding die voor de trigger wordt gebruikt. Als je een groen vinkje ziet, werkt je verbinding. Als je geen groen vinkje ziet, selecteer dan het account en kies dan een ander account of maak een nieuwe verbinding aan.

      Screenshot van het triggerpaneel Nieuwe e-mail met de Office 365 Outlook verbinding gemarkeerd, met een waarschuwingsicoon in plaats van een groen vinkje.

      Notitie

      Sommige triggers, zoals Recurrence, Copilot en Teams triggers, vereisen geen verbindingsverificatie.

    2. Voeg optioneel extra instructies toe die je naar je agent wilt sturen voor deze trigger. Deze stap is vooral belangrijk wanneer je meerdere triggers in je agent hebt en elke trigger de uitvoering van de agent anders aanstuurt.

    3. Configureer de trigger-opties die bepalen wanneer de agent moet worden aangeroepen wanneer het trigger-event wordt opgepikt.

    4. Als je deze agent deelt met anderen om te gebruiken, kies dan welke opties gebruikers zichzelf wel of niet kunnen configureren door voor elke optie Editable by user aan of uit te zetten.

      Screenshot van nieuwe e-mailtriggeropties met de velden Map, Aan, CC en Aan of CC, waarbij de schakelaars 'Bewerkbaar door gebruiker' zijn ingeschakeld en gemarkeerd.

    5. Vouw geavanceerde parameters uit om alle geavanceerde parameters te configureren die je nodig hebt.

  5. Selecteer Trigger toevoegen.

Test en publiceer de agent

Test elke trigger voordat je de agent publiceert.

  1. Test een trigger door de knop testkolf ( ) te selecteren. Om bij de knop te komen, doe een van de volgende dingen:

    • Selecteer de trigger op het tabblad Build.
    • Open het tabblad Voorbeeld.
  2. Ga op een van de volgende manieren te werk:

    • Selecteer Begin met luisteren voor de eerste test. Genereer een event dat overeenkomt met de triggerconfiguratie, zoals het versturen van een e-mail of het aanmaken van een SharePoint-item. Je agent wacht tot de triggergebeurtenis plaatsvindt en reageert ter test. Op basis van de resultaten pas de instructies, tools, trigger-aanpassing of het bericht van uw agent aan om aan uw behoeften te voldoen.
    • Kies een eerdere triggergebeurtenis (laatste e-mail, bestand, enzovoort) uit de lijst Test met eerdere triggergebeurtenissen . Deze actie roept de agent met dat trigger-event op.

Publiceer en activeer een autonome agent

De agent draait pas autonoom als je hem publiceert. Publiceer de agent opnieuw nadat je een trigger, de instructies of de tools hebt veranderd. Het bijwerken van een agent vraagt gebruikers om de nieuwe wijzigingen te accepteren.

  1. Selecteer Publiceren om de nieuwste versie van de agent met de trigger bij te werken.

  2. Gebruik na publicatie het succesdialoog om te kiezen wie je als agent wilt gebruiken:

    • Activeren voor mezelf: Alleen jij, de maker, kunt de agent gebruiken met je eigen maker-inloggegevens.
    • Delen met anderen: Laat andere gebruikers de agent gebruiken, met hun eigen inloggegevens. Je moet de agent ook met die gebruikers delen.

    Screenshot van het dialoogvenster 'Uw agent is gepubliceerd' met de opties 'Activeer deze agent voor mij' en 'Deel met anderen'.

Activeer voor mij

Notitie

Het gebruik van autonome agenten wordt gefactureerd volgens de factureringstarieven van Copilot Studio.

Activate for me brengt je naar Agent Management, waar je de agent inschakelt. Nadat je de agent hebt ingeschakeld, begint je agent namens jou te werken.

Je kunt ook toegang krijgen tot Agent Management en je autonome agent activeren via de link onder de agentnaam.

Deel met anderen

Om mensen een autonome agent met hun eigen inloggegevens te laten gebruiken, moet u de triggers en tools voor gebruikersauthenticatie configureren en vervolgens de gepubliceerde agent delen. Ontvangers voltooien alle benodigde verbindingen en kunnen alleen de trigger-opties bewerken die jij toestaat.

Notitie

Het autonome agentgebruik van elke eindgebruiker wordt opgeteld en gefactureerd via de onderliggende omgeving waar de agent wordt gehost. Lees meer in Overzicht van facturering voor agenten die worden aangedreven door het GitHub Copilot-harnas

Lees meer in Een autonome agent delen. Voor instructies voor eindgebruikers die een gedeelde autonome agent opzetten, ga naar Een gedeelde autonome agent opzetten.