智谱清言 AI Home Assistant 🏡

通知：本项目未经允许严禁商用，你可以隐晦但不能作为盈利手段。

📦 安装步骤

1. HACS 添加自定义存储库

在 Home Assistant 的 HACS 中，点击右上角的三个点，选择“自定义存储库”，并添加以下 URL：

https://github.com/knoop7/zhipuai

2. 添加智谱清言集成

进入 Home Assistant 的“集成”页面，搜索并添加“智谱清言”。

3. 配置 Key 🔑

在配置页面中，你可以通过手机号登录获取 Key。获取后，直接填写 Key 使用，不需要进行额外验证。
注意：建议你新建一个 Key，避免使用系统默认的 Key。

4. 免费模型使用 💡

智谱清言默认选择了免费模型，完全免费，不用担心收费。如果你有兴趣，还可以选择其他付费模型来体验更丰富的功能。

5. 版本兼容性 📅

请确保 Home Assistant 的版本不低于 8.0，因为智谱清言主要针对最新版本开发。如果遇到无法识别的实体问题，建议重启系统或更新至最新版本。

🛠 模型指令使用示例

为了保证大家能使用舒畅，并且不出任何bug可以使用我的模版指令进行尝试


作为 Home Assistant 的智能家居管理者，你的名字叫“自定义”，我将为您提供智能家居信息和问题的解答。请查看以下可用设备、状态及操作示例。


### 可用设备展示


# 注意如果实体超过1000以上
# 直接删掉这句话

### 今日油价：
```yaml
{% set sensor = 油价实体 %}
Sensor: {{ sensor.name }}
State: {{ sensor.state }}

Attributes:
{% for attribute, value in sensor.attributes.items() %}
  {{ attribute }}: {{ value }}
{% endfor %}
```

### 电费余额信息：
```yaml
{% set balance_sensor = 电费实体 %}

{% if balance_sensor %}
当前余额: {{ balance_sensor.state }} {{ balance_sensor.attributes.unit_of_measurement }}
{% endif %}
```

### Tasmota能源消耗：
```yaml
{% set today_sensor = states.sensor.tasmota_energy_today %}
{% set yesterday_sensor = states.sensor.tasmota_energy_yesterday %}

{% if today_sensor is not none and yesterday_sensor is not none %}
今日消耗: {{ today_sensor.state }} {{ today_sensor.attributes.unit_of_measurement }}
昨日消耗: {{ yesterday_sensor.state }} {{ yesterday_sensor.attributes.unit_of_measurement }}
{% endif %}
```


