Przegląd wyzwalaczy zdarzeń (podgląd)

Za pomocą wyzwalaczy zdarzeń można skonfigurować agentów niestandardowych do wykonywania akcji lub wywoływania tematów w odpowiedzi na coś, co się wydarzyło. W przeciwieństwie do wyzwalaczy tematów, które wymagają danych wejściowych od użytkownika, wyzwalacze zdarzeń umożliwiają agentowi autonomiczne działanie w odpowiedzi na wystąpienie zdefiniowanego zdarzenia.

Ważne

Włączenie wyzwalaczy zdarzeń może mieć wpływ na sposób obliczania rozliczeń. Dowiedz się więcej o rozliczeniu dla trybu generatywnego.

Notatka

Ta funkcja jest dostępna tylko dla agentów z włączoną funkcją orkiestracja generatywna.

Jak działają wyzwalacze zdarzeń

Wyzwalacze zdarzeń wymagają wybranego zdarzenia, które generuje ładunek wyzwalający i wysyła go do agenta za pośrednictwem łącznika. Ładunek zawiera informacje o zdarzeniu, w tym zmienne dla określonych rodzajów danych. Gdy agent otrzyma ładunek, wykonuje wskazówki dostarczone przez autora agenta w instrukcjach agenta i instrukcjach wysłanych za pośrednictwem ładunku wyzwalającego.

Agenci działają wyłącznie w oparciu o projekt i instrukcje ich autora. Na przykład można dodać wyzwalacz dla po dodaniu nowego członka zespołu i wyznaczyć reakcję jako akcję wyślij nowemu pracownikowi wiadomość powitalną z zasobami wdrożeniowymi.

Wyzwalacze zdarzeń są aktywowane na podstawie zdarzeń zewnętrznych niezależne od agenta. Różnią się one od wyzwalaczy tematów, które służą do aktywowania tematów lub akcji na podstawie fraz wyzwalających wprowadzanych przez użytkowników.

W tym artykule wyjaśniono, jak działają wyzwalacze zdarzeń, jakie są ich ograniczenia i jakie są strategie rozwiązywania problemów. Aby uzyskać więcej informacji na temat dodawania wyzwalacza zdarzenia, zobacz Dodawanie wyzwalacza zdarzenia.

Inne przykłady wyzwalaczy zdarzeń obejmują:

• Po utworzeniu elementu w SharePoint
• Po utworzeniu pliku w OneDrive
• Gdy zadanie zostanie ukończone w aplikacji Planner
• Minęła określona ilość czasu (wyzwalacz cyklu )

Ważne

To, jakie wyzwalacze są dostępne, zależy od zasad zapobiegania utracie danych organizacji, skonfigurowanych w Power Automate przez administratora.

Rozliczenia i użycie wyzwalaczy zdarzeń

Działanie wyzwalacza zdarzenia jest wliczane do jednostek zużycia na potrzeby użycia i rozliczeń, również w publicznej wersji zapoznawczej. Wiadomość jest definiowana jako dowolne żądanie lub komunikat wysłany do agenta, który wyzwala działanie lub odpowiedź agenta. Obejmuje to ładunki wysyłane do agentów z wyzwalaczy zdarzeń. Na przykład wyzwalacz cyklu ustawiony do aktywowania co 10 minut wysyła ładunek wyzwalacza jako komunikat do agent co 10 minut.

Więcej informacji znajdziesz w Zarządzanie wiadomościami Copilot Studio i pojemnością.

Przepływ pracy wyzwalacza

Wyzwalacz to jedna część przepływu pracy zawierająca wiele części:

1. Wyzwalacz zdarzenia rejestruje, że wystąpiło określone zdarzenie .
2. Wyzwalacz wysyła ładunek zawierający informacje o zdarzeniu i instrukcje.
3. Agent ma instrukcje, aby wybrać jedną lub więcej akcji lub tematów w oparciu o ładunek.

