中間文字起こしは、Cloud Speech-to-Text API による音声認識の中間結果です。中間文字起こしは、音声の詳細な分析によって変更される場合があります。Cloud Pub/Sub トピックを使用して中間文字起こし配信を構成するか、gRPC を使用して CCAI 文字起こし配信を行います。
音声認識の最終結果の配信は、ConversationProfile.newMessageEventNotificationConfig
または gRPC レスポンスで構成できます。
会話プロファイルを作成または更新する
会話プロファイルを作成または更新する手順は次のとおりです。Agent Assist は、中間文字起こしを削除しません。
コンソール
- Agent Assist コンソールで、[会話プロファイル] をクリックします。
- プロフィールの名前または [+ 作成] をクリックします。
- [Pub/Sub 通知] に移動し、[音声文字変換の中間結果通知] を選択します。
- 中間文字起こしを受信するために作成した Pub/Sub トピックを入力し、メッセージ形式を選択します。
- [保存] をクリックします。
REST
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 サブスクリプションをカスタマイズする際は、次のガイドラインに沿って操作してください。