ITSpecialist111/ai_automation_suggester

AI Automation Suggester – Home Assistant 統合

概要 – 公式スタイルの Home Assistant カスタム統合で、大規模言語モデル（LLM）を呼び出して現在の Home Assistant 設定（エンティティ、デバイス、エリア、既存のオートメーション）を確認し、貼り付け可能な YAML オートメーションスニペットを返します。OpenAI 互換のプロバイダー（OpenAI、Anthropic、Google Gemini、Groq、Ollama、LocalAI など）で動作し、提案を永続通知、センサー属性、またはバンドルされた Lovelace カードとして表示します。

必要な理由

• 大規模な Home Assistant 設定はすぐに理解しにくくなり、役立つオートメーションを見逃す可能性があります。
• 複雑な YAML を手動で書くのは、特に初心者にとって面倒です。
• この統合は、お持ちの正確なデバイスに合わせたコンテキスト認識のアイデア（省エネ、セキュリティ、快適性）を提供し、時間を節約し、新しいオートメーションを刺激します。

仕組み（ステップバイステップ）

1. スナップショット – オンデマンド（または Home Assistant オートメーションを介して）統合は、エンティティ、デバイス、エリア、既存のオートメーションのスナップショットを収集します。ドメインでフィルタリングしたり、エンティティ数を制限したり、特定の項目を除外したりできます。
2. プロンプト構築 – スナップショットはシステムプロンプトに挿入されます。出力を導くためにカスタムプロンプトを追加できます（例：「在室照明に焦点を当てる」）。
3. プロバイダー呼び出し – プロンプトは選択した AI プロバイダー（OpenAI、Anthropic、Gemini、Groq、Ollama など）に送信されます。温度、モデル、トークン制限、エンドポイントは設定可能です。
4. 解析 – 統合はモデルに構造化 JSON を要求します。失敗した場合はフェンス付き YAML 解析にフォールバックし、YAML を検証して切り捨て警告を記録します。
5. 表示 – 結果の提案は、Home Assistant の永続通知、センサーの属性として表示され、バンドルされたダッシュボードカードが読み取れる履歴ログに保存されます。

主な機能

• モデル非依存 – 100 以上のバックエンド（クラウドおよびローカル）で動作します。温度、最大トークン数、カスタムエンドポイントは設定可能です。
• カスタムプロンプトとフィルター – ドメインを制限したり、エンティティ/エリアを除外したり、エンティティ制限を設定したり、1 回限りのカスタム指示を追加したりできます。
• 永続的な提案履歴 – 各提案には、使用されたモデル、トークン使用量、警告、レビューステータス（承認/拒否/却下）が保存されます。
• ダッシュボード対応出力 – センサー属性には人間が読める説明と生の YAML ブロックが含まれ、Lovelace カードの構築が容易です。
• ランダム化されたエンティティ選択 – 同じアイデアが繰り返し表示されるのを防ぎます。
• サービスベースのトリガー – ai_automation_suggester.generate_suggestions をオプションのパラメータ付きで呼び出し、オンデマンドまたはオートメーション（毎週のレビュー、新エンティティ検出、起動時など）から実行できます。

インストール

1. HACS（Home Assistant Community Store）をまだインストールしていない場合はインストールします。
2. HACS → 統合 で + ボタンをクリックし、AI Automation Suggester を検索してインストールします。
3. Home Assistant を再起動します。
4. 設定 → デバイスとサービス → 統合の追加 → AI Automation Suggester から統合を追加します。
   • （または、custom_components/ai_automation_suggester フォルダーを custom_components ディレクトリにコピーして再起動します。）

設定

• ドロップダウンから AI プロバイダーを選択します。
• 必要な API キーまたはローカルエンドポイント URL を入力します。
• モデルを選択し、温度（0.0〜2.0、デフォルト 0.7）を設定し、最大入力/出力トークンを定義します。
• オプションで、モデルに特定の性格や焦点を与えるカスタムシステムプロンプトを提供します。
• すべてのオプションは、統合のオプションページで後から編集できます。

一般的な使用法

• 手動 – 開発者ツール → サービス を開き、ai_automation_suggester.generate_suggestions を呼び出します（all_entities: true、entity_limit: 50、custom_prompt: "夜間照明オートメーションを提案" などのパラメータを渡せます）。
• 自動 – スケジュール（例：毎週）または新エンティティ追加などのイベントで同じサービスを呼び出す Home Assistant オートメーションを作成します。
• 通知またはセンサーカードで提案を確認し、YAML を automations.yaml にコピーして有効にします。

前提条件

• Home Assistant 2024.1 以降。
• LLM プロバイダーへのアクセス（クラウド API キーまたは Ollama/LocalAI などの実行中のローカルサーバー）。

安全上の注意 – この統合は自動的にオートメーションを書き込むことはありません。YAML を自分で確認して適用する必要があるため、意図しない変更のリスクはありません。

---

この要約はリポジトリの README のみに基づいています。