Activer les notifications Cloud Pub/Sub pour les événements d'assistance par agent CCAI

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

  1. Activez l'API Dialogflow.
  2. 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ées

Fonctionnalité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
}