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