Versions - Export

Ссылка

Service:: Cognitive Services - LUIS

API Version:: 2.0

Экспортирует приложение LUIS в формат JSON.

GET {Endpoint}/luis/api/v2.0/apps/{appId}/versions/{versionId}/export

Параметры URI

Имя	В	Обязательно	Тип	Описание
appId	path	True	string uuid	Код приложения.
Endpoint	path	True	string	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например : https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	Идентификатор версии.

Заголовок запроса

Имя	Обязательно	Тип	Описание
Ocp-Apim-Subscription-Key	True	string

Ответы

Имя	Тип	Описание
200 OK	LuisApp	Структура приложения LUIS в формате JSON.
Other Status Codes	ErrorResponse	Ответ на ошибку.

Безопасность

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Примеры

Successful Export Application Version

Sample Request

HTTP

GET {Endpoint}/luis/api/v2.0/apps/bd72e8d7-62b8-48f5-9dcb-e3b0588b803a/versions/0.2/export

Sample Response

Status code:: 200

{
  "luis_schema_version": "3.0.0",
  "versionId": "0.1",
  "name": "LuisBot",
  "desc": "",
  "culture": "en-us",
  "intents": [
    {
      "name": "HomeAutomation.TurnOff",
      "inherits": {
        "domain_name": "HomeAutomation",
        "model_name": "TurnOff"
      }
    },
    {
      "name": "dateintent"
    },
    {
      "name": "Help"
    },
    {
      "name": "None"
    },
    {
      "name": "SearchHotels"
    },
    {
      "name": "ShowHotelsReviews"
    }
  ],
  "entities": [
    {
      "name": "AirportCode",
      "roles": [
        "destination"
      ]
    },
    {
      "name": "Hotel",
      "roles": []
    }
  ],
  "composites": [],
  "closedLists": [],
  "patternAnyEntities": [
    {
      "name": "patternAny1",
      "explicitList": [],
      "roles": [
        "role1",
        "role2"
      ]
    }
  ],
  "regex_entities": [
    {
      "name": "regex1",
      "regexPattern": "[^a]+",
      "roles": [
        "regex role"
      ]
    }
  ],
  "prebuiltEntities": [
    {
      "name": "datetimeV2",
      "roles": [
        "datetime role"
      ]
    }
  ],
  "model_features": [
    {
      "name": "Near",
      "mode": true,
      "words": "near,around,close,nearby",
      "activated": true
    },
    {
      "name": "Show",
      "mode": true,
      "words": "show,find,look,search",
      "activated": true
    }
  ],
  "regex_features": [
    {
      "name": "AirportCodeRegex",
      "pattern": "[a-z]{3}",
      "activated": true
    }
  ],
  "patterns": [
    {
      "pattern": "this is [a test] {patternAny1:role1}",
      "intent": "Help"
    }
  ],
  "utterances": [
    {
      "text": "i need help",
      "intent": "Help",
      "entities": []
    },
    {
      "text": "help me",
      "intent": "Help",
      "entities": []
    },
    {
      "text": "tomorrow",
      "intent": "dateintent",
      "entities": []
    },
    {
      "text": "search for hotels in seattle",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "what can i do?",
      "intent": "Help",
      "entities": []
    },
    {
      "text": "next monday",
      "intent": "dateintent",
      "entities": []
    },
    {
      "text": "next year",
      "intent": "dateintent",
      "entities": []
    },
    {
      "text": "look for hotels in miami",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "show me hotels in california",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "show me the reviews of the amazing bot resort",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 23,
          "endPos": 44
        }
      ]
    },
    {
      "text": "can i see the reviews of extended bot hotel?",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 25,
          "endPos": 42
        }
      ]
    },
    {
      "text": "find reviews of hotelxya",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 16,
          "endPos": 23
        }
      ]
    },
    {
      "text": "show me reviews of the amazing hotel",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 19,
          "endPos": 35
        }
      ]
    },
    {
      "text": "what are the available options?",
      "intent": "Help",
      "entities": []
    },
    {
      "text": "best hotels in seattle",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "hotels in los angeles",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "can you show me hotels from los angeles?",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "can you show me the reviews of the amazing resort & hotel",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 31,
          "endPos": 56
        }
      ]
    },
    {
      "text": "what are the reviews of the hotel bot framework?",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 24,
          "endPos": 46
        }
      ]
    },
    {
      "text": "find hotels near eze",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 17,
          "endPos": 19
        }
      ]
    },
    {
      "text": "where can i stay near nnn?",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 22,
          "endPos": 24
        }
      ]
    },
    {
      "text": "show hotels near att airport",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 17,
          "endPos": 19
        }
      ]
    },
    {
      "text": "find hotels near agl",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 17,
          "endPos": 19
        }
      ]
    },
    {
      "text": "find hotels around eze airport",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 19,
          "endPos": 21
        }
      ]
    },
    {
      "text": "01/7",
      "intent": "dateintent",
      "entities": []
    }
  ]
}

Определения

