1. Klicken Sie in der seitlichen Navigationsleiste auf Entitys .

2. Klicken Sie auf Entitys hinzufügen.

3. Wählen Sie Mischentity als Entitytyp aus.

4. Geben Sie einen Namen und eine Beschreibung ein.
5. Klicken Sie auf + Event-Handler, wenn Sie das Prompting und die Logik der Mischentity programmgesteuert mit Entity-Event-Handlern ausführen möchten.

6. Klicken Sie auf + Mischentityelement, um das Dialogfeld "Mischentityelement hinzufügen" zu öffnen. Wenn Sie eine integrierte Entity oder eine vorhandene benutzerdefinierte Entity hinzufügen, können Sie einen mischentityspezifischen Namen für sie erstellen und eine Beschreibung der Rolle innerhalb des Kontextes der Mischentity hinzufügen.

7. Sie können die Tasche mit benutzerdefinierten Entitys, integrierten Entitys sowie folgenden Entitys füllen:

   • STRING - Erfasst freien Text vom Benutzer.

   • LOCATION - erfasst den Standort des Benutzers.

   • ATTACHMENT - Akzeptiert Dateien, Audiodateien, Video- und Bilddateien, die vom Benutzer hochgeladen wurden. Die Mischentity speichert die URL, unter der der Anhang gehostet wird.

   Hinweis
   
   Sie werden zur Eingabe eines Subtyps aufgefordert, wenn Sie die Entity DATE_TIME hinzufügen.

   Die Elemente werden in der Reihenfolge aufgelöst, in der Sie sie hinzufügen. Die Reihenfolge kann jedoch davon beeinflusst werden, wie Sie die einzelnen Elemente der Mischentity konfigurieren.

8. Wenn Sie auf Schließen klicken, kehren Sie zur Seite "Entitys" zurück. Zunächst können Sie dem Element jedoch weitere mischentityspezifische Funktionen hinzufügen (oder es später aktualisieren, indem Sie auf der Seite "Entitys" auf klicken).

9. Nächste Schritte:

   • Fügen Sie einzelne Fehlermeldungen, Begriffserklärungs-Prompts oder bedingte Eingabeaufforderungen für die Mischentityelemente hinzu.
     Hinweis
     
     Diese werden überschrieben, wenn Sie die Entity zu einer Mischentity hinzufügen.

   • Fügen Sie die Entity einem Intent hinzu. Informationen hierzu finden Sie unter Entitys zu Intents hinzufügen.

   • Konfigurieren Sie den Dialogablauf für die Verwendung der Mischentity..

• Nur das aktuell auflösende Element wird aktualisiert. Wenn eine Übereinstimmung für mehrere Mischentityelemente gilt, hat das aktuell auflösende Mischentityelement Vorrang vor anderen Elementen. Wenn Sie die erweiterte Slotfüllung deaktivieren, werden alle Elemente mit demselben Wert aktualisiert.
• Wenn es sich bei dem aktuell auflösenden Element um ein STRING-Beutelartikel handelt, werden keine anderen Beutelartikel jemals aktualisiert.
• Wenn eine Entityübereinstimmung für mehrere (nicht auflösende) Mischentityelemente gilt, wird ein Dialogfeld mit einer eindeutigen Definition angezeigt, in dem der Benutzer auswählen kann, welches Element aktualisiert werden soll, anstatt alle Mischentityelemente zu aktualisieren.
• Der Schalter Prompt für Begriffsklärung der Entity wird ignoriert. Es wird empfohlen, benutzerdefinierte Desambiguation mit einem Entity Event Handler zu implementieren.

1. Wenn Sie Prompting aktivieren möchten, lassen Sie das Feld Prompt für Wert leer (Standardstatus). Die Eingabe von false im Feld Prompt für Wert verhindert das Prompting. Um Benutzer zur Eingabe eines bedingten Wertes aufzufordern, fügen Sie einen booleschen FreeMarker-Ausdruck hinzu, der true (für Prompting) oder false ergibt.

   Tipp:

   Wenn Sie Prompt für Wert auf false setzen, kann das Element dennoch als Teil eines anderen Elements aufgelöst werden, zu dessen Eingabe der Benutzer aufgefordert wird, wenn Sie die Option Out-of-Order-Extraktion aktivieren.
