Создание моделей вызова

Модель вызова определяет, как пользователи вызывают действия в вашем проекте. Когда пользователи вызывают Действие, они начинают с ним диалог, который определяется вашей моделью диалога . Вы можете определить вызовы следующими способами:

  • Основной вызов — это единственный необходимый вызов для вашего проекта Actions. Пользователи произносят фразу, похожую на «Окей, Google, поговори с <отображаемое имя>», чтобы соответствовать этому намерению, которое вы обычно реализуете, приветствуя пользователя приветственным сообщением.

  • Вызовы глубоких ссылок . Это необязательные вызовы, которые позволяют вам определять обучающие фразы в специальном намерении, чтобы пользователи могли размещать глубокие ссылки на определенную часть вашего разговора. Пользователи могут произнести фразу, похожую на «Окей, Google, поговори с <отображаемым именем> по <фраза глубокой ссылки>», чтобы соответствовать этим типам намерений (например, «Окей, Google, поговори с Фактами о Google, чтобы узнать факты о компании» ).

  • Встроенные намерения — это необязательные вызовы, которые позволяют вам воспользоваться преимуществами определяемых системой моделей вызовов. Объявив поддержку встроенного намерения, пользователи смогут обнаруживать и вызывать ваш проект Actions без необходимости указывать отображаемое имя. Например, пользователи могут сказать «Окей, Google, поиграй в игру» , а Google Assistant может представить ваше действие в качестве варианта для вызова.

Рисунок 1. Модель вызова состоит из всех намерений, которые могут начать диалог с вашими действиями.

Создайте основной вызов

Каждый проект Actions имеет основной вызов по умолчанию, который действует как точка входа по умолчанию в ваш проект Actions. Языковая модель для этого вызова связана с отображаемым именем вашего проекта, поэтому пользователям просто нужно произнести фразу, похожую на «Окей, Google, поговорим». to <отображаемое имя>» , чтобы использовать этот вызов. Когда пользователи вызывают ваши действия таким образом, среда выполнения Assistant соответствует системному намерению actions.intent.MAIN .

Чтобы создать основной вызов:

Чтобы создать вызовы глубоких ссылок, вы создаете глобальные намерения пользователя с обучающими фразами, которые определяют ввод пользователя, который вы хотите установить для глубокой ссылки. Пользователи произносят ваше отображаемое имя в сочетании с фразой глубокой ссылки, чтобы выполнить вызов глубокой ссылки (например, «Окей, Google, поговори с <отображаемым именем> по <фраза глубокой ссылки>» ).

Создание неявных вызовов

Неявный вызов позволяет пользователям вызывать ваше действие без использования отображаемого имени вашего проекта. Чтобы найти подходящие действия, Google использует сигналы, например, когда пользователи говорят Ассистенту сделать что-то похожее на фразу вызова для одного из ваших настроенных намерений, или когда пользователь находится в контексте, где ваши действия могут быть подходящими.

Обработка событий вызова

Когда Ассистент соответствует одному из ваших глобальных намерений, он запускает событие, которое вы можете обработать с помощью обработчика. В следующих разделах описывается, что может выполнять ваш обработчик (вы можете выбрать один или любую комбинацию из трех).

Запустить вебхук

Ваш обработчик намерений может делегировать полномочия веб-службе, вызывая событие веб-перехватчика. Чтобы запустить вебхук и заставить веб-службу обработать вызов:

Подсказки

Ваш обработчик намерений может ответить статическим приглашением. Обычно запросы о намерениях вызова приветствуют пользователя, ориентируют его на то, как использовать Действие, или отвечают немедленной информацией, которая нужна пользователю (одноразовые действия).

Чтобы обработать совпадение намерения вызова с помощью приглашения:

Переход к сцене

Ваш обработчик намерения может перейти к сцене для обработки соответствующего намерения вызова. Это дает вам максимальную гибкость для реализации логики. Чтобы перейти к сцене: