music-assistant/voice-support

解決する問題

Home Assistantには、音楽やメディア制御のインテントが非常に限られており、特に音声による音楽再生の開始に関しては不十分です。このプロジェクトは、Home Assistant AssistとMusic Assistantの間のギャップを埋め、音楽再生の完全な音声制御を可能にするコミュニティ駆動のスクリプト、ブループリント、ハウツーを提供します。

仕組み

このリポジトリは、それぞれ異なる柔軟性とセットアップ要件を持つ3つのオプションを提供します。

• オプション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の3つの異なるオプションでさまざまなニーズに対応。
• ブループリントは複数の言語（オランダ語、英語、ドイツ語、ポルトガル語、スペイン語、イタリア語、スロバキア語、ハンガリー語、フランス語）で利用可能。
• コミュニティ駆動のプロジェクトで、貢献とフィードバックを奨励。
• 各オプションには、デフォルトプレイヤー、ラジオモード、プロンプト、トリガー文などの設定可能な設定が含まれています。
• 各オプションの広範な使用例があり、単純な音声コマンドと複雑な音声コマンドの両方を示しています。
• スクリプトオプションは、Home Assistantにアクセスできる任意のLLM統合で動作し、コマンドは任意の言語で使用できます。