Намерения — это объекты обмена сообщениями, описывающие, как что-то сделать. Вы можете использовать намерения одним из двух способов:
- Обеспечивая реализацию намерения или
- Запросив выполнение намерения у Google Ассистента.
Процесс, с помощью которого вы обеспечиваете выполнение намерения, различен для разработчиков , использующих Dialogflow , и для разработчиков, использующих Actions SDK . Однако в обоих случаях вы указываете имя намерения и URL-адрес веб-перехватчика выполнения. Это сообщает Actions on Google, что вы можете поддерживать запросы пользователей, соответствующие намерению.
Чтобы запросить выполнение намерения, вы указываете намерение в объекте possibleIntents при ответе Ассистенту. В последующем запросе на ваше выполнение Ассистент возвращает вам результат обработанного намерения . Для получения дополнительной информации прочтите обзор использования помощников .
Общие намерения
В следующей таблице описаны намерения, которые Помощник просит вас выполнить.
| Имя намерения | Применение | Событие диалогового потока |
|---|---|---|
actions.intent.MAIN | Обязательно : каждый пакет действий объявляет одно и только одно намерение, которое служит точкой входа для пользователей, чтобы начать общение. | WELCOME или GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT | Получите необработанное текстовое представление запроса пользователя. Вы используете это большую часть времени при общении с пользователями. | |
actions.intent.CANCEL | Вы получаете это намерение, когда разрешаете получать намерения отмены в своем пакете действий. Когда пользователи произносят глобальную команду отмены, например «выход», вы получаете это намерение в следующем запросе на ваше выполнение, поэтому вы можете ответить последним сообщением и выполнить любую очистку в вашей логике выполнения. | actions_intent_CANCEL |
actions.intent.NO_INPUT | Вы получаете это намерение, когда разрешаете получать намерения без ввода данных в своем пакете действий. Если пользователи не отвечают на запрос, вы получаете это намерение в следующем запросе для вашего выполнения. | actions_intent_NO_INPUT |
Помощники
В следующей таблице описаны поддерживаемые помощники , которые вы можете запросить у Ассистента.
| Имя намерения | Применение | Событие диалогового потока |
|---|---|---|
actions.intent.PERMISSION | Получите полное имя пользователя, приблизительное или точное местоположение или все 3 . | actions_intent_PERMISSION |
actions.intent.OPTION | Получите выбранный элемент из списка или пользовательского интерфейса карусели . Или, если пользователь не делает выбор из списка или пользовательского интерфейса карусели, он получит речевой или текстовый ввод, соответствующий ключу в пользовательском интерфейсе списка или карусели. | actions_intent_OPTION |
actions.intent.DATETIME | Получите ввод даты и времени от пользователя. | actions_intent_DATETIME |
actions.intent.SIGN_IN | Запрашивает поток привязки учетной записи для привязки учетной записи пользователя. | actions_intent_SIGN_IN |
actions.intent.PLACE | Получите адрес или сохраненное местоположение от пользователя. | actions_intent_PLACE |
actions.intent.CONFIRMATION | Получите подтверждение от пользователя (например, ответ на вопрос «да» или «нет»). | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE | Запрашивает у пользователя разрешение на переход на другую поверхность Ассистента . | actions_intent_NEW_SURFACE |
Встроенные намерения
Встроенные намерения моделируют некоторые распространенные способы, с помощью которых пользователи выражают задачи, которые они пытаются выполнить, или информацию, которую они ищут, например заказ еды, заказ поездки или проверку баланса счета. Дополнительную информацию см. в справочнике по встроенным намерениям .
Дополнительные намерения
Большинство диалоговых действий построены на сочетании общих намерений, помощников и ответов. Однако действия, включающие дополнительные функции, такие как транзакции или ежедневные обновления, имеют доступ к намерениям, специфичным для этих функций.
Помощники транзакций
В следующей таблице описаны помощники, связанные с обработкой покупок, которые вы можете попросить Помощника выполнить. Дополнительную информацию о том, как реализовать эти и другие связанные намерения, можно найти в документации по функциям транзакций .
| Имя намерения | Применение | Событие диалогового потока |
|---|---|---|
actions.intent.DELIVERY_ADDRESS | Получите ввод адреса доставки от пользователя. | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK | Проверьте, соблюдены ли все требования для транзакции. | actions_intent_TRANSACTION_REQUIREMENTS_CHECK |
actions.intent.TRANSACTION_DECISION | Спрашивает пользователя, должна ли произойти транзакция. | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK | Проверяет конфигурацию транзакции пользователя. Используется, чтобы избежать предложения цифровых товаров пользователям, для которых транзакция не удастся. | actions_intent_DIGITAL_PURCHASE_CHECK |
actions.intent.COMPLETE_PURCHASE | Начинает запрос на покупку. В результате получается результат покупки, описывающий, была ли транзакция успешной или неудачной, и если да, то каким образом. | actions_intent_COMPLETE_PURCHASE |
Намерения взаимодействия с пользователем
В следующей таблице описаны намерения, связанные с функциями взаимодействия с пользователем. Дополнительную информацию о том, как реализовать эти и другие связанные намерения, можно найти в документации по функции взаимодействия с пользователем .
| Имя намерения | Обеспечить выполнение | Выполнение запроса | Применение | Событие диалогового потока |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE | Икс | Просит пользователя зарегистрироваться для получения обновлений . | actions_intent_REGISTER_UPDATE | |
actions.intent.CONFIGURE_UPDATES | Икс | Вы получаете это намерение, когда пользователь пытается зарегистрироваться для получения обновлений (т. е. должно быть отправлено намерение REGISTER_UPDATE). | actions_intent_CONFIGURE_UPDATES |
Пользовательские намерения
Вы можете создавать свои собственные намерения, чтобы определять ярлыки для разговора, чтобы помочь пользователям выполнять задачи более эффективно. Эти намерения находятся в вашем собственном пространстве имен; вы определяете, как пользователи запускают намерения, и ваш пакет действий — единственный, который может их поддерживать.
Для получения дополнительной информации прочтите об определении действий в Dialogflow или с помощью Actions SDK . Дополнительную информацию о пакетах действий можно найти в справочной документации по пакетам действий .
Умный дом
Если вы создаете действие «умный дом», вы определяете поддержку намерений немного по-другому. Дополнительную информацию см. в документации по умному дому .