音频环境
为智能体的外发音频添加背景音并应用语音滤镜。
概述
音频环境用于控制智能体外发音频在通话者听来是什么效果。可应用两项设置：
- 背景音会在智能体语音下方循环播放环境音。
- 语音滤镜会在混音前为智能体语音应用电话风格滤镜。
通话者会听到最终效果。智能体不会听到背景音，背景音也不会被传入语音识别。
这与工具调用音效不同，后者仅在工具运行时播放。
背景音
背景音会在整个对话期间，将内置预设混入智能体语音下方。用户打断时，声音仍会继续循环；不会随智能体回合结束而停止。
预设包括办公室、餐厅、城市、打字声和电梯音乐。在控制台中，可先预览预设再保存。
使用 conversation_config.conversation.background_sound 配置背景音。
配置
通过控制台更新
通过 CLI 更新
通过 API 更新
在网络状况很差的 WebSocket 连接上，混入背景音可能导致音频断续。
参数
有效的 source_id 值为 office1、office2、restaurant、city、typing，以及 elevator1 到 elevator4。
语音滤镜
语音滤镜会调整智能体生成的语音。它不会均衡或降噪背景音。滤镜会先运行，然后将背景音混入处理后的语音下方。
使用 conversation_config.tts.audio_effects.filter_preset_id 配置语音滤镜。控制台提供电话预设；通过 CLI 或 API，可设置音频效果目录列出的任意滤镜预设。
通过控制台更新
通过 CLI 更新
通过 API 更新
在同一 音频环境 面板中，将 语音滤镜设为 关闭或电话预设，然后 保存。
智能体音频为单声道。pan 对智能体无效，environment_id 的混响会
下混为单声道。
限制
- 仅支持内置预设。无法上传自定义文件，也不能指定任意 URL。
- 智能体处于 纯文本 模式时，音频环境控件会隐藏。
- 背景音不会混入 WhatsApp 语音消息回复中，但 WhatsApp 通话仍会包含背景音。
- 无法通过客户端覆盖设置按对话设置背景音；
conversation_config_override不包含background_sound。不过，仍可在 workflow 节点中更改。