Ativar as notificações do Cloud Pub/Sub para eventos de assistência do agente CCAI
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 Assistente do agente para enviar uma notificação de todos os eventos ou apenas dos eventos especificados, incluindo sugestões do Assistente do agente, informações sobre o ciclo de vida da conversa e transcrições em tempo real.
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 Assistente de IA 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 IA, você pode selecionar os tipos de notificações que quer receber usando os tópicos 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eAgent Assist can send notifications via Cloud Pub/Sub for completed events, including suggestions, conversation lifecycle updates, and live transcripts.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure Agent Assist to send notifications for all events or only for specific event types, like suggestion_event, life_cycle_event, or new_message_event, through conversation profiles.\u003c/p\u003e\n"],["\u003cp\u003eTo enable Cloud Pub/Sub notifications, you need to have the Dialogflow API enabled and have already created a Cloud Pub/Sub topic.\u003c/p\u003e\n"],["\u003cp\u003eNotifications can be configured via the Agent Assist console or by directly calling the API, allowing for separate configuration of each notification type.\u003c/p\u003e\n"],["\u003cp\u003eEach notification type—suggestion, lifecycle, and new message—sends different data formats in its Cloud Pub/Sub message, with examples provided for each.\u003c/p\u003e\n"]]],[],null,["# Enable Cloud Pub/Sub notifications for CCAI Agent Assist events\n\nEnabling [Cloud Pub/Sub](/pubsub) notifications lets you receive a\nnotification each time an Agent Assist event completes. You can\nconfigure Agent Assist to send a notification for all events or only\nspecified events, including Agent Assist suggestions, conversation\nlifecycle information, and live transcripts.\n\nPrerequisites\n-------------\n\n1. Enable the [Dialogflow API](/dialogflow/es/docs/reference/rest/v2-overview).\n2. Follow the instructions to [create a Cloud Pub/Sub topic](/pubsub/docs/create-topic-console).\n\nEnable Cloud Pub/Sub notifications\n----------------------------------\n\nYou can configure Agent Assist to send a notification for\n*all events* or for *specified events* in your **conversation profile**.\n\nA [conversation profile](/agent-assist/docs/conversation-profile) configures a\nset of parameters that control the suggestions or notifications made to an agent\nduring a conversation. You have the option of configuring [Cloud Pub/Sub](/pubsub)\nnotifications either using the\n[Agent Assist console](https://agentassist.cloud.google.com)\nor by calling the API directly. You can configure each type of notification\nseparately, using the topics that you've created.\n\nFor more details about Cloud Pub/Sub configuration parameters, see the\n[`conversationProfile` reference documentation](/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles).\n\n### Enable Cloud Pub/Sub notifications using the Agent Assist console\n\n| **Note:** You can use the Agent Assist simulator to create a conversation. In this case, notifications for live transcripts and suggestions are published to Google internal Pub/Sub topics instead of the ones you configured in your conversation profiles.\n\nWhen you create a new conversation profile using the\n[Agent Assist console](https://agentassist.cloud.google.com),\nyou can select which notification types you'd like to receive using the topics\nyou've created:\n\n### Enable Cloud Pub/Sub notifications using the API\n\nIf you prefer to call the API directly to create or update a conversation profile,\ncheck this section for the locations you should configure in the\n[`ConversationProfile`](/dialogflow/es/docs/reference/rest/v2/projects.conversationProfiles)\nresource.\n\nThe following example is configured to enable all Cloud Pub/Sub notifications\nthat match a designated `TOPIC_ID`. \n\n```json\n{\n \"name\": \"projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID\",\n \"displayName\": \"CONVERSATION_PROFILE_NAME\",\n \"automatedAgentConfig\": {\n },\n \"humanAgentAssistantConfig\": {\n \"notificationConfig\": {\n \"topic\": \"projects/PROJECT_ID/topics/FEATURE_SUGGESTION_TOPIC_ID\",\n \"messageFormat\": \"JSON\"\n },\n \"humanAgentSuggestionConfig\": {\n \"featureConfigs\": [{\n \"enableEventBasedSuggestion\": true,\n \"suggestionFeature\": {\n \"type\": \"ARTICLE_SUGGESTION\"\n },\n \"conversationModelConfig\": {\n }\n }]\n },\n \"messageAnalysisConfig\": {\n }\n },\n \"notificationConfig\": {\n \"topic\": \"projects/PROJECT_ID/topics/CONVERSARION_LIFECYCLE_TOPIC_ID\",\n \"messageFormat\": \"JSON\"\n },\n \"newMessageEventNotificationConfig\": {\n \"topic\": \"projects/PROJECT_ID/topics/LIVE_TRANSCRIPT_TOPIC_ID\",\n \"messageFormat\": \"JSON\"\n },\n \"newRecognitionResultNotificationConfig\": {\n \"topic\": \"projects/PROJECT_ID/topics/NEW_RECOGNITION_RESULT_TOPIC_ID\",\n \"messageFormat\": \"JSON\"\n },\n \"languageCode\": \"en-US\"\n}\n```\n\n### Configuration of the Cloud Pub/Sub message\n\n### Content of the Cloud Pub/Sub message\n\nThe content of the [Cloud Pub/Sub message](/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage) depends on the event that triggers that Cloud Pub/Sub notification."]]
