小智AI 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和风天气联动小智

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的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中用文字询问却显示空闲

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歌曲试试能否成功