Concepten en definities van aangepaste opdrachten

Belangrijk

Aangepaste opdrachten worden op 30 april 2026 buiten gebruik gesteld. Vanaf 30 oktober 2023 kunt u geen nieuwe toepassingen voor aangepaste opdrachten maken in Speech Studio. Met betrekking tot deze wijziging wordt LUIS op 1 oktober 2025 buiten gebruik gesteld. Vanaf 1 april 2023 kunt u geen nieuwe LUIS-resources maken.

Dit artikel fungeert als referentie voor concepten en definities voor toepassingen met aangepaste opdrachten.

Configuratie van opdrachten

Opdrachten zijn de basisbouwstenen van een toepassing aangepaste opdrachten. Een opdracht is een set configuraties die nodig zijn om een specifieke taak te voltooien die door een gebruiker is gedefinieerd.

Voorbeeldzinnen

Voorbeelduitingen zijn de setvoorbeelden die de gebruiker kan zeggen om een bepaalde opdracht te activeren. U moet alleen een voorbeeld van utterances opgeven en geen volledige lijst.

Parameters

Parameters zijn informatie die is vereist voor de opdrachten om een taak te voltooien. In complexe scenario's kunnen parameters ook worden gebruikt om voorwaarden te definiëren die aangepaste acties activeren.

Voltooiingsregels

Voltooiingsregels zijn een reeks regels die moeten worden uitgevoerd nadat aan de opdracht is voldaan, bijvoorbeeld wanneer aan alle voorwaarden van de regels wordt voldaan.

Interactieregels

Interactieregels zijn extra regels voor het afhandelen van specifiekere of complexere situaties. U kunt meer validaties toevoegen of geavanceerde functies configureren, zoals bevestigingen of een correctie in één stap. U kunt ook uw eigen aangepaste interactieregels maken.

Configuratie van parameters

Parameters zijn informatie die is vereist voor opdrachten om een taak te voltooien. In complexe scenario's kunnen parameters ook worden gebruikt om voorwaarden te definiëren die aangepaste acties activeren.

Naam

Een parameter wordt geïdentificeerd door de naameigenschap. U moet altijd een beschrijvende naam aan een parameter geven. Een parameter kan worden verwezen in verschillende secties, bijvoorbeeld wanneer u voorwaarden, spraakreacties of andere acties samenwerkt.

Vereist

Met dit selectievakje wordt aangegeven of een waarde voor deze parameter vereist is voor het uitvoeren of voltooien van de opdracht. U moet antwoorden configureren om de gebruiker te vragen een waarde op te geven als een parameter is gemarkeerd als vereist.

Als u een vereiste parameter hebt geconfigureerd om een standaardwaarde te hebben, vraagt het systeem nog steeds om de waarde van de parameter.

Type

Aangepaste opdrachten ondersteunen de volgende parametertypen:

• Leeftijd
• Valuta
• Datum en tijd
• Dimensie
• E-mailen
• Geografie
• Aantal
• Rangtelwoord
• Percentage
• PersonName
• PhoneNumber
• String
• Temperatuur
• URL

Elke landinstelling ondersteunt het parametertype 'Tekenreeks', maar de beschikbaarheid van alle andere typen verschilt per landinstelling. Aangepaste opdrachten maken gebruik van de vooraf gedefinieerde entiteitsomzetting van LUIS, dus de beschikbaarheid van een parametertype in een landinstelling is afhankelijk van de vooraf gedefinieerde ondersteuning voor luis-entiteiten in die landinstelling. Meer informatie over de vooraf gedefinieerde entiteitsondersteuning van LUIS vindt u per landinstelling. Aangepaste LUIS-entiteiten (zoals door machine learning-entiteiten) worden momenteel niet ondersteund.

Sommige parametertypen, zoals Getal, Tekenreeks en Datum/tijd, ondersteunen standaardwaardeconfiguratie, die u vanuit de portal kunt configureren.

Configuratie

Configuratie is een parametereigenschap die alleen is gedefinieerd voor het type Tekenreeks. De volgende waarden worden ondersteund:

• Geen.
• Volledige invoer accepteren: wanneer deze optie is ingeschakeld, accepteert een parameter elke invoeruiting. Deze optie is handig wanneer de gebruiker een parameter met de volledige uiting nodig heeft. Een voorbeeld hiervan zijn postadressen.
• Accepteer vooraf gedefinieerde invoerwaarden uit een externe catalogus: deze waarde wordt gebruikt om een parameter te configureren die kan uitgaan van een grote verscheidenheid aan waarden. Een voorbeeld is een verkoopcatalogus. In dit geval wordt de catalogus gehost op een extern webeindpunt en kan deze onafhankelijk worden geconfigureerd.
• Vooraf gedefinieerde invoerwaarden uit de interne catalogus accepteren: deze waarde wordt gebruikt om een parameter te configureren die een paar waarden kan aannemen. In dit geval moeten waarden worden geconfigureerd in Speech Studio.

