homey

Skill do kontroli inteligentnych urządzeń Athom Homey bezpośrednio z agenta. Łączysz się lokalnie przez sieć domową (LAN/VPN) lub zdalnie przez API chmury — wybór zależy od Twojej konfiguracji. Wyświetlaj listę urządzeń, włączaj/wyłączaj je, ustawiaj parametry (jasność, temperaturę), wyzwalaj przepływy automatyzacji i sprawdzaj strefy. Obsługuje Homey Pro, Cloud i Bridge.

1. Upewnij się, że masz zainstalowany Node.js w wersji 18 lub wyższej. Skill wymaga narzędzia homeycli, które zostanie zainstalowane automatycznie.

2. Wybierz sposób połączenia: lokalny (jeśli agent działa w sieci domowej) lub chmurowy (dla zdalnego dostępu). W przypadku połączenia lokalnego pobierz klucz API z aplikacji webowej Homey i adres IP urządzenia. Dla połączenia chmurowego przygotuj token z Developer Tools.

3. Skonfiguruj autentykację. Dla połączenia lokalnego uruchom homeycli auth discover-local --save --pick 1, a następnie ustaw klucz API poleceniem homeycli auth set-local --stdin (możesz też użyć flagi --prompt dla interaktywnego wprowadzenia). Dla połączenia chmurowego użyj homeycli auth set-token --stdin. Sprawdź status poleceniem homeycli auth status.

4. Przetestuj połączenie poleceniem homeycli status, aby upewnić się, że agent może komunikować się z Homey.

5. Pobierz listę dostępnych urządzeń poleceniem homeycli devices --json, aby agent mógł je parsować. Możesz filtrować urządzenia po nazwie, na przykład homeycli devices --match "kuchnia" --json.

6. Steruj urządzeniami za pomocą poleceń takich jak homeycli device "Lampa salonu" on (włączenie) lub homeycli device "Lampa salonu" off (wyłączenie). Dla urządzeń z regulacją użyj homeycli device "Ściemniacz" set dim 0.5 (50% jasności). Agent może również wyzwalać przepływy automatyzacji i pobierać dane o strefach.