Ativar as notificações do Cloud Pub/Sub para eventos de assistência do agente CCAI

Ao ativar as notificações do Cloud Pub/Sub, você recebe uma notificação sempre que um evento do Agent Assist é concluído. É possível configurar o Agent Assist para enviar uma notificação de todos os eventos ou apenas dos especificados, incluindo sugestões do Agent Assist, informações do ciclo de vida da conversa e transcrições ao vivo.

Pré-requisitos

  1. Ative a API Dialogflow.
  2. Siga as instruções para criar um tópico do Cloud Pub/Sub.

Ativar notificações do Cloud Pub/Sub

É possível configurar o Agent Assist para enviar uma notificação de todos os eventos ou de eventos especificados no perfil de conversa.

Um perfil de conversa configura um conjunto de parâmetros que controlam as sugestões ou notificações feitas a um agente durante uma conversa. Você pode configurar as notificações do Cloud Pub/Sub usando o console do Agent Assist ou chamando a API diretamente. É possível configurar cada tipo de notificação separadamente, usando os tópicos criados.

Para mais detalhes sobre os parâmetros de configuração do Cloud Pub/Sub, consulte a conversationProfile documentação de referência.

Ativar notificações do Cloud Pub/Sub usando o console do Agent Assist

Ao criar um novo perfil de conversa usando o console do Agent Assist, você pode selecionar os tipos de notificação que quer receber usando os tópicos criados:

Ativar notificações do Cloud Pub/Sub usando a API

Se preferir chamar a API diretamente para criar ou atualizar um perfil de conversa, confira esta seção para saber os locais que você precisa configurar no ConversationProfile recurso.

O exemplo a seguir está configurado para ativar todas as notificações do Cloud Pub/Sub que correspondem a um TOPIC_ID designado.

{
  "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"
}

Configuração da mensagem do Cloud Pub/Sub

Notificação Gatilho Configuração em ConversationProfile
suggestion_event Quando o Agent Assist gera uma sugestão ConversationProfile.humanAgentAssistantConfig.notificationConfig
Defina SuggestionFeatureConfig.enableEventBasedSuggestion como verdadeiro para os recursos selecionados

Recursos compatíveis: ARTICLE_SUGGESTION, FAQ AND DIALOGFLOW_ASSIST
life_cycle_event Quando a conversa é aberta ou fechada ConversationProfile.notificationConfig
new_message_event Quando uma nova transcrição de mensagem/enunciado aparece ConversationProfile.newMessageEventNotificationConfig
new_recognition_result_event Quando uma transcrição intermediária está disponível ConversationProfile.newRecognitionResultNotificationConfig

Conteúdo da mensagem do Cloud Pub/Sub

O conteúdo da mensagem do Cloud Pub/Sub depende do evento que aciona essa notificação.

Notificação Dados da mensagem Exemplo de dados da mensagem
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
}