Именованные сущности в запросах
После того, как пользователь произносит команду, Диалоги распознают ее текст и извлекают именованные сущности (named entities) — слова и фразы, которые описывают определенные объекты.
Сейчас Диалоги распознают:
- имена (фамилия, имя, отчество);
Все извлеченные сущности включаются в запрос к навыку в свойстве request.nlu.entities
.
Имя, фамилия, отчество
Диалоги распознают и связывают друг с другом имена, фамилии и отчества.
Примеры оформления имен в запросе к навыку:
Фраза «Антон Павлович Чехов»:
"type": "YANDEX.FIO",
"value": {
"first_name": "антон",
"patronymic_name": "павлович",
"last_name": "чехов"
}
"type": "YANDEX.FIO",
"value": {
"first_name": "лев",
"last_name": "толстой"
}
{
"type": "YANDEX.FIO",
"value": {
"first_name": "василий",
"patronymic_name": "иванович"
},
},
{
"type": "YANDEX.FIO",
"value": {
"first_name": "петька"
}
}
Местоположение
Диалоги распознают указания на место:
country
— страна;city
— город;street
— улица;house_number
— номер дома;airport
— название аэропорта.
Примеры местоположения в запросе к навыку:
"type": "YANDEX.GEO",
"value": {
"country": "россия",
"city": "москва",
"street": "улица льва толстого",
"house_number": "16"
}
"type": "YANDEX.GEO",
"value": {
"airport": "аэропорт внуково",
}
Дата и время
Диалоги распознают упоминания даты и времени, а также относительную дату и время. Например, именованной сущностью станет как фраза «в 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,
}
"type": "YANDEX.DATETIME",
"value": {
"day": -1,
"day_is_relative": true
}
Число
Диалоги распознают целые и дробные числа:
integer
— целое число;float
— десятичная дробь.
Примеры чисел в запросе к навыку:
"type": "YANDEX.NUMBER",
"value": 33
"type": "YANDEX.NUMBER",
"value": 4.5