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
- Ative a API Dialogflow.
- 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 selecionadasFuncionalidades 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 } |