Validatie

Validaties zijn constructies die van toepassing zijn op bepaalde parametertypen waarmee u beperkingen voor de waarde van een parameter kunt configureren. Op dit moment bieden aangepaste opdrachten ondersteuning voor validaties voor de volgende parametertypen:

• Datum en tijd
• Aantal

Configuratie van regels

Een regel in aangepaste opdrachten wordt gedefinieerd door een set voorwaarden waaraan wordt voldaan, een set acties uit te voeren. Met regels kunt u ook de status en verwachtingen na de uitvoering configureren voor de volgende beurt.

Typen

Aangepaste opdrachten ondersteunen de volgende regelcategorieën:

• Voltooiingsregels: deze regels moeten worden uitgevoerd bij het uitvoeren van opdrachten. Alle regels die zijn geconfigureerd in deze sectie waarvoor de voorwaarden waar zijn, worden uitgevoerd.
• Interactieregels: deze regels kunnen worden gebruikt om extra aangepaste validaties, bevestigingen en een correctie in één stap te configureren of om andere aangepaste dialoogvensterlogica uit te voeren. Interactieregels worden op elke beurt in de verwerking geëvalueerd en kunnen worden gebruikt om voltooiingsregels te activeren.

De verschillende acties die zijn geconfigureerd als onderdeel van een regel, worden uitgevoerd in de volgorde waarin ze worden weergegeven in de ontwerpportal.

Voorwaarden

Voorwaarden zijn de vereisten waaraan moet worden voldaan om een regel uit te voeren. Voorwaarden voor regels kunnen van de volgende typen zijn:

• Parameterwaarde is gelijk aan: De geconfigureerde parameterwaarde is gelijk aan een specifieke waarde.
• Geen parameterwaarde: de geconfigureerde parameters mogen geen waarde hebben.
• Vereiste parameters: de geconfigureerde parameter heeft een waarde.
• Alle vereiste parameters: alle parameters die als vereist zijn gemarkeerd, hebben een waarde.
• Bijgewerkte parameters: een of meer parameterwaarden zijn bijgewerkt als gevolg van het verwerken van de huidige invoer (uiting of activiteit).
• Bevestiging is geslaagd: de invoeruiting of activiteit is een geslaagde bevestiging (ja).
• Bevestiging is geweigerd: de invoeruiting of activiteit was geen geslaagde bevestiging (nee).
• De vorige opdracht moet worden bijgewerkt: deze voorwaarde wordt gebruikt in exemplaren wanneer u een negatieve bevestiging wilt ontvangen, samen met een update. Achter de schermen wordt deze voorwaarde geconfigureerd voor wanneer de dialoogvensterengine een negatieve bevestiging detecteert waarbij de intentie hetzelfde is als de vorige beurt en de gebruiker heeft gereageerd met een update.

Acties

• Spraakantwoord verzenden: Een spraakantwoord terugsturen naar de client.
• Parameterwaarde bijwerken: Werk de waarde van een opdrachtparameter bij naar een opgegeven waarde.
• Parameterwaarde wissen: Wis de parameterwaarde van de opdracht.
• Webeindpunt aanroepen: maak een aanroep naar een webeindpunt.
• Activiteit verzenden naar client: Een aangepaste activiteit naar de client verzenden.

Verwachtingen

Verwachtingen worden gebruikt om hints te configureren voor de verwerking van de volgende gebruikersinvoer. De volgende typen worden ondersteund:

• Bevestiging van de gebruiker wordt verwacht: Deze verwachting geeft aan dat de toepassing een bevestiging (ja/nee) verwacht voor de volgende gebruikersinvoer.
• Verwachte invoer van parameters van de gebruiker: Deze verwachting geeft een of meer opdrachtparameters op die de toepassing verwacht van de gebruikersinvoer.

Status na uitvoering

De status na uitvoering is de dialoogvensterstatus nadat de huidige invoer (uiting of activiteit) is verwerkt. Het is van de volgende typen:

• Huidige status behouden: alleen de huidige status behouden.
• Voltooi de opdracht: Voltooi de opdracht en geen regels meer van de opdracht worden verwerkt.
• Voltooiingsregels uitvoeren: voer alle geldige voltooiingsregels uit.
• Wacht op invoer van de gebruiker: Wacht op de volgende gebruikersinvoer.

Volgende stappen

Voorbeelden bekijken op GitHub