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

En activant les notifications Cloud Pub/Sub, vous recevez une notification chaque fois qu'un événement Agent Assist se termine. Vous pouvez configurer Agent Assist pour qu'il envoie une notification pour tous les événements ou uniquement pour certains événements, y compris les suggestions Agent Assist, 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 Agent Assist pour qu'il envoie une notification pour tous les événements ou pour certains événements 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 à l'aide des sujets que vous avez créés.

Pour en savoir plus sur les paramètres de configuration de Cloud Pub/Sub, consultez la conversationProfile documentation de référence.

Activer les notifications Cloud Pub/Sub à l'aide de la console Agent Assist

Remarque : Vous pouvez utiliser le simulateur Agent Assist pour créer une conversation. Dans ce cas, les notifications concernant les transcriptions et les suggestions en direct sont publiées dans des sujets Pub/Sub internes à Google au lieu de ceux que vous avez configurés dans vos profils de conversation.

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 sujets 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 que vous devez configurer dans la ConversationProfile ressource.

L'exemple suivant est configuré pour activer toutes les notifications Cloud Pub/Sub qui correspondent à 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	Lorsque 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 du message	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 }