2. Klicken Sie auf Prompt hinzufügen, um die Prompt-Sequenz zu erstellen. Sie können die Reihenfolge ändern, indem Sie die Felder durch Drag-and-Drop-Gesten neu anordnen oder sie neu nummerieren. Sie können die Ausgabe der Prompts zufällig anordnen, indem Sie zwei oder mehr Prompts dieselbe Nummer zuweisen.

   Hinweis
   
   Sie können Prompts für integrierte Entitys nur hinzufügen, wenn Sie sie einer Mischentity hinzufügen.

   Sie können Prompts in Resource Bundles (z.B. ${rb.askCheese}) speichern oder als Kombinationen aus Text und FreeMarker-Ausdrücken schreiben.

• Immer: Die Standardoption. Wenn Sie diese Option für ein Element auswählen, kann der Wert ohne Prompt eingefügt werden. Beispiel: Die PizzaSize-Entity kann aufgelöst werden, wenn ein Kunde Ich möchte eine große Pizza eingibt. Mit dieser Option kann der Elementwert jederzeit geändert werden, sofern der Ausdruck in der Eigenschaft Aktualisierbar nicht als false ausgewertet wird. Beispiel: Wenn die Composite Bag zur Eingabe der Entity PizzaType auffordert, kann der Kunde dann Vegetarisch bitte, aber mittelgroß antworten. Der Skill kann den Wert der PizzaSize-Entity mit "mittelmäßig" aktualisieren, ohne die Unterhaltung neu zu starten, weil Immer für die Elemente PizzaSize und PizzaType der Tasche aktiviert ist.
  Hinweis
  
  Obwohl diese Option das Standardverhalten ist, ist sie möglicherweise nicht immer für STRING-Elemente geeignet. Wenn Sie diese Option für ein STRING-Element ausgewählt haben, wird beispielsweise die erste Benutzernachricht vom STRING-Element gespeichert, anstatt mit der beabsichtigten Entity abgeglichen zu werden (die als das erste Element in der Tasche angegeben werden kann, um aufgelöst zu werden).
• Niemals: Wenn Sie diese Option auswählen, wird das Element erst nach der Eingabeaufforderung angezeigt, selbst wenn andere Benutzernachrichten gültige Werte enthalten. Wählen Sie Nie aus, um versehentliche Übereinstimmungen zu verhindern.
• Nur beim Auflösen der Intent-Äußerung - Schränkt das Out-of-Order-Wert-Slotting auf die erste Benutzeräußerung ein, die in das Intent aufgelöst wurde, das mit der Mischentity verknüpft ist.

• Die Mischentity enthält zwei adressbezogene Entitys: "NamedAddress", eine Wertelistenentity mit Werten wie "Home" und "Büro", und "DeliveryAddress", die ADDRESS-Entity.
• Der Prompt für die Entity "DeliveryAddress" lautet "Wohin soll geliefert werden? "
• Die Entity "NamedAddress" fordert den Benutzer nicht zur Eingabe auf (in das Feld "Prompt für Wert" wird false eingegeben).
• Die Entity "NamedAddress" kann mit "DeliveryAddress" extrahiert werden ("DeliveryAddress" wird im Menü Extrahieren mit ausgewählt).

${varName.value.itemName}

${expense.value.Amount.amount > 4}

Amounts below 5 ${expense.value.Amount.currency} cannot be expensed. Enter a higher amount or type 'cancel'.

• userInput
• prompt
• promptCount
• updatedEntities
• outOfOrderMatches
• disambiguationValues
• enumValues
• needShowMoreButton
• rangeStartVar
• nextRangeStart

Sorry,'${system.entityToResolve.value.userInput!'this'}' is not a valid pizza size.

    metadata:
      responseItems:        
      - type: "text" 
        text: "<#list system.entityToResolve.value.updatedEntities>I have updated <#items as ent>${ent.description}<#sep> and </#items>. </#list><#list system.entityToResolve.value.outOfOrderMatches>I got <#items as ent>${ent.description}<#sep> and </#items>. </#list>"
      - type: "text" 
        text: "${system.entityToResolve.value.prompt}"
        actions:
        - label: "${enumValue}"
          type: "postback"
          iteratorVariable: "system.entityToResolve.value.enumValues"

        globalActions: 
        - label: "Show More"
          type: "postback" 
          visible:
            expression: "${system.entityToResolve.value.needShowMoreButton}"
          payload:
            action: "system.showMore"
            variables: 
              ${system.entityToResolve.value.rangeStartVar}: ${system.entityToResolve.value.nextRangeStart} 
        - label: "Cancel"
          type: "postback" 
          visible:
            onInvalidUserInput: true
          payload:
            action: "cancel"