Znajdź wyzwalacz, który pasuje do Twojego zdarzenia

Copilot Studio posiada bibliotekę wyzwalaczy dla szeregu zdarzeń, które mogą wystąpić w usługach Microsoft i partnerów. Konfiguracja wyzwalacza określa parametry zdarzenia, które inicjuje wyzwalacz. Określa również zawartość ładunku wyzwalacza.

Większość wyzwalaczy pozwala na określenie parametrów dotyczących zdarzenia, które aktywuje wyzwalacz. Przykładowo, w trigerze Gdy wiersz jest dodawany, modyfikowany lub usuwany dla Dataverse, użytkownik wybiera, które zmiany w tabeli aktywują triger.

Definiowanie ładunku wyzwalacza

Ładunek wyzwalacza to wiadomość JSON lub zwykły tekst, która zawiera informacje o zdarzeniu i jest wysyłana do agenta jako komunikat. Podczas dodawania wyzwalacza możesz zachować domyślną zawartość ładunku dla tego wyzwalacza lub dodać własne instrukcje. Później możesz zmodyfikować zawartość ładunku, w tym dodać zmienne i operatory ciągów. Power Automate

Na przykład domyślnym komunikatem w wyzwalaczu Po dodaniu, zmodyfikowaniu lub usunięciu wiersza jest Użyj zawartości z Body. Gdy agent odbiera ładunek, ma zawartość z wiersza i instrukcje dotyczące użycia tej zawartości.

Możesz dodać instrukcje, które mają zostać wysłane do agent wewnątrz ładunku, które kierują agent, jak ma działać po aktywacji przez wyzwalacz. Jeśli masz wiele wyzwalaczy, każdy ładunek wyzwalacza może zawierać konkretne i szczegółowe instrukcje. W rezultacie można uniknąć pisania długich i skomplikowanych wskazówek w ogólnych instrukcjach agenta lub dezorientacji agenta co do tego, które instrukcje mają zastosowanie do którego wyzwalacza.

Na przykład w ładunku wyzwalacza Po dodaniu, zmodyfikowaniu lub usunięciu wiersza możesz dodać opcję Wyślij podsumowanie zmian na czacie. Gdy agent otrzyma ładunek, podsumowuje zmiany dla użytkownika na czacie agenta.

Unikaj jednak pisania instrukcji ładunku, które są sprzeczne z ogólnymi instrukcjami agent. Konflikty w instrukcjach mogą spowodować błąd lub nieoczekiwane wyniki. Pamiętaj, aby przetestować wszystkie zmiany związane z wyzwalaczami zdarzeń.

Po utworzeniu wyzwalacza, można dodać lub zmienić zmienne lub operatory łańcuchowe w ładunku wyzwalacza i zmodyfikować istniejące instrukcje ładunku używając Power Automate.

Instrukcje agenta a instrukcje ładunku

Instrukcje dotyczące danych wejściowych są specyficzne dla sposobu reagowania na jedno zdarzenie. Możesz także użyć instrukcji agenta, aby pokierować agentem w zakresie sposobu obsługi informacji z wyzwalacza i sposobu działania po otrzymaniu ładunku wyzwalacza, a także w celu określenia ogólnego zachowania agenta. Na przykład dla agenta, który sprawdza zduplikowane nazwy kont w nowych wierszach tabeli Dataverse, instrukcje mogą wyglądać następująco: Po dodaniu nowego wiersza sprawdź, czy jest to zduplikowane konto. Jeśli istnieje duplikat, utwórz zadanie do wykonania w celu zbadania i dołącz szczegóły dotyczące zmian i duplikatów.

Jednak instrukcje agenta mogą nie działać najlepiej we wszystkich sytuacjach. Jeśli agent ma wiele wyzwalaczy lub wiele złożonych celów, zamiast tego należy użyć instrukcji w ładunku wyzwalacza.

