Hlas a text

Conversation

Conversation zpracovává textové příkazy a předává je konverzačnímu agentovi. Slouží pro hlasové asistenty, textové příkazy a vlastní věty.

Začít nastavení Zpět na integrace

Doména: conversation
Kategorie: hlas
Komunikace: lokální zpracování podle agenta
Nastavení: systémová konfigurace
Akce: conversation.process, conversation.reload

Co integrace přidá

Conversation umožňuje poslat přepsaný text do konverzačního agenta. Uživatel může příkaz zadat přes mikrofon v podporovaném prohlížeči nebo voláním akce conversation.process.

Vestavěné věty pokrývají běžné příkazy podle jazyka. Vlastní věty lze doplnit v adresáři custom_sentences/<jazyk> a navázat je na vlastní intent nebo rozšířit vestavěné intenty.

Kontrolní témata

Základní konfigurace používá conversation:.
Vlastní věty se ukládají do jazykových YAML souborů.
Akce conversation.reload znovu načte intent konfiguraci.
Přesnost závisí na jazyku, názvech entit, oblastech a zvoleném agentovi.

Příprava před přidáním

Zkontrolujte jazyk systému a názvy entit, oblastí a zařízení. Hlasové a textové příkazy fungují nejlépe s krátkými, jednoznačnými názvy.

Pokud chcete vlastní věty, vytvořte adresář pro jazyk, například custom_sentences/cs, a připravte YAML soubor s větami.

Vlastní věty testujte po malých změnách. Jedna obecná věta může nechtěně zachytávat víc příkazů, než čekáte.

Nastavení v RichPear Home

Základní zápis v konfiguraci je jednoduchý. Po změně restartujte RichPear Home nebo použijte reload konverzačních agentů, pokud měníte jen věty/intenty.

conversation:

intent_script:
  CustomOutsideHumidity:
    speech:
      text: "Venkovní vlhkost je {{ states('sensor.venkovni_vlhkost') }} %."

Kontrola entit a funkcí

Otestujte krátký příkaz v rozhraní Assist nebo voláním akce conversation.process. Sledujte, jaký intent byl rozpoznán a jaká odpověď se vrátila.

U vlastních vět ověřte, že fungují v cílovém jazyce a nebijí se s vestavěnými příkazy.

Po nastavení

Zkraťte názvy entit a oblastí.
Testujte věty v přesném jazyce domácnosti.
Po změně YAML použijte reload nebo restart.
Citlivé akce chraňte potvrzením nebo podmínkami.

Použití v automatizacích

Conversation lze použít pro textové spouštění akcí, vlastní intent skripty nebo hlasové scénáře. U nevratných akcí přidejte kontrolní otázku nebo jinou ochranu.

Vlastní intenty jsou vhodné pro fráze typu stav domu, spuštění scén nebo dotazy na vybrané senzory.

Provoz a údržba

Po přejmenování entit nebo oblastí projděte vlastní věty a upravte sloty.

Při rozšíření hlasového ovládání si veďte seznam podporovaných frází, aby se daly snadno testovat po aktualizaci.

Řešení problémů

Když příkaz není rozpoznán, ověřte jazyk, názvy entit, umístění souboru vlastních vět, YAML syntaxi, reload agentů a logy konverzační integrace.

Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény conversation. Integraci neodstraňujte jako první krok; nejdřív ověřte přístup, síť, konfiguraci a poslední úspěšnou aktualizaci.