Vývoj vlastních aplikací příkazů

  • Článek

Důležité

Vlastní příkazy budou vyřazeny 30. dubna 2026. Od 30. října 2023 nemůžete v sadě Speech Studio vytvářet nové aplikace Vlastních příkazů. V souvislosti s touto změnou bude služba LUIS vyřazena 1. října 2025. Od 1. dubna 2023 nemůžete vytvářet nové prostředky LUIS.

V tomto článku s postupy se dozvíte, jak vyvíjet a konfigurovat aplikace Vlastních příkazů. Funkce Vlastní příkazy vám pomůže vytvářet bohaté aplikace pro hlasové příkazy, které jsou optimalizované pro prostředí hlasové interakce. Funkce je nejvhodnější pro scénáře dokončení úkolů nebo řízení příkazů a řízení. Je vhodný pro zařízení Internetu věcí (IoT) a pro okolní a bezobsádová zařízení.

V tomto článku vytvoříte aplikaci, která může zapnout a vypnout televizi, nastavit teplotu a nastavit alarm. Po vytvoření těchto základních příkazů se dozvíte o následujících možnostech pro přizpůsobení příkazů:

  • Přidání parametrů do příkazů
  • Přidání konfigurací do parametrů příkazu
  • Vytváření pravidel interakce
  • Vytváření šablon pro generování jazyka pro odpovědi na řeč
  • Použití vlastních hlasových nástrojů

Vytvoření aplikace pomocí jednoduchých příkazů

Začněte vytvořením prázdné aplikace Vlastních příkazů. Podrobnosti najdete v rychlém startu. V této aplikaci místo importu projektu vytvoříte prázdný projekt.

  1. Do pole Název zadejte název projektu Smart-Room-Lite (nebo jiný název podle vašeho výběru).

  2. V seznamu Jazyků vyberte angličtinu (USA).

  3. Vyberte nebo vytvořte prostředek LUIS.

    Screenshot showing the

Aktualizace prostředků SLUŽBY LUIS (volitelné)

Zdroj pro vytváření, který jste vybrali v okně Nový projekt , můžete aktualizovat. Můžete také nastavit prostředek predikce.

Prostředek předpovědi se používá k rozpoznávání při publikování aplikace Custom Commands. Během fází vývoje a testování nepotřebujete prediktivní prostředek.

Přidání příkazu TurnOn

Do prázdné aplikace Smart-Room-Lite Custom Commands, kterou jste vytvořili, přidejte příkaz. Příkaz zpracuje promluvu. Turn on the tv Odpoví zprávou Ok, turning the tv on.

  1. Vytvořte nový příkaz výběrem příkazu Nový v horní části levého podokna. Otevře se okno Nový příkaz .
  2. Do pole Název zadejte hodnotu TurnOn.
  3. Vyberte Vytvořit.

V prostředním podokně jsou uvedeny vlastnosti příkazu.

Následující tabulka vysvětluje vlastnosti konfigurace příkazu. Další informace najdete v tématu Koncepty a definice vlastních příkazů.

Konfigurace Popis
Ukázkové věty Ukázkové promluvy, které může uživatel říct, aby aktivoval tento příkaz.
Parametry Informace potřebné k dokončení příkazu.
Pravidla dokončování Akce, které se mají provést pro splnění příkazu. Příklady: reakce na uživatele nebo komunikace s webovou službou.
Pravidla interakce Další pravidla pro zpracování konkrétnějších nebo složitějších situací

Screenshot showing where to create a command.

Přidání ukázkových vět

V části Ukázkové věty zadáte příklad toho, co může uživatel říct.

  1. V prostředním podokně vyberte Ukázkové věty.

  2. V pravém podokně přidejte příklady:

    Turn on the tv

  3. V horní části podokna vyberte Uložit.

Ještě nemáte parametry, takže můžete přejít do části Pravidla dokončování.

Přidání pravidla dokončení

V dalším kroku příkaz potřebuje pravidlo dokončení. Toto pravidlo uživateli říká, že se provádí akce plnění.

