L'activation des notifications Cloud Pub/Sub vous permet de recevoir une notification chaque fois qu'un événement Agent Assist est terminé. Vous pouvez configurer l'Assistance d'agent pour qu'elle envoie une notification pour tous les événements ou uniquement pour certains événements spécifiques, y compris les suggestions de l'Assistance d'agent, les informations sur le cycle de vie des conversations et les transcriptions en direct.
Prérequis
- Activez l'API Dialogflow.
- Suivez les instructions pour créer un sujet Cloud Pub/Sub.
Activer les notifications Cloud Pub/Sub
Vous pouvez configurer l'Assistance de l'agent pour qu'elle envoie une notification pour tous les événements ou pour des événements spécifiques dans votre profil de conversation.
Un profil de conversation configure un ensemble de paramètres qui contrôlent les suggestions ou les notifications adressées à un agent au cours d'une conversation. Vous pouvez configurer les notifications Cloud Pub/Sub à l'aide de la console Agent Assist ou en appelant directement l'API. Vous pouvez configurer chaque type de notification séparément, en utilisant les thèmes que vous avez créés.
Pour en savoir plus sur les paramètres de configuration de Cloud Pub/Sub, consultez la documentation de référence conversationProfile
.
Activer les notifications Cloud Pub/Sub à l'aide de la console Agent Assist
Lorsque vous créez un profil de conversation à l'aide de la console Agent Assist, vous pouvez sélectionner les types de notifications que vous souhaitez recevoir à l'aide des thèmes que vous avez créés :
Activer les notifications Cloud Pub/Sub à l'aide de l'API
Si vous préférez appeler directement l'API pour créer ou mettre à jour un profil de conversation, consultez cette section pour connaître les emplacements à configurer dans la ressource ConversationProfile
.
L'exemple suivant est configuré pour activer toutes les notifications Cloud Pub/Sub correspondant à un TOPIC_ID
désigné.
{ "name": "projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID", "displayName": "CONVERSATION_PROFILE_NAME", "automatedAgentConfig": { }, "humanAgentAssistantConfig": { "notificationConfig": { "topic": "projects/PROJECT_ID/topics/FEATURE_SUGGESTION_TOPIC_ID", "messageFormat": "JSON" }, "humanAgentSuggestionConfig": { "featureConfigs": [{ "enableEventBasedSuggestion": true, "suggestionFeature": { "type": "ARTICLE_SUGGESTION" }, "conversationModelConfig": { } }] }, "messageAnalysisConfig": { } }, "notificationConfig": { "topic": "projects/PROJECT_ID/topics/CONVERSARION_LIFECYCLE_TOPIC_ID", "messageFormat": "JSON" }, "newMessageEventNotificationConfig": { "topic": "projects/PROJECT_ID/topics/LIVE_TRANSCRIPT_TOPIC_ID", "messageFormat": "JSON" }, "newRecognitionResultNotificationConfig": { "topic": "projects/PROJECT_ID/topics/NEW_RECOGNITION_RESULT_TOPIC_ID", "messageFormat": "JSON" }, "languageCode": "en-US" }
Configuration du message Cloud Pub/Sub
Notification | Déclencheur | Configuration dans ConversationProfile |
---|---|---|
suggestion_event | Lorsqu'Agent Assist génère une suggestion | ConversationProfile.humanAgentAssistantConfig.notificationConfig Définissez SuggestionFeatureConfig.enableEventBasedSuggestion sur "true" pour les fonctionnalités sélectionnéesFonctionnalités compatibles : ARTICLE_SUGGESTION, FAQ et DIALOGFLOW_ASSIST |
life_cycle_event | Lorsque la conversation est ouverte ou fermée | ConversationProfile.notificationConfig |
new_message_event | Lorsqu'une nouvelle transcription de message/énoncé s'affiche | ConversationProfile.newMessageEventNotificationConfig |
new_recognition_result_event | Lorsqu'une transcription intermédiaire est disponible | ConversationProfile.newRecognitionResultNotificationConfig |
Contenu du message Cloud Pub/Sub
Le contenu du message Cloud Pub/Sub dépend de l'événement qui déclenche cette notification Cloud Pub/Sub.
Notification | Données des messages | Exemple de données de message |
---|---|---|
suggestion_event | HumanAgentAssistantEvent |
{ "conversation": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID", "participant": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID", "suggestionResults": [ SuggestionResult ]} |
life_cycle_event | ConversationEvent |
{ "conversation": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID", "type": "CONVERSATION_STARTED" } |
new_message_event | ConversationEvent |
{ "conversation": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID", "type": "NEW_MESSAGE", "newMessagePayload": Message } |
new_recognition_result_event | ConversationEvent |
{ "conversation": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID", "type": "NEW_RECOGNITION_RESULT", "newRecognitionResultPayload": StreamingRecognitionResult } |