Integrace RichPear Home
Intent Script
Intent Script umožňuje spouštět akce podle rozpoznaného záměru. Používá se pro hlasové asistenty, konverzační ovládání a scénáře, kde uživatel řekne požadavek přirozeným jazykem.
- Doména
intent_script- Kategorie
- intent
- Komunikace
- Podle konfigurace
- Kvalita
- internal
Připravte přístup a síť
Před přidáním integrace si připravte účet, IP adresu, token, párovací režim nebo API klíč podle typu zařízení. U lokálních zařízení ověřte, že jsou ve stejné síti jako RichPear Home.
Konkrétní typ připojení ověřte v průvodci integrace a v dokumentaci výrobce.
Lokální adresa
Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.
Přidejte integraci v RichPear Home
Otevřete Konfigurační soubory a následná kontrola v Nastavení → Zařízení a služby, vyhledejte Intent Script a projděte průvodce nastavením.
Dokumentace integrace zmiňuje YAML nebo ruční konfiguraci. V RichPear Home proto počítejte s kontrolou konfigurace a restartem služby, pokud průvodce není dostupný.
Zkontrolujte entity, funkce a akce
Po dokončení nastavení otevřete detail integrace, zkontrolujte vytvořená zařízení a entity a přiřaďte je do správných oblastí.
Dokumentace integrace zmiňuje i tyto akce nebo služby: Akce: Reload.
Návrh záměrů
Každý záměr pojmenujte podle jasné akce, například spuštění scény, zjištění stavu nebo provedení servisního příkazu. Popis má vysvětlit, kdy se má záměr použít.
Pokud záměr přijímá parametry, napište do popisu jejich význam a typ. U jazykových modelů je to důležité, protože bez popisu může model doplnit špatný údaj.
Akce a odpověď
Uvnitř záměru definujte akci, která se provede, a odpověď, která se vrátí uživateli. Odpověď má být krátká a potvrdit skutečný výsledek, ne jen přijetí příkazu.
U delších úloh zvažte režim, ve kterém systém nečeká na dokončení skriptu. Pak ale odpověď formulujte jako zahájení akce, nikoli jako hotový výsledek.
Bezpečnost
Hlasem nespouštějte rizikové akce bez další podmínky. Otevírání, vypínání zabezpečení nebo ovládání topení nad limit má vyžadovat přítomnost, časový rozsah nebo potvrzení.
Parametry z hlasu vždy omezte na očekávané hodnoty. Volný text může obsahovat překlep nebo nejednoznačný požadavek.
Údržba
Po změně záměrů znovu načtěte konfiguraci a vyzkoušejte běžné fráze. V logu sledujte, jestli se spouští správný záměr a jestli odpověď odpovídá provedené akci.
Při předání uživatelům zdokumentujte podporované věty a limity. Tím se sníží počet požadavků, které asistent neumí správně přiřadit.