Имя	Описание
ClosedList	Экспортируемая модель — сущность списка.
ErrorResponse	Ответ об ошибке при вызове операции в API.
HierarchicalModel
JSONEntity	Экспортируемая модель — извлеченная сущность из речевого фрагмента.
JSONModelFeature	Экспортируемая модель — функция модели с списком фраз.
JSONRegexFeature	Экспортируемая модель — функция шаблона.
JSONUtterance	Экспортируемая модель — речевой фрагмент, который использовался для обучения модели.
LuisApp	Экспортируемая модель — экспортируемое приложение LUIS.
PatternAny	Pattern.Any Entity Extractor.
PatternRule	Шаблон
PrebuiltDomainObject
PrebuiltEntity	Предварительно созданный средство извлечения сущностей.
RegexEntity	Средство извлечения сущностей регулярного выражения.
SubClosedList	Подсписок элементов для сущности списка.

ClosedList

Экспортируемая модель — сущность списка.

Имя	Тип	Описание
name	string	Имя сущности списка.
roles	string[]
subLists	SubClosedList[]	Вложенные списки для сущности списка.

ErrorResponse

Ответ об ошибке при вызове операции в API.

Имя	Тип	Описание
errorType	string

HierarchicalModel

Имя	Тип	Описание
children	string[]
inherits	PrebuiltDomainObject
name	string
roles	string[]

JSONEntity

Экспортируемая модель — извлеченная сущность из речевого фрагмента.

Имя	Тип	Описание
endPos	integer	Индекс в речевом фрагменте, в котором заканчивается извлеченная сущность.
entity	string	Имя сущности.
role	string	Роль сущности в речевом фрагменте.
startPos	integer	Индекс в речевом фрагменте, с которого начинается извлеченная сущность.

JSONModelFeature

Экспортируемая модель — функция модели с списком фраз.

Имя	Тип	Описание
activated	boolean	Указывает, включена ли функция.
mode	boolean	Функция списка взаимозаменяемых фраз служит списком синонимов для обучения. Список фраз без обмена служит отдельными функциями для обучения. Таким образом, если список незаменяемых фраз содержит 5 фраз, они будут сопоставлены с 5 отдельными функциями. Список незаменяемых фраз можно рассматривать как дополнительный набор слов для добавления в существующие функции словаря LUIS. Он используется в качестве функции поиска лексикона, где его значение равно 1, если лексикон содержит заданное слово, или 0, если это не так. Значение по умолчанию — true.
name	string	Имя списка фраз.
words	string	Список фраз, разделенных запятыми, которые представляют список фраз.

JSONRegexFeature

Экспортируемая модель — функция шаблона.

Имя	Тип	Описание
activated	boolean	Указывает, включена ли функция "Шаблон".
name	string	Имя компонента.
pattern	string	Регулярное выражение для сопоставления.

JSONUtterance

Экспортируемая модель — речевой фрагмент, который использовался для обучения модели.

Имя	Тип	Описание
entities	JSONEntity[]	Совпадаемые сущности.
intent	string	Соответствующее намерение.
text	string	Речевой фрагмент.

LuisApp

Экспортируемая модель — экспортируемое приложение LUIS.

Имя	Тип	Описание
closedLists	ClosedList[]	Список сущностей списка.
composites	HierarchicalModel[]	Список составных сущностей.
culture	string	Язык и региональные параметры приложения. Например: en-us.
desc	string	Описание приложения.
entities	HierarchicalModel[]	Список сущностей.
intents	HierarchicalModel[]	Список намерений.
model_features	JSONModelFeature[]	Список функций модели.
name	string	Имя приложения.
patternAnyEntities	PatternAny[]	Список сущностей Pattern.Any.
patterns	PatternRule[]	Список шаблонов.
prebuiltEntities	PrebuiltEntity[]	Список предварительно созданных сущностей.
regex_entities	RegexEntity[]	Список сущностей регулярного выражения.
regex_features	JSONRegexFeature[]	Список функций шаблона.
utterances	JSONUtterance[]	Список примеров речевых фрагментов.
versionId	string	Идентификатор версии экспортированного приложения.

PatternAny

Pattern.Any Entity Extractor.

Имя	Тип	Описание
explicitList	string[]
name	string
roles	string[]

PatternRule

Шаблон

Имя	Тип	Описание
intent	string	Имя намерения, к которому принадлежит шаблон.
pattern	string	Текст шаблона.

PrebuiltDomainObject

Имя	Тип	Описание
domain_name	string
model_name	string

PrebuiltEntity

Предварительно созданный средство извлечения сущностей.

Имя	Тип	Описание
name	string
roles	string[]

RegexEntity

Средство извлечения сущностей регулярного выражения.

Имя	Тип	Описание
name	string
regexPattern	string
roles	string[]

SubClosedList

Подсписок элементов для сущности списка.

Имя	Тип	Описание
canonicalForm	string	Стандартная форма, представленная списком.
list	string[]	Список слов-синонимов.

Share via