Další informace o pravidlech a pravidlech dokončení najdete v tématu Koncepty a definice vlastních příkazů.

  1. Vyberte výchozí pravidlo dokončení Dokončeno. Pak ho upravte následujícím způsobem:

    Nastavení Navrhovaná hodnota Description
    Jméno ConfirmationResponse Název popisující účel pravidla
    Podmínky Nic Podmínky, které určují, kdy se pravidlo může spustit
    Akce Odeslání jednoduchého editoru odpovědi na>řeč>Ok, turning the tv on Akce, která se má provést, když je podmínka pravidla pravdivá

    Screenshot showing where to create a speech response.

  2. Akci uložíte výběrem možnosti Uložit .

  3. Zpět v části Pravidla dokončování vyberte Uložit a uložte všechny změny.

    Poznámka:

    Nemusíte používat výchozí pravidlo dokončení, které je součástí příkazu. Výchozí pravidlo dokončení můžete odstranit a přidat vlastní pravidlo.

Přidání příkazu SetTemperature

Teď přidejte ještě jeden příkaz. SetTemperature Tento příkaz vezme jednu promluvu Set the temperature to 40 degreesa odpoví zprávou Ok, setting temperature to 40 degrees.

Chcete-li vytvořit nový příkaz, postupujte podle kroků, které jste použili pro TurnOn příkaz, ale použijte ukázku věty Set the temperature to 40 degrees.

Pak upravte existující pravidla dokončení dokončeno následujícím způsobem:

Nastavení Navrhovaná hodnota
Název ConfirmationResponse
Podmínky Nic
Akce První varianta odeslání odpovědi na>řeč v jednoduchém editoru>>Ok, setting temperature to 40 degrees

Výběrem možnosti Uložit uložíte všechny změny příkazu.

Přidání příkazu SetAlarm

Vytvořte nový SetAlarm příkaz. Použijte ukázku věty Set an alarm for 9 am tomorrow. Pak upravte existující pravidla dokončení dokončeno následujícím způsobem:

Nastavení Navrhovaná hodnota
Název ConfirmationResponse
Podmínky Nic
Akce První varianta odeslání odpovědi na>řeč v jednoduchém editoru>>Ok, setting an alarm for 9 am tomorrow

Výběrem možnosti Uložit uložíte všechny změny příkazu.

Vyzkoušejte si to.

Otestujte chování aplikace pomocí testovacího podokna:

  1. V pravém horním rohu podokna vyberte ikonu Train (Trénovat ).
  2. Po dokončení trénování vyberte Test.

Vyzkoušejte následující příklady promluv pomocí hlasu nebo textu:

  • Zadáte: nastavte teplotu na 40 stupňů.
  • Očekávaná odpověď: Ok, nastavení teploty na 40 stupňů
  • Zadáte: zapněte televizor.
  • Očekávaná odpověď: Ok, zapnutí televizoru
  • Napíšete: nastavte alarm na 9 hodin zítra.
  • Očekávaná odpověď: Ok, nastavení alarmu na 9 ráno

Screenshot showing the test in a web-chat interface.

Tip

V testovacím podokně můžete vybrat možnost Turn details for information about how this voice input or text input was processed.

Přidání parametrů do příkazů

V této části se dozvíte, jak do příkazů přidat parametry. Příkazy vyžadují parametry k dokončení úkolu. Ve složitých scénářích lze parametry použít k definování podmínek, které aktivují vlastní akce.

Konfigurace parametrů pro příkaz TurnOn

Začněte úpravou existujícího TurnOn příkazu, abyste zapnuli a vypnuli více zařízení.

  1. Teď, když příkaz zpracovává scénáře zapnutí i vypnutí, přejmenujte příkaz na TurnOnOff.

    1. V podokně vlevo vyberte příkaz TurnOn . Pak vedle příkazu Nový v horní části podokna vyberte tlačítko upravit.

    2. V příkazovém okně Přejmenovat změňte název na TurnOnOff.

  2. Přidejte do příkazu nový parametr. Parametr představuje, jestli chce uživatel zařízení zapnout nebo vypnout.

    1. V horní části prostředního podokna vyberte Přidat. V rozevírací nabídce vyberte Parametr.

    2. V podokně vpravo v části Parametry v poli Název přidejte OnOff.

    3. Vyberte Požadované. V okně Přidat odpověď požadovaného parametru vyberte Jednoduchý editor. Do pole První varianta přidejte zapnuto nebo vypnuto.

    4. Vyberte Aktualizovat.

      Screenshot that shows the 'Add response for a required parameter' section with the 'Simple editor' tab selected.

    5. Pomocí následující tabulky nakonfigurujte vlastnosti parametru. Informace o všechvlastnostech

      Konfigurace Navrhovaná hodnota Description
      Jméno OnOff Popisný název parametru
      Povinní účastníci Selected Zaškrtávací políčko označující, zda je před dokončením příkazu požadována hodnota pro tento parametr.
      Odpověď na požadovaný parametr Jednoduchý editor>On or Off? Výzva k zadání hodnoty tohoto parametru, pokud není známá.
      Typ Řetězec Typ parametru, například Number, String, Date Time nebo Geography.
      Konfigurace Přijetí předdefinovaných vstupních hodnot z interního katalogu U řetězců toto nastavení omezuje vstupy na sadu možných hodnot.
      Předdefinované vstupní hodnoty on, off Sada možných hodnot a jejich aliasů

    6. Pokud chcete přidat předdefinované vstupní hodnoty, vyberte Přidat předdefinovaný vstup. V okně Nová položka zadejte Název , jak je znázorněno v předchozí tabulce. V tomto případě nepoužíváte aliasy, takže toto pole můžete nechat prázdné.

      Screenshot showing how to create a parameter.

    7. Výběrem možnosti Uložit uložte všechny konfigurace parametru.

Přidání parametru SubjectDevice

  1. Chcete-li přidat druhý parametr představující název zařízení, která lze řídit pomocí tohoto příkazu, vyberte Přidat. Použijte následující konfiguraci.

    Nastavení Navrhovaná hodnota
    Název SubjectDevice
    Povinní účastníci Selected
    Odpověď na požadovaný parametr Jednoduchý editor>Which device do you want to control?
    Typ Řetězec
    Konfigurace Přijetí předdefinovaných vstupních hodnot z interního katalogu
    Předdefinované vstupní hodnoty tv, fan
    Aliasy (tv) television, telly

  2. Zvolte Uložit.

Úprava ukázkových vět

Pro příkazy, které používají parametry, je užitečné přidat ukázkové věty, které pokrývají všechny možné kombinace. Příklad:

  • Úplné informace o parametrech: turn {OnOff} the {SubjectDevice}
  • Částečné informace o parametrech: turn it {OnOff}
  • Žádné informace o parametrech: turn something

Ukázkové věty, které používají různé stupně informací, umožňují aplikaci Custom Commands přeložit rozlišení na jednom snímku i rozlišení s vícenásobným otáčením pomocí částečných informací.

S ohledem na tyto informace upravte ukázkové věty tak, aby používaly tyto navrhované parametry:

turn {OnOff} the {SubjectDevice}
{SubjectDevice} {OnOff}
turn it {OnOff}
turn something {OnOff}
turn something

Zvolte Uložit.

Tip

V editoru s ukázkovými větami použijte složené závorky, které odkazují na vaše parametry. Například turn {OnOff} the {SubjectDevice}. Pomocí karty můžete automatické dokončování zálohované dříve vytvořenými parametry.

Úprava pravidel dokončování tak, aby zahrnovala parametry

Upravte existující pravidlo ConfirmationResponsedokončení .

  1. V části Podmínky vyberte Přidat podmínku.

  2. V okně Nová podmínka v seznamu Typ vyberte Požadované parametry. V následujícím seznamu vyberte OnOff i SubjectDevice.

  3. Vyberte Vytvořit.

  4. V části Akce upravte akci Odeslat odpověď na řeč tak, že na ni najedete myší a vyberete tlačítko upravit. Tentokrát použijte nově vytvořené OnOff parametry:SubjectDevice

    Ok, turning the {SubjectDevice} {OnOff}

  5. Zvolte Uložit.

