Egyéni parancsok fogalmai és definíciói
Fontos
Az egyéni parancsok 2026. április 30-án megszűnnek. 2023. október 30-ától nem hozhat létre új Egyéni parancsokat a Speech Studióban. A módosítással kapcsolatban a LUIS 2025. október 1-jén megszűnik. 2023. április 1-től nem hozhat létre új LUIS-erőforrásokat.
Ez a cikk a Custom Commands-alkalmazások fogalmainak és definícióinak hivatkozásaként szolgál.
Parancsok konfigurálása
A parancsok az egyéni parancsok alkalmazás alapvető építőelemei. A parancsok olyan konfigurációk, amelyek egy felhasználó által meghatározott feladat elvégzéséhez szükségesek.
Példa mondatok
Példa kimondott szövegek azok a beállított példák, amelyeket a felhasználó kimondhat egy adott parancs aktiválásához. Csak a kimondott szövegek mintáját kell megadnia, és nem teljes listát.
Paraméterek
A paraméterek a parancsok által a feladat elvégzéséhez szükséges információk. Összetett helyzetekben paraméterekkel is meghatározhatók az egyéni műveleteket kiváltó feltételek.
Befejezési szabályok
A befejezési szabályok olyan szabályok sorozatát képezik, amelyeket a parancs teljesítése után kell végrehajtani, például ha a szabályok összes feltétele teljesül.
Interakciós szabályok
Az interakciós szabályok további szabályok a konkrétabb vagy összetettebb helyzetek kezelésére. További érvényesítéseket adhat hozzá, vagy konfigurálhat speciális funkciókat, például megerősítéseket vagy egylépéses javítást. Saját egyéni interakciós szabályokat is létrehozhat.
Paraméterek konfigurálása
A paraméterek a feladatok elvégzéséhez szükséges parancsok által igényelt információk. Összetett helyzetekben paraméterekkel is meghatározhatók az egyéni műveleteket kiváltó feltételek.
Név
A névtulajdonság azonosít egy paramétert. Mindig adjon leíró nevet egy paraméternek. A paraméterek különböző szakaszokban hivatkozhatók, például feltételek, beszédválaszok vagy egyéb műveletek létrehozásakor.
Szükséges
Ez a jelölőnégyzet azt jelzi, hogy a paraméter értéke szükséges-e a parancsok teljesítéséhez vagy befejezéséhez. Konfigurálnia kell a válaszokat, hogy kérje meg a felhasználót, hogy adjon meg egy értéket, ha egy paraméter kötelezőként van megjelölve.
Ha egy kötelező paramétert úgy konfigurált, hogy alapértelmezett értékkel rendelkezzen, a rendszer továbbra is kéri a paraméter értékét.
Típus
Az egyéni parancsok a következő paramétertípusokat támogatják:
- Kor
- Pénznem
- Dátum/idő
- Dimenzió
- Földrajzi hely
- Szám
- Sorszám
- Százalék
- PersonName
- PhoneNumber
- Sztring
- Hőmérséklet
- URL-cím
Minden területi beállítás támogatja a "Sztring" paramétertípust, de az összes többi típus rendelkezésre állása területi beállításonként eltérő. Az egyéni parancsok a LUIS előre összeállított entitásfeloldását használják, így egy paramétertípus rendelkezésre állása a területi beállításban a LUIS előre összeállított entitástámogatásától függ. A LUIS előre összeállított entitástámogatásával kapcsolatos további részleteket területi beállítások szerint talál. Az egyéni LUIS-entitások (például a gép által tanult entitások) jelenleg nem támogatottak.
Egyes paramétertípusok, például a Szám, a Sztring és a DateTime támogatják az alapértelmezett értékkonfigurációt, amelyet a portálon konfigurálhat.
Konfiguráció
A konfiguráció egy paramétertulajdonság, amely csak a Sztring típushoz van definiálva. A következő értékek támogatottak:
- Nincs.
- Teljes bemenet elfogadása: Ha engedélyezve van, a paraméter minden bemeneti kimondott szöveget elfogad. Ez a beállítás akkor hasznos, ha a felhasználónak teljes kimondott szöveggel rendelkező paraméterre van szüksége. Ilyenek például a postai címek.
- Előre definiált bemeneti értékek elfogadása külső katalógusból: Ez az érték egy olyan paraméter konfigurálására szolgál, amely számos különböző értéket feltételezhet. Ilyen például egy értékesítési katalógus. Ebben az esetben a katalógus egy külső webes végponton található, és egymástól függetlenül konfigurálható.
- Előre definiált bemeneti értékek elfogadása a belső katalógusból: Ez az érték egy olyan paraméter konfigurálására szolgál, amely néhány értéket feltételezhet. Ebben az esetben az értékeket a Speech Studióban kell konfigurálni.
Ellenőrzés
Az érvényesítés olyan szerkezetek, amelyek bizonyos paramétertípusokra alkalmazhatók, amelyek lehetővé teszik a paraméterek értékére vonatkozó korlátozások konfigurálását. Az egyéni parancsok jelenleg a következő paramétertípusokon támogatják az érvényesítéseket:
- Dátum/idő
- Szám
Szabályok konfigurálása
Az Egyéni parancsok szabályát olyan feltételek határozzák meg, amelyek teljesülése esetén műveletek halmazát hajtják végre. A szabályok lehetővé teszik a végrehajtás utáni állapot és az elvárások konfigurálását is a következő sorra.
Típusok
Az egyéni parancsok a következő szabálykategóriákat támogatják:
- Befejezési szabályok: Ezeket a szabályokat a parancsok teljesítésekor kell végrehajtani. A rendszer végrehajtja az ebben a szakaszban konfigurált összes szabályt, amelyre a feltételek teljesülnek.
- Interakciós szabályok: Ezekkel a szabályokkal további egyéni érvényesítések, megerősítések és egylépéses javítások konfigurálhatók, illetve bármely más egyéni párbeszédpanel-logika is elvégezhető. Az interakciós szabályok kiértékelése a feldolgozás minden egyes során történik, és a befejezési szabályok aktiválására használható.
A szabály részeként konfigurált különböző műveleteket a rendszer abban a sorrendben hajtja végre, amelyben azok megjelennek a szerzői portálon.
Feltételek
A feltételek azok a követelmények, amelyeknek teljesülniük kell egy szabály végrehajtásához. A szabályok feltételei a következő típusúak lehetnek:
- A paraméter értéke egyenlő: A konfigurált paraméter értéke egy adott értékkel egyenlő.
- Nincs paraméterérték: A konfigurált paramétereknek nem szabad értéket megadniuk.
- Kötelező paraméterek: A konfigurált paraméternek van értéke.
- Minden szükséges paraméter: Minden kötelezőként megjelölt paraméternek van értéke.
- Frissített paraméterek: Egy vagy több paraméterérték frissült az aktuális bemenet (kimondott szöveg vagy tevékenység) feldolgozása miatt.
- A megerősítés sikeres volt: A bemeneti kimondott szöveg vagy tevékenység sikeres megerősítés volt (igen).
- Megerősítés megtagadva: A bemeneti kimondott szöveg vagy tevékenység nem volt sikeres megerősítés (nem).
- Az előző parancsot frissíteni kell: Ezt a feltételt akkor használja a rendszer, ha egy nem megfelelő megerősítést és egy frissítést szeretne kapni. A színfalak mögött ez a feltétel akkor van konfigurálva, ha a párbeszédpanel-motor negatív megerősítést észlel, ahol a szándék megegyezik az előző turnével, és a felhasználó egy frissítéssel válaszolt.
Műveletek
- Beszédválasz küldése: Válasz küldése vissza az ügyfélnek.
- Paraméter értékének frissítése: Egy parancsparaméter értékének frissítése egy megadott értékre.
- Paraméter értékének törlése: Törölje a parancsparaméter értékét.
- Webes végpont hívása: Hívás indítása webes végpontra.
- Tevékenység küldése az ügyfélnek: Egyéni tevékenység küldése az ügyfélnek.
Elvárások
Az elvárások a következő felhasználói bemenet feldolgozására vonatkozó tippek konfigurálására szolgálnak. A következő típusok támogatottak:
- Megerősítést vár a felhasználótól: Ez az elvárás azt határozza meg, hogy az alkalmazás megerősítést (igen/nem) vár a következő felhasználói bemenethez.
- Paraméterbemenetet vár a felhasználótól: Ez a várakozás egy vagy több parancsparamétert határoz meg, amelyet az alkalmazás a felhasználói bemenettől vár.
Végrehajtás utáni állapot
A végrehajtás utáni állapot a párbeszédpanel állapota az aktuális bemenet (kimondott szöveg vagy tevékenység) feldolgozása után. A következő típusokat tartalmazza:
- Az aktuális állapot megtartva: Csak az aktuális állapot megtartva.
- Fejezze be a parancsot: Fejezze be a parancsot, és a parancsnak nincs több szabálya.
- Végrehajtási szabályok végrehajtása: Hajtsa végre az összes érvényes befejezési szabályt.
- Várja meg a felhasználó bemenetét: Várja meg a következő felhasználói bemenetet.