Интеграция с Домашним помощником

Hermes Agent интегрируется с Home Assistant двумя способами:

1. Платформа шлюза — подписывается изменение состояния в первый раз через WebSocket и реагирует на события.
2. Инструменты умного дома — четыре вызываемых инструмента LLM для запросов и управления устройствами через REST API.

Настройка

1. Создание долгоживущего токена доступа

1. Откройте ваш экземпляр Home Assistant.
2. Перейдите в свой Профиль (нажмите на свое имя на боковой панели).
3. Прокрутите до Долгоживущие токены доступа
4. Нажмите Создать токен, дайте ему имя, например «Агент Гермеса».
5. Скопируйте токен

2. Настройте переменные окружения.

# Добавьте в ~/.hermes/.env

# Обязательно: ваш долгоживущий токен доступа
HASS_TOKEN=your-long-lived-access-token

# Опционально: URL HA (по умолчанию: http://homeassistant.local:8123)
HASS_URL=http://192.168.1.100:8123
```:::информация
Набор инструментов «homeassistant» включается автоматически, когда установлен «HASS_TOKEN». И шлюз платформы, и инструменты управления устройствами активируются из этого одного токена.</div>
### 3. Запустить шлюз
```bash
hermes gateway

Home Assistant создается как подключённая платформа рядом с другими платформами обмена сообщениями (Telegram, Discord и т.д.).

Доступные инструменты

Агент Гермес регистрирует четыре инструмента для управления умным домом:

ha_list_entities

Список сущностей Home Assistant, опционально отфильтрованных по домену или области.

Параметры: - domain (опционально) — Фильтр по домену влияний: light, switch, climate, sensor, binary_sensor, cover, fan, media_player и т.д. - область (опционально) — Фильтр по названию области/комнаты (сопоставляется с дружественными именами): гостиная, кухня, спальня и т.д.

Пример:

Список всех светильников в гостиной

Возвращает идентификаторы сущностей, состояния и дружелюбные имена.

ha_get_state

Получите подробное описание состояния одного объекта, включая все атрибуты (яркость, цвет, заданную температуру, срабатывание датчиков и т.д.).

Параметры: - entity_id (обязательно) — Сущность для запроса, например, light.living_room, climate.thermostat, sensor.temperature

Пример:

Каково текущее состояние climate.thermostat?

Возвращает: состояние, все атрибуты, временные метки последних изменений/обновлений.

ha_list_services

Список доступных сервисов (действий) для управления устройствами. Показывает, какие действия можно выполнить для каждого типа устройств и какие параметры они принимают.

Параметры: - домен (опционально) — Фильтр по домену, например, свет, климат, выключатель

Пример:

Какие сервисы доступны для климатических устройств?

ha_call_service

Вызов сервиса Home Assistant для управления телефоном.

Параметры: - domain (обязательно) — Домен сервиса: light, switch, climate, cover, media_player, fan, scene, script - service (обязательно) — Имя сервиса: turn_on, turn_off, toggle, set_temperature, set_hvac_mode, open_cover, close_cover, set_volume_level - entity_id (опционально) — Целевая сущность, например, light.living_room - data (опционально) — Дополнительные параметры в виде JSON-объекта

Примеры:

Включи свет в гостиной
→ ha_call_service(domain="light", service="turn_on", entity_id="light.living_room")

Установи термостат на 22 градуса в режиме обогрева
→ ha_call_service(domain="climate", service="set_temperature",
    entity_id="climate.thermostat", data={"temperature": 22, "hvac_mode": "heat"})

Установи свет в гостиной на синий цвет с яркостью 50%
→ ha_call_service(domain="light", service="turn_on",
    entity_id="light.living_room", data={"brightness": 128, "color_name": "blue"})

Платформа шлюза: события в первый раз

Адаптер шлюза Home Assistant контролируется через WebSocket и подписывается событиям state_changed. Когда состояние устройства меняется и соответствует вашим фильтрам, оно пересылается агенту как сообщение.

Фильтрация событий

⚠️ Warning

Обязательная перемена

По умолчанию никакие события не пересылаются. Чтобы получать события, вам нужно настроить хотя бы один из параметров watch_domains, watch_entities или watch_all. Без фильтров при запуске записывается предупреждение, и все изменения состояния выбрасываются молча.