Vyzkoušejte změny výběrem ikony Train (Trénovat) v horní části podokna vpravo.

Po dokončení trénování vyberte Test. Zobrazí se okno Test vaší aplikace . Vyzkoušejte následující interakce:

  • Vstup: vypněte televizor.
  • Výstup: Ok, vypnutí televizoru
  • Vstup: vypněte televizi.
  • Výstup: Ok, vypnutí televizoru
  • Vstup: vypněte ho.
  • Výstup: Které zařízení chcete ovládat?
  • Vstup: tv
  • Výstup: Ok, vypnutí televizoru

Konfigurace parametrů pro příkaz SetTemperature

SetTemperature Upravte příkaz tak, aby nastavil teplotu tak, jak to uživatel nasměruje.

TemperatureValue Přidejte parametr. Použijte následující konfiguraci:

Konfigurace Navrhovaná hodnota
Název TemperatureValue
Povinní účastníci Selected
Odpověď na požadovaný parametr Jednoduchý editor>What temperature would you like?
Typ Number

Upravte ukázkové promluvy tak, aby používaly následující hodnoty.

set the temperature to {TemperatureValue} degrees
change the temperature to {TemperatureValue}
set the temperature
change the temperature

Upravte existující pravidla dokončování. Použijte následující konfiguraci.

Konfigurace Navrhovaná hodnota
Podmínky Povinný parametr>TemperatureValue
Akce Odeslání odpovědi na řeč>Ok, setting temperature to {TemperatureValue} degrees

Konfigurace parametrů pro příkaz SetAlarm

Přidejte parametr s názvem DateTime. Použijte následující konfiguraci.

Nastavení Navrhovaná hodnota
Název DateTime
Povinní účastníci Selected
Odpověď na požadovaný parametr Jednoduchý editor>For what time?
Typ Datetime
Výchozí hodnoty data Pokud chybí datum, použijte dnes.
Výchozí hodnoty času Pokud čas chybí, použijte začátek dne.

Poznámka:

Tento článek většinou používá typy parametrů String, Number a DateTime. Seznam všech podporovaných typů parametrů a jejich vlastností najdete v tématu Koncepty a definice vlastních příkazů.

Upravte ukázkové promluvy. Použijte následující hodnoty.

set an alarm for {DateTime}
set alarm {DateTime}
alarm for {DateTime}

Upravte existující pravidla dokončování. Použijte následující konfiguraci.

Nastavení Navrhovaná hodnota
Akce Odeslání odpovědi na řeč>Ok, alarm set for {DateTime}

Otestujte tři příkazy společně pomocí promluv souvisejících s různými příkazy. (Můžete přepínat mezi různými příkazy.)

  • Vstup: Nastavení alarmu
  • Výstup: Kdy?
  • Vstup: Zapnutí televizoru
  • Výstup: Ok, zapnutí televizoru
  • Vstup: Nastavení alarmu
  • Výstup: Kdy?
  • Vstup: 5:00
  • Výstup: Ok, alarm nastavený pro 2020-05-01 17:00:00

Přidání konfigurací do parametrů příkazů

V této části se dozvíte další informace o pokročilé konfiguraci parametrů, včetně následujících:

  • Jak můžou hodnoty parametrů patřit do sady definované mimo aplikaci Custom Commands.
  • Přidání ověřovacích klauzulí k hodnotám parametrů

Konfigurace parametru jako entity externího katalogu

Funkce Vlastní příkazy umožňuje konfigurovat parametry typu řetězce tak, aby odkazovali na externí katalogy hostované přes webový koncový bod. Externí katalog tak můžete aktualizovat nezávisle bez úprav aplikace Vlastní příkazy. Tento přístup je užitečný v případech, kdy jsou položky katalogu mnoho.