Hinweis

Sie können den für den EEH bereitgestellten Service auf der Seite "Komponenten" verwalten.

ExpenseDate: {

        validate: async (event, context) => {
          if (new Date(event.newValue.date) > new Date()) {
            context.addValidationError("ExpenseDate",context.translate('ExpenseDate.text'));
            return false;
          }          
        }

1. Bevor Sie ein Mischentityelement DATE_TIME erstellen, konfigurieren Sie die für Ihren Anwendungsfall geeigneten Auflösungsregeln für Datum und Uhrzeit. Beispiel: Wenn Sie einen Skill für Spesenabrechnungen erstellen, wählen Sie Vergangen aus. Wenn der Skill ein Besprechungsplaner ist, wählen Sie Zukünftig aus.
2. Klicken Sie in der Mischentity auf Element hinzufügen.
3. Wählen Sie im Menü "Typ" die Option Entity aus.
4. Wählen Sie im Menü "Entityname" die Option DATE_TIME aus.
5. Wählen Sie im Menü "Subtyp" einen DATE_TIME-Subtyp.
   
   
   Beschreibung der Abbildung select-date-time-subtype.png
   
   Die Konfigurationsoptionen auf der Seite "Beutelartikel hinzufügen" ändern sich je nach ausgewähltem Subtyp. Beispiel: Wenn Sie den Subtyp Wiederkehrend auswählen, können Sie auf Konfigurationsoptionen für die verschachtelten Mischentityelemente zugreifen, die spezifisch für das Festlegen eines sich wiederholenden Ereignisses sind, wie z.B. das Objekt Datum und Uhrzeit für das Anfangsdatum und die Anfangszeit und das Objekt Dauer zum Festlegen der Ereignishäufigkeit.
   
   
   Beschreibung der Abbildung edit-date-time-bag-item.png
   
   
6. Wenn Sie die Subtypen "Wiederkehrend" oder "Intervall" ausgewählt haben:
   • Legen Sie die Subtypwerte fest, die vom Mischentity-Prompt im Menü Prompt für angefordert werden.
   • Da Besprechungen normalerweise am selben Tag beginnen und enden, aktivieren Sie für den Subtyp startDate das Standardenddatum bis Startdatum. Dadurch wird das Enddatum auf das Startdatum gesetzt, wenn die Benutzernachricht das Enddatum nicht erwähnt (oder wenn das Enddatum nicht in der falschen Reihenfolge extrahiert wird).
     
     
     
     
7. Fügen Sie optional ein Begriffslabel hinzu, wenn die Benutzereingabe mehrere Subtypen abgleichen kann.

   Tipp:

   Sie können auch die Eigenschaften konfigurieren, die nicht DATE_TIME-spezifisch sind, wie Erweiterte Slotfüllung, Slotting-Werte aktualisieren mit Apache FreeMarker, benutzerdefinierte Prompts und Fehlermeldungen.
8. Sie können auf die Konfiguration auf Subtypebene zugreifen, indem Sie auf einen Subtyp klicken. Mit der Traversal kehren Sie zur Konfiguration auf Elementebene zurück.
   
   
   
   
9. Nächste Schritte:
   • Ordnen Sie die Mischentity dem Intent zu.
   • Deklarieren Sie eine Variable für die Entity im Dialogablauf.
   • Referenzieren Sie im Dialogablauf die Mischentity mit dem Element DATE_TIME mit dem Status "Composite Bag auflösen".
   • Die DATE_TIME-Werte werden als ISO 8601 dargestellt. Für eine benutzerfreundliche Ausgabe verwenden Sie den Apache FreeMarker .xs integriert. Im folgenden Snippet wird der Wert für den Zeitsubtyp mit .value?time.xs?string['hh:mm a'] formatiert.

     Your pizza will be delivered at ${pizza.value.deliveryTime.value?time.xs?string['hh:mm a']}.
     

     Anstatt das Element DATE_TIME als Zeichenfolge zu referenzieren, können Sie den Best-Practice-Ansatz verfolgen, es in einem Resource Bundle zu referenzieren, wie z.B. DeliveryMessage im folgenden Beispiel.

     ${rb('DeliveryMessage','time',pizza.value.deliveryTime.value?time.xs?string['hh:mm a'])}
     

     Für die Resource Bundle-Nachricht DeliveryMessage wird der Wert über den Parameter {time} wiedergegeben:

     Your pizza will be delivered at {time}.