Begrepp och definitioner för anpassade kommandon

Viktigt!

Anpassade kommandon dras tillbaka den 30 april 2026. Från och med den 30 oktober 2023 kan du inte skapa nya program för anpassade kommandon i Speech Studio. I samband med den här ändringen dras LUIS tillbaka den 1 oktober 2025. Från och med den 1 april 2023 kan du inte skapa nya LUIS-resurser.

Den här artikeln fungerar som en referens för begrepp och definitioner för program med anpassade kommandon.

Konfiguration av kommandon

Kommandon är de grundläggande byggstenarna i ett program för anpassade kommandon. Ett kommando är en uppsättning konfigurationer som krävs för att slutföra en specifik uppgift som definieras av en användare.

Exempel på meningar

Exempelyttranden är de exempel som användaren kan säga utlöser ett visst kommando. Du behöver bara ange ett urval av yttranden och inte en fullständig lista.

Parametrar

Parametrar är information som krävs av kommandona för att slutföra en uppgift. I komplexa scenarier kan parametrar också användas för att definiera villkor som utlöser anpassade åtgärder.

Slutföranderegler

Slutföranderegler är en serie regler som ska köras när kommandot är redo att uppfyllas, till exempel när alla villkor i reglerna är uppfyllda.

Interaktionsregler

Interaktionsregler är extra regler för att hantera mer specifika eller komplexa situationer. Du kan lägga till fler valideringar eller konfigurera avancerade funktioner som bekräftelser eller en korrigering i ett steg. Du kan också skapa egna anpassade interaktionsregler.

Konfiguration av parametrar

Parametrar är information som krävs av kommandon för att slutföra en uppgift. I komplexa scenarier kan parametrar också användas för att definiera villkor som utlöser anpassade åtgärder.

Name

En parameter identifieras av namnegenskapen. Du bör alltid ge ett beskrivande namn till en parameter. En parameter kan refereras i olika avsnitt, till exempel när du skapar villkor, talsvar eller andra åtgärder.

Obligatoriskt

Den här kryssrutan anger om ett värde för den här parametern krävs för kommandouppfyllelse eller slutförande. Du måste konfigurera svar för att uppmana användaren att ange ett värde om en parameter har markerats som obligatorisk.

Om du har konfigurerat en obligatorisk parameter för att ha ett standardvärde frågar systemet fortfarande efter parameterns värde.

Typ

Anpassade kommandon stöder följande parametertyper:

• Ålder
• Valuta
• Datum/tid
• Dimension
• Email
• Geografi
• Antal
• Ordning
• Procent
• PersonName
• PhoneNumber
• String
• Temperatur
• URL

Varje språk har stöd för parametertypen "String", men tillgängligheten för alla andra typer skiljer sig åt beroende på språkvariant. Anpassade kommandon använder LUIS:s fördefinierade entitetsmatchning, så tillgängligheten för en parametertyp i ett språk beror på LUIS fördefinierade entitetsstöd i det språket. Du hittar mer information om LUIS fördefinierade entitetsstöd per språk. Anpassade LUIS-entiteter (till exempel maskininlärda entiteter) stöds för närvarande inte.

Vissa parametertyper som Number, String och DateTime stöder standardvärdekonfiguration, som du kan konfigurera från portalen.

Konfiguration

Konfiguration är en parameteregenskap som endast definieras för typen Sträng. Följande värden stöds:

• Inga.
• Acceptera fullständiga indata: När den är aktiverad accepterar en parameter alla indatayttranden. Det här alternativet är användbart när användaren behöver en parameter med det fullständiga yttrandet. Ett exempel är postadresser.
• Acceptera fördefinierade indatavärden från en extern katalog: Det här värdet används för att konfigurera en parameter som kan anta en mängd olika värden. Ett exempel är en försäljningskatalog. I det här fallet finns katalogen på en extern webbslutpunkt och kan konfigureras separat.
• Acceptera fördefinierade indatavärden från den interna katalogen: Det här värdet används för att konfigurera en parameter som kan anta några få värden. I det här fallet måste värden konfigureras i Speech Studio.