SubjectDevice Znovu použijte parametr z TurnOnOff příkazu. Aktuální konfigurace pro tento parametr je Přijmout předdefinované vstupy z interního katalogu. Tato konfigurace odkazuje na statický seznam zařízení v konfiguraci parametru. Přesuňte tento obsah do externího zdroje dat, který lze aktualizovat nezávisle.

Pokud chcete obsah přesunout, začněte přidáním nového webového koncového bodu. V podokně vlevo přejděte do části Webové koncové body . Přidejte novou adresu URL webového koncového bodu. Použijte následující konfiguraci.

Nastavení Navrhovaná hodnota
Název getDevices
Adresa URL <Your endpoint of getDevices.json>
Metoda GET

Pak nakonfigurujte a hostujte webový koncový bod, který vrací soubor JSON se seznamem zařízení, která se dají ovládat. Webový koncový bod by měl vrátit soubor JSON formátovaný jako v tomto příkladu:

{
    "fan" : [],
    "refrigerator" : [
        "fridge"
    ],
    "lights" : [
        "bulb",
        "bulbs",
        "light",
        "light bulb"
    ],
    "tv" : [
        "telly",
        "television"
        ]
}

Dále přejděte na stránku nastavení parametrů SubjectDevice . Nastavte následující vlastnosti.

Nastavení Navrhovaná hodnota
Konfigurace Přijmout předdefinované vstupy z externího katalogu
Koncový bod katalogu getDevices
Metoda GET

Pak vyberte Uložit.

Důležité

Možnost konfigurace parametru pro příjem vstupů z externího katalogu se nezobrazí, pokud nemáte webový koncový bod nastavený v části Webový koncový bod v podokně vlevo.

Vyzkoušejte si to výběrem možnosti Train (Trénovat). Po dokončení trénování vyberte Test a zkuste několik interakcí.

  • Vstup: zapněte
  • Výstup: Které zařízení chcete ovládat?
  • Vstup: světla
  • Výstup: Ok, zapnutí světel

Poznámka:

Teď můžete řídit všechna zařízení hostovaná ve webovém koncovém bodu. Přesto ale potřebujete aplikaci vytrénovat, aby otestuje nové změny, a pak aplikaci znovu publikujte.

Přidání ověření k parametrům

Ověření jsou konstrukce, které platí pro určité typy parametrů, které umožňují konfigurovat omezení hodnoty parametru. Zobrazí výzvu k opravám, pokud hodnoty nespadají do omezení. Seznam typů parametrů, které rozšiřují konstruktor ověřování, naleznete v tématu Koncepty a definice vlastních příkazů.

Otestujte ověření pomocí SetTemperature příkazu. Pomocí následujícího postupu přidejte ověření parametru Temperature .

  1. V podokně vlevo vyberte příkaz SetTemperature .

  2. V prostředním podokně vyberte Teplota.

  3. V podokně vpravo vyberte Přidat ověření.

  4. V okně Nové ověření nakonfigurujte ověření, jak je znázorněno v následující tabulce. Pak vyberte Vytvořit.

    Konfigurace parametrů Navrhovaná hodnota Popis
    Minimální hodnota 60 U parametrů Číslo může minimální hodnota tohoto parametru předpokládat.
    Maximální hodnota 80 U parametrů Číslo může maximální hodnota tohoto parametru předpokládat.
    Odpověď na selhání Jednoduchá varianta editoru>– první varianta>Sorry, I can only set temperature between 60 and 80 degrees. What temperature do you want? Výzva k zadání nové hodnoty, pokud se ověření nezdaří

    Screenshot showing how to add a range validation.

Vyzkoušejte si to výběrem ikony Train (Trénovat) v horní části podokna vpravo. Po dokončení trénování vyberte Test. Vyzkoušejte několik interakcí:

  • Vstup: Nastavte teplotu na 72 stupňů.
  • Výstup: Ok, nastavení teploty na 72 stupňů
  • Vstup: Nastavte teplotu na 45 stupňů.
  • Výstup: Omlouvám se, ale můžu nastavit teplotu pouze mezi 60 stupňů a 80 stupňů.
  • Vstup: nastavte místo toho 72 stupňů.
  • Výstup: Ok, nastavení teploty na 72 stupňů

