Pub/Sub 中間文字起こし

中間文字起こしは、Cloud Speech-to-Text API による音声認識の中間結果です。中間文字起こしは、音声の詳細な分析によって変更される場合があります。Cloud Pub/Sub トピックを使用して中間文字起こし配信を構成するか、gRPC を使用して CCAI 文字起こし配信を行います。

音声認識の最終結果の配信は、ConversationProfile.newMessageEventNotificationConfig または gRPC レスポンスで構成できます。

会話プロファイルを作成または更新する

会話プロファイルを作成または更新する手順は次のとおりです。Agent Assist は、中間文字起こしを削除しません。

コンソール

  1. Agent Assist コンソールで、[会話プロファイル] をクリックします。
  2. プロフィールの名前または [+ 作成] をクリックします。
  3. [Pub/Sub 通知] に移動し、[音声文字変換の中間結果通知] を選択します。
  4. 中間文字起こしを受信するために作成した Pub/Sub トピックを入力し、メッセージ形式を選択します。
  5. [保存] をクリックします。

REST

  1. ConversationProfile.newRecognitionResultNotificationConfig を使用して中間文字起こしを受信するように 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/NEW_MESSAGE_TOPIC_ID",
  "messageFormat": "JSON"
},
"newRecognitionResultNotificationConfig": {
  "topic": "projects/PROJECT_ID/topics/INTERMEDIATE_TRANSCRIPT_TOPIC_ID",
  "messageFormat": "JSON"
},
"languageCode": "en-US"
}

省略可: メッセージの順序付けを有効にする

会話 ID は、パブリッシュされた Pub/Sub 音声文字変換メッセージの順序指定キーです。メッセージを順に受信するには、メッセージを受信するサブスクリプションのメッセージ順序指定プロパティを設定します。

省略可: 詳細情報を取得する

Dialogflow は、会話 ID、メッセージ ID、参加者 ID、参加者のロールを属性として Pub/Sub メッセージに追加します。これらの属性には PubsubMessage.attributes でアクセスできます。また、カスタム属性でサブスクライブして、次の Pub/Sub メッセージデータとともに取得することもできます。

  • 参加者 ID の属性キー: participant_id
  • メッセージ ID の属性キー: message_id
  • 会話 ID の属性キー: conversation_id
  • 参加者のロールの属性キー: participant_role

属性セットの例を次に示します。{"conversation_id": "c_id", "participant_id": "p_id"}

省略可: サブスクリプションの構成

音声文字変換の配信を処理するように Pub/Sub サブスクリプションをカスタマイズする際は、次のガイドラインに沿って操作してください。