Ative as notificações do Cloud Pub/Sub para eventos do Agent Assist do CCAI

A ativação das notificações do Cloud Pub/Sub permite-lhe receber uma notificação sempre que um evento do Agent Assist for concluído. Pode configurar o Assistente do agente para enviar uma notificação para todos os eventos ou apenas para eventos especificados, incluindo sugestões do Assistente do agente, informações do ciclo de vida da conversa e transcrições em direto.

Pré-requisitos

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

Ative as notificações do Cloud Pub/Sub

Pode configurar o Agent Assist para enviar uma notificação para todos os eventos ou para eventos especificados no seu perfil de conversa.

Um perfil de conversa configura um conjunto de parâmetros que controlam as sugestões ou as notificações feitas a um agente durante uma conversa. Tem a opção de configurar as notificações do Cloud Pub/Sub através da consola do Agent Assist ou chamando diretamente a API. Pode configurar cada tipo de notificação separadamente, usando os tópicos que criou.

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

Ative as notificações do Cloud Pub/Sub através da consola do Agent Assist

Quando cria um novo perfil de conversa através da consola do Agent Assist, pode selecionar os tipos de notificações que quer receber através dos tópicos que criou:

Ative as notificações do Cloud Pub/Sub através da API

Se preferir chamar a API diretamente para criar ou atualizar um perfil de conversa, consulte esta secção para ver as localizações que deve configurar no recurso ConversationProfile.

O exemplo seguinte está configurado para ativar todas as notificações do Cloud Pub/Sub que correspondam 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 Acionador Configuração em ConversationProfile
suggestion_event Quando o Agent Assist gera uma sugestão ConversationProfile.humanAgentAssistantConfig.notificationConfig
Defina SuggestionFeatureConfig.enableEventBasedSuggestion como true para as funcionalidades selecionadas

Funcionalidades suportadas: ARTICLE_SUGGESTION, FAQ e DIALOGFLOW_ASSIST
life_cycle_event Quando a conversa é aberta ou fechada ConversationProfile.notificationConfig
new_message_event Quando aparece uma nova transcrição de mensagem/expressão ConversationProfile.newMessageEventNotificationConfig
new_recognition_result_event Quando está disponível uma transcrição intermédia 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 do Cloud Pub/Sub.

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