--- metadata: - name: generator content: Diplodoc Platform v5.39.1 alternate: - https://yandex.ru/dev/dialogs/alice/doc/ru/request-simpleutterance.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/alice/doc/ru/llms.txt # SimpleUtterance {% include notitle [neuroexpert-button](_includes/reusables/neuroexpert-button-99270fdba323.md) %} Навык получает запрос с типом `SimpleUtterance`, если: - Пользователь произносит фразу. - Пользователь нажимает кнопку в бабле из предыдущего ответа навыка (свойство `hide` со значением `false`). - Пользователь нажимает отдельную кнопку в предыдущем ответе навыка (свойство `hide` со значением `true`) с отсутствующим значением в поле `payload`. - Пользователь впервые обращается к навыку в контексте сессии. Остальные поля в объекте `request` в этом случае передаются пустыми. ```json { "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 {#request-desc} Данные, полученные от пользователя. #| || **Свойство** | **Описание** || || `command` | [string](*string) Нормализованный текст запроса. В ходе нормализации текст очищается от знаков препинания, приводится к нижнему регистру, а числительные преобразуются в числа. При запуске навыка по запросу вида «Спроси у навыка <Название> сколько времени» в `command` придет только правая часть запроса: «сколько времени». Чтобы получить точный текст запроса, используйте свойство `original_utterance`. || || `original_utterance` | [string](*string) Полный текст пользовательского запроса, максимум 1024 символа. Если свойство содержит значение `ping`, то запрос выполняется Диалогами и является [проверочным](https://yandex.ru/dev/dialogs/alice/doc/ru/moderation.md). || || [`markup`](#markup-desc) | [object](*object) Формальные характеристики реплики, которые удалось выделить Яндекс Диалогам. Свойство отсутствует, если ни одно из вложенных свойств не применимо. || || [`nlu`](#nlu-desc) | [object](*object) Слова и именованные сущности, которые Диалоги извлекли из запроса пользователя. Подробное описание поддерживаемых типов сущностей см. в разделе [Именованные сущности в запросах](https://yandex.ru/dev/dialogs/alice/doc/ru/naming-entities.md). || || `tokens` | [object](*object) Обозначение начала и конца именованной сущности в массиве слов. Нумерация слов в массиве начинается с 0. || || `type` | [string](*string) Тип ввода. Возможные значения см. в разделе [Формат запроса](https://yandex.ru/dev/dialogs/alice/doc/ru/request.md#request-desc). || |# ## request.markup {#markup-desc} Формальные характеристики реплики, которые удалось выделить Яндекс Диалогам. Объект отсутствует, если ни одно из вложенных свойств не применимо. #| || **Свойство** | **Описание** || || `dangerous_context` | [boolean](*boolean) Признак реплики, которая содержит криминальный подтекст (самоубийство, разжигание ненависти, угрозы). Вы можете настроить навык на определенную реакцию для таких случаев — например, отвечать «Не понимаю, о чем вы. Пожалуйста, переформулируйте вопрос.» Возможно только значение `true`. Если признак не применим, это свойство не включается в ответ. || |# ## request.nlu {#nlu-desc} Слова и сущности, которые Диалоги извлекли из запроса пользователя. Подробное описание поддерживаемых типов сущностей см. в разделе [Именованные сущности в запросах](https://yandex.ru/dev/dialogs/alice/doc/ru/naming-entities.md). #| || **Свойство** | **Описание** || ||`tokens[]` | [array](*array) of [strings](*string) Массив слов из произнесенной пользователем фразы. || || [`entities[]`](#entities-desc) | [array](*array) of [objects](*object) Массив именованных сущностей. || || `intents` | [object](*object) Объект с данными, извлеченными из пользовательского запроса. Подробнее см. в разделе [Обработка естественного языка (NLP)](https://yandex.ru/dev/dialogs/alice/doc/ru/nlu.md). || |# ## request.nlu.entities {#entities-desc} Массив именованных сущностей. #| || **Свойство** | **Описание** || || `start` | [number](*number) Первое слово именованной сущности. || || `end` | [number](*number) Первое слово после именованной сущности. || || `type` | [string](*string) Тип именованной сущности. Возможные значения: - `YANDEX.DATETIME` — дата и время, абсолютные или относительные. - `YANDEX.FIO` — фамилия, имя и отчество. - `YANDEX.GEO` — местоположение (адрес или аэропорт). - `YANDEX.NUMBER` — число, целое или с плавающей точкой. || || `value` | [object](*object), [number](*number) Формальное описание именованной сущности. Формат этого поля для всех поддерживаемых типов сущностей приведен в разделе [Именованные сущности в запросах](https://yandex.ru/dev/dialogs/alice/doc/ru/naming-entities.md). || |# {% include [index-support-button](_includes/index/id-index/support-button-a766d80c172a.md) %} [*string]: Cтрока, выделяется кавычками, например `"Hello world"`. [*number]: Целое или дробное число без кавычек, например `25.5`. [*object]: Список пар `"ключ": значение`, разделенных запятой. Выделяется фигурными скобками `{}`. ``` { "name": "John", "surname": "Smith" } ``` [*array]: Массив элементов, разделенных запятой. Элементом могут быть стандартные элементы JSON: строка, число, `true`, `false`, объект или массив. Массив выделяется квадратными скобками `[]`: ```"cities": ["Moscow", "Tokyo", "New York"] ``` [*boolean]: Логическое значение без кавычек: `true` (истина) или `false` (ложь).