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

Ativar as notificações do Cloud Pub/Sub permite que você receba uma notificação sempre que um evento do Assistente do agente for concluído. É possível configurar o Assistente do agente para enviar uma notificação para todos os eventos ou apenas para eventos específicos, incluindo sugestões do Assistente do agente, 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 Assistente do agente para enviar uma notificação para todos os eventos ou para eventos específicos no seu perfil de conversa.

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

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

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

Ao criar um novo perfil de conversa usando o console do Assistente do agente, é possível selecionar os tipos de notificação que você quer receber usando os tópicos que você criou:

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

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

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"
  },
  "languageCode": "en-US"
}

Configuração da mensagem do Cloud Pub/Sub

Notificação Gatilho Configuração em ConversationProfile
suggestion_event Quando o Assistente de agente gera uma sugestão ConversationProfile.humanAgentAssistantConfig.notificationConfig
Defina SuggestionFeatureConfig.enableEventBasedSuggestion como "true" para os recursos selecionados

Recursos compatíveis: ARTICLE_SUGGESTION, FAQ E DIALOGFLOW_ASSIST
life_cycle_event Quando a conversa é aberta ou fechada ConversationProfile.notificationConfig
new_message_event Quando uma nova mensagem/transcrição de fala aparece ConversationProfile.newMessageEventNotificationConfig

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
}