From f398115df3915eb1d23b7dc54c1591fc8a3d8a0a Mon Sep 17 00:00:00 2001
From: hrz <1710360675@qq.com>
Date: Sat, 22 Mar 2025 21:38:40 +0800
Subject: [PATCH] =?UTF-8?q?update:=E6=9B=B4=E6=96=B0Home=20Assistant?=
=?UTF-8?q?=E6=8E=A5=E5=85=A5=E6=96=B9=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
README.md | 44 ++++++++++++++++--
docs/images/demo0.png | Bin 0 -> 295543 bytes
docs/images/demo5.png | Bin 295349 -> 346103 bytes
.../plugins_func/functions/hass_init.py | 35 ++++++++++++++
4 files changed, 75 insertions(+), 4 deletions(-)
create mode 100644 docs/images/demo0.png
create mode 100644 main/xiaozhi-server/plugins_func/functions/hass_init.py
diff --git a/README.md b/README.md
index 3e61b7a2..191790bc 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@
-
+
@@ -95,6 +95,11 @@
|
+
+
+
+
+
|
@@ -185,7 +190,6 @@ server:
| LLM | FastgptLLM | fastgpt 接口调用 | 免费/消耗 token | 本地化部署,注意配置提示词需在 Fastgpt 控制台设置 |
| LLM | GeminiLLM | gemini 接口调用 | 免费 | [点击申请密钥](https://aistudio.google.com/apikey) |
| LLM | CozeLLM | coze 接口调用 | 消耗 token | 需提供 bot_id、user_id 及个人令牌 |
-| LLM | Home Assistant | homeassistant语音助手接口调用 | 免费 | 需提供home assistant令牌 |
实际上,任何支持 openai 接口调用的 LLM 均可接入使用。
@@ -370,9 +374,41 @@ VAD:
### 6、我想通过小智控制电灯、空调、远程开关机等操作 💡
-方法1:在配置文件中将 `LLM` 设置为 `HomeAssistant`,通过 调用`HomeAssistant`接口实现相关控制。
+本项目,支持以工具调用的方式控制HomeAssistant设备
-方法2:以工具调用的方式控制HomeAssistant设备,LLM中配置HomeAssistant的api_key、base_url,不选择HomeAssistant做LLM,但必须配置一款支持tool调用的LLM,最后在提示词prompt里以示例的格式设置需要控制的设备,音乐播放需要在homeassistant中对接好musicassistant,同时音乐有削刮出媒体信息,对应的媒体播放器配置在设备列表中即可。
+1、首先选择一款支持function call支持的LLM,例如`ChatGLMLLM`。
+
+2、在配置文件中,将 `selected_module.Intent` 设置为 `function_call`。
+
+3、登录`HomeAssistant`,点击`左下角个人`,切换`安全`导航栏,划到底部`长期访问令牌`生成api_key。
+
+在配置文件中,配置好你的home assistant的`devices`(被控制的设备)和`api_key`和`base_url`等信息。例如:
+
+``` yaml
+plugins
+ home_assistant:
+ devices:
+ - 客厅,玩具灯,switch.cuco_cn_460494544_cp1_on_p_2_1
+ - 卧室,台灯,switch.iot_cn_831898993_socn1_on_p_2_1
+ base_url: http://你的homeassistant地址:8123
+ api_key: 你的home assistant api访问令牌
+```
+
+最后,允许function_call 插件在配置文件中启用`hass_get_state`(必须)、`hass_set_state`(必须)、`hass_play_music`(不想用ha听音乐可以不启动),例如:
+
+``` yaml
+Intent:
+ ...
+ function_call:
+ type: nointent
+ functions:
+ - change_role
+ - get_weather
+ - get_news
+ - hass_get_state
+ - hass_set_state
+ - hass_play_music
+```
### 7、更多问题,可联系我们反馈 💬
diff --git a/docs/images/demo0.png b/docs/images/demo0.png
new file mode 100644
index 0000000000000000000000000000000000000000..99592be6878e713cda4789443f06fcca0d5c542b
GIT binary patch
literal 295543
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