Benutzerdefinierte Ereignisse und benutzerdefinierte UI-Modul-Connectors

Die gesamte Kommunikation zwischen einem Agent Assist-UI-Modul und seinem Connector erfolgt über benutzerdefinierte Ereignisse. Der UI-Modul-Connector ermöglicht die Übertragung von Ereignissen zwischen dem Computer des Kundenservicemitarbeiters und den UI-Modulen.

Wenn beispielsweise ein Vorschlag für Agent Assist empfangen wird, sendet ein UI-Modul-Connector-Dienst ein analyze-content-received-Ereignis an die UI-Module. Die Module abonnieren solche Ereignisse.

Details zum benutzerdefinierten Ereignis

Eine vollständige Liste der UI-Modul-Ereignisse und ihrer Nutzlasten finden Sie in der API-Dokumentation zu UI-Modul-Ereignissen.

Verwenden Sie die folgende Syntax, um ein benutzerdefiniertes Ereignis manuell zu senden:

    dispatchAgentAssistEvent('event_name', {
      detail: event_payload,
    });

Das folgende Beispiel zeigt, wie das analyze-content-received-Ereignis gesendet wird:

if (newMessageFromHumanAgent) {
  dispatchAgentAssistEvent('analyze-content-received', {
    detail: {
      participantRole: 'HUMAN_AGENT',
      request: {
        textInput: {text: newMessageFromHumanAgent},
        messageSendTime: new Date().toISOString()
      }
    }
  });
}

Nachdem Sie ein benutzerdefiniertes Ereignis gesendet haben, sehen Sie im UI-Modul-Connector-Dienst Folgendes:

    this.api.analyzeContent(...).then(function (response) {
      dispatchAgentAssistEvent('analyze-content-response-received', {
       detail: {response: response}});
    });

Im Modul sehen Sie Folgendes:

    addAgentAssistEventListener('analyze-content-response-received', function (event) {
      // Use the AnalyzeContent response to render suggestions in the UI.
    });

Wenn Sie ein benutzerdefiniertes Ereignis manuell abonnieren möchten, verwenden Sie die folgende Syntax:

    addAgentAssistEventListener('event_name', function (event) {
      // `event.detail` contains the event payload.
    });

Das folgende Beispiel zeigt ein benutzerdefiniertes Ereignisabo:

addAgentAssistEventListener('smart-reply-selected', function (event) {
  var chipContent = event.details;
  // Populate the agent chat box with the selected Smart Reply chip.
});

Connectors für benutzerdefinierte UI-Module

Mit benutzerdefinierten Ereignissen können Sie auch eigene benutzerdefinierte UI-Modul-Connectors erstellen, mit denen Sie die UI-Module in einen Kundenservicemitarbeiter-Desktop einbinden können, der von Agent Assist nicht unterstützt wird. Weitere Informationen zur Implementierung von Modulen und Connectoren finden Sie in der Implementierungsdokumentation.

Wenn Sie UI-Module für Agent Assist in einen Kundenservicemitarbeiter-Desktop ohne vorgefertigten UI-Modul-Connector einbinden, müssen Sie einen benutzerdefinierten Connector schreiben. Nachdem Sie einen benutzerdefinierten UI-Modul-Connector erstellt haben, kehren Sie zur Dokumentation zur Implementierung von UI-Modulen zurück. Dort finden Sie weitere Informationen zur Konfiguration Ihrer Connectors und zur Implementierung der Module. Sie können einen benutzerdefinierten UI-Modul-Connector entweder mit einem verwalteten Container oder mit einzelnen Modulen verwenden.

Ein benutzerdefinierter UI-Modul-Connector muss für die folgenden Vorgänge verantwortlich sein:

  1. Es wird ein Ereignis gesendet, um die aktive Unterhaltung auszuwählen. Dadurch wird die Unterhaltung mit den Teilnehmern initialisiert. Ereignisname: active-conversation-selected
  2. Bei Chatunterhaltungen wird ein Ereignis gesendet, wenn vom Kunden oder Kundenservicemitarbeiter eine neue Äußerung erfasst wird. Ereignisname: analyze-content-requested
  3. Das Modulsystem wird benachrichtigt, wenn der „Dunkelmodus“ in der Hauptanwendung aktiviert wurde. Ereignisname: dark-mode-toggled

Außerdem muss ein benutzerdefinierter UI-Modul-Connector die folgenden Ereignisse abonnieren, um die Desktop-Benutzeroberfläche des Kundenservicemitarbeiters gegebenenfalls zu aktualisieren:

  1. Aktualisieren Sie bei der intelligenten Antwort das Eingabefeld des Kundenservicemitarbeiters, wenn ein intelligenter Antwort-Chip ausgewählt ist. Ereignisname: smart-reply-selected.
  2. Aktualisieren Sie bei der generativen Wissensunterstützung das Eingabefeld des Kundenservicemitarbeiters, wenn eine Antwort der Wissensunterstützung in das Eingabefeld eingefügt wird. Ereignisname: knowledge-assist-v2-answer-pasted.