Именованные сущности в запросах

После того, как пользователь произносит команду, Диалоги распознают ее текст и извлекают именованные сущности (named entities) — слова и фразы, которые описывают определенные объекты.

На текущий момент Диалоги распознают:

Все извлеченные сущности включаются в запрос к навыку в свойстве request.nlu.entities.

Имя, фамилия, отчество

Диалоги распознают и связывают друг с другом имена, фамилии и отчества.

Примеры оформления имен в запросе к навыку:

Фраза «Антон Павлович Чехов»:

"type": "YANDEX.FIO",
"value": {
  "first_name": "антон",
  "patronymic_name": "павлович",
  "last_name": "чехов"
}

Местоположение

Диалоги распознают указания на место:

  • country — страна;
  • city — город;
  • street — улица;
  • house_number — номер дома;
  • airport — название аэропорта.

Примеры местоположения в запросе к навыку:

Фраза «Адрес — Россия, Москва, улица Льва Толстого, шестнадцать»:
"type": "YANDEX.GEO",
"value": {
  "country": "россия",
  "city": "москва", 
  "street": "улица льва толстого", 
  "house_number": "16"
}

Дата и время

Диалоги распознают упоминания даты и времени, а также относительную дату и время: именованной сущностью станет как фраза «в 1968 году», так и фраза «40 лет назад»:

  • year — точный год;
  • year_is_relative — признак того, что в поле year указано относительное количество лет;
  • month — месяц;
  • month_is_relative — признак того, что в поле month указано относительное количество месяцев;
  • day — день;
  • day_is_relative — признак того, что в поле day указано относительное количество дней;
  • hour — час;
  • hour_is_relative — признак того, что в поле hour указано относительное количество часов;
  • minute — минута;
  • minute_is_relative — признак того, что в поле minute указано относительное количество минут.

Примеры даты и времени в запросе к навыку:

Фраза «в двадцать два часа тридцать минут, пятнадцатого сентября тысяча девятьсот восемьдесят второго года»:
"type": "YANDEX.DATETIME",
"value": {
  "year": 1982,
  "month": 9,
  "day": 15,
  "hour": 22,
  "minute": 30,
}

Число

Диалоги распознают целые и дробные числа:

  • integer — целое число;
  • float — десятичная дробь.

Примеры чисел в запросе к навыку:

Фраза «тридцать три попугая»:
"type": "YANDEX.NUMBER",
"value": 33