添加智谱清言集成
进入 Home Assistant 的"集成"页面,搜索并添加"智谱清言"。
配置 Key
在配置页面中,你可以通过手机号登录获取 Key。获取后,直接填写 Key 使用,不需要进行额外验证。  
注意:建议你新建一个 Key,避免使用系统默认的 Key。
免费模型使用
智谱清言默认选择了免费模型,完全免费,不用担心收费。如果你有兴趣,还可以选择其他付费模型来体验更丰富的功能。
版本兼容性
请确保 Home Assistant 的版本不低于 11.0,因为智谱清言主要针对最新版本开发。如果遇到无法识别的实体问题,建议重启系统或更新至最新版本。
集成概述
核心特点
智能分层处理:系统按优先级依次尝试服务调用、意图识别和AI对话三种处理方式
自然语言交互:支持日常用语控制家居设备,无需记忆复杂命令
上下文感知:能够理解对话历史和设备状态,提供连贯的交互体验
安全可靠:内置冷却机制和错误处理,确保系统稳定运行
基础控制:灯开关、温度调节、音乐播放等基础控制
场景管理:一键触发预设场景,如回家模式、观影模式等
状态查询:了解设备运行状态、历史数据分析等
智能建议:基于使用习惯和环境数据提供优化建议  
配置说明
API设置
- API密钥:从智谱AI官网获取,用于访问API服务
 
- 聊天模型:选择合适的模型版本
- 推荐使用免费通用128K模型
 
- 可选其他付费模型以获得更好体验
 
- 实际使用费用较低,详见官网计费标准
 
 
性能参数
- 最大令牌数:控制响应长度
 
- 温度:控制输出随机性(0-2)
 
- Top P:控制输出多样性(0-1)
 
- 请求超时:设置AI响应等待时间(10-120秒)
 
高级功能
对话管理
- 最大历史消息数:
- 控制上下文对话的记忆量
 
- 设备控制建议保持在5次以内
 
- 日常对话可设置10次以上
 
- 影响对话连贯性和系统性能
 
 
系统控制
- 最大工具迭代次数:
- 单次对话中的最大工具调用次数
 
- 建议设置在20-30次
 
- 防止系统因过多调用而卡死
 
- 特别适合性能较弱的小主机
 
 
请求管理
- 冷却时间:
- 两次请求的最小间隔(0-10秒)
 
- 建议设置在3秒以内
 
- 防止因频率过高导致请求失败
 
- 优化系统响应稳定性
 
 
扩展功能
数据分析
- 历史数据分析:
- 可选择需要分析的实体
 
- 设置历史数据天数(1-15天)
 
- 提供设备使用趋势分析
 
- 支持智能建议生成
 
 
网络功能
- 互联网分析搜索:
- 可选开启在线搜索能力
 
- 提供更广泛的信息支持
 
- 增强回答准确性
 
- 实时获取最新信息
 
 
Home Assistant集成
- LLM API集成:
- 可选择启用LLM API
 
- 支持更多自定义功能
 
- 增强与Home Assistant的协同
 
- 提供更灵活的控制选项
 
 
模板定制
提示词模板
- 支持自定义提示词
 
- 指导LLM响应方式
 
- 可使用模板语法
 
- 优化交互效果
 
模型指令使用示例
为了保证大家能使用舒畅,并且不出任何bug也可以使用我的模版指令进行尝试。
作为 Home Assistant 的智能家居管理者,你的名字叫“自定义”,我将为您提供智能家居信息和问题的解答。请查看以下可用设备、状态及操作示例。
### 今日油价:
{% set sensor = 油价实体 %}
Sensor: {{ sensor.name }}
State: {{ sensor.state }}
Attributes:
{% for attribute, value in sensor.attributes.items() %}
{{ attribute }}: {{ value }}
{% endfor %}
### 电费实体:
{% set balance_sensor = 电费实体 %}
{% if balance_sensor %}
当前余额: {{ balance_sensor.state }} {{ balance_sensor.attributes.unit_of_measurement }}
{% endif %}
### Tasmota能源消耗:
{% 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 %}
### 此时天气:
{% 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 %}
}
}
处理流程详解
共计有三个处理机制,分别为:一、内置LLM结合集成实现的服务调用、二、自定义意图识别、三、多元化AI对话,LLMAPI内置意图,服务调用识别是系统的第一道处理机制,专门用于处理直接的设备控制命令,可以帮助系统更快地响应用户的控制需求(毫秒级操作逻辑)属于结合搭配原本内置LLM的能力。
原本支持有:
- 
基础控制:
- 开关控制:打开/关闭设备 (HassTurnOn/HassTurnOff)
 
