# Entitäten

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.

## Entitäten verwenden

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](/bot-verwalten/variablen.md#variablen-im-bot-builder-verwenden). Durch den Einsatz von [Bedingungen](/bot-verwalten/bot-builder/bedingung.md) kannst du prüfen, ob dein Bot eine Entität erkannt hat oder nicht.

## Entität erstellen

**1. Klicke auf "Entität erstellen"**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/2a315dcc-03cb-4c8d-94d2-9070c888ebed/ascreenshot.jpeg?tl_px=2346,990\&br_px=3839,1830\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=446,252)

**2. Gebe in dem Eingabefeld den Namen der Entität ein.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/ab8d863e-68e2-4437-b50a-26635828efb2/ascreenshot.jpeg?tl_px=899,0\&br_px=2392,840\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,138)

**3. In unserem Beispiel tragen wir "Bestellnummer" ein.**

**4. Klicke auf "Entität erstellen".**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/5e330a16-9168-4aa7-8a9e-8b5caaf74305/ascreenshot.jpeg?tl_px=1455,504\&br_px=2948,1344\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

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.

## Entität konfigurieren

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.

{% hint style="info" %}
Built-In Entitäten können nicht bearbeitet werden.
{% endhint %}

Entitäten können aus bis zu 4 verschiedenen Komponenten bestehen.

### Reguläre-Ausdrücke

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"**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/c5f4041f-92fa-4539-bd65-cc360b5bd848/ascreenshot.jpeg?tl_px=2203,80\&br_px=3696,920\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**2. Klicke in das Eingabefeld "Schlüssel" und gebe den Namen dieser Komponente ein.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/0650152d-c719-4c24-ad84-4553d878ee95/ascreenshot.jpeg?tl_px=969,332\&br_px=2462,1172\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**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.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/e3c087fe-a8a6-498d-8dc5-8d4e3fd6625b/ascreenshot.jpeg?tl_px=1627,340\&br_px=3120,1180\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/6d603ecc-9909-4307-ac8d-ab77c80aa97e/ascreenshot.jpeg?tl_px=1631,392\&br_px=3124,1232\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**5. Klicke in das Eingabefeld "Regulärer Ausdruck" und trage dort deinen Regulären Ausdruck zur Erkennung der Entität ein.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/b22af72d-47c5-4995-9373-a4a8592ca569/ascreenshot.jpeg?tl_px=1041,428\&br_px=2534,1268\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**6. In unserem Beispiel lautet dieser "\[0-9]{4}".**

**7. Klicke auf "Ausdruck hinzufügen"**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/61511e10-2460-4a16-8d8d-5b9fbf90db67/ascreenshot.jpeg?tl_px=2035,574\&br_px=3528,1414\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

### Prebuilt

Prebuilt Komponenten können genutzt werden, um eine benutzerdefinierte Entität zu erweitern.

**1. Klicke auf das Eingabefeld "Prebuilt".**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/880a46b6-1843-4048-b22e-ac773605c667/ascreenshot.jpeg?tl_px=875,516\&br_px=2368,1356\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**2. Wähle die Built-In Entität aus, die du hinzufügen möchtest.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/70bfd756-dc4a-49c6-a7cf-e4a36fcb3487/ascreenshot.jpeg?tl_px=853,662\&br_px=2346,1502\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**3. Klicke auf "Prebuilt hinzufügen".**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/738f95e1-8da2-4dcc-afff-6d3ac91ea124/ascreenshot.jpeg?tl_px=2089,628\&br_px=3582,1468\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

### Listen

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.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/fba8fa15-6458-460a-b3c5-e7d2d5157ea3/ascreenshot.jpeg?tl_px=965,660\&br_px=2458,1500\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**2. Gebe einen Wert ein. In diesem Beispiel "volkswagen".**

**3. Klicke in das Eingabefeld "Sprache".**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/d6c5f29b-08a8-4f1c-8d9b-316e5ad623ca/ascreenshot.jpeg?tl_px=1023,758\&br_px=2516,1598\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**4. Wähle die gewünschte Sprache aus.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/04cefb86-15cb-4b36-a752-595ceeb0d2fd/ascreenshot.jpeg?tl_px=943,856\&br_px=2436,1696\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**5. Klicke auf "Sprache hinzufügen".**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/5114e27e-49d9-4edc-9075-5c3de229b13b/ascreenshot.jpeg?tl_px=2047,762\&br_px=3540,1602\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**6. Klicke in das Eingabefeld "Synonym für Deutsch hinzufügen", wenn du weitere Synonyme hinzufügen möchtest.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/bc4b4468-2749-4452-9265-1d83ad96cefa/ascreenshot.jpeg?tl_px=1213,930\&br_px=2706,1770\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**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".**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/4f9f40ea-37de-4b09-a9b4-3990d65a5438/ascreenshot.jpeg?tl_px=2011,990\&br_px=3504,1830\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,233)

**9. Die Liste für diese Automarke wurde nun angelegt.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/a4dea38f-1510-4131-bee4-adbcfb8e300f/user_cropped_screenshot.jpeg?tl_px=97,0\&br_px=1590,626\&force_format=png\&width=560.0)

### Erlernt

Erlernte Komponenten können über den Bereich [Daten laben](/bot-verwalten/daten-labeln.md) auf der linken Seite hinzugefügt werden. Wie das funktioniert erfährst du [hier](/bot-verwalten/daten-labeln.md).

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.

{% hint style="warning" %}
**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.
{% endhint %}

### Komponenten gemeinsam verwenden

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.

### Komponenten als benötigt markieren

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".**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/b0564c60-5d9a-4dfb-a13a-825d63ebde74/ascreenshot.jpeg?tl_px=1987,102\&br_px=3480,942\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**2. Wiederhole dies für alle Komponenten, die du als benötigt markieren möchtest.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/b6fc5eb5-2734-4f35-97e5-ebbffb5ce7bd/ascreenshot.jpeg?tl_px=1989,472\&br_px=3482,1312\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

**3. Klicke anschließend auf "Entität speichern", um deine Änderungen zu speichern.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/2befb648-f38b-4253-bd6a-211ef4df27a0/ascreenshot.jpeg?tl_px=2119,812\&br_px=3612,1652\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)

## Entität löschen

{% hint style="info" %}
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.
{% endhint %}

**1. Klicke auf das Mülltonnen-Icon bei der Entität, die du löschen möchtest.**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/0ee5048d-ec13-4c6c-b177-0bd0a19b1e5c/ascreenshot.jpeg?tl_px=2346,0\&br_px=3839,840\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=495,99)

**2. Klicke auf "Entität löschen".**

![](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2023-07-18/845dd285-7779-414d-b7f0-cf7054d37316/ascreenshot.jpeg?tl_px=1471,238\&br_px=2964,1078\&force_format=png\&width=560.0\&wat_scale=50\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=262,139)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chatcaptain.com/bot-verwalten/entitaten.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.