Bu yardım dokümanının Türkçe versiyonu için buraya tıklayın.


What is an Entity?


In NLP-based chatbots, entities are elements used to identify and extract important information from text. These entities typically include specific information such as names, dates, places, or product names. An entity is a piece of information that provides critical details about the context or the user's intent in a statement and can be thought of as "variables" representing specific values in a sentence.


For example, when training an intent for dealers, it would be cumbersome to list every city or district individually. Using entities for parts of the sentence that can vary makes the training process much more practical. For instance, in the sentence “I want the address of the Istanbul dealer,” the entity is "Istanbul."



How to add an Entity?


Navigate to the Jetbot menu and click on "Edit Content" to access the content page of the chatbot. Click on the "Entities" option located just below the "Intents" section.





On the page that opens, click on the “+ Add New Entity” button at the top right.




The name of the entity should generally describe the content of that entity. For example, if you are adding an entity for countries, the entity name should be Countries.




On the page where you add the entity, you will see two fields: ‘Reference Value’ and ‘Synonyms’. Enter the known name of the entity in the ‘Reference Value’ field and the various names the entity might be referred to in the ‘Synonyms’ field. This means that if a user writes "USA" or "United States" the entity will be recognized.




After adding the entities, click "Save Changes" at the top right, and the newly added entity will now appear among your other entities.





How to Use an Entity?


To use entities, go to the user says part of your intents.




Create the user expression by incorporating the entity using "x" as a placeholder.

 ❗ Here, "x" acts as a variable for our purposes. Using "x," "y," or "z," or other similar terms does not affect the outcome.




When you drag and select the part labeled "x," the following window will appear.




Choose the entity you want to use and click "Save."




Your user expression will now look like this, indicating that it includes an entity.


The example below shows how the entity functions. Here, 'Instagram' is an entity.




To see how frequently entities are used, go to the Reports page and select "Entity Report."


You can easily view how often the entity was used between specific dates.