Senden von Ereignisaktivitäten

  • Artikel

Wichtig

Power Virtual Agents-Fähigkeiten und -Funktionen sind jetzt Teil von Microsoft Copilot Studio nach erheblichen Investitionen in generative KI und verbesserte Integrationen in Microsoft Copilot.

Einige Artikel und Screenshots beziehen sich möglicherweise auf Power Virtual Agents während wir Dokumentation und Schulungsinhalte aktualisieren.

Microsoft Copilot Studio bietet zwei Knoten, die es Ihnen erlauben, Aktivitäten zu senden, die keine Nachrichten sind: Ein Ereignis senden und eine Aktivität senden. Diese werden in den folgenden Abschnitten näher erläutert.

Screenshot des Hinzufügens eines erweiterten Knotens, einschließlich der Optionen „Ereignis senden“ und „Aktivität senden“.

Senden von Ereignissen

Der Knoten „Ereignis senden“ ist speziell für das Senden von Ereignisaktivitäten konzipiert. Ereignisaktivitäten werden vom Bot gesendet und können vom Kanal abgefangen und verwendet werden, der entscheidet, ob und wie die Aktivitäten verwendet werden. Wenn Sie ein Ereignis senden, geben Sie ihm einen Namen und können dann einen Wert für das Ereignis festlegen. Dieser Wert kann ein beliebiges Format haben: einen primitiven Literalwert, eine Variablenreferenz oder eine Power Fx-Formel. Der Wert wird als JSON serialisiert und der ausgehenden Aktivität hinzugefügt.

Screenshot mit dem Einstellungsmenü für einen Ereignisaktivitätsknoten.

Zu den Verwendungsmöglichkeiten dieses Knotens gehören:

  • Sie können ein benutzerdefiniertes Web-Chat-Steuerelement konfigurieren, um vom Bot gesendete Ereignisse zu verarbeiten. Sie könnten beispielsweise nach einem vom Bot zurückkommenden Ereignis suchen und auf der Seite eine Aktion ausführen. Das 04.api/c.incoming-activity-event Beispiel im Microsoft Bot Framework Web-Chat-Beispiel-Repository auf GitHub zeigt, wie dies funktionieren könnte.
  • AudioCodes nutzen Ereignisaktivitäten, um Ihnen die Steuerung des Dienstes zu ermöglichen. Zum Beispiel das Starten oder Stoppen der Anrufaufzeichnung. Weitere Informationen finden Sie unter Aufzeichnen von Anrufen.

Senden anderer Aktivitätstypen

Zusätzlich zu Ereignisaktivitäten können Sie über den Knoten „Aktivität senden“ auch Aktivitäten anderer Art senden. Im Allgemeinen ist die Verwendung dieses Knotens fortgeschritten – daher befindet er sich in der erweiterten Unterkategorie. Die Arten von Aktivitäten, die Sie senden können, sind eine Teilmenge der im Bot Framework Schema – ActivityTypes-Klasse angebotenen Aktivitäten. Wenn Sie diesen Knoten verwenden, wählen Sie den Typ der Aktivität aus und legen dann optional einen Namen oder Wert fest.

Gängige Typen sind:

  • Typing – dadurch wird eine Tippaktivität gesendet, die der Kanal aufgreifen und auf dem Client als Tippindikator anzeigen kann.
  • Delay – dies kann verwendet werden, um eine Verzögerung zwischen Nachrichten bereitzustellen. Beispiel: Senden einer Nachricht, dann Senden einer Verzögerungsaktivität, gefolgt von einer weiteren Nachricht. Der Endbenutzer sieht die erste Nachricht, gefolgt von einer Pause und dann der zweiten Nachricht. In diesem Fall wird „Wert“ auf eine Verzögerung entsprechend der Anzahl der Millisekunden eingestellt. Weitere Informationen finden Sie unter ActivityTypes.Delay-Feld
  • Invoke/Invoke Response – im Allgemeinen werden diese für Microsoft Teams verwendet. Ein Benutzer erstellt ein Thema mit einem Invoke-Tigger, um einen eingehenden Aufruf von Teams abzufangen. Der C1 verwendet dann eine Invoke Response-Aktivität, um eine entsprechende Antwort an Teams zurückzusenden.
  • Handoff – dadurch kann ein Benutzer eine Handoff-Aktivität mit expliziter Kontrolle über den Wert senden. Dies wird für einige externe Kanäle verwendet, z. B. AudioCodes.

Screenshot mit dem Aktivitätsknoten „Invoke“ mit der Dropdownliste „Typ“.