CCAI エージェント アシスト イベントの Cloud Pub/Sub 通知を有効にする

Cloud Pub/Sub 通知を有効にすると、Agent Assist イベントが完了するたびに通知を受け取ることができます。エージェント アシストの候補、会話のライフサイクル情報、ライブ文字起こしなど、すべてのイベントまたは指定したイベントのみの通知を送信するようにエージェント アシストを構成できます。

前提条件

  1. Dialogflow API を有効にします。
  2. 手順に沿って、Cloud Pub/Sub トピックを作成します。

Cloud Pub/Sub 通知を有効にする

会話プロファイルで、すべてのイベントまたは指定したイベントの通知を送信するように Agent Assist を構成できます。

会話プロファイルでは、会話中にエージェントに提示される候補や通知を制御する一連のパラメータを構成します。Cloud Pub/Sub 通知は、Agent Assist コンソールを使用するか、API を直接呼び出して構成できます。作成したトピックを使用して、通知の種類ごとに個別に構成できます。

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"
  },
  "newRecognitionResultNotificationConfig": {
    "topic": "projects/PROJECT_ID/topics/NEW_RECOGNITION_RESULT_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
new_recognition_result_event 中間文字起こしが利用可能になった場合 ConversationProfile.newRecognitionResultNotificationConfig

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
}
new_recognition_result_event ConversationEvent {
"conversation": "projects/PROJECT_ID/locations/LOCATION/conversations/CONVERSATION_ID",
"type": "NEW_RECOGNITION_RESULT",
"newRecognitionResultPayload": StreamingRecognitionResult
}