### 此时天气：
```json
{% set entity_id = '天气实体' %}
{% set entity = states[entity_id] %}
{
  "state": "{{ entity.state }}",
  "attributes": {
    {% for attr in entity.attributes %}
      {% if attr not in ['hourly_temperature', 'hourly_skycon', 'hourly_cloudrate', 'hourly_precipitation'] %}
        "{{ attr }}": "{{ entity.attributes[attr] }}"{% if not loop.last %},{% endif %}
      {% endif %}
    {% endfor %}
  }
}

或者这个模版指令

### 可用设备展示
```csv
entity_id,name,state,category
{%- for entity in states if 'automation.' not in entity.entity_id and entity.state not in ['unknown'] and not ('device_tracker.' in entity.entity_id and ('huawei' in entity.entity_id or 'Samsung' in entity.entity_id)) and 'iphone' not in entity.entity_id and 'daily_english' not in entity.entity_id and 'lenovo' not in entity.entity_id and 'time' not in entity.entity_id and 'zone' not in entity.entity_id and 'n1' not in entity.entity_id and 'z470' not in entity.entity_id and 'lao_huang' not in entity.entity_id and 'lao_huang_li' not in entity.entity_id and 'input_text' not in entity.entity_id and 'conversation' not in entity.entity_id  and 'camera' not in entity.entity_id  and 'update' not in entity.entity_id and 'IPhone' not in entity.entity_id and 'mac' not in entity.entity_id and 'macmini' not in entity.entity_id and 'macbook' not in entity.entity_id and 'ups' not in entity.entity_id and 'OPENWRT' not in entity.entity_id  and 'OPENWRT' not in entity.entity_id%}
{%- set category = '其他' %}
{%- if 'light.' in entity.entity_id %}{% set category = '灯' %}
{%- elif 'sensor.' in entity.entity_id and 'battery' in entity.entity_id %}
    {% set category = '电池' %}
{%- elif 'sensor.' in entity.entity_id and 'sun' in entity.entity_id %}
    {% set category = '太阳' %}
{%- elif 'sensor.' in entity.entity_id and ('motion' in entity.entity_id or 'presence' in entity.entity_id) %}
    {% set category = '人体存在' %}
{%- elif 'sensor.' in entity.entity_id and ('motion' in entity.entity_id or 'presence' in entity.entity_id) %}
    {% set category = '人体存在' %}
{%- elif 'climate.' in entity.entity_id %}{% set category = '空调' %}
{%- elif 'media_player.' in entity.entity_id %}{% set category = '媒体播放器' %}
{%- elif 'cover.' in entity.entity_id %}{% set category = '门窗' %}
{%- elif 'lock.' in entity.entity_id %}{% set category = '门锁' %}
{%- elif 'switch.' in entity.entity_id %}{% set category = '开关' %}
{%- elif 'sensor.' in entity.entity_id %}{% set category = '传感器' %}
{%- elif 'watering.' in entity.entity_id %}{% set category = '浇花器' %}
{%- elif 'fan.' in entity.entity_id %}{% set category = '风扇' %}
{%- elif 'air_quality.' in entity.entity_id %}{% set category = '空气质量' %}
{%- elif 'vacuum.' in entity.entity_id %}{% set category = '扫地机器人' %}
{%- elif 'person.' in entity.entity_id %}{% set category = '人员' %}
{%- elif 'binary_sensor.' in entity.entity_id and ('door' in entity.entity_id or 'window' in entity.entity_id) %}{% set category = '门窗' %}
{%- elif 'gas.' in entity.entity_id %}{% set category = '天然气' %}
{%- elif 'energy.' in entity.entity_id %}{% set category = '用电量' %}
{%- elif 'script.' in entity.entity_id %}{% set category = '脚本' %}
{%- elif 'scene.' in entity.entity_id %}{% set category = '场景' %}
{%- endif %}
{{- entity.entity_id }},{{ entity.name }},{{ entity.state }},{{ category }}
{%- endfor %}

使用内置 API 公开实体 🌐

你可以使用智谱清言内置的 API 来公开实体，并为其设置别名。通过重新命名实体，你可以避免使用系统默认名称造成的混乱，提升管理效率。

🚀 使用指南

访问界面
打开 Home Assistant 仪表板，找到“智谱清言”集成卡片或对应的集成页面。
输入指令
在集成页面或对话框中，输入自然语言指令，或使用语音助手下达命令。
查看响应
系统会根据你的指令执行任务，设备状态变化将实时显示并反馈。
探索功能
你可以尝试不同的指令来控制家中的智能设备，或查询相关状态。

📑 常用指令示例

"打开客厅灯"
"将卧室温度调到 22 度"
"播放音乐"
"明早 7 点提醒我备忘"
"检查门锁状态"
"看看全屋温度湿度“

🛠 Bug 处理

如果你在使用过程中遇到持续的 Python 错误，建议重启对话框并重新加载环境。这样可以解决一些潜在的代码问题。

🗂 处理不被 Home Assistant 认可的实体

如果 Home Assistant 中存在不被认可的实体，你可以将这些实体剔除出自动化控制的范围。通过在指令中添加 Jinja2 模板，可以有效避免 Python 的错误提示，杜绝潜在问题。

额外提示

系统版本要求：智谱清言需要 Home Assistant 至少 8.0 版本支持。
建议：如果遇到兼容性问题，建议重启或更新系统。通常这能解决大多数问题。
相关项目 如果需要语音转文字可以使用免费在线AI模型集成，个人二次深度修改 https://github.com/knoop7/groqcloud_whisper

📊 实时状态

当前时间：16:09:23，今日日期：2024-10-12。

油价信息 ⛽

92号汽油：7元/升
95号汽油：7元/升
98号汽油：8元/升
预计下次油价调整时间为10月23日24时，油价可能继续上涨。

电费余额 ⚡

当前余额：27.5元

今日能源消耗 💡

今日消耗：4033.0 Wh
昨日消耗：7.558 kWh

今日新闻摘要 📰

民政部发布全国老年人口数据。