用途:配置 Home Assistant Assist 语音控制,包括语音管线、自定义意图、唤醒词、语音处理与语音卫星,实现本地或云端语音助手。
主要能力:
- 配置 Assist 管线,将 STT、TTS、意图与对话代理串联为单一语音工作流。
- 在 custom_sentences/ 目录创建自定义意图,支持槽位、列表、可选词组与通配符语法。
- 配置本地或云端语音引擎:本地 STT 用 Faster Whisper,本地 TTS 用 Piper;云端可选 Google Cloud、OpenAI 等。
- 配置唤醒词:openWakeWord(本地)或 Porcupine(本地,付费)。
- 搭建 ESP32 语音卫星,通过 ESPHome 接入麦克风与扬声器。
- 提供内置意图参考(HassTurnOn、HassGetState、HassLockDoor 等)与常见意图模式。
使用方式:
- 在 configuration.yaml 中定义 assist_pipeline,指定 language、stt_engine、tts_engine、conversation_engine 与 wake_word_entity。
- 在 custom_sentences/en/ 下编写 YAML 意图文件,必须包含 version: 1,使用 {name:list} 槽位语法与 lists 定义。
- 用 Assist 开发者工具测试语句,确认意图匹配、槽位提取与音频播放。
- 语音卫星需 ESP32-S3 等板卡、I2S 麦克风与扬声器,通过 ESPHome 配置 voice_assistant。
适用场景:家庭本地语音控制、多房间语音卫星、自定义自然语言指令、隐私优先的离线语音处理。
限制:
- 需 Home Assistant 2024.1+;Faster Whisper 0.5+、Piper TTS 1.0+ 为必需依赖。
- Piper 模型体积 100+ MB,需足够磁盘空间。
- 语音卫星需 WiFi 与兼容硬件。
- 语言支持分完整、部分与社区三档,具体可用性因语言而异。
- 资料未提供具体收费价格与效果数据。