Přidání pravidel interakce

Pravidla interakce jsou další pravidla, která zpracovávají konkrétní nebo složité situace. I když můžete vytvářet vlastní pravidla interakce, v tomto příkladu použijete pravidla interakce pro následující scénáře:

  • Potvrzení příkazů
  • Přidání opravy o krok do příkazů

Další informace o pravidlech interakce najdete v tématu Koncepty a definice vlastních příkazů.

Přidání potvrzení do příkazu

Pokud chcete přidat potvrzení, použijte SetTemperature tento příkaz. K potvrzení vytvořte pravidla interakce pomocí následujícího postupu:

  1. V podokně vlevo vyberte příkaz SetTemperature .

  2. V prostředním podokně přidejte pravidla interakce výběrem možnosti Přidat. Pak vyberte příkaz Potvrdit pravidla>interakce.

    Tato akce přidá tři pravidla interakce. Pravidla uživatele vyzve, aby potvrdil datum a čas alarmu. U dalšího turnu očekávají potvrzení (ano nebo ne).

    1. Upravte pravidlo interakce příkazu Potvrdit pomocí následující konfigurace:

      1. Změňte název na Potvrzení teploty.
      2. Podmínka Všechny požadované parametry jsou již nastaveny.
      3. Přidat novou akci: Zadejte>odpověď>na odeslání řeči. Opravdu chcete nastavit teplotu jako {TemperatureValue} stupňů?
      4. V části Očekávání ponechte výchozí hodnotu Očekávání potvrzení od uživatele.

      Screenshot showing how to create the required parameter response.

    2. Upravte pravidlo úspěšné interakce potvrzení tak, aby zpracoval úspěšné potvrzení (uživatel řekl ano).

      1. Změňte název na Potvrzovací teplota byla úspěšná.
      2. Ponechte existující podmínku Potvrzení úspěšné .
      3. Přidejte novou podmínku: Zadejte>požadované parametry>TemperatureValue.
      4. Ponechte výchozí hodnotu stavu po spuštění jako pravidla dokončení provádění.

    3. Upravte pravidlo interakce s potvrzením odepření tak, aby zpracovával scénáře při odepření potvrzení (uživatel řekl ne).

      1. Změňte název na Potvrzená teplota odepřena.
      2. Ponechte existující podmínku Potvrzení zamítnuto .
      3. Přidejte novou podmínku: Zadejte>požadované parametry>TemperatureValue.
      4. Přidání nové akce: Napište>Odeslat odpověď>na řeč Bez problému. Jakou teplotu pak?
      5. Změňte výchozí hodnotu stavu po spuštění na hodnotu Čekání na vstup uživatele.

Důležité

V tomto článku použijete integrovanou potvrzovací funkci. Pravidla interakce můžete přidat také ručně po druhém.

Vyzkoušejte změny výběrem možnosti Train (Trénovat). Po dokončení trénování vyberte Test.

  • Vstup: Nastavení teploty na 80 stupňů
  • Výstup: Opravdu chcete nastavit teplotu jako 80 stupňů?
  • Vstup: Ne
  • Výstup: Žádný problém. Jaká teplota pak?
  • Vstup: 72 stupňů
  • Výstup: Opravdu chcete nastavit teplotu jako 72 stupňů?
  • Vstup: Ano
  • Výstup: OK, nastavení teploty na 72 stupňů

Implementace oprav v příkazu

V této části nakonfigurujete opravu s jedním krokem. Tato oprava se použije po spuštění akce plnění. Uvidíte také příklad toho, jak je ve výchozím nastavení povolená oprava, pokud příkaz ještě není splněný. Pokud chcete přidat opravu, když příkaz není hotový, přidejte nový parametr AlarmTone.

