SimpleUtterance
Навык получает запрос с типом SimpleUtterance
, если:
- Пользователь произносит фразу.
- Пользователь нажимает кнопку в бабле из предыдущего ответа навыка (свойство
hide
со значениемfalse
). - Пользователь нажимает отдельную кнопку в предыдущем ответе навыка (свойство
hide
со значениемtrue
) с отсутствующим значением в полеpayload
. - Пользователь впервые обращается к навыку в контексте сессии. Остальные поля в объекте
request
в этом случае передаются пустыми.
{
"request": {
"command": "закажи пиццу на улицу льва толстого 16 на завтра",
"original_utterance": "закажи пиццу на улицу льва толстого, 16 на завтра",
"markup": {
"dangerous_context": true
},
"payload": {},
"nlu": {
"tokens": [
"закажи",
"пиццу",
"на",
"льва",
"толстого",
"16",
"на",
"завтра"
],
"entities": [
{
"tokens": {
"start": 2,
"end": 6
},
"type": "YANDEX.GEO",
"value": {
"house_number": "16",
"street": "льва толстого"
}
},
{
"tokens": {
"start": 3,
"end": 5
},
"type": "YANDEX.FIO",
"value": {
"first_name": "лев",
"last_name": "толстой"
}
},
{
"tokens": {
"start": 5,
"end": 6
},
"type": "YANDEX.NUMBER",
"value": 16
},
{
"tokens": {
"start": 6,
"end": 8
},
"type": "YANDEX.DATETIME",
"value": {
"day": 1,
"day_is_relative": true
}
}
],
"intents": {},
}
"type": "SimpleUtterance"
},
}
request
Данные, полученные от пользователя.
Свойство |
Описание |
|
string Нормализованный текст запроса. В ходе нормализации текст очищается от знаков препинания, приводится к нижнему регистру, а числительные преобразуются в числа. При запуске навыка по запросу вида «Спроси у навыка <Название> сколько времени» в Чтобы получить точный текст запроса, используйте свойство |
|
string Полный текст пользовательского запроса, максимум 1024 символа. Если свойство содержит значение |
object Формальные характеристики реплики, которые удалось выделить Яндекс Диалогам. Свойство отсутствует, если ни одно из вложенных свойств не применимо. |
|
object Слова и именованные сущности, которые Диалоги извлекли из запроса пользователя. Подробное описание поддерживаемых типов сущностей см. в разделе Именованные сущности в запросах. |
|
|
object Обозначение начала и конца именованной сущности в массиве слов. Нумерация слов в массиве начинается с 0. |
|
string Тип ввода. Возможные значения см. в разделе Формат запроса. |
request.markup
Формальные характеристики реплики, которые удалось выделить Яндекс Диалогам. Объект отсутствует, если ни одно из вложенных свойств не применимо.
Свойство |
Описание |
|
boolean Признак реплики, которая содержит криминальный подтекст (самоубийство, разжигание ненависти, угрозы). Вы можете настроить навык на определенную реакцию для таких случаев — например, отвечать «Не понимаю, о чем вы. Пожалуйста, переформулируйте вопрос.» Возможно только значение |
request.nlu
Слова и сущности, которые Диалоги извлекли из запроса пользователя.
Подробное описание поддерживаемых типов сущностей см. в разделе Именованные сущности в запросах.
Свойство |
Описание |
|
array of strings Массив слов из произнесенной пользователем фразы. |
array of objects Массив именованных сущностей. |
|
|
object Объект с данными, извлеченными из пользовательского запроса. Подробнее см. в разделе Обработка естественного языка (NLP). |
request.nlu.entities
Массив именованных сущностей.
Свойство |
Описание |
|
number Первое слово именованной сущности. |
|
number Первое слово после именованной сущности. |
|
string Тип именованной сущности. Возможные значения:
|
|
object, number Формальное описание именованной сущности. Формат этого поля для всех поддерживаемых типов сущностей приведен в разделе Именованные сущности в запросах. |
Cтрока, выделяется кавычками, например "Hello world"
.
Целое или дробное число без кавычек, например 25.5
.
Список пар "ключ": значение
, разделенных запятой. Выделяется фигурными скобками {}
.
{
"name": "John",
"surname": "Smith"
}
Массив элементов, разделенных запятой. Элементом могут быть стандартные элементы JSON: строка, число, true
, false
, объект или массив. Массив выделяется квадратными скобками []
: "cities": ["Moscow", "Tokyo", "New York"]
Логическое значение без кавычек: true
(истина) или false
(ложь).