为 CCAI Agent Assist 事件启用 Cloud Pub/Sub 通知

启用 Cloud Pub/Sub 通知后，您可以在每次 Agent Assist 事件完成时接收通知。您可以将 Agent Assist 配置为针对所有事件或仅针对指定事件发送通知，包括 Agent Assist 建议、对话生命周期信息和实时转写内容。

前提条件

  1. 启用 Dialogflow API。
  2. 按照说明创建 Cloud Pub/Sub 主题。

启用 Cloud Pub/Sub 通知

您可以在对话资料中配置 Agent Assist，以便针对所有事件或指定事件发送通知。

对话配置文件可配置一组参数，用于控制对话期间向客服人员提出的建议或通知。您可以选择使用 Agent Assist 控制台或直接调用 API 来配置 Cloud Pub/Sub 通知。您可以使用自己创建的主题，单独配置每种类型的通知。

如需详细了解 Cloud Pub/Sub 配置参数，请参阅 conversationProfile 参考文档。

使用 Agent Assist 控制台启用 Cloud Pub/Sub 通知

使用 Agent Assist 控制台创建新的对话配置文件时，您可以选择要根据自己创建的主题接收哪些类型的通知：

使用 API 启用 Cloud Pub/Sub 通知

如果您希望直接调用 API 来创建或更新对话配置文件，请参阅本部分，了解您应在 ConversationProfile 资源中配置的位置。

以下示例配置为启用与指定 TOPIC_ID 匹配的所有 Cloud Pub/Sub 通知。

{
  "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"
}

Cloud Pub/Sub 消息的配置

通知 触发器 ConversationProfile 中的配置
suggestion_event 当 Agent Assist 生成建议时 ConversationProfile.humanAgentAssistantConfig.notificationConfig
将SuggestionFeatureConfig.enableEventBasedSuggestion 设为所选功能的 true

支持的功能：ARTICLE_SUGGESTION、FAQ 和 DIALOGFLOW_ASSIST
life_cycle_event 对话打开或关闭的时间 ConversationProfile.notificationConfig
new_message_event 当系统显示新消息/语音转写内容时 ConversationProfile.newMessageEventNotificationConfig

Cloud Pub/Sub 消息的内容

Cloud Pub/Sub 消息的内容取决于触发该 Cloud Pub/Sub 通知的事件。

通知 消息数据 消息数据示例
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
}