V levém podokně vyberte příkaz SetAlarm . Pak přidejte nový parametr AlarmTone.

  • Název>AlarmTone
  • Řetězec typu>
  • Výchozí šimény hodnot>
  • Konfigurace>Přijmout předdefinované vstupní hodnoty z interního katalogu
  • Předdefinované vstupní hodnoty>Chimes, Jingle a Echo (tyto hodnoty jsou jednotlivé předdefinované vstupy.)

Dále aktualizujte odpověď parametru DateTime na hodnotu Připraveno k nastavení alarmu s tónem {AlarmTone}. Na kolik času? Potom upravte pravidlo dokončení následujícím způsobem:

  1. Vyberte existující pravidlo dokončení ConfirmationResponse.
  2. V podokně vpravo najeďte myší na existující akci a vyberte Upravit.
  3. Aktualizujte odpověď řeči na OK, alarm set for {DateTime}. The alarm tone is {AlarmTone}.

Důležité

Tón alarmu se může změnit bez explicitní konfigurace v probíhajícím příkazu. Může se například změnit, když se příkaz ještě nedokončil. Oprava je ve výchozím nastavení povolena pro všechny parametry příkazu bez ohledu na číslo otáčení, pokud příkaz ještě není splněn.

Implementace opravy po dokončení příkazu

Platforma Custom Commands umožňuje opravu jedním krokem i po dokončení příkazu. Tato funkce není ve výchozím nastavení povolená. Musí být explicitně nakonfigurovaný.

Pomocí následujících kroků nakonfigurujte opravu jedním krokem:

  1. V příkazu SetAlarm přidejte pravidlo interakce typu Aktualizovat předchozí příkaz pro aktualizaci dříve nastaveného alarmu. Přejmenujte pravidlo interakce jako aktualizovat předchozí alarm.
  2. Ponechte výchozí podmínku: Předchozí příkaz je potřeba aktualizovat.
  3. Přidejte novou podmínku: Zadejte>požadovaný parametr>DateTime.
  4. Přidat novou akci: Zadejte>odeslat odpověď na řeč>– Jednoduchý editor>, který aktualizuje předchozí čas alarmu na {DateTime}.
  5. Ponechte výchozí hodnotu stavu po spuštění jako dokončený příkaz.

Vyzkoušejte změny výběrem možnosti Train (Trénovat). Počkejte, až se trénování dokončí, a pak vyberte Test.

  • Vstup: Nastavte alarm.
  • Výstup: Připraveno k nastavení alarmu s tónem jako Chimes. Na jakou dobu?
  • Vstup: Nastavte alarm s tónem jako Jingle pro 9 hodin zítra.
  • Výstup: OK, alarm nastavený pro 2020-05-21 09:00:00. Tón alarmu je Jingle.
  • Vstup: Ne, 8 am.
  • Výstup: Aktualizace předchozího času alarmu na 2020-05-29 08:00.

Poznámka:

V reálné aplikaci budete muset v části Akce tohoto pravidla opravy odeslat zpět aktivitu klientovi nebo volat koncový bod HTTP, který aktualizuje čas alarmu ve vašem systému. Tato akce by měla být zodpovědná výhradně za aktualizaci času alarmu. Nemělo by být zodpovědné za žádný jiný atribut příkazu. V tomto případě by tento atribut byl tón alarmu.

Přidání šablon pro generování jazyka pro odpovědi na řeč

Šablony pro generování jazyka (LG) umožňují přizpůsobit odpovědi odeslané klientovi. Do odpovědí zavádějí odchylku. Generování jazyka můžete dosáhnout pomocí:

  • Šablony generování jazyka.
  • Adaptivní výrazy.

Vlastní šablony příkazů jsou založené na šablonách LG služby Bot Framework. Vzhledem k tomu, že funkce Vlastní příkazy vytvoří novou šablonu LG v případě potřeby (pro odpovědi řeči v parametrech nebo akcích), nemusíte zadávat název šablony LG.

Takže šablonu nemusíte definovat takto:

   # CompletionAction
   - Ok, turning {OnOff} the {SubjectDevice}
   - Done, turning {OnOff} the {SubjectDevice}
   - Proceeding to turn {OnOff} {SubjectDevice}

