Koncepty a definice vlastních příkazů

  • Článek

Důležité

Vlastní příkazy budou vyřazeny 30. dubna 2026 a od 30. října 2023 nebude možné vytvářet nové aplikace vlastních příkazů v nástroji Speech Studio. V souvislosti s touto změnou bude služba LUIS 1. října 2025 vyřazena a od 1. dubna 2023 nebude možné vytvářet nové prostředky služby LUIS.

Tento článek slouží jako referenční informace o konceptech a definicích aplikací vlastních příkazů.

Konfigurace příkazů

Příkazy jsou základní stavební bloky aplikace Vlastních příkazů. Příkaz je sada konfigurací potřebných k dokončení konkrétní úlohy definované uživatelem.

Ukázkové věty

Příklady promluv jsou sady příkladů, které uživatel může říct, aby aktivovalo konkrétní příkaz. Musíte zadat pouze vzorek promluv, nikoli vyčerpávající seznam.

Parametry

Parametry jsou informace vyžadované příkazy k dokončení úlohy. Ve složitých scénářích lze parametry použít také k definování podmínek, které aktivují vlastní akce.

Pravidla dokončování

Pravidla dokončení jsou řada pravidel, která se mají provést poté, co je příkaz připraven ke splnění, například když jsou splněny všechny podmínky pravidel.

Pravidla interakce

Pravidla interakce jsou další pravidla pro zpracování konkrétnějších nebo složitějších situací. Můžete přidat další ověření nebo nakonfigurovat pokročilé funkce, jako jsou potvrzení nebo oprava v jednom kroku. Můžete také vytvořit vlastní pravidla interakce.

Konfigurace parametrů

Parametry jsou informace vyžadované příkazy k dokončení úlohy. Ve složitých scénářích lze parametry použít také k definování podmínek, které aktivují vlastní akce.

Name

Parametr je identifikován vlastností name. Parametr byste měli vždy pojmenovat popisně. Parametr lze odkazovat v různých oddílech, například při vytváření podmínek, odpovědí na řeč nebo jiných akcí.

Vyžadováno

Toto zaškrtávací políčko označuje, jestli se hodnota tohoto parametru vyžaduje pro splnění nebo dokončení příkazu. Pokud je parametr označený jako povinný, musíte nakonfigurovat odpovědi, které uživatele vyzve k zadání hodnoty.

Mějte na paměti, že pokud jste nakonfigurovali požadovaný parametr tak, aby měl výchozí hodnotu, systém stále explicitně vyzve k zadání hodnoty parametru.

Typ

Vlastní příkazy podporují následující typy parametrů:

  • Věk
  • Měna
  • DateTime
  • Dimenze
  • E-mail
  • Geografie
  • Číslo
  • Řádová číslovka
  • Procento
  • Jméno osoby
  • PhoneNumber
  • Řetězec
  • Teplota
  • URL

Každé národní prostředí podporuje typ parametru String, ale dostupnost všech ostatních typů se liší podle národního prostředí. Vlastní příkazy používají rozlišení předem připravených entit služby LUIS, takže dostupnost typu parametru v národním prostředí závisí na podpoře předem připravených entit služby LUIS v tomto národním prostředí. Další podrobnosti najdete v tématu Podpora předem připravených entit služby LUIS pro jednotlivá národní prostředí. Vlastní entity služby LUIS (například strojově naučené entity) se v současné době nepodporují.

Některé typy parametrů, jako jsou Number, String a DateTime, podporují konfiguraci výchozích hodnot, kterou můžete nakonfigurovat na portálu.

Konfigurace

Konfigurace je vlastnost parametru definovaná pouze pro typ String. Podporují se následující hodnoty:

  • Žádné.
  • Přijmout úplný vstup: Pokud je povolená, parametr přijímá všechny vstupní promluvy. Tato možnost je užitečná, když uživatel potřebuje parametr s úplnou promluvou. Příkladem jsou poštovní adresy.
  • Přijmout předdefinované vstupní hodnoty z externího katalogu: Tato hodnota se používá ke konfiguraci parametru, který může předpokládat širokou škálu hodnot. Příkladem je prodejní katalog. V tomto případě je katalog hostovaný na externím webovém koncovém bodu a je možné ho nakonfigurovat nezávisle.
  • Přijmout předdefinované vstupní hodnoty z interního katalogu: Tato hodnota slouží ke konfiguraci parametru, který může předpokládat několik hodnot. V tomto případě musí být hodnoty nakonfigurované v speech studiu.

