Сущность списка

Важно!

Служба LUIS будет прекращена 1 октября 2025 г., и с 1 апреля 2023 г. вы не сможете создавать новые ресурсы LUIS. Мы рекомендуем перенести приложения LUIS на распознавание устной речи , чтобы воспользоваться непрерывной поддержкой продуктов и многоязычными возможностями.

Сущности списка представляют фиксированный, закрытый набор связанных слов вместе с их синонимами. LUIS не обнаруживает дополнительные значения для сущностей списка. Посмотреть предложения для новых слов на основе текущего списка можно с помощью функции Рекомендовать. Если имеется несколько сущностей списка с одним и тем же значением, в запросе конечной точки возвращается каждая сущность.

Сущность списка не прошла машинное обучение. Она является точным текстовым совпадением. LUIS помечает все совпадения с элементом в списке как сущность в ответе.

Сущность оптимальна для данных в таких случаях.

• Значения данных являются известным набором.
• Не изменяется часто. Если необходимо часто изменять список или он должен быть самораскрывающимся, лучше выбрать простую сущность, дополненную списком фраз.
• Набор не превышает максимальные ограничения LUIS для этого типа сущности.
• Текст в речевом фрагменте — это совпадение без учета регистра с синонимом или каноническим именем. LUIS не использует список за пределами соответствия. Сущность списка не используется для разрешения нечеткого соответствия, выделения корней, множественных форм и других вариантов. Для управления вариантами рекомендуется применять шаблон с синтаксисом, имеющим необязательный текст.

Пример файла JSON для импорта в сущность списка

Можно импортировать значения в существующую сущность списка, используя существующий формат JSON.

[
    {
        "canonicalForm": "Blue",
        "list": [
            "navy",
            "royal",
            "baby"
        ]
    },
    {
        "canonicalForm": "Green",
        "list": [
            "kelly",
            "forest",
            "avacado"
        ]
    }
]

Пример ответа в формате JSON

Предположим, что в приложении есть список Cities, допускающий разные варианты названия городов, включая город аэропорта (Sea-tac), код аэропорта (SEA), почтовый индекс (98101) и телефонный код города (206).

Элемент списка	Синонимы элемента
Seattle	sea-tac, sea, 98101, 206, +1
Paris	cdg, roissy, ory, 75001, 1, +33

book 2 tickets to paris

В предыдущем высказывании слово paris сопоставляется с элементом paris как часть сущности списка Cities. Сущность списка совпадает с нормализованным именем элемента, а также с синонимами элемента.

Отклик конечной точки прогнозирования V2

  "entities": [
    {
      "entity": "paris",
      "type": "Cities",
      "startIndex": 18,
      "endIndex": 22,
      "resolution": {
        "values": [
          "Paris"
        ]
      }
    }
  ]

Отклик конечной точки прогнозирования V3

Это JSON, если в строке запроса задано verbose=false:

"entities": {
    "Cities": [
        [
            "Paris"
        ]
    ]
}

Это JSON, если в строке запроса задано verbose=true:

"entities": {
    "Cities": [
        [
            "Paris"
        ]
    ],
    "$instance": {
        "Cities": [
            {
                "type": "Cities",
                "text": "paris",
                "startIndex": 18,
                "length": 5,
                "modelTypeId": 5,
                "modelType": "List Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

Объект данных	Имя сущности	Значение
Сущность списка	Cities	paris

Дальнейшие действия

Узнайте больше о сущностях:

• Типы сущностей
• Создание сущностей