Entities

entities are data points or values that you can extract from a conversation/user query this allows you to customize what kind of information you are collecting, how you want to associate it and even add your own custom set of values if needed also when a group of values leads to the same answer you can use entities rather than creating faqs for all the variables for instance, the enrolment procedure for all the courses in an institute is the same a common user query may be “how can i enrol for the artificial intelligence course?” similarly, there can be a number of queries in the same context for different courses here rather than creating different faqs for each subject you can create an entity set with custom values and add all the course names to it and it will give relevant answers each time the query is triggered availability availability this functionality is provided to all our customers it can be accessed by clicking on the train tab in the left panel and selecting entities terms and definitions terms and definitions terms definitions entity it is a data point or value which you can extract from a conversation/user query this helps you to customize what kind of information you are collecting or how you want to associate it or want to add some custom value to it for more information on entities and intents faq frequently asked questions (faqs) are the standard queries relevant to a product or a service for more information on faqs intent intention/purpose of the user in the conversational flow context based on the previous conversation of the user on the bot it maintains the relevance of the communication system defined entities these are commonly used entities that are pre defined in the system custom entities these are the entities that can be defined by the user as per their use case entity management entity management creating an entity creating an entity step 1 navigate to train > entities > +add entity and create an entity step 2 fill in the fields available for your convenience, we have provided descriptions for each field, indicating the values to enter in each entity name this field allows you to give a name to your entity entity type based on your use case you can select the type of your entity step 3 your entity is created and is now ready for use in the conversations naming your entities naming your entities you can give any name to your entity related to the information you are collecting, for e g – booking date, courses, products, etc the only restriction being you cannot add a space or a slash character in the name also, it cannot be the same as a built in entity type like – number, date, time, etc the name is important because this will be used extensively for using the extracted values in the conversation you can define multiple entities of the same type in cases where the usage is different or we want different values to be associated there for example – for a travel bot, i can have booking date and travel date as separate entities although both are of date and time types types of entities types of entities if you look at the drop down for entity types, you would see a lot of options to select from they can be categorized as built in or system defined entity types or custom defined entity types \[custom values option] built in or system entities built in or system entities these are the common entity types we have seen being used and handled as a separate types so that it is convenient for the bot admins to start using these right away for the standard use cases all options other than the custom values would fall into the built in or system entity types some of the notable ones are – number, email address, phone numbers, date and time and its different variants including duration and ranges, amount, quantity, urls and others custom entities custom entities this is a special type of entity where you can define a type and then define values that are custom to your bot, organization or domain you can add the various values of a particular type in different rows, in case there are variations of a particular value, those can also be added by a comma separating those options in the example below, if you are building a bot for an online course site, courses will be a data type commonly used in various conversations so, you can define the various courses listed out and then intents can be a linked to request for a course also in which case the user input will be matched to the defined type and persisted entities usage entities usage entities can be associated with faqs primarily to look for specific pieces of data/information from the user intent you can define which entities to look for in the particular intent you can also define which of the entities are mandatory for the intent to qualify if those values are not retrieved, the bot will prompt the user to enter these and only then continue to the response resolution entities can also be used specifically in the request user data section to extract the values you can also now request for multiple entities in a single query and then the bot will intelligently associate the values appropriately as per the defined types in case the values are missed, they can be prompted again once defined, these entities can be used to associate with an intent where the information will automatically be collected as per the entity definition and be tagged to that entity to refer to the extracted values associated with an entity anywhere in a flow, you can just do that via {{context booking date}} as we mentioned earlier, entity values can be referred to by using double braces notation {{context booking date}} some of the entity types here are complex entities and have parts to the values they contain you can refer to them by qualifying the entity name along with the specific part just to highlight this aspect, let’s say we were just interested to know or use the month value of booking date above we can do that by using {{context booking date month}} these options would automatically come up in the auto complete here are some of the other options for a date – scenario lets consider a scenario for a better understanding query how can i enrol in the iot course? now there may be the same procedure for enrolling in a set of subjects let’s say database management, artificial intelligence, machine learning, data mining, and iot the procedure to enrol for each of them is the same instead of creating 5 faqs, you can create an entity of type course with the name of all the courses in it step 1 navigate to train > entities > +add entity and create an entity step 2 return to the faq page and incorporate the created entity into the entity section to employ this entity, select the word that will be substituted by one of the entities based on the end user's query initially, include the entity created in the entity section, then double click on the custom value provided in the question section a dropdown menu will appear, allowing you to select your entity deletion of entities deletion of entities one should be very careful while deleting entities if they are being used in intent or in the paths if these are deleted, it could lead to unstable flow behaviour or inconsistent values ensure that the entity to be deleted is not used anywhere in the flows or intents and then proceed for deletion renaming of entities renaming of entities renaming of entities is allowed but there is a restriction that the entity must not be in use in intent or flow before, else again as is the case with delete, it might lead to inconsistent behaviour that covers everything about entities i trust that reading this documentation has provided a clearer understanding of how to make the most of the entities section on our platform if you face any issues or queries please reach out to us at mailto\ support\@engati com