music-assistant/voice-support

它解决了什么问题

Home Assistant对音乐和媒体控制的意图非常有限，尤其是在通过语音开始播放音乐方面。该项目弥合了Home Assistant Assist与Music Assistant之间的差距，提供了社区驱动的脚本、蓝图和操作指南，使音乐播放的完整语音控制成为可能。

它是如何工作的

该仓库提供了三个选项，每个选项具有不同的灵活性和设置要求：

• 选项1：本地助手蓝图 – 一个使用纯本地意图处理并带有自定义句子来处理媒体播放的蓝图。不涉及云端LLM。句子必须遵循严格的格式，以“Shuffle”、“Play”或“Listen to”开头，后跟项目类型（艺术家、曲目、专辑、播放列表、电台），然后是名称。可以添加关于艺术家、区域和电台模式的可选短语。蓝图提供多种语言版本。

• 选项2：由LLM集成增强的本地助手 – 此选项使用LLM集成（如OpenAI Conversation或Google Generative AI）来理解更自然的语言查询。该蓝图需要一个不对家庭实体进行控制的LLM对话代理，以避免错误。它允许灵活的句子，并根据提到的区域/播放器、请求的来源区域或默认播放器来确定目标播放器。提示可以根据每个模型进行调整。

• 选项3：由LLM集成作为工具使用的脚本 – 一个可以被具有家庭控制权的LLM集成作为工具调用的脚本。LLM根据其描述决定何时使用该脚本。没有必需的句子格式；LLM解释任何请求并提取参数，如媒体类型、艺术家、专辑、区域等。这适用于任何语言，因为只有描述是英文的。

适用人群

这适用于已安装Music Assistant并希望通过语音控制音乐播放的Home Assistant用户。它适合熟悉导入蓝图和配置自动化的爱好者。根据所需的灵活性，他们可以在严格的本地设置、LLM增强的自动化或基于脚本的工具之间进行选择。

亮点

• 三个不同的选项以满足不同需求：仅本地、LLM增强和LLM作为工具。
• 蓝图提供多种语言版本（荷兰语、英语、德语、葡萄牙语、西班牙语、意大利语、斯洛伐克语、匈牙利语、法语）。
• 社区驱动的项目，鼓励贡献和反馈。
• 每个选项都包含可配置的设置，如默认播放器、电台模式、提示和触发句子。
• 每个选项都有广泛的使用示例，展示简单和复杂的语音命令。
• 脚本选项适用于任何可以访问Home Assistant的LLM集成，并且命令可以使用任何语言。