L'attivazione delle notifiche Cloud Pub/Sub ti consente di ricevere una notifica ogni volta che un evento di Agent Assist viene completato. Puoi configurare Agent Assist in modo che invii una notifica per tutti gli eventi o solo per gli eventi specificati, inclusi i suggerimenti di Agent Assist, le informazioni sul ciclo di vita della conversazione e le trascrizioni live.
Prerequisiti
- Attiva l'API Dialogflow.
- Segui le istruzioni per creare un argomento Cloud Pub/Sub.
Abilitazione delle notifiche Cloud Pub/Sub
Puoi configurare Agent Assist in modo che invii una notifica per tutti gli eventi o per eventi specifici nel tuo profilo di conversazione.
Un profilo di conversazione configura un insieme di parametri che controllano i suggerimenti o le notifiche inviati a un agente durante una conversazione. Puoi configurare le notifiche Cloud Pub/Sub utilizzando la console Agent Assist o chiamando direttamente l'API. Puoi configurare separatamente ogni tipo di notifica utilizzando gli argomenti che hai creato.
Per maggiori dettagli sui parametri di configurazione di Cloud Pub/Sub, consulta la
documentazione di riferimento di conversationProfile
.
Abilitare le notifiche Cloud Pub/Sub utilizzando la console Agent Assist
Quando crei un nuovo profilo conversazione utilizzando la console Agent Assist, puoi selezionare i tipi di notifiche che vuoi ricevere utilizzando gli argomenti che hai creato:
Abilitare le notifiche Cloud Pub/Sub utilizzando l'API
Se preferisci chiamare direttamente l'API per creare o aggiornare un profilo conversazione,
consulta questa sezione per le località da configurare nella risorsa
ConversationProfile
.
L'esempio seguente è configurato per abilitare tutte le notifiche Cloud Pub/Sub
che corrispondono a un TOPIC_ID
designato.
{ "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" }
Configurazione del messaggio Cloud Pub/Sub
Notifica | Trigger | Configurazione in ConversationProfile |
---|---|---|
suggestion_event | Quando Agent Assist genera un suggerimento | ConversationProfile.humanAgentAssistantConfig.notificationConfig Imposta SuggestionFeatureConfig.enableEventBasedSuggestion su true per le funzionalità selezionateFunzionalità supportate: ARTICLE_SUGGESTION, FAQ AND DIALOGFLOW_ASSIST |
life_cycle_event | Quando la conversazione viene aperta o chiusa | ConversationProfile.notificationConfig |
new_message_event | Quando viene visualizzata la trascrizione di un nuovo messaggio/enunciato | ConversationProfile.newMessageEventNotificationConfig |
new_recognition_result_event | Quando è disponibile una trascrizione intermedia | ConversationProfile.newRecognitionResultNotificationConfig |
Contenuto del messaggio Cloud Pub/Sub
Il contenuto del messaggio Cloud Pub/Sub dipende dall'evento che attiva la notifica Cloud Pub/Sub.
Notifica | Dati del messaggio | Esempio di dati del messaggio |
---|---|---|
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 } |