ナビゲーションにスキップ

オーディオ環境

エージェントから発信されるオーディオにバックグラウンドサウンドを追加し、音声フィルターを適用します。

概要

オーディオ環境では、エージェントの発信オーディオが発信者にどのように聞こえるかを設定できます。次の2つの設定が適用されます。

  • バックグラウンドサウンド:エージェントの発話にループする環境音を重ねて再生します。
  • 音声フィルター:ミックス前のエージェント音声に、電話風のフィルターを適用します。

発信者には処理後の音声が聞こえます。エージェントにはバックグラウンドサウンドは聞こえず、音声認識にも送信されません。

これは、ツールの実行中にのみ再生されるツール呼び出しサウンドとは別の機能です。

バックグラウンドサウンド

バックグラウンドサウンドは、会話中のエージェントの発話に組み込みプリセットを重ねます。ユーザーが割り込んだ場合もサウンドはループし続け、エージェントのターン終了時に停止することはありません。

プリセットには、オフィス、レストラン、街中、タイピング、エレベーター音楽などがあります。ダッシュボードでは、保存前にプリセットをプレビューできます。

バックグラウンドサウンドはconversation_config.conversation.background_soundで設定します。

設定

1

オーディオ環境を開く

エージェントを開きます。エージェントページで、Voicesの横にあるオーディオ環境 ボタンをクリックします。

2

バックグラウンドサウンドを有効にする

バックグラウンドサウンドを有効化をオンにします。バックグラウンドサウンドからプリセットを選択します。ドロップダウンの横にある再生 コントロールでプレビューできます。

3

音量とループを設定する

音量を設定します。サウンドの繰り返し時にクリック音が聞こえないよう、クロスフェードループは有効のままにします。変更を 保存します。

WebSocket接続の品質が非常に低い場合、バックグラウンドサウンドのミックスによってオーディオが途切れることがあります。

パラメーター

有効なsource_idの値はoffice1、office2、restaurant、city、typing、およびelevator1からelevator4です。

フィールド型デフォルト説明
source_typestring未設定サウンドを有効にする場合はpresetにする必要があります。source_idと一緒に設定します。
source_idstring未設定組み込みプリセットの識別子です。
volumenumber0.15エージェントの発話に対するレベルです。範囲は0.01~1.0です。
crossfade_loopbooleantrueループ境界でクロスフェードし、繰り返し時のクリック音を防ぎます。

音声フィルター

音声フィルターは、エージェントが生成した音声を加工します。バックグラウンドサウンドのイコライジングやノイズ除去は行いません。フィルターが先に実行され、その後フィルター済みの音声にバックグラウンドサウンドが重ねられます。

音声フィルターはconversation_config.tts.audio_effects.filter_preset_idで設定します。ダッシュボードでは電話プリセットを選択できます。CLIまたはAPIでは、オーディオエフェクトカタログに掲載されている任意のフィルタープリセットを設定できます。

同じオーディオ環境パネルで、音声フィルターをオフまたは電話プリセットに設定してから、 保存します。

エージェントのオーディオはモノラルです。panはエージェントには影響せず、environment_idによるリバーブは モノラルにミックスダウンされます。

制限事項

  • 組み込みプリセットのみ利用できます。カスタムファイルのアップロードや任意のURLの指定はできません。
  • エージェントがテキストのみの場合、オーディオ環境のコントロールは表示されません。
  • バックグラウンドサウンドは、WhatsAppのボイスメッセージ返信にはミックスされません。WhatsApp通話には引き続き含まれます。
  • バックグラウンドサウンドは、クライアントのオーバーライドで会話ごとに設定できません。conversation_config_overrideにはbackground_soundが含まれません。 ワークフローノードでは変更できます。

関連項目