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

L'attivazione delle notifiche Cloud Pub/Sub ti consente di ricevere una notifica ogni volta che viene completato un evento Agent Assist. Puoi configurare Agent Assist in modo che invii una notifica per tutti gli eventi o solo per eventi specifici, inclusi i suggerimenti di Agent Assist, le informazioni sul ciclo di vita della conversazione e le trascrizioni in tempo reale.

Prerequisiti

1. Attiva 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 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 ogni tipo di notifica separatamente, utilizzando gli argomenti che hai creato.

Per ulteriori dettagli sui parametri di configurazione di Cloud Pub/Sub, consulta la documentazione di riferimento di conversationProfile.

Attivare le notifiche Cloud Pub/Sub utilizzando la console Agent Assist

Nota: puoi utilizzare il simulatore di Agent Assist per creare una conversazione. In questo caso, le notifiche per le trascrizioni in tempo reale e i suggerimenti vengono pubblicate negli argomenti Pub/Sub interni di Google anziché in quelli configurati nei profili di conversazione.

Quando crei un nuovo profilo di 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 di conversazione, consulta questa sezione per conoscere le posizioni da configurare nella risorsa ConversationProfile.

L'esempio seguente è configurato per attivare 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"
  },
  "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 e DIALOGFLOW_ASSIST
life_cycle_event	Quando la conversazione si apre o si chiude	ConversationProfile.notificationConfig
new_message_event	Quando viene visualizzata la trascrizione di un nuovo messaggio/pronuncia	ConversationProfile.newMessageEventNotificationConfig

Contenuto del messaggio Cloud Pub/Sub

I contenuti del messaggio Cloud Pub/Sub dipendono 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 }