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 des événements spécifiés, 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 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, à 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 documentation de référence conversationProfile.

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 pour les transcriptions en direct et les suggestions 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 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"
  },
  "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éfinir 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 s'ouvre ou se ferme	ConversationProfile.notificationConfig
new_message_event	Lorsqu'une nouvelle transcription de message/d'énoncé s'affiche	ConversationProfile.newMessageEventNotificationConfig

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 du 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 }