Integrace RichPear Home

Dialogflow

Dialogflow přijímá fráze z Google Dialogflow a posílá do RichPear Home akce a parametry přes webhook pro intent zpracování.

Začít nastavení Zpět na integrace

Doména: dialogflow
Kategorie: hlas, intent, webhook
Komunikace: webhook z Dialogflow
Nastavení: YAML a veřejně dostupný webhook
Stav screenshotů: čeká na reálný Dialogflow agent

Co umí

Po každé rozpoznané frázi pošle Dialogflow akci a parametry na webhook. RichPear Home odpoví textem a případně provede akci přes intent_script.

Server musí být dostupný z internetu a musí mít nastavenou externí URL. Pokud webhook neodpoví nebo trvá déle než několik sekund, Dialogflow vrátí fallback odpověď.

Příprava

RichPear Home v místní síti otevřete na http://rphome.local:8123. Pokud místní název v dané síti neodpoví, použijte http://IP-ADRESA:8123.

Připravte Dialogflow agenta, veřejnou HTTPS adresu RichPear Home a rozhodněte, jaké intenty chcete podporovat. Po ukončení starých Conversational Actions už Dialogflow neslouží pro integraci s Google Assistant stejným způsobem jako dřív.

Nastavení

Tato integrace se nastavuje ručně v konfiguraci. Po úpravě YAML ověřte syntaxi, restartujte systém a až potom kontrolujte vytvořené entity.

dialogflow:
intent_script:
  Temperature:
    speech:
      text: "Teplota doma je {{ states('sensor.home_temp') }} stupňů"

Webhook URL získáte v konfiguraci integrace Dialogflow. V Dialogflow nastavte webhook fulfillment a v RichPear Home připravte odpovědi přes intent_script.

Kontrola

Otestujte jednoduchý intent bez akce a ověřte textovou odpověď. Potom přidejte intent s parametry, například místnost a stav světla, a zkontrolujte, že parametry dorazí správně.

Všechny akce ošetřete šablonami tak, aby cizí nebo chybějící parametr nespustil špatnou entitu.

Automatizace

Dialogflow se hodí pro konverzační příkazy, které vrací odpověď a případně spouští akci. Pro běžné hlasové ovládání v domácnosti ale zvažte nativní hlasové asistenty RichPear Home.

U akčních intentů vždy vraťte jasnou odpověď, co systém provedl nebo proč příkaz odmítl.

Provoz

Sledujte dostupnost veřejné URL a certifikátu. Změna domény nebo reverzní proxy vyžaduje aktualizaci webhooku v Dialogflow.

Veřejně dostupný webhook chraňte a neposílejte do něj citlivé parametry bez kontroly.

Řešení problémů

Fallback odpovědi znamenají obvykle nedostupný webhook, pomalou odpověď nebo chybu v intent_script. Zkontrolujte logy a odezvu URL z internetu.

Když parametry chybí, ověřte názvy slotů v Dialogflow a proměnné použité v šabloně.