Simple entity

2025-06-13

Important

Language Understanding Intelligent Service (LUIS) will be fully retired on March 31, 2026. LUIS resource creation isn't available. Beginning on October 31, 2025, the LUIS portal will no longer be available. We recommend migrating your LUIS applications to conversational language understanding to benefit from continued product support and multilingual capabilities.

A simple entity is a generic entity that describes a single concept and is learned from the machine-learning context. Because simple entities are generally names such as company names, product names, or other categories of names, add a phrase list when using a simple entity to boost the signal of the names used.

The entity is a good fit when:

The data aren't consistently formatted but indicate the same thing.

simple entity

Example JSON

Bob Jones wants 3 meatball pho

In the previous utterance, Bob Jones is labeled as a simple Customer entity.

The data returned from the endpoint includes the entity name, the discovered text from the utterance, the ___location of the discovered text, and the score:

V2 prediction endpoint response
V3 prediction endpoint response

"entities": [
  {
  "entity": "bob jones",
  "type": "Customer",
  "startIndex": 0,
  "endIndex": 8,
  "score": 0.473899543
  }
]

This is the JSON if verbose=false is set in the query string:

"entities": {
    "Customer": [
        "Bob Jones"
    ]
}```

This is the JSON if `verbose=true` is set in the query string:

```json
"entities": {
    "Customer": [
        "Bob Jones"
    ],
    "$instance": {
        "Customer": [
            {
                "type": "Customer",
                "text": "Bob Jones",
                "startIndex": 0,
                "length": 9,
                "score": 0.9339134,
                "modelTypeId": 1,
                "modelType": "Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

Data object	Entity name	Value
Simple Entity	`Customer`	`bob jones`

Next steps

Learn pattern syntax

Share via

Simple entity

Example JSON

Next steps

Additional resources