Toutes les communications entre un module d'interface utilisateur Agent Assist et son connecteur s'effectuent via des événements personnalisés. Le connecteur de module d'interface utilisateur facilite les événements entre le bureau de l'agent et les modules d'interface utilisateur.
Par exemple, lorsqu'une suggestion Agent Assist est reçue, un service de connecteur de module d'interface utilisateur distribue un événement analyze-content-received aux modules d'interface utilisateur, qui sont abonnés à ces événements.
Détails de l'événement personnalisé
Pour obtenir la liste complète des événements du module d'interface utilisateur et de leurs charges utiles, consultez la documentation de l'API des événements du module d'interface utilisateur.
Pour diffuser manuellement un événement personnalisé, utilisez la syntaxe suivante:
dispatchAgentAssistEvent('event_name', {
detail: event_payload,
});
L'exemple suivant montre comment distribuer l'événement analyze-content-received:
if (newMessageFromHumanAgent) {
dispatchAgentAssistEvent('analyze-content-received', {
detail: {
participantRole: 'HUMAN_AGENT',
request: {
textInput: {text: newMessageFromHumanAgent},
messageSendTime: new Date().toISOString()
}
}
});
}
Une fois que vous avez distribué un événement personnalisé, le service de connecteur du module d'interface utilisateur affiche ce qui suit:
this.api.analyzeContent(...).then(function (response) {
dispatchAgentAssistEvent('analyze-content-response-received', {
detail: {response: response}});
});
Vous verrez ce qui suit dans le module:
addAgentAssistEventListener('analyze-content-response-received', function (event) {
// Use the AnalyzeContent response to render suggestions in the UI.
});
Pour vous abonner manuellement à un événement personnalisé, utilisez la syntaxe suivante:
addAgentAssistEventListener('event_name', function (event) {
// `event.detail` contains the event payload.
});
L'exemple suivant montre un abonnement à des événements personnalisés:
addAgentAssistEventListener('smart-reply-selected', function (event) {
var chipContent = event.details;
// Populate the agent chat box with the selected Smart Reply chip.
});
Connecteurs de module d'UI personnalisés
Vous pouvez également utiliser des événements personnalisés pour créer vos propres connecteurs de modules d'interface utilisateur personnalisés, qui vous permettent d'intégrer les modules d'interface utilisateur à un ordinateur de bureau d'agent non compatible avec Agent Assist. Pour en savoir plus sur l'implémentation de modules et de connecteurs, consultez la documentation d'implémentation.
Si vous intégrez des modules d'interface utilisateur Agent Assist à un bureau d'agent sans connecteur de module d'interface utilisateur prédéfini, vous devrez en écrire un personnalisé. Une fois que vous avez créé un connecteur de module d'interface utilisateur personnalisé, revenez à la documentation sur l'implémentation du module d'interface utilisateur pour en savoir plus sur la configuration de vos connecteurs et l'implémentation des modules. Vous pouvez utiliser un connecteur de module d'interface utilisateur personnalisé avec un conteneur géré ou avec des modules individuels.
Un connecteur de module d'interface utilisateur personnalisé doit être responsable des opérations suivantes:
- Distribution d'un événement pour sélectionner la conversation active. La conversation et ses participants sont alors initialisés.
Nom de l'événement:
active-conversation-selected - Pour les conversations par chat, distribution d'un événement chaque fois qu'une nouvelle énonciation est enregistrée par l'agent ou le client.
Nom de l'événement:
analyze-content-requested - Notification du système de module lorsque le mode sombre a été activé dans l'application principale.
Nom de l'événement:
dark-mode-toggled
En outre, un connecteur de module d'interface utilisateur personnalisé doit s'abonner aux événements suivants pour mettre à jour l'interface utilisateur de bureau de l'agent, le cas échéant:
- Pour la réponse suggérée, mettez à jour le champ de saisie de l'agent chaque fois qu'un chip de réponse suggérée est sélectionné.
Nom de l'événement:
smart-reply-selected. - Pour Generative Knowledge Assist, mettez à jour le champ de saisie de l'agent chaque fois qu'une réponse de l'assistance par le biais de la base de connaissances est collée dans le champ de saisie.
Nom de l'événement:
knowledge-assist-v2-answer-pasted.