Number prebuilt entity for a LUIS app

Important

LUIS will be retired on October 1st 2025 and starting April 1st 2023 you will not be able to create new LUIS resources. We recommend migrating your LUIS applications to conversational language understanding to benefit from continued product support and multilingual capabilities.

There are many ways in which numeric values are used to quantify, express, and describe pieces of information. This article covers only some of the possible examples. LUIS interprets the variations in user utterances and returns consistent numeric values. Because this entity is already trained, you do not need to add example utterances containing number to the application intents.

Types of number

Number is managed from the Recognizers-text GitHub repository

Examples of number resolution

Utterance	Entity	Resolution
one thousand times	"one thousand"	"1000"
1,000 people	"1,000"	"1000"
1/2 cup	"1 / 2"	"0.5"
one half the amount	"one half"	"0.5"
one hundred fifty orders	"one hundred fifty"	"150"
one hundred and fifty books	"one hundred and fifty"	"150"
a grade of one point five	"one point five"	"1.5"
buy two dozen eggs	"two dozen"	"24"

LUIS includes the recognized value of a builtin.number entity in the resolution field of the JSON response it returns.

Resolution for prebuilt number

The following entity objects are returned for the query:

order two dozen eggs

V3 response

The following JSON is with the verbose parameter set to false:

"entities": {
    "number": [
        24
    ]
}

V3 verbose response

The following JSON is with the verbose parameter set to true:

"entities": {
    "number": [
        24
    ],
    "$instance": {
        "number": [
            {
                "type": "builtin.number",
                "text": "two dozen",
                "startIndex": 6,
                "length": 9,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

V2 response

The following example shows a JSON response from LUIS, that includes the resolution of the value 24, for the utterance "two dozen".

"entities": [
  {
    "entity": "two dozen",
    "type": "builtin.number",
    "startIndex": 6,
    "endIndex": 14,
    "resolution": {
      "subtype": "integer",
      "value": "24"
    }
  }
]

Next steps

Learn about the currency, ordinal, and percentage.