- 状态查询:获取设备状态 (HassGetState)
 
- 取消操作:取消当前操作 (HassNevermind)
 
- 系统响应:获取系统回应 (HassRespond)
 
 
- 
设备控制:
- 位置设置:调整设备位置 (HassSetPosition)
 
- 灯光控制:设置灯光参数 (HassLightSet)
 
- 温度查询:获取温度信息 (HassClimateGetTemperature)
 
- 真空吸尘器:启动/返回充电 (HassVacuumStart/HassVacuumReturnToBase)
 
 
- 
媒体控制:
- 播放控制:暂停/继续/下一个/上一个 (HassMediaPause/HassMediaUnpause/HassMediaNext/HassMediaPrevious) |(补充控制词已实现)
 
- 音量控制:设置音量 (HassSetVolume) |(补充控制词已实现)
 
 
- 
时间相关:
- 时间查询:获取当前日期/时间 (HassGetCurrentDate/HassGetCurrentTime)
 
- 定时器控制:
 
- 基础操作:开始/取消/暂停/继续 (HassStartTimer/HassCancelTimer/HassPauseTimer/HassUnpauseTimer) |(本集成中已实现自定义意图)
 
- 时间调整:增加/减少时间 (HassIncreaseTimer/HassDecreaseTimer)  |(本集成中已实现自定义意图)
 
- 批量操作:取消所有定时器 (HassCancelAllTimers) |(本集成中已实现自定义意图)
 
- 状态查询:获取定时器状态 (HassTimerStatus) |(本集成中已实现自定义意图)
 
 
- 
列表管理:
- 购物清单:添加商品 (HassShoppingListAddItem)
 
- 通用列表:添加项目 (HassListAddItem)
 
 
- 
环境信息:
- 天气查询:获取天气信息 (HassGetWeather) |(本集成中已实现联网查询在线天气)
 
 
- 
已弃用功能:
- 窗帘控制:打开/关闭窗帘 (HassOpenCover/HassCloseCover) |(本集成中自定义意图已实现)
 
- 开关切换:切换设备状态 (HassToggle)|(补充控制词已实现)
 
- 加湿器控制:设置湿度/模式 (HassHumidifierSetpoint/HassHumidifierMode) |(本集成中自定义意图已实现)
 
- 购物清单:获取最近项目 (HassShoppingListLastItems) | (本集成中未实现,实际使用人数不多为弃用状态)
 
 
接着是补充实现的功能:
- 
控制词识别增强
- 请求词扩展增加:
 - 基础请求:让、请、帮我、麻烦、把、将
 - 意愿表达:要、想、希望、需要
 - 能力询问:能否、能不能、可不可以、可以
 - 协助请求:帮忙、给我、替我、为我
 - 主动表达:我要、我想、我希望
- 控制词分类增加:
 - 开启类:打开、开启、启动、激活、运行、执行、调用、执行
 - 关闭类:关闭、关掉、停止
 - 切换类:切换
 - 按键类:按、按下、点击
 - 选择类:选择、下一个、上一个、第一个、最后一个
 - 触发类:触发、调用、执行、自动化、脚本
 - 媒体类:暂停、继续播放、播放、停止、下一首、上一首、切歌等
- 
语法结构:
- 基本格式:[控制词] + [设备/区域] + [动作词]
 
- 扩展格式:[控制词] + [区域] + [设备名称] + [动作词] + [参数]
 
 
- 
示例:
- "请打开客厅灯光1"
 
- "帮我把空调调到26度制冷模式"
 
- "将阳台的窗帘关闭"
 
- "帮我我按下按钮"
 
- "请我选择第三个选项"
 
- "触发脚本"
 
- "调用自动化"
 
- "请播放音乐"
 
- "请我调整音量到50%"
 
- "设备数字400"
 
- "设备设置数值500"
 
 
 
- 
服务调用映射
domain: media_player
services:
- media_pause: 暂停播放
- media_play: 继续播放/开始播放
- media_stop: 停止播放
- media_next_track: 下一首/下一曲/切歌/换歌
- media_previous_track: 上一首/上一曲/返回上一首
- volume_set: 设置音量(支持百分比)
功能特点:
- 完整的媒体控制链路
- 精确的播放状态管理
- 音量精确控制(支持百分比和相对调节)
- 智能的播放列表管理
 
- 
按键设备控制
domain: button
services:
- press: 按下按键
功能特点:
- 支持所有button类型设备
- 支持实体ID直接调用
- 支持模糊名称匹配
- 智能按键操作确认
 
- 
选择器控制
domain: select
services:
- select_next: 选择下一个(支持循环)
- select_previous: 选择上一个(支持循环)
- select_first: 选择第一个
- select_last: 选择最后一个
- select_option: 选择指定选项
功能特点:
- 支持循环选择模式
- 支持直接选择操作
- 智能选项匹配
- 状态自动同步
 
- 
自动化与场景控制
domains: script/automation/scene
services:
- script.turn_on: 运行脚本
- automation.trigger: 触发自动化
- scene.turn_on: 激活场景
功能特点:
- 智能场景识别
- 自动化任务管理
- 场景状态同步
- 执行状态跟踪
 
- 
数值设备控制
domain: number
services:
- set_value: 设置数值
功能特点:
- 支持精确数值设置
- 支持小数点数值
- 智能范围验证
- 单位自动转换
 
未来会增加更多的服务调用映射,以支持更加丰富的设备控制能力。
2. AI自定义意图识别(第二优先级)
如果无法识别为具体的服务调用,系统会尝试理解用户的更广泛意图。这一层处理能够处理更复杂的用户需求,支持自由的语言理解能力,并且会先让AI去处理接着启用工具类调用操作,支持各种复杂情况下解决用户需求。负责将理解到的用户意图转化为具体的执行动作。根据语义分析的结果,系统会将用户请求分类到不同的处理模块:可能是空调、窗帘、电视等设备的直接控制指令,或是休息、娱乐、工作等场景的管理命令,又或是天气、新闻、日程等信息的查询请求,以及摄像头画面、传感器数据等的智能分析任务。通过这种智能分发机制,系统能够精确地执行用户的各类需求,提供流畅的智能家居体验。
现已经实现有:摄像头分析、定时控制、定时器管理、联网查找相关资讯等、通知备忘录、
功能示例
- 
AI 摄像头分析意图
用户说:"帮我分析下门口摄像头的画面"
系统会:
- 调用摄像头服务
- 进行AI图像分析
- 返回分析结果
 
- 
AI 通知控制意图
用户说:"通知我今天是妈妈的生日,明天需要处理下日常缴费"
系统会:
- 解析时间信息
- 设置定时器
- 创建提醒通知
 
- 
AI 定时任务管理
用户说:
- "一小时后提醒我关窗"
- "设置一个晚上8点的睡觉提醒"
- "明天早上7点提醒我打开窗帘"
系统会:
- 时间识别:解析具体时间点
- 任务提取:确定提醒内容
- 定时设置:创建定时任务
- 通知管理:设置提醒方式
请注意需要到系统中辅助元素生成定时器实体,并且设置 cron 表达式为 64:00:00 的定时器,可以用来修改用于存储定时任务的执行时间。
 
- 
AI 联网查找相关资讯
场景五:在线信息搜索
用户说:
- "联网搜索今天的天气预报"
- "帮我查查昨天的新闻"
- "上网查找最近的股市行情"
- "网上搜索今天的体育赛事"
- "互联网查询北京今天的路况"
系统会:
- 识别查询类型:确定搜索主题
- 时间范围解析:处理时间相关信息
- 在线数据获取:访问相关信息源
- 信息整理:筛选和组织搜索结果
- 智能总结:生成简洁的信息摘要
 
- 
AI 环境类设备控制
用户说:
- "把卧室的温度调到26度制冷模式"
- "将客厅的温度调高一点"
- "把主卧空调的风速调到高档"
- "客厅的窗帘打开到一半"
- "把所有窗帘都关上"
- "主卧的窗帘开到70%"
系统会:
- 设备识别:定位具体设备和位置
- 参数解析:处理温度、模式、风速等参数
- 状态确认:检查当前设备状态
- 执行控制:发送精确的控制指令
- 反馈确认:验证操作是否成功
注意:系统会智能判断设备类型(如空调、窗帘等),并根据不同设备类型调用对应的控制接口和参数设置。对于百分比类的控制(如窗帘开合度),系统会自动进行数值转换和范围限制。
 
未来会增加更多的AI自定义意图识别,以支持更加丰富的设备控制能力。
3. AI对话回复各种世界相关 + 系统设备状态问题(第三优先级)
作为系统的最后一道处理机制,当前两层无法处理用户需求时,系统会启动AI对话模式。这一层具有语言理解和知识处理能力,可以处理各类开放性问题和复杂对话场景。并且可以分析家中和设备相关问题,提供有用的建议和解决方案。已经将系统中所有的设备都接入进去,更多需要用户自己去步骤:配置 - 语音助手 - 公开新实体(是否公开新实体?公开显示受支持的、且未被归类为 "安全设备" 的设备。)勾选,并且公开实体,这样就可以使用AI对话回复各种世界相关问题了,已经默认增加空调相关属性值,后续将版本更新继续添加重要的智能设备产品的属性值
其次,系统会根据用户的对话历史和设备状态,进行连贯的对话回复,提供更加流畅的交互体验。可以在 智谱清言  - 配置选项 - 勾选历史记录分析,支持1-15天各类相关描述询问,相当于全屋智能家居的知识库,提供更加丰富的对话回复能力,更加满足用户的需求
智能家居对话能力
- 
设备使用咨询
用户可以了解:
- 设备使用:"如何让空调更省电?"
- 场景推荐:"晚上睡觉温度应该设置多少?"
- 智能联动:"可以设置哪些自动化?"
- 功能探索:"这个设备还有什么功能?"
系统会:
- 提供使用指导
- 推荐最佳实践
- 分享场景方案
- 介绍新功能
 
- 
数据分析查询
用户可以查询:
- 能耗统计:"这个月的用电量比上月如何?"
- 行为分析:"我们家经常用什么电器?"
系统会:
- 统计历史数据
- 生成趋势报告
- 对比分析结果
- 提供优化建议
 
通用知识问答能力
- 
科技与自然
用户可以询问:
- 科技前沿:"最新的人工智能发展如何?"
- 自然科学:"为什么会有地震发生?"
- 生活百科:"如何正确护理皮肤?"
系统会:
- 提供准确信息
- 解释原理机制
- 举例说明
- 推荐延伸阅读
 
- 
实时资讯
用户可以了解:
- 新闻动态:"最近有什么重要新闻?"
- 天气信息:"明天天气怎么样?"
- 体育赛事:"最近有什么重要比赛?"
- 娱乐资讯:"最新的电影推荐"
系统会:
- 获取最新信息
- 提供简要概述
- 分析重要影响
- 推荐相关内容
 
- 
生活服务
用户可以咨询:
- 健康建议:"如何保持良好的作息习惯?"
- 美食烹饪:"红烧肉怎么做最好吃?"
- 旅游攻略:"周边有什么好玩的地方?"
- 生活技巧:"如何整理房间更有效率?"
系统会:
- 提供实用建议
- 分享经验技巧
- 推荐具体方案
- 注意事项提醒
 
注意:系统会通过智能分析和在线搜索,为用户提供最新、最准确的信息。对于需要专业判断的问题(如医疗、法律等),建议仅作参考,并咨询相关专业人士。
服务类调用器
智谱清言集成提供了多个强大的服务调用器,可以通过 Home Assistant 的服务调用界面或自动化使用:
1. 图像分析服务 (image_analyzer)
service: zhipuai.image_analyzer
data:
  model: "glm-4v-flash"  # 必选,可选值:glm-4v-plus、glm-4v、glm-4v-flash
  message: "请描述这张图片的内容"  # 必选,给模型的提示词
  image_file: "/config/www/tmp/front_door.jpg"  # 可选,本地图片路径
  image_entity: "camera.front_door"  # 可选,图片或摄像头实体
  temperature: 0.8  # 可选,控制输出随机性(0.1-1.0)
  max_tokens: 1024  # 可选,限制生成文本长度
  stream: false  # 可选,是否使用流式响应
功能特点:
- 支持多种图像分析模型
 
- 可分析本地图片或摄像头实体
 
- 支持流式响应实时返回结果
 
- 图片格式支持jpg、png、jpeg(最大5MB,最大分辨率6000x6000像素)
 
2. 视频分析服务 (video_analyzer)
service: zhipuai.video_analyzer
data:
  model: "glm-4v-plus"  # 可选,仅支持 glm-4v-plus
  message: "请描述这段视频的内容"  # 必选,提示词
  video_file: "/config/www/tmp/video.mp4"  # 必选,本地视频文件路径
  temperature: 0.8  # 可选,控制输出随机性
  max_tokens: 1024  # 可选,限制生成文本长度
  stream: false  # 可选,是否使用流式响应
功能特点:
- 专业视频内容分析
 
- 支持mp4格式视频
 
- 建议视频时长不超过30秒
 
- 实时流式响应选项
 
3. 图像生成服务 (image_gen)
service: zhipuai.image_gen
data:
  prompt: "一只可爱的小猫咪"  # 必选,图像描述
  model: "cogview-3-flash"  # 可选,默认使用免费的 cogview-3-flash
  size: "1024x1024"  # 可选,图片尺寸
支持的模型:
- CogView-3 Plus
 
- CogView-3
 
- CogView-3 Flash (免费版)
 
支持的尺寸:
- 1024x1024
 
- 768x1344
 
- 864x1152
 
- 1344x768
 
- 1152x864
 
- 1440x720
 
- 720x1440
 
4. 联网搜索服务 (web_search)
service: zhipuai.web_search
data:
  query: "今日新闻摘要"  # 必选,搜索内容
  stream: false  # 可选,是否使用流式响应
功能特点:
- 使用智谱AI的web-search-pro工具
 
- 支持实时流式响应
 
- 提供准确的搜索结果
 
5. 实体分析服务 (entity_analysis)
service: zhipuai.entity_analysis
data:
  entity_id: 
    - "sensor.living_room_temperature"
    - "binary_sensor.motion_sensor"  # 必选,支持多个实体
  days: 3  # 可选,分析天数(1-15天)
功能特点:
- 支持多实体同时分析
 
- 灵活的历史记录查询
 
- 适用于各类传感器数据分析
 
- 支持1-15天的数据范围
 
使用示例
- 
智能摄像头图像分析
automation:
trigger:
platform: state
entity_id: binary_sensor.front_door_motion
to: "on"
action:
service: zhipuai.image_analyzer
data:
  model: "glm-4v-flash"
  message: "分析是否有人在门口,详细描述看到的场景"
  image_entity: camera.front_door
  stream: true
 
- 
定期生成天气艺术图
automation:
trigger:
platform: time
at: "08:00:00"
action:
service: zhipuai.image_gen
data:
  prompt: "{{states('weather.home')}}天气的艺术表现"
  model: "cogview-3-flash"
  size: "1024x1024"
 
- 
智能家居数据分析
automation:
trigger:
platform: time_pattern
hours: "/12"
action:
service: zhipuai.entity_analysis
data:
  entity_id: 
    - sensor.living_room_temperature
    - sensor.living_room_humidity
  days: 7
 
注意事项
- 图片和视频文件需要确保Home Assistant有访问权限
 
- 视频分析建议使用较短的视频以获得更好的效果
 
- 使用流式响应可以获得更好的实时体验,但会增加系统负载
 
- 图像生成服务建议使用免费的Flash版本开始尝试
 
- 实体分析服务的天数建议根据实际需求选择,避免分析过多历史数据
 
最近更新
2025.05.08更新
新增:多个模型,GLM-4-Plus, GLM-4-0520, GLM-4-Long, glm-zero-preview, GLM-Z1-Air, GLM-Z1-AirX, GLM-Z1-flash, GLM-Z1-flashX-250414, GLM-4-Flash, glm-4-flash-250414, glm-4-flashx-250414, CharGLM-4, GLM-4-Air, GLM-4-AirX, GLM-4-Air-250414, GLM-4-AllTools, GLM-4-Assistant, GLM-4-CodeGeex-4,建议已安装集成,选择 glm-4-flash-250414 体验新模型,注意新模型能力略显堪忧,如需要更好体验建议使用 GLM-4-Plus,现在 Plus 价格便宜,,可以免除没有微调的难(原本的免费模型由于微调对于大量工具指令是可以直接理解),但未来可能会flash默认模型官方删除。
新增功能
- 
新增:全面重构为流式响应,建议更新到最新IOS安卓版本Hass体验流式的响应,其中流式响应全面提升速度,提升速度80%,实现ChatGPT的实时流式输出,适配Home Assistant最新版本,增加TCP连接保持技术。集成中通过async_add_delta_content_stream实现了文本的实时流式传输,极大地提升了用户体验,使回答不再需要等待完整生成。
 
- 
新增:多工具调用增强,一次会话可执行多个连续动作,支持复杂指令执行,由于为了确保适配工具调用发挥作用,顺序调整为:多工具调用策略,实现了递归式的工具调用处理,支持复杂链式操作。通过ToolCallProcessor类,系统可以在单次对话中连续调用多个工具,使处理复杂控制指令变得可能。
 
- 
新增:策略模式,针对不同场景采用不同策略:流式/非流式响应策略:通过direct_stream、collect_stream和non_stream_request处理不同类型的API请求,消息处理策略:通过MessageFactory创建不同类型的消息。这种设计模式使系统可以灵活应对不同场景,提高代码复用性和可维护性。
 
- 
新增:上下文记忆管理,会话ID管理:使用ulid.ulid_now()生成唯一会话ID,确保上下文隔离,会话历史过滤:通过filtered_recent_messages过滤掉工具调用相关消息,保持对话连贯性。系统会智能记住用户的上下文信息,如上次使用的媒体播放器,使连续指令更加自然流畅。
 
- 
新增:动态工具调用,工具动态发现:根据用户输入通过get_tools_for_text动态加载相关工具,多工具链式调用:通过process方法支持工具间的递归调用和结果传递,工具调用跟踪:使用IdTracker跟踪已处理的工具调用,避免重复执行。系统可以根据用户意图智能选择和加载合适的工具,提高命令执行的精准度。
 
- 
新增:错误处理和弹性设计,优雅降级:当首选策略失败时,自动尝试备选策略,模型兼容性:识别Z1推理系列模型并自动禁用工具调用功能(暂时无法较好实现工具调用所以禁用增加提示词)异常包装:将底层异常转换为用户友好的消息。系统能够智能处理各种异常情况,确保即使在出错的情况下也能够提供有用的反馈。
 
- 
新增:提示词工程,动态提示词注入:根据关键词检测,动态注入相关提示词,提示词分层:系统提示词、工具描述提示词、动态提示词分层管理,指令优化:通过温度、top_p等参数调整精细控制模型行为。这些技术确保AI能够理解并正确执行复杂的用户意图。
 
- 
新增:搜索引擎,重构增加大量功能,支持更加智能选择。
<img width="859" alt="截屏2025-05-08 16 13 48" src="https://github.com/user-attachments/assets/4d5ea8a3-65ea-4d83-b08a-113da8eaf141" />
 
- 
新增:多个模型支持,建议已安装集成的用户选择glm-4-flash-250414体验新模型。这个新增的模型提供了更好的理解能力和更快的响应速度,极大提升了用户体验。
<img width="575" alt="截屏2025-05-08 16 09 16" src="https://github.com/user-attachments/assets/094315be-4fe2-408f-8035-9c01df3dba88" />
 
- 
新增:Markdown过滤器功能,可以自动过滤AI回复中的Markdown格式,使显示更加清晰整洁,特别适合在不支持Markdown格式的界面上使用。
<img width="575" alt="截屏2025-05-08 16 09 10" src="https://github.com/user-attachments/assets/c202209d-fa5f-453c-9a64-3fbd3d38cdd3" />
 
- 
新增:通知服务支持,用户可以配置自定义通知服务,AI可以通过这些服务发送通知到手机、电脑等多种设备,极大地增强了智能家居的交互能力和通知功能。通过简单的配置,您可以让AI主动向您推送重要信息。
<img width="575" alt="截屏2025-05-08 16 09 04" src="https://github.com/user-attachments/assets/32cac188-5d76-4729-8ab2-1956e0cf44f8" />
 
2025.01.20更新
主要修复
2025.01.19 更新
新增功能
使用方法,自动化或者脚本中复制粘贴使用
或者找到智谱清言:优先本地处理
action: zhipuai.process_with_ha
data:
  text: 打开灯光1
  language: zh-cn
  fallback_agent: conversation.zhi_pu_qing_yan
- 
新增:智能多命令执行进行依次执行,例如询问”20秒内,依次执行5次命令,打开灯光1、灯光2、灯光3、灯光4、灯光5“等等,智能化连续复杂性操作,可以应用自动化脚本操作,继续放权给AI,支持多任务复杂化操作
 
- 
新增:AI模型调整 "GLM-4-Plus", "glm-zero-preview","web-search-pro","GLM-4-0520", "GLM-4V","GLM-4-Long","GLM-4-Flash",
"GLM-4-FlashX","GLM-4-9B", "GLM-4-Air",  "GLM-4-AirX",   "GLM-4-AllTools",  "glm-4-Air-0111", "GLM-4","GLM-4-CodeGeex-4"(部分可能无法正常使用,建议首选128K免费默认)
 
其他修复
2025.01.16 更新
新增功能
- 
新增:支持 number实体 #1  聊天方式:实体+ “数字|数值” 多少数字即可
 
- 
新增:空调类型实体:迁移至新的意图控制,支持问询属性温度等、温湿度调节、风速、模式自动识别 #6  @hzcoolwind 谢谢你的建议!
 
- 
新增:聊天支持打开/关闭全部设备、窗帘 @紫易辰 谢谢你的建议!
 
- 
新增:智能多命令执行进行依次执行,例如询问”20秒内,依次执行5次命令,打开灯光1、灯光2、灯光3、灯光4、灯光5“等等智能化连续复杂性操作,可以应用自动化脚本操作!
 
- 
新增:改善性错误信息
 
其他修复
- 
主要修复:中国第一个解决LLM无法回答中文、本地处理命令的解决方案:命令将首先发送到本地对话代理。如果本地代理不处理该命令,则该命令将被发送到所选代理。(语言类完全解决,需要毫秒切换设备来控制家用产品,可以直接勾选复选框启用)
 
- 
修复:空调类硬编码控制移动到自定义意图
 
- 
修复:移除工具类调用8个限制,更具满足大众需求,因发现大家都会尝试复杂性操作,故而修正。并非是国产AI不行,所有类型的AI都会有幻觉问题
 
- 
修复:调整发送给AI的消息为JSON格式,更好的让AI精准定位设备,防止实体位置互相争权,会略微产生些许延迟毫秒延迟,因为为了精准而做出牺牲  #7   @hzcoolwind 谢谢你的建议!
 
- 
修复:日志格式化上问题
 
- 
修复:制造商为北京智谱华章科技有限公司,模型为ChatGLM AI
 
- 
修复:配置选项位置,选择模型为首位
 
- 
修复:翻译键文字描述
 
- 
修复:未知错误的人性化处理
 
- 
修复: 历史消息空调属性值备份添加
 
2025.01.14 更新
2025.01.13 更新
新增功能
- 历史实体数据:获取时间间隔自定义(默认10分钟,可以自调任意时间范围)
 
- 空调类实体:毫秒级全面控制
 
- 全面升级反馈词
 
其他修复
- 
重大修复:国内首创解决LLM无法回答中文,本地处理命令:命令将首先发送给本地对话代理。如果本地代理不处理此命令,则将命令发送给选定的代理。(语言类彻底解决,需要毫秒级开关设备控制家居产品,可以直接勾选启用)
 
- 
修复:东八区问题 #5  @hzcoolwind 感谢提醒,谢谢!
 
- 
修复:Jinja2模版错误反馈 @2016 感谢提醒,谢谢!
 
- 
修复:逻辑判断继续加强速度,关键类全面使用三元
 
- 
修复:数据库和异常AI通信类错误反馈
 
- 
修复:翻译键错误
 
- 
修复:日志和历史简化压缩
 
- 
删除:模版定义,可以无需配置提示词
 
2025.01.10 更新
新增功能
AI 智能定时器:
- 
支持绝对时间设置:
- "下午3点提醒我吃水果"
 
- "明天早上8点提醒我开会"
 
- "后天晚上6点提醒我做饭"
 
 
- 
支持相对时间设置:
- "5分钟后提醒我"
 
- "1小时30分钟后提醒我"
 
- "2天后提醒我"
 
 
AI 通知系统:
全局智能通知系统,为所有Home Assistant通知提供增强功能:
- 智能标题生成:自动分析内容生成简洁明了的标题
 
- 情境表情符号:根据内容智能添加相关表情符号
 
- 全局通知同步:所有设备实时接收通知
 
- 通知持久化:自动保存到Home Assistant通知中心
 
- 智能时间标记:自动添加人性化的时间信息
 
使用指南
创建定时器:
您可以通过以下两种方式创建定时器:
- 
在configuration.yaml中配置:
yaml
timer:
reminder:
name: 提醒器
work:
name: 工作提醒
family:
name: 家庭提醒
 
- 
通过"辅助工具 创建计时器":
- 点击右下角的"+"按钮
 
- 选择"计时器"
 
- 填写名称(如"提醒器")
 
- 设置时间格式为24:00:00
 
- 点击"创建"完成
 
 
- 
注意:必须添加到已公开实体中,设置 - 语音设置 - 公开新实体 - 是否公开新实体?公开显示受支持的、且未被归类为 “安全设备” 的设备。(勾选,或者点击已公开实体并且在内部找到继续添加进去)
 
日常提醒示例:
工作相关:
- "明天早上8点记得开会"
 
- "下午2点提醒我开线上会议"
 
- "提醒我打印工作文件"
 
- "别忘了周五提交报销单"
 
- "晚上记得加班做报告"
 
生活起居:
- "明早7点叫我起床"
 
- "记得今天做饭前解冻肉"
 
- "晚上提醒我洗衣服"
 
- "记得今天打扫卫生"
 
- "提醒我整理旅行行李"
 
家庭事务:
- "下午3点接孩子放学"
 
- "提醒我参加孩子的家长会"
 
- "别忘了买生日礼物给妈妈"
 
- "周末带宠物去打疫苗"
 
- "提醒我给朋友发微信祝贺生日"
 
购物清单:
- "周五提醒我去超市买菜"
 
- "提醒我买咖啡豆和牛奶"
 
- "明天去市场买水果和蔬菜"
 
重要事项:
- "提醒我缴水电费"
 
- "记得预约牙医检查"
 
- "提醒我购买保险续费"
 
- "明天早上去银行办业务"
 
- "记得给快递员打电话取件"
 
技术优化
核心优化:
- 修复绝对时间计算错误
 
- 优化日志输出格式
 
- 改进时间解析准确性
 
- 增强系统稳定性
 
服务集成:
- 完整接入timer服务
 
- 优化notify服务调用
 
- 首创定时器的完整实现流程
 
使用须知
定时器使用:
- 需要预先在Home Assistant中创建定时器实体
 
- 系统自动选择首个可用定时器
 
- 自动验证时间有效性
 
- 过期时间点自动识别为无效
 
通知系统特点:
- AI增强:智能分析内容并优化展示
 
- 全局同步:所有设备实时接收通知
 
- 持久化存储:通知保存在系统通知中心
 
- 智能时间:自动添加人性化时间标记
 
- 表情符号:根据内容AI智能匹配表情
 
其他修复
- 
重大修复:国内首创解决LLM无法回答中文,本地处理命令:命令将首先发送给本地对话代理。如果本地代理不处理此命令,则将命令发送给选定的代理。(语言类彻底解决,需要毫秒级开关设备控制家居产品,可以直接勾选启用)
 
- 
修复:优化设置,支持更多语言
 
- 
修复:天气和新闻搜索等方法的兼容性错误,支持联网和不联网请求,可以在关键词询问中加入联网或者不联网关键词
举例:"联网搜索 北京 今日天气"(即调用内部自定义意图查找今日全网关键地区天气信息)
举例:"今日天气"(即调用内部实体自动查找天气信息无需JInja2模版 再次定义)
 
- 
修复:联网搜索开关无法开关的错误,注意没有开关互联网搜索接口即放弃开启联网自定义意图!
 
- 
修复:日志错误反馈,报错信息优化,各种AI错误人性化提示修复
 
- 
修复:增加实体特别标识符(ZHIPU.AI)
 
- 
修复:yaml文件错误异常,调整为异步调用
 
- 
修复:翻译键,自定义名称硬编码
 
- 
修复:翻译文件语言错误
 
- 
修复:联网通信搜索错误定义
 
- 
修复:Home Assistant LLM API 开关启用和关闭复用
 
2024.12.28 更新
新增功能
联网搜索:集成智谱 AI 的 web-search-pro 工具,支持实时流式响应,搜索结果即时展现。支持多种触发方式,包括"搜索xxx"、"查找xxx"、"帮我联网xxx"等,搜索结果自动保存到对话历史。
AI 图像生成:支持三种 CogView-3 模型(Plus高级版、标准版、Flash免费版),提供7种图片尺寸选择,自动保存到本地 /www 目录,支持通过服务调用生成图片。
智能对话升级:优化对话上下文处理,增加实体状态显示,添加响应内容属性,支持中英双语交互。摄像头分析方面支持实时画面分析、自然语言问答和多摄像头支持。设备控制方面支持更多设备类型,改进控制逻辑,增强状态反馈。
视频分析增强:基于 GLM-4V 视觉模型,支持实时分析摄像头画面内容,可以回答"摄像头现在看到了什么"、"有人吗"等问题。支持多个摄像头同时分析,还可以进行跨镜头的场景理解。使用方式:
- 直接对话:"xxx摄像头现在看到了什么"
 
- 自动化调用:可配置定时分析、事件触发分析
 
- 场景联动:支持与其他设备和服务联动
 
短视频分析:集成 GLM-4V-Plus 模型的视频理解能力,支持对本地视频文件进行智能分析:
- 视频内容理解:分析视频中的场景、人物、动作和事件
 
- 情节描述:自然语言描述视频的主要情节发展
 
- 时间轴分析:可对视频特定时间点进行精确分析
 
- 多模态理解:结合视觉和音频信息的综合分析
 
技术优化
架构改进:采用模块化设计,功能独立封装,优化服务调用机制,改进错误处理流程,完善日志记录系统。性能方面优化了 API 调用效率,改进响应速度,提升系统稳定性。用户体验方面增加了实体状态显示,添加响应内容属性,优化配置流程,提供友好错误提示。
使用示例
# 联网搜索
service: zhipuai.web_search
data:
  query: "查询内容"
  stream: true
# 图像生成
service: zhipuai.image_gen
data:
  prompt: "一只可爱的小猫咪"
  model: "cogview-3-flash"
  size: "1024x1024"
# 摄像头分析
service: conversation.process
data:
  : "客厅摄像头现在看到了什么"
# 短视频分析示例
service: zhipuai.video_analysis
data:
  video_path: "/config/www/videos/party.mp4"
  query: "这个视频记录了什么活动"
# 自动化示例:分析新上传的视频
automation:
  trigger:
    platform: event
    event_type: file_uploaded
    event_data:
      file_type: video
  action:
    service: zhipuai.video_analysis
    data:
      video_path: "{{ trigger.event.data.path }}"
      query: "简要描述这个视频的内容"