App schema definition

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.

The LUIS app is represented in either the .json or .lu and includes all intents, entities, example utterances, features, and settings.

Format

When you import and export the app, choose either .json or .lu.

Format	Information
.json	Standard programming format
.lu	Supported by the Bot Framework's Bot Builder tools.

Version 7.x

• Moving to version 7.x, the entities are represented as nested machine-learning entities.
• Support for authoring nested machine-learning entities with enableNestedChildren property on the following authoring APIs:
  • Add label
  • Add batch label
  • Review labels
  • Suggest endpoint queries for entities
  • Suggest endpoint queries for intents

{
  "luis_schema_version": "7.0.0",
  "intents": [
    {
      "name": "None",
      "features": []
    }
  ],
  "entities": [],
  "hierarchicals": [],
  "composites": [],
  "closedLists": [],
  "prebuiltEntities": [],
  "utterances": [],
  "versionId": "0.1",
  "name": "example-app",
  "desc": "",
  "culture": "en-us",
  "tokenizerVersion": "1.0.0",
  "patternAnyEntities": [],
  "regex_entities": [],
  "phraselists": [
  ],
  "regex_features": [],
  "patterns": [],
  "settings": []
}

element	Comment
"hierarchicals": [],	Deprecated, use machine-learning entities.
"composites": [],	Deprecated, use machine-learning entities. Composite entity reference.
"closedLists": [],	List entities reference, primarily used as features to entities.
"versionId": "0.1",	Version of a LUIS app.
"name": "example-app",	Name of the LUIS app.
"desc": "",	Optional description of the LUIS app.
"culture": "en-us",	Language of the app, impacts underlying features such as prebuilt entities, machine-learning, and tokenizer.
"tokenizerVersion": "1.0.0",	Tokenizer
"patternAnyEntities": [],	Pattern.any entity
"regex_entities": [],	Regular expression entity
"phraselists": [],	Phrase lists (feature)
"regex_features": [],	Deprecated, use machine-learning entities.
"patterns": [],	Patterns improve prediction accuracy with pattern syntax
"settings": []	App settings

Version 6.x

• Moving to version 6.x, use the new machine-learning entity to represent your entities.

{
  "luis_schema_version": "6.0.0",
  "intents": [
    {
      "name": "None",
      "features": []
    }
  ],
  "entities": [],
  "hierarchicals": [],
  "composites": [],
  "closedLists": [],
  "prebuiltEntities": [],
  "utterances": [],
  "versionId": "0.1",
  "name": "example-app",
  "desc": "",
  "culture": "en-us",
  "tokenizerVersion": "1.0.0",
  "patternAnyEntities": [],
  "regex_entities": [],
  "phraselists": [],
  "regex_features": [],
  "patterns": [],
  "settings": []
}

Version 4.x

{
  "luis_schema_version": "4.0.0",
  "versionId": "0.1",
  "name": "example-app",
  "desc": "",
  "culture": "en-us",
  "tokenizerVersion": "1.0.0",
  "intents": [
    {
      "name": "None"
    }
  ],
  "entities": [],
  "composites": [],
  "closedLists": [],
  "patternAnyEntities": [],
  "regex_entities": [],
  "prebuiltEntities": [],
  "model_features": [],
  "regex_features": [],
  "patterns": [],
  "utterances": [],
  "settings": []
}

Next steps

• Migrate to the V3 authoring APIs