Conectores de módulos de IU y eventos personalizados

Toda la comunicación entre un módulo de la IU de Agent Assist y su conector se realiza a través de eventos personalizados. El conector de módulos de IU facilita los eventos entre el escritorio del agente y los módulos de la IU.

Por ejemplo, cuando se recibe una sugerencia de Agent Assist, un servicio de conector de módulos de IU enviará un evento analyze-content-received a los módulos de IU, y los módulos se suscribirán a esos eventos.

Detalles del evento personalizado

Para obtener la lista completa de los eventos del módulo de IU y sus cargas útiles, consulta la documentación de la API de eventos del módulo de IU.

Para enviar un evento personalizado de forma manual, usa la siguiente sintaxis:

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

En el siguiente ejemplo, se muestra cómo enviar el evento analyze-content-received:

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

Después de enviar un evento personalizado, verás lo siguiente en el servicio de conector del módulo de la IU:

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

Y verás lo siguiente en el módulo:

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

Para suscribirte manualmente a un evento personalizado, usa la siguiente sintaxis:

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

En el siguiente ejemplo, se muestra una suscripción a eventos personalizados:

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

Conectores de módulos de IU personalizados

También puedes usar eventos personalizados para crear tus propios conectores de módulos de IU personalizados, que te permiten integrar los módulos de IU en un escritorio de agente que no es compatible con Agent Assist. Para obtener más información sobre la implementación de módulos y conectores, consulta la documentación de implementación.

Si integras módulos de la IU de Agent Assist en cualquier escritorio de agente sin un conector de módulo de IU precompilado, deberás escribir uno personalizado. Una vez que hayas creado un conector de módulo de IU personalizado, vuelve a la documentación de implementación de módulos de IU para obtener detalles sobre la configuración de los conectores y la implementación de los módulos. Puedes usar un conector de módulo de IU personalizado con un contenedor administrado o con módulos individuales.

Un conector de módulo de IU personalizado debe ser responsable de las siguientes operaciones:

1. Envía un evento para seleccionar la conversación activa. Esto inicializará la conversación junto con sus participantes. Nombre del evento: active-conversation-selected
2. En el caso de las conversaciones de chat, envía un evento cada vez que se registra una nueva oración del agente o del cliente. Nombre del evento: analyze-content-requested
3. Notificar al sistema de módulos cuando se activó el "modo oscuro" en la aplicación principal Nombre del evento: dark-mode-toggled

Además, un conector de módulo de IU personalizado debe suscribirse a los siguientes eventos para actualizar la IU de escritorio del agente cuando corresponda:

1. Para la Respuesta inteligente, actualiza el campo de entrada del agente cada vez que se seleccione un chip de Respuesta inteligente. Nombre del evento: smart-reply-selected.
2. Para Generative Knowledge Assist, actualiza el campo de entrada del agente cada vez que se pega una respuesta de Knowledge Assist en el cuadro de entrada. Nombre del evento: knowledge-assist-v2-answer-pasted.