Composite entities

Use composite entities when you want to combine two different entities into one.

A composite entity is a combination of two or more different, yet related entities. This type of entity allows you to combine two separate entities into a single one.

Composite entities tab.

Example of composite entity

When a user tells the bot Two fries please, the bot will understand this as the predefined composite entity @order, which consists of two separate entities:

• @sys.number : 2, a system entity.

• and @foodItem: fries, a match entity.

Add a composite entities

To add a composite entity to your bot:

1. From your Entities tab, make sure that you have different entities that your composite would be made of. For this example, we created a @car_brand match entity and will use @sys.number.
2. Click on Composite entities.

3. Click on Add composite entity.

4. Fill in the Entity name.

5. Under Entity values, add the entities that will make the composite one.

Add a composite entity.

1. Click on Create entity.

Route your conversation based on composite entity values

To route your flow based on composite entities:

1. Create a Collect input block where you composite entity will be detected. In this example, we detect @car_info.

Detect a composite entity inside your flow.

1. Let's say you now want to route the flow based on the year of the car. For instance:

   • When the year is equal to or more than 2016, the car is a green car

   • When the year is less than 2016, the car is not a green car.

2. Create a Condition block that checks the @car_brand.sys.number variable.

Route the flow based on part of a composite entity.

1. Click Save.