Entitäten
Last updated
Last updated
Mit Entitäten kann dein Bot wichtige Informationen aus einer Nachricht eines Nutzers erkennen. Dies sind häufig zum Beispiel Namen, E-Mail-Adressen, Telefon- oder Bestellnummern. Für viele Anwendungsfälle ist es wichtig, auf diese Daten in einer strukturierten Form zuzugreifen.
Du musst keine spezielle Einrichtung vornehmen, damit dein Bot Entitäten erkennt. Der Bot versucht in jeder Nachricht eines Nutzers Entitäten zu finden und diese korrekt zuzuordnen. Nach der Erstellung deines Bots, verfügt dieser bereits über einige vorkonfigurierte Entitäten. Wenn diese nicht zu deinem Anwendungsfall passen, kannst du benutzerdefinierte Entitäten erstellen.
Der Wert einer Entität wird nach dem sie erkannt wurde in einer Variable gespeichert. Für jede Entität existiert in deinem Bot eine eigene Variable mit dem gleichen Namen. In dem du auf diese Variablen zugreifst, greifst du auch auf die Werte der Entität zu. Hier erfährst du, wie du Variablen verwenden kannst. Durch den Einsatz von Bedingungen kannst du prüfen, ob dein Bot eine Entität erkannt hat oder nicht.
1. Klicke auf "Entität erstellen"
2. Gebe in dem Eingabefeld den Namen der Entität ein.
3. In unserem Beispiel tragen wir "Bestellnummer" ein.
4. Klicke auf "Entität erstellen".
Nach dem Erstellen einer Entität wirst du automatisch in den Bearbeitungsmodus weitergeleitet, damit du diese Entität im nächsten Schritt richtig konfigurieren kannst.
Klicke in der Liste aller Entitäten auf die Entität, die du bearbeiten möchtest. Anschließend öffnet sich der Bearbeitungsmodus für diese Entität.
Built-In Entitäten können nicht bearbeitet werden.
Entitäten können aus bis zu 4 verschiedenen Komponenten bestehen.
Reguläre Ausdrücke (kurz Regex) stammen aus der Programmierung und ermöglichen es, bestimmte Zeichenfolgen zuverlässig zu erkennen. Diese Komponente ist vor allem sinnvoll für Daten, die immer gleich aufgebaut sind. Beispielsweise eine 4-stellige Bestellnummer, die wie folgt aussieht: 1234, 7249 oder 5555
1. Klicke auf den Pfeil im Abschnitt "Reguläre-Ausdrücke-Komponente"
2. Klicke in das Eingabefeld "Schlüssel" und gebe den Namen dieser Komponente ein.
3. In unserem Beispiel lautet dieser "bestellnummer". Der Name dient nur zur Identifikation für die Bearbeitung des Bots.
4. Klicke in das Eingabefeld "Sprache" und wähle die gewünschte Sprache aus.
5. Klicke in das Eingabefeld "Regulärer Ausdruck" und trage dort deinen Regulären Ausdruck zur Erkennung der Entität ein.
6. In unserem Beispiel lautet dieser "[0-9]{4}".
7. Klicke auf "Ausdruck hinzufügen"
Prebuilt Komponenten können genutzt werden, um eine benutzerdefinierte Entität zu erweitern.
1. Klicke auf das Eingabefeld "Prebuilt".
2. Wähle die Built-In Entität aus, die du hinzufügen möchtest.
3. Klicke auf "Prebuilt hinzufügen".
Die Listen Komponente ermöglicht das Hinterlegen einer Liste mit festen Werten. Dies ist beispielsweise sinnvoll für eine begrenzte Auswahl, die dem Nutzer zur Verfügung stehen sollen. Zu jedem Listeneintrag können Synonyme hinzugefügt werden, um das Verständnis des Bots zu verbessern.
1. Klicke in das Eingabefeld "Schlüssel" um den Wert dieser Auflistung festzulegen.
2. Gebe einen Wert ein. In diesem Beispiel "volkswagen".
3. Klicke in das Eingabefeld "Sprache".
4. Wähle die gewünschte Sprache aus.
5. Klicke auf "Sprache hinzufügen".
6. Klicke in das Eingabefeld "Synonym für Deutsch hinzufügen", wenn du weitere Synonyme hinzufügen möchtest.
7. Gebe einen Wert ein. In diesem Beispiel tragen wir "vw" ein und drücken anschließend [Enter].
8. Klicke anschließend auf "Liste hinzufügen".
9. Die Liste für diese Automarke wurde nun angelegt.
Erlernte Komponenten können über den Bereich Daten laben auf der linken Seite hinzugefügt werden. Wie das funktioniert erfährst du hier.
Erlernte Komponenten erkennen Daten in Texten anhand ihrer Position im Text. Dabei wird außerdem der Kontext berücksichtigt, um die Daten richtig zuzuordnen. Erlernte Komponenten können beispielsweise für das Erkennen von Orten genutzt werden. Eine Listen Komponenten kommt dort nicht in Frage, da es zu viele Orte gibt um diese zu hinterlegen.
Beachte: Erlente Komponenten werden immer erkannt, wenn die Satzstellung stimmt. Es werden daher möglicherweise auch Wörter als Ort erkannt, die in Wirklichkeit keinen realen Ort beischreiben aber so vom Nutzer verwendet wurden.
Eine Entität kann alle 4 Komponenten gleichzeitig verwenden. Es wäre daher beispielsweise möglich einen Regex Ausdruck zu hinterlegen, der nur 4-stellige Nummern erkennt und diese mit einer Listen Komponente zu koppeln, die nur die Nummern 1234 und 4321 enthält. Somit würde die Entität nur noch 1234 oder 4321 als einen Treffer erkennen und zuordnen.
Du kannst festlegen, ob eine Komponente notwendig ist, damit die Entität erkannt wird. Wenn diese nicht benötigt ist, reicht es aus, wenn eine Komponente erkannt wurde. Dabei spielt es keine Rolle ob eine andere nicht erkannt wurde.
Wenn 2 Komponenten als benötigt markiert wurden, wird die Entität nur erkannt, wenn es auch in beiden Komponenten eine Übereinstimmung gab.
1. Klicke auf den Schalter neben "benötigt".
2. Wiederhole dies für alle Komponenten, die du als benötigt markieren möchtest.
3. Klicke anschließend auf "Entität speichern", um deine Änderungen zu speichern.
Built-In Entitäten, die sofort nach der Erstellung deines Bots erstellt werden, können nicht gelöscht werden. Du kannst diese aber deaktivieren, sodass sie nicht mehr erkannt werden.
1. Klicke auf das Mülltonnen-Icon bei der Entität, die du löschen möchtest.
2. Klicke auf "Entität löschen".