Ověřování

Ověření jsou konstrukce použitelné pro určité typy parametrů, které umožňují konfigurovat omezení hodnoty parametru. V současné době vlastní příkazy podporují ověřování u následujících typů parametrů:

  • DateTime
  • Číslo

Konfigurace pravidel

Pravidlo ve vlastních příkazech je definováno sadou podmínek , které při splnění spustí sadu akcí. Pravidla také umožňují nakonfigurovat stav po spuštění a očekávání pro další tah.

Typy

Vlastní příkazy podporují následující kategorie pravidel:

  • Pravidla dokončení: Tato pravidla se musí spustit při splnění příkazu. Budou provedena všechna pravidla nakonfigurovaná v této části, pro která platí podmínky.
  • Pravidla interakce: Tato pravidla se dají použít ke konfiguraci dalších vlastních ověření, potvrzení a jednostupňové opravy nebo k provedení jakékoli jiné vlastní logiky dialogového okna. Pravidla interakce se vyhodnocují při každém otočení zpracování a dají se použít k aktivaci pravidel dokončení.

Různé akce nakonfigurované jako součást pravidla se spouštějí v pořadí, ve kterém se zobrazují na portálu pro vytváření obsahu.

Podmínky

Podmínky jsou požadavky, které musí být splněny, aby se pravidlo spustilo. Podmínky pravidel můžou být následujících typů:

  • Hodnota parametru se rovná: Hodnota nakonfigurovaného parametru se rovná určité hodnotě.
  • Žádná hodnota parametru: Nakonfigurované parametry by neměly mít žádnou hodnotu.
  • Požadované parametry: Nakonfigurovaný parametr má hodnotu.
  • Všechny požadované parametry: Všechny parametry, které byly označené jako povinné, mají hodnotu.
  • Aktualizované parametry: Jedna nebo více hodnot parametrů se aktualizovaly v důsledku zpracování aktuálního vstupu (promluvy nebo aktivity).
  • Potvrzení proběhlo úspěšně: Vstupní promluva nebo aktivita byla úspěšným potvrzením (ano).
  • Potvrzení bylo zamítnuto: Vstupní promluva nebo aktivita nebyla úspěšně potvrzena (ne).
  • Předchozí příkaz je potřeba aktualizovat: Tato podmínka se používá v případech, kdy chcete spolu s aktualizací zachytit negované potvrzení. Na pozadí se tato podmínka nakonfiguruje pro, když modul dialogového okna zjistí negativní potvrzení, kdy záměr je stejný jako při předchozím otočení a uživatel odpověděl aktualizací.

Akce

  • Odeslat odpověď na řeč: Odešle zpět klientovi odpověď na řeč.
  • Aktualizovat hodnotu parametru: Aktualizujte hodnotu parametru příkazu na zadanou hodnotu.
  • Vymazat hodnotu parametru: Vymažte hodnotu parametru příkazu.
  • Volání webového koncového bodu: Volání webového koncového bodu
  • Odeslat aktivitu klientovi: Odešle klientovi vlastní aktivitu.

Očekávání

Očekávání se používají ke konfiguraci tipů pro zpracování dalšího uživatelského vstupu. Jsou podporovány následující typy:

  • Očekávání potvrzení od uživatele: Toto očekávání určuje, že aplikace očekává potvrzení (ano/ne) pro další uživatelský vstup.
  • Očekávání vstupu parametrů od uživatele: Toto očekávání určuje jeden nebo více parametrů příkazu, které aplikace očekává od vstupu uživatele.

Stav po spuštění

Stav po spuštění je stav dialogového okna po zpracování aktuálního vstupu (promluvy nebo aktivity). Jedná se o následující typy:

  • Zachovat aktuální stav: Zachovat pouze aktuální stav.
  • Dokončete příkaz: Dokončete příkaz a nezpracují se žádná další pravidla příkazu.
  • Spustit pravidla dokončení: Proveďte všechna platná pravidla dokončení.
  • Počkejte na vstup uživatele: Počkejte na další uživatelský vstup.

Další kroky

Projděte si ukázky na GitHubu.