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 Assistente do agente é concluído. Você pode configurar o recurso para enviar uma notificação de todos os eventos ou apenas dos especificados, incluindo sugestões da Assistente de IA, informações sobre o ciclo de vida da conversa e transcrições em tempo real.

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

Você pode configurar o Assistente do agente para enviar uma notificação de todos os eventos ou de 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 feitas a um agente durante uma conversa. É possível 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 documentação de referência do conversationProfile.

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

Ao criar um perfil de conversa usando o console do Assistente de agente, você pode selecionar os tipos de notificação que quer receber usando os temas 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 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"
  },
  "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 "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 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 de 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
}