Перейти к основному содержимому

$entities

Переменная $entities содержит список всех сущностей NLU, распознанных в запросе пользователя.

Формат объекта

В качестве значения переменной выступает массив объектов вида:

[
{
"pattern": "fruit",
"startPos": 1,
"length": 1,
"value": "{\n \"name\": \"banana\",\n \"type\": \"fruit\"\n}"
}
]
  • pattern — название сущности.

  • startPos — позиция слова, с которого начинается сущность. Нумерация начинается с нуля.

  • length — число токенов, которые входят в сущность.

  • value — справочные данные сущности (DATA).

    предупреждение
    Значение value всегда имеет строковый тип, даже если в DATA вы указали JSON. Используйте в сценарии метод JSON.parse, чтобы преобразовать строку в объект и обратиться к его полям.

Если запрос пользователя попал в интент со слот-филлингом, у объектов в массиве $entities появляется дополнительное поле slot — название слота, в который попала сущность.

Пример использования

state: DebugEntities
q!: *
if: $entities.length
a: В запросе есть следующие сущности: {{_.pluck($entities, "pattern").join(", ")}}.
else:
a: В запросе нет сущностей.