# Entities

Entities are basically specific parts of your expressions that can be detected by the Xenioo engine and extracted to your chatbot variables. Entities are used whenever a specific word represent a value that your chatbot, your flow or even your [remote endpoints](/actions-and-operations/integration/xenioo.bots.actions.base.callapiserviceaction.md) require.

The fastest way to define an entity is by picking a word inside your expressions and click on it. Xenioo will automatically bring up the entity selector dialog where you will be able to either assign the word to an existing entity or create a new one.

![](/files/-LeMQHIiwxgBxY_-pU96)

Once you've defined your entity, Xenioo will be able to recognize variations inside the expression as well as detect any of the different entity values inside different sentences.

Consider the following example:

```
I want a cheeseburger
I'm having a taco
I think I'll have an hamburger
```

What our chatbot needs to know is not really how the user asked for food but what food has been asked. Assigning to cheeseburger, hamburger and taco the entity 'food', our expressions will look to Xenioo something like this:

```
I want a {food}
I'm having a {food}
I think I'll have an {food}
```

Also, the entity 'food' can now be either cheeseburger, hamburger or taco so all of the above sentences become acceptable for any type of order. Later, if you need to add new food types you can [manually add](/ai/entities/creating-manually.md) new entries (or even [variations](/ai/entities/synonims.md)) to the same entity


---

# 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://docs10.xenioo.com/ai/entities.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.