Místo toho můžete definovat text šablony bez názvu, například takto:

Screenshot showing a template editor example.

Tato změna zavádí variaci odpovědí na řeč, které se odesílají klientovi. U promluvy se odpovídající odpověď řeči náhodně vybere z poskytnutých možností.

Když využijete šablony LG, můžete také definovat složité odpovědi řeči pro příkazy pomocí adaptivních výrazů. Další informace naleznete ve formátu šablon LG.

Funkce Vlastní příkazy ve výchozím nastavení podporuje všechny možnosti s následujícími drobnými rozdíly:

  • V šablonách LG jsou entity reprezentovány jako ${entityName}. Funkce Vlastní příkazy nepoužívá entity. Parametry ale můžete použít jako proměnné s reprezentací ${parameterName} nebo reprezentací {parameterName} .
  • Funkce Vlastní příkazy nepodporuje složení a rozšíření šablon, protože soubor .lg nikdy neupravujete přímo. Upravujete pouze odpovědi automaticky vytvořených šablon.
  • Funkce Vlastní příkazy nepodporuje vlastní funkce, které LG vloží. Podporují se předdefinované funkce.
  • Funkce Vlastní příkazy nepodporuje možnosti, například strict, replaceNulla lineBreakStyle.

Přidání odpovědí šablony do příkazu TurnOnOff

TurnOnOff Upravte příkaz tak, aby přidal nový parametr. Použijte následující konfiguraci.

Nastavení Navrhovaná hodnota
Název SubjectContext
Povinní účastníci Nevybráno
Typ Řetězec
Výchozí hodnota all
Konfigurace Přijetí předdefinovaných vstupních hodnot z interního katalogu
Předdefinované vstupní hodnoty room, , bathroomall

Úprava pravidla dokončení

Upravte oddíl Akce existujícího pravidla dokončení ConfirmationResponse. V okně upravit akci přepněte do Editoru šablon. Potom nahraďte text následujícím příkladem.

- IF: @{SubjectContext == "all" && SubjectDevice == "lights"}
    - Ok, turning all the lights {OnOff}
- ELSEIF: @{SubjectDevice == "lights"}
    - Ok, turning {OnOff} the {SubjectContext} {SubjectDevice}
- ELSE:
    - Ok, turning the {SubjectDevice} {OnOff}
    - Done, turning {OnOff} the {SubjectDevice}

Natrénujte a otestujte aplikaci pomocí následujícího vstupu a výstupu. Všimněte si varianty odpovědí. Varianta je vytvořená několika alternativami hodnoty šablony a také pomocí adaptivních výrazů.

  • Vstup: zapněte televizor.
  • Výstup: Ok, zapnutí televizoru
  • Vstup: zapněte televizor.
  • Výstup: Hotovo, zapnuto na televizoru
  • Vstup: vypněte světla.
  • Výstup: Ok, vypnutí všech světel
  • Vstup: vypnutí světel místností
  • Výstup: Ok, vypnutí světel místnosti

Použití vlastního hlasu

Další možností, jak přizpůsobit odpovědi vlastních příkazů, je vybrat výstupní hlas. Pomocí následujících kroků přepněte výchozí hlas na vlastní hlas:

  1. V aplikaci Vlastní příkazy v podokně vlevo vyberte Nastavení.
  2. V prostředním podokně vyberte Vlastní hlas.
  3. V tabulce vyberte vlastní hlas nebo veřejný hlas.
  4. Zvolte Uložit.

Screenshot showing sample sentences and parameters.

Poznámka:

Pro veřejné hlasy jsou neurální typy dostupné jenom pro konkrétní oblasti. Další informace najdete v tématu Podporované oblasti služby Speech.

Vlastní hlasy můžete vytvořit na stránce Vlastní hlasový projekt. Další informace najdete v tématu Začínáme s vlastním hlasem.

Aplikace teď reaguje ve vybraném hlasu místo výchozího hlasu.

Další kroky