Eventos personalizados e conectores de módulo de UI personalizados

Toda a comunicação entre um módulo da interface do Assistente do agente e o conector acontece por eventos personalizados. O conector do módulo da interface facilita os eventos entre o agente de computador e os módulos da UI.

Por exemplo, quando uma sugestão do Assistente do agente é recebida, um serviço de conector de módulo de UI envia um evento analyze-content-received aos módulos de UI, que são inscritos nesses eventos.

Detalhes do evento personalizado

Para conferir a lista completa de eventos do módulo UI e os payloads deles, consulte a documentação da API de eventos do módulo de interface.

Para enviar um evento personalizado manualmente, use esta sintaxe:

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

O exemplo a seguir mostra como enviar o evento analyze-content-received:

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

Depois de enviar um evento personalizado, você vai encontrar o seguinte no serviço de conector do módulo da UI:

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

E você vai encontrar o seguinte no módulo:

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

Para se inscrever manualmente em um evento personalizado, use a seguinte sintaxe:

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

O exemplo a seguir mostra uma assinatura de evento personalizada:

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

Conectores de módulo de interface personalizados

Também é possível usar eventos personalizados para criar seus próprios conectores de módulo UI, que permitem integrar os módulos UI a um computador de agente que não tem suporte ao Assistente. Para mais informações sobre a implementação de módulos e conectores, consulte a documentação de implementação.

Se você estiver integrando os módulos de interface do Agente Assist a qualquer agente de área de trabalho sem um conector de módulo de UI pré-criado, será necessário criar um personalizado. Depois de criar um conector de módulo UI personalizado, volte à documentação da implementação de módulos de interface para conferir detalhes sobre como configurar os conectores e implementar os módulos. É possível usar um conector de módulo UI personalizado com um contêiner gerenciado ou com módulos individuais.

Um conector de módulo UI personalizado precisa ser responsável pelas seguintes operações:

1. Envio de um evento para selecionar a conversa ativa. Isso vai inicializar a conversa com os participantes. Nome do evento: active-conversation-selected
2. Para conversas por chat, envie um evento sempre que uma nova frase for registrada pelo agente ou pelo cliente. Nome do evento: analyze-content-requested
3. Notificar o sistema do módulo quando o "modo escuro" for ativado no aplicativo principal. Nome do evento: dark-mode-toggled

Além disso, um conector de módulo de UI personalizado precisa se inscrever nos seguintes eventos para atualizar a UI do agente para computador, quando aplicável:

1. Para a Resposta inteligente, atualize o campo de entrada do agente sempre que um ícone de Resposta inteligente for selecionado. Nome do evento: smart-reply-selected.
2. Para a assistente de conhecimento generativa, atualize o campo de entrada do agente sempre que uma resposta da assistente for colada na caixa de entrada. Nome do evento: knowledge-assist-v2-answer-pasted.