Kontynuując ostatni przykład, możesz dodać instrukcję w ładunku wyzwalacza, aby wyszukać zduplikowane nazwy kont w tej samej Dataverse tabeli. Gdy agent odbiera ładunek, jest instruowany, aby szukać zduplikowanych nazw kont. Ogólne instrukcje agent mówią następnie: Jeśli istnieje duplikat, utwórz zadanie do wykonania do zbadania i dołącz szczegółowe informacje o zmianach i duplikatach.

Tworzenie instrukcji dla agentów wymaga praktyki. Przejdź do wskazówki dotyczące pisania, aby uzyskać więcej wskazówek i zawsze testuj wszystkie zmiany wprowadzone w agencie.

Wywoływanie akcji lub tematu

Gdy agent odbiera ładunek wyzwalacza, podane mu instrukcje określają akcję lub temat, który wywołuje w odpowiedzi, na podstawie dostępnych informacji.

Twój agent nie tworzy od razu nowej akcji ani tematu. Jako autor agent musisz zdefiniować działania lub tematy, z których może wybierać. Aby dowiedzieć się, w jaki sposób agent określa, którą akcję lub temat należy wywołać, przejdź do tematu Jak działa tryb generatywny?

Jeśli agent nie reaguje zgodnie z oczekiwaniami, możesz użyć mapy aktywności, aby sprawdzić, czy brakuje w niej jakichkolwiek kluczowych informacji wejściowych.

Niektóre ulepszenia, które można wprowadzić w instrukcjach, obejmują:

• Dodanie bardziej szczegółowych instrukcji w ładunku wyzwalacza lub instrukcjach agenta. Twój agent może potrzebować więcej wskazówek, na przykład jakich informacji użyć w określonym polu wejściowym do działania.
• Dołączenie instrukcji w ładunku wyzwalacza.
• Poinstruuj swojego programu, aby wywoła określoną akcję lub temat.
• Sprawdzanie, czy nie ma sprzecznych instrukcji między danymi wyzwalacza a instrukcjami dla agenta.
• Dodawanie do opisów akcji, dzięki czemu agent ma więcej informacji, aby określić, kiedy należy go wywołać.
• Dodawanie opisów do pól wejściowych akcji, aby pomóc agent poprawnie wypełnić parametry. Jeśli dane wejściowe akcji są za każdym razem takie same, możesz ustawić wartość samodzielnie.
• Wywoływanie mniej niż 15 działań lub tematów po kolei. Agenci złożeni, którzy uruchamiają wiele akcji lub tematów w ramach jednej sekwencji, mogą mieć trudności z zarządzaniem ich niezawodnym uruchomieniem.

Jeśli agent nadal ma problemy z wywołaniem oczekiwanej akcji, rozważ dodanie przepływu Power Automate jako akcję dla Twojego agenta, który spełnia Twój cel.

Publikacja agentów z wyzwalaczami zdarzeń

Zanim opublikujesz agent z nowym wyzwalaczem zdarzenia, agent nie zareaguje automatycznie na ten wyzwalacz. Upewnij się, że dokładnie przetestowałeś agent przed publikacją, ponieważ po opublikowaniu agent z nowym wyzwalaczem, Twój agent reaguje automatycznie za każdym razem, gdy jego wyzwalacze są aktywowane. Możesz zobaczyć zapis krok po kroku wyzwalaczy i reakcji agenta na stronie Aktywność.

Aby uzyskać informacje na temat aktywowania wyzwalaczy podczas testowania, przejdź do tematu Testowanie wyzwalacza.

Wyzwalacze zdarzeń mogą używać tylko poświadczeń autora agent do uwierzytelniania (czyli poświadczeń użytych do autoryzacji połączeń) dla wyzwalacza. Może to umożliwić użytkownikom agenta korzystanie z agenta w celu uzyskania dostępu do danych i systemów przy użyciu tej samej autoryzacji. Więcej informacji można znaleźć w sekcji Rozwiązywanie problemów i ograniczenia.

