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은 모든 요청을 해석하고 media_type, artist, album, area 등의 매개변수를 추출합니다. 설명만 영어로 되어 있으므로 모든 언어에서 작동합니다.

대상 사용자

이것은 Music Assistant가 설치되어 있고 음성으로 음악 재생을 제어하려는 Home Assistant 사용자를 위한 것입니다. 블루프린트 가져오기 및 자동화 구성에 익숙한 취미 사용자에게 적합합니다. 원하는 유연성에 따라 엄격한 로컬 설정, LLM 강화 자동화 또는 스크립트 기반 도구 중에서 선택할 수 있습니다.

주요 특징

• 로컬 전용, LLM 강화, LLM-as-tool의 세 가지 옵션으로 다양한 요구 사항 충족.
• 블루프린트는 여러 언어(네덜란드어, 영어, 독일어, 포르투갈어, 스페인어, 이탈리아어, 슬로바키아어, 헝가리어, 프랑스어)로 제공됩니다.
• 커뮤니티 기반 프로젝트로 기여와 피드백을 장려합니다.
• 각 옵션에는 기본 플레이어, 라디오 모드, 프롬프트 및 트리거 문장과 같은 구성 가능한 설정이 포함됩니다.
• 각 옵션에 대한 광범위한 사용 예제가 있으며 간단한 음성 명령과 복잡한 음성 명령을 모두 보여줍니다.
• 스크립트 옵션은 Home Assistant에 액세스할 수 있는 모든 LLM 통합에서 작동하며 명령은 모든 언어로 사용할 수 있습니다.