Tutte le comunicazioni tra un modulo dell'interfaccia utente di Agent Assist e il relativo connettore avvengono tramite eventi personalizzati. Il connettore del modulo UI facilita gli eventi tra il desktop dell'agente e i moduli UI.
Ad esempio, quando viene ricevuto un suggerimento di Agent Assist, un servizio di connettore del modulo UI invia un evento analyze-content-received ai moduli UI, che sono iscritti a questi eventi.
Dettagli sugli eventi personalizzati
Per l'elenco completo degli eventi del modulo UI e dei relativi payload, consulta la documentazione dell'API relativa agli eventi del modulo UI.
Per inviare manualmente un evento personalizzato, utilizza la seguente sintassi:
dispatchAgentAssistEvent('event_name', {
detail: event_payload,
});
L'esempio seguente mostra come inviare l'evento analyze-content-received:
if (newMessageFromHumanAgent) {
dispatchAgentAssistEvent('analyze-content-received', {
detail: {
participantRole: 'HUMAN_AGENT',
request: {
textInput: {text: newMessageFromHumanAgent},
messageSendTime: new Date().toISOString()
}
}
});
}
Dopo aver inviato un evento personalizzato, nel servizio del connettore del modulo dell'interfaccia utente viene visualizzato quanto segue:
this.api.analyzeContent(...).then(function (response) {
dispatchAgentAssistEvent('analyze-content-response-received', {
detail: {response: response}});
});
Nel modulo vedrai quanto segue:
addAgentAssistEventListener('analyze-content-response-received', function (event) {
// Use the AnalyzeContent response to render suggestions in the UI.
});
Per iscriverti manualmente a un evento personalizzato, utilizza la seguente sintassi:
addAgentAssistEventListener('event_name', function (event) {
// `event.detail` contains the event payload.
});
L'esempio seguente mostra un abbonamento a eventi personalizzati:
addAgentAssistEventListener('smart-reply-selected', function (event) {
var chipContent = event.details;
// Populate the agent chat box with the selected Smart Reply chip.
});
Connettori dei moduli dell'interfaccia utente personalizzata
Puoi anche utilizzare gli eventi personalizzati per creare i tuoi connettori dei moduli UI personalizzati, che ti consentono di integrare i moduli UI in un computer dell'agente non supportato da Agent Assist. Per saperne di più sull'implementazione di moduli e connettori, consulta la documentazione sull'implementazione.
Se stai integrando i moduli dell'interfaccia utente di Agent Assist in qualsiasi desktop dell'agente senza un connettore del modulo dell'interfaccia utente predefinito, dovrai scriverne uno personalizzato. Dopo aver creato un connettore del modulo UI personalizzato, torna alla documentazione sull'implementazione del modulo UI per informazioni dettagliate sulla configurazione dei connettori e sull'implementazione dei moduli. Puoi utilizzare un connettore del modulo dell'interfaccia utente personalizzato con un contenitore gestito o con singoli moduli.
Un connettore del modulo dell'interfaccia utente personalizzato deve essere responsabile delle seguenti operazioni:
- Invio di un evento per selezionare la conversazione attiva. La conversazione verrà inizializzata insieme ai relativi partecipanti.
Nome evento:
active-conversation-selected - Per le conversazioni via chat, invia un evento ogni volta che viene registrato un nuovo enunciato dall'agente o dal cliente.
Nome evento:
analyze-content-requested - Invia una notifica al sistema del modulo quando la "modalità oscura" è stata attivata nell'applicazione principale.
Nome evento:
dark-mode-toggled
Inoltre, un connettore del modulo dell'interfaccia utente personalizzata deve iscriversi ai seguenti eventi per aggiornare l'interfaccia utente desktop dell'agente, se applicabile:
- Per la funzionalità Risposta rapida, aggiorna il campo di immissione dell'agente ogni volta che viene selezionato un chip Risposta rapida.
Nome evento:
smart-reply-selected. - Per l'Assistente generativo di conoscenze, aggiorna il campo di immissione dell'agente ogni volta che una risposta dell'assistente di conoscenze viene incollata nella casella di immissione.
Nome evento:
knowledge-assist-v2-answer-pasted.