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 个后端（云端和本地）。温度、最大令牌数和自定义端点均可配置。
• 自定义提示和过滤器 – 限制域、排除实体/区域、设置实体限制或添加一次性自定义指令。
• 持久建议历史 – 每个建议存储使用的模型、令牌使用量、警告和审查状态（接受/拒绝/忽略）。
• 仪表板就绪输出 – 传感器属性包含人类可读的描述和原始 YAML 块，便于构建 Lovelace 卡片。
• 随机实体选择 – 防止相同想法重复出现。
• 基于服务的触发 – 调用 ai_automation_suggester.generate_suggestions 并带有可选参数，可按需或从自动化（每周审查、新实体检测、启动等）运行。

安装

1. 如果您还没有安装 HACS（Home Assistant 社区商店），请先安装。
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。