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

После того, как пользователь произносит команду, Диалоги распознают ее текст и извлекают именованные сущности (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