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

Cloud Pub/Sub 通知を有効にすると、Agent Assist イベントが完了するたびに通知を受け取ることができます。すべてのイベントまたは特定のイベント（Agent Assist の候補、会話のライフサイクル情報、ライブ文字起こしなど）に対して通知を送信するように 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"
  },
  "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
}