Senden von Ereignisaktivitäten

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 Knotentypen werden in den folgenden Abschnitten besprochen.

Senden von Ereignissen

Der Knoten „Ereignis senden“ ist zum Senden von Ereignisaktivitäten vorgesehen. Ereignisaktivitäten werden vom Copiloten 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.

Zu den Verwendungsmöglichkeiten dieses Knotens gehören:

• Sie können ein benutzerdefiniertes Web-Chat-Steuerelement konfigurieren, um vom Copiloten gesendete Ereignisse zu verarbeiten. Sie können beispielsweise nach einem Ereignis suchen, das der Copilot zurückgibt, und auf der Seite eine Aktion ausführen. Das 04.api/c.incoming-activity-event-Beispiel in der Microsoft Bot Framework-Web-Chat-Beispiel-Repository auf GitHub demonstriert, wie die Ereignisbehandlung 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 Anrufe aufzeichnen.

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:

• Eingabe: Sendet eine Eingabeaktivität, die der Kanal nehmen kann, um einen Eingabeindikator auf dem Client auszuwählen und anzuzeigen.
• Verzögerung: Kann verwendet werden, um für eine Verzögerung zwischen Nachrichten zu sorgen. 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 von einer Anzahl an Millisekunden eingestellt. Weitere Informationen finden Sie unter ActivityTypes.Delay-Feld
• Aufrufen/Antwort aufrufen: Wird grundsätzlich für Microsoft Teams verwendet. Benutzende erstellen ein Thema mit einem Aufrufen-Trigger, um einen eingehenden Aufruf von Teams abzufangen, und verwenden eine „Antwort aufrufen“-Aktivität, um eine entsprechende Antwort an Teams zurückzusenden.
• Übergabe: Erlaubt Benutzenden, eine Übergabeaktivität mit expliziter Kontrolle über den Wert zu senden. Für einige externe Kanäle, wie etwa AudioCodes, wird eine Übergabe verwendet.

Zugehöriger Inhalt

• Variablen themenübergreifend wiederverwenden
• Das Copilot-Erscheinungsbild anpassen