Verifiering

Valideringar är konstruktioner som gäller för vissa parametertyper som gör att du kan konfigurera begränsningar för en parameters värde. Anpassade kommandon har för närvarande stöd för valideringar av följande parametertyper:

• Datum/tid
• Antal

Regelkonfiguration

En regel i anpassade kommandon definieras av en uppsättning villkor som när de uppfylls kör en uppsättning åtgärder. Med regler kan du också konfigurera tillstånd efter körning och förväntningar för nästa tur.

Typer

Anpassade kommandon stöder följande regelkategorier:

• Slutföranderegler: Dessa regler måste köras när kommandot uppfylls. Alla regler som konfigureras i det här avsnittet för vilka villkoren är sanna kommer att köras.
• Interaktionsregler: Dessa regler kan användas för att konfigurera extra anpassade valideringar, bekräftelser och en korrigering i ett steg eller för att utföra någon annan anpassad dialoglogik. Interaktionsregler utvärderas vid varje tur i bearbetningen och kan användas för att utlösa slutföranderegler.

De olika åtgärder som konfigureras som en del av en regel körs i den ordning de visas i redigeringsportalen.

Villkor

Villkor är de krav som måste uppfyllas för att en regel ska kunna köras. Regelvillkor kan vara av följande typer:

• Parametervärdet är lika med: Värdet för den konfigurerade parametern är lika med ett specifikt värde.
• Inget parametervärde: De konfigurerade parametrarna får inte ha något värde.
• Obligatoriska parametrar: Den konfigurerade parametern har ett värde.
• Alla obligatoriska parametrar: Alla parametrar som har markerats som obligatoriska har ett värde.
• Uppdaterade parametrar: Ett eller flera parametervärden uppdaterades som ett resultat av bearbetningen av aktuella indata (yttrande eller aktivitet).
• Bekräftelsen lyckades: Indatayttrandet eller aktiviteten var en lyckad bekräftelse (ja).
• Bekräftelse nekades: Indatayttrandet eller aktiviteten var inte en lyckad bekräftelse (nej).
• Föregående kommando måste uppdateras: Det här villkoret används i instanser när du vill få en negerad bekräftelse tillsammans med en uppdatering. I bakgrunden konfigureras det här villkoret för när dialogmotorn identifierar en negativ bekräftelse där avsikten är densamma som föregående tur och användaren har svarat med en uppdatering.

Åtgärder

• Skicka talsvar: Skicka tillbaka ett talsvar till klienten.
• Uppdatera parametervärdet: Uppdatera värdet för en kommandoparameter till ett angivet värde.
• Rensa parametervärde: Rensa kommandoparametervärdet.
• Anropa webbslutpunkt: Ring ett anrop till en webbslutpunkt.
• Skicka aktivitet till klienten: Skicka en anpassad aktivitet till klienten.

Förväntningar

Förväntningar används för att konfigurera tips för bearbetning av nästa användarindata. Följande typer stöds:

• Förväntar sig bekräftelse från användaren: Den här förväntan anger att programmet förväntar sig en bekräftelse (ja/nej) för nästa användarindata.
• Förväntade parameterindata från användaren: Den här förväntan anger en eller flera kommandoparametrar som programmet förväntar sig av användarens indata.

Tillstånd efter körning

Tillståndet efter körningen är dialogtillståndet efter bearbetning av aktuella indata (yttrande eller aktivitet). Det är av följande typer:

• Behåll aktuellt tillstånd: Behåll endast aktuellt tillstånd.
• Slutför kommandot: Slutför kommandot och inga fler regler för kommandot bearbetas.
• Kör slutföranderegler: Kör alla giltiga slutföranderegler.
• Vänta på användarens indata: Vänta på nästa användarindata.

Nästa steg

Se exempel på GitHub