Lägga till en händelseutlösare (förhandsversion)

Händelseutlösare gör att din agent kan reagera automatiskt när en händelse inträffar i andra system. Du kan sedan definiera ett specifikt flöde av åtgärder för agenten att vidta som svar, eller ge dina agenter instruktioner för hur de ska bestämma vilka åtgärder som är bäst att vidta.

Viktigt

Om du aktiverar händelseutlösare kan det påverka hur faktureringen beräknas. Läs mer om fakturering för generativt läge.

Detaljerad vägledning om hur händelseutlösare fungerar och relaterar till andra komponenter i en agent finns i Översikt över händelseutlösare.

Obs

Den här funktionen är endast tillgänglig för agenter med generativ orkestrering aktiverad.

Så här lägger du till en händelseutlösare i din agent:

1. På sidan Översikt för din agent går du till avsnittet Utlösare.

2. Välj Lägg till utlösare.

3. Markera önskad utlösare.

4. Ange dina autentiseringsuppgifter om det behövs.

5. Klicka på Nästa.

   Obs

   Du kan bara använda anslutningsprogram för autentisera utlösare med hjälp av agentskaparens konto (agentförfattarens autentisering). Du kan bara ställa in en utlösare för din agent baserat på händelser i system som du har behörighet att komma åt som agentförfattare. Mer information finns i begränsningar för händelseutlösare.

6. Konfigurera utlösaren efter behov och definiera händelseparametrarna som aktiverar utlösaren och utlösarnyttolasten. Utlösare tillhandahåller standardinnehåll för nyttolast, men du kan lägga till eget innehåll och instruktioner. Mer information finns i Definiera utlösarnyttolasten.

För att en agent ska kunna reagera på en händelseutlösare behöver agenten åtgärder eller ämnen att anropa i sitt svar och instruktioner för vilka som ska anropas. Mer information finns i Anropa en åtgärd eller ett ämne.

Testa en utlösare

Testa alltid en utlösare och dess reaktion innan du publicerar. Du kan testa hur din agent reagerar på din definierade utlösare med hjälp av testchatten för agent.

Tills du publicerar din agent med en ny utlösare reagerar inte agenten automatiskt på utlösaren. I stället måste du manuellt aktivera din agent genom att välja en utlösarens nyttolast att skicka till din agent.

1. Kör den utlösande händelsen en gång för att generera en nyttolast. Om du till exempel använder utlösaren Microsoft Planner När en ny uppgift tilldelas mig för Microsoft Planner, tilldela dig själv en testuppgift i Microsoft Planner för att aktivera din utlösare.
2. Välj ikonen Testa utlösare bredvid utlösaren på översiktssidan för agentens sida Översikt. Listan innehåller alla de senaste instanserna av händelsen.
3. Välj den instans du vill testa och välj Starta test.

Du kan använda aktivitetsöversikten för att se hur agenten reagerar på utlösarnyttolast under dina tester. Om du vill öppna aktivitetsöversikten väljer du kartikonen överst i testfönstret.

Ändra en utlösare

När du har skapat en utlösare kan du ändra händelseparametrarna och nyttolasten genom Power Automate. Så här öppnar du utlösaren från Copilot Studio:

1. Leta upp utlösaren på sidan Översikt.
2. Välj ikonen Mer (…), sedan Öppna i Power Automate.
3. Välj utlösaren och gå sedan till flikarna Parametrar och Kod för att göra ändringarna. Information om vilka variabler och strängoperatorer du kan lägga till finns på fliken Om.
4. Gör och spara dina ändringar. Mer information om hur du gör ändringar i Power Automate finns på Komma igång med utlösare i Power Automate.

Publicera en agent med en utlösare

När du har publicerat en agent med händelseutlösare reagerar den automatiskt varje gång agentens utlösare aktiveras. Du kan se en steg-för-steg-registrering av agentens utlösare och reaktioner på sidan Aktivitet.

Händelseutlösare kan bara använda agentförfattarens autentiseringsuppgifter för autentisering (det vill säga de autentiseringsuppgifter som du använde för att auktorisera anslutningarna). Detta kan göra det möjligt för användare av en agent utan egen auktorisering att komma åt data och system som de inte borde. Mer information finns i Felsökning och begränsningar.