Attivare le notifiche Cloud Pub/Sub per gli eventi di assistenza dell'agente CCAI

L'abilitazione 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 eventi specifici, tra cui suggerimenti di Agent Assist, informazioni sul ciclo di vita della conversazione e trascrizioni in tempo reale.

Prerequisiti

  1. Abilita l'API Dialogflow.
  2. 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 profilo di conversazione.

Un profilo di conversazione configura un insieme di parametri che controllano i suggerimenti o le notifiche inviate a un agente durante una conversazione. Hai la possibilità di configurare le notifiche Cloud Pub/Sub utilizzando la console di 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 conversationProfile documentazione di riferimento.

Abilitazione delle notifiche Cloud Pub/Sub utilizzando la console di Agent Assist

Quando crei un nuovo profilo di conversazione utilizzando la console di Agent Assist, puoi selezionare i tipi di notifica che vuoi ricevere utilizzando gli argomenti che hai creato:

Abilitazione delle notifiche Cloud Pub/Sub utilizzando l'API

Se preferisci chiamare direttamente l'API per creare o aggiornare un profilo di conversazione, consulta questa sezione per le località da configurare nella ConversationProfile risorsa.

Il seguente esempio è 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à selezionate

Funzionalità supportate: ARTICLE_SUGGESTION, FAQ AND DIALOGFLOW_ASSIST
life_cycle_event Quando la conversazione si apre o si chiude ConversationProfile.notificationConfig
new_message_event Quando viene visualizzata una nuova trascrizione di un 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
}