SuperAPI AI 工具集

ha-voice

通用与其它

查看项目

更新于 10-16 02:31

技能介绍

用途:配置 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 与兼容硬件。
  • 语言支持分完整、部分与社区三档,具体可用性因语言而异。
  • 资料未提供具体收费价格与效果数据。