Модель вызова определяет, как пользователи вызывают действия в вашем проекте. Когда пользователи вызывают Действие, они начинают с ним диалог, который определяется вашей моделью диалога . Вы можете определить вызовы следующими способами:
Основной вызов — это единственный необходимый вызов для вашего проекта Actions. Пользователи произносят фразу, похожую на «Окей, Google, поговори с <отображаемое имя>», чтобы соответствовать этому намерению, которое вы обычно реализуете, приветствуя пользователя приветственным сообщением.
Вызовы глубоких ссылок . Это необязательные вызовы, которые позволяют вам определять обучающие фразы в специальном намерении, чтобы пользователи могли размещать глубокие ссылки на определенную часть вашего разговора. Пользователи могут произнести фразу, похожую на «Окей, Google, поговори с <отображаемым именем> по <фраза глубокой ссылки>», чтобы соответствовать этим типам намерений (например, «Окей, Google, поговори с Фактами о Google, чтобы узнать факты о компании» ).
Встроенные намерения — это необязательные вызовы, которые позволяют вам воспользоваться преимуществами определяемых системой моделей вызовов. Объявив поддержку встроенного намерения, пользователи смогут обнаруживать и вызывать ваш проект Actions без необходимости указывать отображаемое имя. Например, пользователи могут сказать «Окей, Google, поиграй в игру» , а Google Assistant может представить ваше действие в качестве варианта для вызова.
Создайте основной вызов
Каждый проект Actions имеет основной вызов по умолчанию, который действует как точка входа по умолчанию в ваш проект Actions. Языковая модель для этого вызова связана с отображаемым именем вашего проекта, поэтому пользователям просто нужно произнести фразу, похожую на «Окей, Google, поговорим». to <отображаемое имя>», чтобы использовать этот вызов. Когда пользователи вызывают ваши действия таким образом, среда выполнения Assistant соответствует системному намерению actions.intent.MAIN .
Чтобы создать основной вызов:
Создание вызовов глубоких ссылок
Чтобы создать вызовы глубоких ссылок, вы создаете глобальные намерения пользователя с обучающими фразами, которые определяют ввод пользователя, который вы хотите установить для глубокой ссылки. Пользователи произносят ваше отображаемое имя в сочетании с фразой глубокой ссылки, чтобы выполнить вызов глубокой ссылки (например, «Окей, Google, поговори с <отображаемым именем> по <фраза глубокой ссылки>»).
Создание неявных вызовов
Неявный вызов позволяет пользователям вызывать ваше действие без использования отображаемого имени вашего проекта. Чтобы найти подходящие действия, Google использует сигналы, например, когда пользователи говорят Ассистенту сделать что-то похожее на фразу вызова для одного из ваших настроенных намерений, или когда пользователь находится в контексте, где ваши действия могут быть подходящими.
Обработка событий вызова
Когда Ассистент соответствует одному из ваших глобальных намерений, он запускает событие, которое вы можете обработать с помощью обработчика. В следующих разделах описывается, что может выполнять ваш обработчик (вы можете выбрать один или любую комбинацию из трех).
Запустить вебхук
Ваш обработчик намерений может делегировать полномочия веб-службе, вызывая событие веб-перехватчика. Чтобы запустить вебхук и заставить веб-службу обрабатывать вызов:
Подсказки
Ваш обработчик намерений может ответить статическим приглашением. Обычно запросы о намерениях вызова приветствуют пользователя, ориентируют его на то, как использовать Действие, или отвечают немедленной информацией, которая нужна пользователю (одноразовые действия).
Чтобы обработать совпадение намерения вызова с помощью приглашения:
Переход к сцене
Ваш обработчик намерения может перейти к сцене для обработки соответствующего намерения вызова. Это дает вам максимальную гибкость для реализации логики. Чтобы перейти к сцене: