HASS on 云崖小栈

小智AI连接HASS的MCP服务

Tue, 09 Jun 2026 00:00:00 +0000

小智AI支持MCP

我购买的是无名科技的小智AI设备，登入官方提供的控制台配置角色然后下拉到最下面的MCP设置点击获取MCP接入点

把接入点地址复制下来备用

HASS安装集成

HASS官方已默认安装了集成直接使用就好了

直达安装地址：https://my.home-assistant.io/redirect/config_flow_start?domain=mcp_server

直接复制地址到浏览器然后注意是否是你HASS的地址，如果不是点击修改

如果是就点击打开进行下一步

进入集成页面点击添加集成
搜索xiaozhi就可以看到集成了
然后点击添加服务
将刚才的MCP接入点复制进去提交

然后返回小智AI的控制台稍等一会，或者退回控制台主页再进去就显示在线了

HASS的AI助手配置

Sun, 07 Jun 2026 00:00:00 +0000

注意的点

HASS上AI联动中的巨坑

集成下载

GitHub：https://github.com/paulbertoli94/extended_openai_conversation
下载压缩包解压
用SSH连接unraid进入HASS根目录

将extended_openai_conversation文件夹放入custom_components中

集成配置

在集成页面添加集成搜索extended_openai_conversation

然后就需要添加API这种

最近使用Deepseek官方的V4pro挺好用的

去Deepseek注册充值获取API然后从文档那获取URL和模型名称填进去

然后可以测试一下

在首页右上角点击对话图标
选择管理助手

点击添加助手选择刚才配置进去的AI

点击更新然后对话试试看

AI提示词

进入集成页面点击extended_openai_conversation点击第一项的齿轮

这里就是AI的提示词使用官方天气，日历，音乐助手需要详细配置提示词

传感器这些只要在传感器自身的设置页面点击语音助手-公开就可以被AI发现不需要额外配置，也可以设置别名识别更轻松

接下来以和风天气的当前温度为例来演示整个过程

HASS和风天气联动小智

Sun, 07 Jun 2026 00:00:00 +0000

前置条件

HASS和风天气
 HASS的AI助手配置

官方蓝图下载

GitHub：https://github.com/TheFes/ha-blueprints/blob/main/documentation/weather/3_voice_weather_forecast_full_llm.md

网址中文件有可快捷导入HASS的功能或者在HASS蓝图界面将这个网址复制进去

若快捷导入注意下方的url是否是你HASS的地址

然后点击蓝图选择和风天气直接创建脚本设么也不要改

然后点击脚本设置-语音助手-开放

可起个别名天气查询

AI提示词编写

## 天气与环境传感器分流规则 (Weather & Sensor Rules)
当前时间以系统实时提供的时间为准（当前身处中国北京时间东八区，UTC+8）。
当用户询问关于天气、气温、湿度等信息时，你必须根据用户的【时间语义】执行严格的楚河汉界双轨分流：

### 轨道 A：当前实况与室内环境（直接读取状态，严禁调用脚本）
- 【分流判定】：当用户话语包含“现在”、“当前”、“目前”、“实时”、“家里”、“房间里”等指代【此时此刻】的词汇，或者单纯问“现在多少度”、“热不热”、“湿不湿”。
- 【执行纪律】：100% 严禁调用任何天气查询脚本！你必须直接查阅 Home Assistant 暴露给你的本地环境传感器实体（温湿度传感器、气象站的 current 状态实体等），读取其实时数值并直接用人类语言回答。

### 轨道 B：未来预报与时段天气（必须调用天气脚本）
- 【分流判定】：当用户询问非当前、属于【未来或特定时段】的天气（如“今天下午”、“今晚”、“明天”、“周末”、“这几天”、“下周一”等），或提及非当下的出行关心（如“明天要带伞吗”）。
- 【执行纪律】：100% 必须调用天气查询工具（script.ai_weather_relay），并严格遵守以下 4 参数规范：
  
  1. 严格四字段参数控制 (STRICT 4 PARAMETERS ONLY)：
     - 你只能、且必须传递 `time_period_type`, `time_period_length`, `start_date`, `start_time` 这四个合法参数，【绝对禁止】生造任何其他未提及的字段（如 end_date）。

  2. 时间格式化转换与强行补全 (TIMESTAMP FORMATTING & PADDING)：
     - time_period_type：
       - 话语指代整天（如“明天”、“这几天”）：固定赋值为 `daily`
       - 话语指代局部时段或小时（如“下午”、“接下来2小时”）：固定赋值为 `hourly`
     - time_period_length：
       - daily 模式：“明天”赋值为 `1`；“这几天”赋值为 `5`；其他计算出天数 Y 赋值为 `Y`。
       - hourly 模式：赋值为对应的小时数字或局部时段跨度。
     - start_date（19位完整格式）：
       - 严格为 `YYYY-MM-DD HH:MM:SS`。若无明确提及局部时段，时分秒一律补全为 `00:00:00`。
     - start_time（8位严格格式）：
       - 未提及局部时段：`'00:00:00'`；提及“早上”：`'06:00:00'`；提及“下午”：`'12:00:00'`；提及“晚上”：`'18:00:00'`。

然后使用小智问一下明天天气验证

HASS上AI联动中的巨坑

Sun, 07 Jun 2026 00:00:00 +0000

系统认识的脚本的实体ID跟页面上显示的有可能不一样

比如有个脚本你如果在创建后改了名字，然后点了刷新实体ID，这时候你可以得到一个新的实体ID，但是你用新的实体ID调用的时候可能会提示找不到。

因为他的“真实”实体ID保存在HASS根目录的scripts.yaml中，你要打开查看真实名字。最好不要尝试在这个文件里修改实体ID，如果想修改的话就做好备份工作。

小智MCP集成关于调用HASS官方日历，音乐助手蓝图脚本的时候报One of ’entity_id’, ‘area_id’, or ‘device_id’ is required错误

需要在提示词中严格规定device_id等于你调用的设备的实体ID

日历的话可以写死让他将device_id等于xx(你具体的日历实体ID)

音乐助手由于要切换实体所以要

device_id等于必须填入目标播放器，只要用户提到了具体的播放设备则将该设备的实体ID以字符串形式使用，若没提到则默认xx(填一个播放设备实体ID)

HASS的Outlook日历联动小智

Sat, 06 Jun 2026 00:00:00 +0000

前置条件

HASS的AI助手配置
 HASS通过Outlook日历与华为日历联动

蓝图下载与配置

使用HASS官方日历蓝图
网址：https://github.com/TheFes/ha-blueprints/blob/main/documentation/calendar/3_voice_calendar_entries_full_llm.md

导入HASS

注意下方url是否是你HASS的地址

然后创建脚本，选择Outlook日历实体然后什么也不用改确定创建

将改脚本设置为公开状态

AI提示词编写

重点是AI提示词编写才能让他正确使用

## 日历查询管理规则 (Calendar Query Rules)
当用户询问关于日程、日历、安排、周末计划或特定事件（如“运动”、“会议”）时，你必须调用日历查询工具（script.voice_calendar_entries_full_llm_script）。请严格遵守以下硬核调用规范：
今天以系统当前提供的时间（Current Time）为基准使用北京时间

1. 严格四字段参数控制 (STRICT 4 PARAMETERS ONLY)：
   - 你只能、且必须传递以下四个官方定义的合法参数，【绝对禁止】生造任何其他未提及的字段（例如严禁生成 end_date 字段）：
     `time_period_type`, `time_period_length`, `start_date`, `start_time`

2. 时间格式化转换与强行补全 (TIMESTAMP FORMATTING & PADDING)：
   - time_period_type 转换准则：
     - 若用户话语包含“天”或指代整天（如“今天”、“明天”、“这几天”）：固定赋值为 `daily`
     - 若用户话语包含“小时”或指代当天某个特殊局部时段（如“下午”、“接下来2小时”）：固定赋值为 `hourly`

   - time_period_length 转换准则：
     - 若 time_period_type 为 daily：“今天”或“明天”赋值为 `1`；“这几天”赋值为 `5`；其他时间自行计算出天数 Y，赋值为 `Y`。
     - 若 time_period_type 为 hourly：“未来 X 小时”或局部时间，赋值为对应的小时数字。

   - start_date 赋值规范（★核心：必须是19位完整格式，绝对不能只写日期）：
     - 必须将日期和时分秒完整拼接，格式严格为：`YYYY-MM-DD HH:MM:SS`。
     - 默认如果用户没有明确提及具体时段（如只说“今天”），时分秒部分一律补全为 `00:00:00`。
     - 示例（若今天是2026-06-06）：用户说“今天”，start_date 必须传 `'2026-06-06 00:00:00'`。

   - start_time 赋值规范（格式严格为 8 位时分秒 `HH:MM:SS`）：
     - 若用户没有明确提及局部时段：赋值为 `'00:00:00'`
     - 提及“早上”：赋值为 `'06:00:00'`
     - 提及“下午”：赋值为 `'12:00:00'`
     - 提及“晚上”：赋值为 `'18:00:00'`

3. 结果回复规范 (RESPONSE GENERATION)：
   - 脚本执行完成后，通过 response_variable 拿到结果，用自然、温馨的中文“人话”为主人总结日程。
   - 如果回传结果为空，请告知主人：“主人，您这段时间没有安排任何日程哦。”您这段时间没有安排任何日程哦。”

然后就可以使用了

注意点

用小智语音可以读取到活动但是HASS中用文字询问却显示空闲

HASS和风天气

Sat, 06 Jun 2026 00:00:00 +0000

安装和风天气HASS集成

GitHub ：https://github.com/c1pher-cn/heweather

GitHub页面自带流程故这里简述下

在HACS商店中搜索heweather,找到本插件并下载

配置和风天气

然后设置->设备与服务->添加集成->搜索heweather->选择本插件，同时建议使用JWT凭证，（API模式将在2027年废弃）。

将里面的公钥复制下来备用

注册和风天气并进入开发者平台

新建项目和凭证

凭证选择JWT并输入HASS中的凭据

然后就能在项目页面看到项目id和凭据id分别复制下来

再点击开发者页面的设置里面有API

将第一个页面填好后下一步

根据

国内的城市区域location、经纬度关系：

https://github.com/qwd/LocationList/blob/master/China-City-List-latest.csv

选择经纬度填进去

关注的自然灾害等级，1-6为从轻微到严重，代表在灾害预警里你关注的灾害等级。

“Standard”: “标准的”,

“Minor”: “次要的”,

“Moderate”: “中等的”,

“Major”: “主要”,

“Severe”: “严重”,

“Extreme”: “极端”

只显示标题即只在灾害预警text中透出灾害标题，显示标题+明细信息则会在text中透出全部信息（会比较长）

这样就可以看到实体了

一小时天气预警

在HASS的根目录修改configuration.yaml
加一行

`1`	`template: !include templates.yaml`

然后在根目录创建文件templates.yaml
填入

# ==========================================
# 1. 一小时天气预警（触发型模板传感器）
# ==========================================
- sensor:
    - name: heweather_rain_warn
      unique_id: heweather_rain_warn
      state: >
        {# 依然读取实时中文，用来做状态的主分类判断 #}
        {% set weather_text = states('sensor.he_feng_tian_qi_heweather_text') %}
        
        {% if '雨' in weather_text or '雪' in weather_text or '雹' in weather_text %}
          下雨预警
        {% else %}
          关闭
        {% endif %}
      attributes:
        states: >
          {# 1. 获取当前和风天气的中文描述（例如：晴、多云、小雨） #}
          {% set weather_text = states('sensor.he_feng_tian_qi_heweather_text') %}
          
          {# 2. 完美复刻原作者的提示文字风格 #}
          {% if '雨' in weather_text or '雪' in weather_text or '雹' in weather_text %}
            接下来一小时会有{{ weather_text }}，出门记得带伞
          {% else %}
            未来一小时，天气{{ weather_text }}，没有降雨
          {% endif %}

然后设置-开发者工具-YAML-点击最上面的检查配置
如果是绿色代表成功点击右面的重启的第一个选项

然后就可以在设置-设备与服务-实体最下面看到heweather_rain_warn实体了

可以在首页卡片创建选择Markdown 卡片配置
输入


  <div style="display: flex; justify-content: space-between; align-items: flex-start;">
    <font color="#88" size="3">天气预警</font>
    <ha-icon icon="mdi:cloud-outline" style="color: #44739e;"></ha-icon>
  </div>
<font color="#88" size="5">{{ state_attr('sensor.heweather_rain_warn', 'states') }}</font>

灾害预警

添加单实体卡片添加和风天气里的警告实体，刚开始可能是英文就找warn三角图标的，后面可以自己改名

然后重点来了

卡片里面属性栏选择States才可以看到信息

天气卡片

在卡片里面找到天气预报选择和风天气然后自己选项配置一下

HASS通过Outlook日历与华为日历联动

Sat, 06 Jun 2026 00:00:00 +0000

工作流

华为日历 <- > Outlook日历<- > HASS日历

通过修改这三个的任意一个(用Outlook的日历账户)可以同步到另外两个

华为&Outlook日历互通

APP准备

下载Outlook APP跟Authenticatol软件

Outlook APP：集成日历功能可跟华为系统日历同步
Authenticatol：微软账号登录的快捷安全验证

申请Outlook邮箱账号登录Outlook跟Authenticatol

设置同步

进入Outlook APP点击左上角和左下角进入设置

选择日历开启同步日历

实验

分别在华为日历和Outlook上建立不同的行程，看是否同步

Outlook&HASS同步

HASS集成下载

RogerSelwyn大佬开发了个通过微软azure开发平台应用将日历等数据推送到HASS

GitHub页面：https://github.com/RogerSelwyn/MS365-Calendar

快捷配置页面：https://fixtse.com/en/blog/o365-integrations

视频教程：https://www.youtube.com/watch?v=_g5I2y-xzaM

根据GitHub页面或者快捷配置页面里面的连安装第三方集成

微软azure开发平台应用配置

平台网址：https://portal.azure.com/#home

打开开发平台登录进去

注册应用

在顶部搜索栏搜索“应用注册”

左上角“新注册”

填入以下信息

url ：https://login.microsoftonline.com/common/oauth2/nativeclient

在概述页面有一个“应用程序(客户端) ID”复制备用

配置应用权限

点击左侧菜单栏的管理里面的API授权

点击“添加授权”然后点击“Microsoft Graph”然后点击“委托的权限”

查找官方文档里的日历应用需要的授权
具体如下

搜索相应的授权都勾选上

然后点击下方的添加授权

然后点击“添加权限”旁的“代表 Default Directory 授予管理员同意”

配置应用证书

点击证书和密码添加一个新客户端密码复制“值”里面的内容备用

配置HASS的微软日历集成

进入设置设备与服务右下角添加集成

搜索365点击Microsoft 365 Calendar

第一项名字自己取

Client ID = 刚才复制的应用程序(客户端) ID

Client Secret = 刚才复制的“值”

勾选Enable update services提交

点击蓝色的字体会让登录微软账号，然后会进入一个页面

如果是空白页是正常的直接复制网址然后输入HASS中的框里面确认就行了

如果是显示“此页面通常不会显示，可能是网络钓鱼攻击的迹象。URL包含你的密码。请立即关闭此页面，且不要复制或与任何人共享该URL。”赶紧复制当前的网址因为他马上就要跳走了，一般就是网络代理问题被微软认为是不安全的所以有一个保护机制。
把这个网址输入HASS框里确认就行

然后就看到了Outlook的默认3个实体

此时就可以实验在华为日历，Outlook日历和HASS左侧栏的日历中都试试添加事件看是否同步

遇到的问题跟如何排除的

Q：点开HASS的蓝色连接登录后提示“我们无法完成你的请求”
A：因为创建应用的时候Web连接填错了
修复：在应用总找到Authentication (Preview)页面修改连接为正确的https://login.microsoftonline.com/common/oauth2/nativeclient

Q：HASS跟Outlook同步不了
A：可能是权限啥的没配置好
修复：重新配置一下然后重启HASS，在集成中点击Microsoft 365 - Calendar删除刚才添加的东西重新添加一下

Home Assistant × Music Assistant 联动小智

Fri, 05 Jun 2026 00:00:00 +0000

前置条件

HASS的AI助手配置
 Music Assistant的Unraid Docker安装配置

添加Music Assistant集成

Music Assistant集成可以自动发现直接点击添加就可以

Music Assistant配置

将Music Assistant中开放的设备命好名称

点进Music Assistant

点一个想要改名的设备然后点击右上角的编辑可以编辑设备名称和区域

官方蓝图

下载

GitHub：https://github.com/music-assistant/voice-support#option-3-script-which-can-be-used-as-a-tool-by-an-llm-integration-like-open-ai-conversation-chatgpt-or-google-generative-ai-gemini

下拉选择 Option 3有个蓝色的选项可以快捷添加，记得快捷添加页面网址改为HASS内网网址

快速添加的时候注意下方url是否是你HASS的地址

然后点开蓝图选择一个默认实体直接点击保存也不要改任何东西点击确认

点击脚本设置不公开给AI使用然后保存

创建中转脚本

由于官方脚本输入参数过多所以有些可以简化的参数就通过中转脚本简化输入

通过SSH进入HASS根目录找到scripts.yaml文件这是储存脚本的
粘贴进去不要乱改动这里的名字ai_2，因为跟他对应的部分写死了这个名字，要改得一起改

ai_2:
  alias: AI 音乐中转连接器
  icon: mdi:music-box-outline
  description: 专门让 AI 调用的简单音乐脚本，用来中转复杂的 MA 参数并支持设备选择
  fields:
    media_id:
      description: Put the song title directly here!
      required: true
      selector:
        text: {}
    media_type:
      description: 'MANDATORY! "media_type" can only be one of 5 different values:
        track, album, artist, playlist, radio.'
      required: true
      selector:
        select:
          options:
          - track
          - album
          - artist
          - playlist
          - radio
    shuffle:
      description: 是否随机播放
      required: true
      selector:
        boolean: {}
    media_player:
      description: OPTIONAL. The specific Music Assistant media player entity name
        if mentioned.
      example: media_player.living_room_speaker
      required: false
      selector:
        entity:
          filter:
            integration: music_assistant
            domain: media_player
  sequence:
  - action: script.llm_script_for_music_assistant_voice_requests
    data:
      media_id: '{{ media_id }}'
      media_type: '{{ media_type }}'
      shuffle: '{{ shuffle }}'
      media_player: "{% if media_player and media_player != 'NA' %}\n  {{ [media_player]
        }}\n{% else %}\n  {{ [] }}\n{% endif %}"
      area: NA
      artist: ' '
      album: ' '
      media_description: ' '

进入设置-开发者工具-YAML
检查配置-重启第一项
然后进入脚本页面刷新两下应该就出现了，公开给AI用然后可以起个你认为合适的别名

AI提示词

由于要给AI使用所以提示词是必不可少的，不然AI理解不了这么复杂的参数

[[HASS的AI助手配置]]有如何找到提示词输入

输入下方提示词

🎧 音乐与媒体控制核心纪律（最高执行优先级）
你当前拥有两种完全不同的媒体控制能力，必须根据用户的口令进行严格的“非此即彼”双向分流，严禁混淆：

🧱 分流 A：基础控制类请求 ──> 必须直接控制实体（不准碰脚本！）
适用场景：用户要求“暂停”、“继续播放”、“别放了”、“下一首”、“关掉音乐”。
执行纪律：你必须直接使用标准的 Home Assistant 实体控制动作（如 media_player.media_pause 等）直接操作暴露给你的媒体播放器设备。
❌ 铁律：这类请求绝对、必须、100% 严禁调用 script.ai_2 脚本！

🚀 分流 B：搜索与点歌类请求 ──> 必须且仅调用中转脚本
【重要纪律：高级音乐点歌服务（听歌/放专辑/随机听歌手/指定房间）】

只要用户的意图是“听歌、放音乐、放电台、听专辑”，100% 必须且只能调用工具方法：'script.ai_2'。
你必须严格将提取到的数据装入以下参数，绝不允许自己发明参数名（禁止使用 'song' 等）：

media_id: 必须填入具体的歌曲名、专辑名、电台名或歌手名。
        
media_type: 必须严格对齐：听特定单曲或歌名填 "track"；听歌手的所有歌填 "artist"；听特定专辑填 "album"；听电台填 "radio"，听歌单填 "playlist"

shuffle: 随机播放。如果用户提到“随便放、随机放”，填 true，否则填 false。

area: 【禁忌参数】由于系统架构调整，当前严禁向中转脚本传递任何房间名称。

media_player: 必须填入目标播放器，只要用户提到了具体的播放设备则将该设备的实体ID以字符串形式使用，若没提到则默认media_player.xian_lai_m1t_2

entity_id 必须填入与media_player的字符串结果保持一致

先对齐分流逻辑，再执行工具调用！

#下面是关于本地设备调用权限的

Current Time: {{now()}}

Available Devices:
```csv
entity_id,name,state,aliases
{% for entity in exposed_entities -%}
{{ entity.entity_id }},{{ entity.name }},{{ entity.state }},{{entity.aliases | join('/')}}
{% endfor -%}

这里的script.ai_2 是脚本在scripts.yaml的实体ID

都配置好了可以先去首页右上角的AI试一下比如XX播放器播放XX歌曲试试能否成功