Uwierzytelnianie akcji po opublikowaniu

Jeśli agentowi brakuje uwierzytelnienia do wykonania akcji lub jest skonfigurowany do żądania uwierzytelnienia użytkownika, wysyła wiadomość do użytkownika z prośbą o podanie poświadczeń. Jeśli przepływ agent zostanie przerwany, ponieważ nie może odebrać informacji lub akcja nie powiodła się, nie może kontynuować sesji. Jeśli chcesz, aby agent działał autonomicznie, każda akcja musi być skonfigurowana z działającym uwierzytelnianiem, które nie wymaga wprowadzania danych przez użytkownika. Możesz również poinstruować agent, aby nie żądał poświadczeń od użytkowników.

Agenci mogą nie być w stanie pomyślnie uruchomić każdego konektora. Jeśli agentowi wielokrotnie nie udaje się wywołać konektora, należy rozważyć utworzenie akcji przepływu Power Automate, która wykorzystuje problematyczny konektor do wykonania akcji.

Rozwiązywanie problemów i ograniczenia

Ograniczenia kwotowe

Jeśli wyzwalacze są aktywowane zbyt często, agent może zużywać więcej zasobów niż oczekiwano. Twój agent może wtedy przekroczyć limity przydziału obciążeniausługi, a usługa może zostać ograniczona.

Administratorzy mogą monitorować użycie zasobów za pomocą Power Platform. Mogą również blokować możliwość używania wyzwalaczy zdarzeń w środowisku.

Aby uniknąć przekroczenia limitów przydziału:

• Zachowaj ostrożność podczas dodawania bardzo częstych wyzwalaczy lub wyzwalaczy, które powtarzają się w nieskończoność. Na przykład wyzwalacz cykliczny aktywuje się po upływie określonego czasu. Im krótszy czas między aktywacjami, tym więcej zasobów zużywa wyzwalacz.
• Śledź, ile wyzwalaczy jest aktywnych w środowisku.

Wyzwalacze mogą używać tylko poświadczeń dewelopera

Obecnie wyzwalacze zdarzeń mogą używać tylko poświadczeń autora agent do uwierzytelniania. Jeśli opublikujesz lub udostępnisz agent z uwierzytelnionymi wyzwalaczami zdarzeń, użytkownicy mogą mieć dostęp do informacji lub monit agent o wykonanie akcji przy użyciu poświadczeń autora.

Aby uniemożliwić użytkownikom dostęp do chronionych danych lub systemów lub modyfikowanie ich, należy dokładnie rozważyć, czy i w jaki sposób dane i systemy wymagające uwierzytelniania są używane przez agentów z wyzwalaczami zdarzeń. Autorzy powinni mieć świadomość, kiedy udostępniają lub publikują agenty zawierające wyzwalacze zdarzeń.

Administratorzy mogą również blokować Copilot Studio użytkownikom możliwość używania wyzwalaczy zdarzeń ze swoimi agentami. Więcej informacji znajdziesz w artykule Blokowanie wyzwalaczy zdarzeń.

Ograniczenia dotyczące korzystania ze źródeł wiedzy z wyzwalaczami zdarzeń

Agenci nie mogą odwoływać się do niektórych źródeł wiedzy w odpowiedzi na wyzwalacz zdarzenia. Niektóre źródła wiedzy wymagają od agenta zapewnienia uwierzytelnienia w celu uzyskania dostępu, ale agenci nie mogą zapewnić tego uwierzytelnienia autonomicznie.

Unikaj tych źródeł wiedzy, gdy odwołujesz się do nich w odpowiedzi na wyzwalacz zdarzenia:

• SharePoint
• Dataverse
• Łączniki programu Graph
• Prompty AI Builder

Zamiast tego odwołaj się do tych źródeł wiedzy w odpowiedzi na wyzwalacz zdarzenia:

• Publiczne witryny internetowe
• Przesłane pliki
• Dane przedsiębiorstwa przy użyciu łączników