Dodawanie komendy
Możesz skonfigurować własne zdania/sentencje do przetworzenia na akcje w systemie. Działa to poprzez odwzorowywanie zdań na intencje, a następnie skonfigurowanie skryptu w celu obsługi tych intencji.
Obecnie, żeby dodać nową komendę, należy dodać ją do plików konfiguracji. Dodawanie komend z interfejsu aplikacji będzie rozwijane w przyszłości. UWAGA - dodając własne intencje nadpisujesz domyślną konfigurację Asystenta domowego. Nadpisanie konfiguracji ma wpływ na działanie systemu. W przypadku problemów z działaniem systemu zalecamy usunięcie własnych wpisów z konfiguracji i sprawdzenie działania z domyślną konfiguracją.
Uproszczony diagram działania komend w Asystencie domowym:
Lokalizacja konfiguracji Asystenta
Katalog z konfiguracją domyślnie znajduje się na urządzeniu (bramce) w folderze /data/data/pl.sviete.dom/files/home/AIS
ścieżkę do katalogu możesz sprawdzić w aplikacji::
Katalog z konfiguracją dostępny jest w lokalnej sieci po ssh lub ftp:
Definicja sentencji
Bezpośrednio w katalogu konfiguracji utwórz plik conversation.yaml, w pliku conversation.yaml dodaj sentencje, które mają wywoływać twoje nowe intencje. Przykładowo, jeżeli chcesz, by Twój asystent odpowiadał Ci, ile czasu jeszcze zostało do końca pracy to możesz zdefiniować coś takiego:
Definicja intencji
Bezpośrednio w katalogu konfiguracji utwórz plik intents.yaml, w pliku intents.yaml dodaj intencje oraz akcje, które mają zostać wywołane po wykryciu intencji. Posługując się naszym przykładem możemy zrobić coś takiego:
Dodaj sentencje i intencje do głównego pliku konfiguracji
W katalogu konfiguracji znajduje się plik configuration.yaml, na końcu tego pliku dodaj lokalizację skryptu z intencjami oraz modułu konwersacja - dopisz te 2 linie na końcu pliku:
Wypróbuj działanie nowej komendy
informacja
Sprawdź konfigurację i uruchom ponownie Asystenta domowego w celu przetestowania nowej komendy
Wyjaśnienie dodatkowe
W przykładzie
speech to tekst zwracany do obiektu IntentResponse, tekst z tego obiektu wyświetlany jest w aplikacji w okienku konwersacji z asystentem
szczegóły w dokumentacji dla developerów Home Assistant
action to wykonanie akcji w Asystencie domowym
service to usługa zdefiniowana w systemie
ais_ai_service.say_it To usługa zamiany tekstu na mowę - czytanie tekstu przez asystenta.
Usługi można testować/wywoływać z Narzędzi deweloperskich
data_template to zaawansowana funkcjonalność szablonów, pozwalająca dynamicznie kontrolować informacje przekazywane do usługi,
szczegóły w dokumentacji dla developerów Home Assistant
Szablony możesz tworzyć/sprawdzać w Narzędziach deweloperskich