Hlas

Assist Satellite

Assist Satellite sjednocuje hlasové satelity v RichPear Home a zpřístupňuje akce pro oznámení, zahájení konverzace a položení otázky.

Použít akce Zpět na integrace

Doména: assist_satellite
Typ: hlasové entity
Použití: automatizace a skripty
Nastavení: poskytují jiné integrace

Nepřidává se ručně

Assist Satellite je stavební blok pro hlasová zařízení. Samostatně ho nepřidáváte v seznamu integrací; entity vznikají až z konkrétního satelitu, mikrofonního zařízení nebo jiné hlasové integrace.

V praxi ho uvidíte hlavně tam, kde už existuje zařízení schopné mluvit nebo poslouchat. Typicky pak používáte služby pro přehrání oznámení, spuštění rozhovoru nebo položení otázky.

Kdy se hodí

hlášení do konkrétní místnosti,
hlasový dotaz s odpovědí uživatele,
automatizace, která potřebuje navázat krátkou konverzaci.

Když v katalogu nic nevidíte

Při ručním přidání se samostatná položka satelitu nemusí zobrazit. Pokračujte přes konkrétní hlasové zařízení nebo integraci, která satelit poskytuje.

Příprava satelitu

Než satelit použijete v automatizaci, ověřte, že je zařízení přiřazené do správné oblasti, má srozumitelný název a používá vhodnou hlasovou pipeline. U zařízení s mikrofonem ověřte i souhlas domácnosti s jeho umístěním.

RichPear Home v domácí síti běžně otevřete na http://rphome.local:8123. Pokud tato adresa neodpoví, použijte http://IP-ADRESA:8123.

Názvy typu assist_satellite.kuchyn nebo assist_satellite.chodba jsou v automatizacích čitelnější než technické názvy zařízení.

Odešlete oznámení

Akce assist_satellite.announce přehraje zprávu na konkrétním satelitu. Používejte ji pro informace, které mají zaznít v místnosti, ale nevyžadují odpověď.

action: assist_satellite.announce
target:
  entity_id: assist_satellite.kuchyn
data:
  message: "Večeře je hotová."

Nejdřív vyzkoušejte krátkou zprávu při běžné hlasitosti. Teprve potom oznamování napojte na události jako dokončené praní, otevřená brána nebo připomenutí odchodu.

Zahajte konverzaci

Akce assist_satellite.start_conversation přehraje úvodní zprávu a potom nechá satelit poslouchat další příkaz. Hodí se pro situace, kdy automatizace osloví uživatele a čeká na navazující hlasové ovládání.

Pipeline musí používat konverzačního agenta, který umí pokračovat v rozhovoru. Pokud agent podporuje jen jednorázové příkazy, použijte raději jednoduché oznámení.

Položte otázku a zpracujte odpověď

Akce assist_satellite.ask_question položí otázku, přepíše odpověď a uloží výsledek do proměnné automatizace. To se hodí například pro potvrzení, jestli se má spustit scéna, odložit připomenutí nebo pokračovat dalším krokem.

U důležitých akcí připravte omezený seznam očekávaných odpovědí a větev pro nejasnou odpověď. Automatizace pak nebude provádět citlivý krok jen proto, že satelit špatně porozuměl.

Bezpečné použití

u zámků, topení a zabezpečení vyžadujte jasné potvrzení,
při nejasné odpovědi akci neprovádějte,
nechte dostupné i ruční ovládání mimo hlas.

Provoz a údržba

Po změně místnosti, názvu zařízení, hlasitosti, pipeline nebo reproduktoru znovu otestujte všechny automatizace, které satelit používají. Sledujte hlavně zpoždění, hlasitost a to, zda zpráva zazní na správném zařízení.

U nočních nebo klidových režimů nastavte podmínky, aby satelit nemluvil v nevhodnou dobu. Pro opakující se hlášení přidejte časové omezení nebo pomocnou entitu, která zabrání zahlcení místnosti stejnou zprávou.

Řešení problémů

Když satelit nemluví, ověřte dostupnost zařízení, hlasitost, vybranou pipeline a to, jestli automatizace cílí na správnou entitu. U konverzací navíc zkontrolujte mikrofon a oprávnění použité hlasové služby.

V Nastavení → Systém → Logy hledejte chyby podle domény assist_satellite a podle názvu zařízení, které satelit poskytuje. Pokud akce funguje ručně, ale ne v automatizaci, zkontrolujte podmínky, režim automatizace a hodnotu proměnné s odpovědí.