Wysyłanie zdarzenia lub działania
Microsoft Copilot Studio dostarcza dwa węzły umożliwiające wysyłanie działań niezwiązanych z wiadomością: Wysyłanie zdarzenia i Wysyłanie działania. W kolejnych sekcjach omówiono te typy węzłów.
Wysyłanie zdarzeń
Węzeł Wyślij zdarzenie jest przeznaczony do wysyłania działań zdarzeń. Działania dotyczące zdarzeń są wysyłane z pomocnika i mogą być przechwytywane i używane przez kanał, co decyduje o tym, czy i jak korzystać z tych działań. Podczas wysyłania zdarzenia należy nadać mu nazwę, a następnie ustawić wartość zdarzenia. Może być w dowolnym formacie: podstawową dosłowną wartością o różnych odwołaniach lub formułą Power Fx. Ta wartość jest serializowana jako JSON i dodana do działania wychodzącego.
Zastosowania tego węzła to:
- Można skonfigurować niestandardową kontrolkę czatu sieci Web w celu obsługi zdarzeń wysyłanych z pomocnika. Na przykład można szukać zdarzenia wracającego z pomocnika i wykonywać akcję na stronie. Przykład
04.api/c.incoming-activity-eventw repozytorium przykładów czatu internetowego Microsoft Bot Framework zademonstruje, jak może działać obsługa zdarzeń. - Kody AudioCodes używają działań zdarzeń, by umożliwić kontrolę usługi. Można na przykład rozpoczynać lub zatrzymać nagranie rozmowy. Dodatkowe informacje można znaleźć w temacie Nagrywanie rozmów.
Wysyłanie innych typów działań
Oprócz działań zdarzeń można wysyłać działania innych typów przy użyciu węzła Wyślij działanie. Generalnie użycie tego węzła jest zaawansowane, co oznacza, że jest to zaawansowana podkategoria. Typy działań, które można wysłać, są podzbiorem działań oferowanych w Schemacie Bot Framework — klasa typów działań. Podczas używania tego węzła należy wybrać typ działania, a następnie opcjonalnie ustawić nazwę lub wartość.
Typowe są następujące typy:
- Wpisanie — wysyła działanie wpisywania, które kanał może odebrać i wyświetlić wskaźniki wpisywania na kliencie.
- Opóźnienie — może służyć do zapewnienia opóźnienie między wiadomościami. Na przykład: wysłanie wiadomości, wysłanie działania opóźnieniem, a po niej inna wiadomość. Dla użytkownika końcowego jest wyświetlany pierwszy komunikat, po nim przerwa, a następnie drugi komunikat. W tym przypadku „Wartość” jest ustawiana na liczbę z opóźnieniem w milisekundach. Aby uzyskać szczegółowe informacje, zobacz Pole ActivityTypes.Delay.
- Wywoływanie/wywoływanie odpowiedzi — zwykle używane w Microsoft Teams. Użytkownik tworzy temat z wyzwalaczem wywoływania, który przerywa przychodzące wywoływanie z Teams, i używa działania Wywoływanie odpowiedzi w celu wysłania odpowiedniej odpowiedzi z powrotem do Teams.
- Przekazanie — umożliwia użytkownikowi wysłanie działania ręcznego z jawną kontrolą nad wartością. Przekazanie jest używane w przypadku niektórych kanałów zewnętrznych, takich jak AudioCodes.
