Встроенные намерения

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

Например, вот некоторые пользовательские запросы, которые Ассистент сопоставляет встроенным намерениям:

• Встроенное намерение «Играть в игру» : «Окей, Google. Поиграй в игру на память».
• Встроенное намерение «Научи меня чему-нибудь новому» : «Окей, Google. Научи меня чему-нибудь новому».
• Встроенное намерение «Рассказывание историй» : «Окей, Google. Расскажи мне сказку на ночь».

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

Если вы разрабатываете свое действие с помощью Actions SDK, убедитесь, что вы используете двоичный файл gactions версии 3.1.0 или выше для использования встроенных намерений.

Примечание. Обнаружение действий с помощью встроенных намерений доступно только на английском языке.

Параметры вызова

Некоторые встроенные намерения имеют значения параметров, которые используются для дальнейшей категоризации вашего действия для обнаружения. Например, встроенное намерение повествования имеет значения параметров жанра. Пользователи могут включать эти значения в свой запрос к Ассистенту, отправляя запросы типа «Окей, Google. Расскажи мне приключенческую историю» .

Подробную информацию о конкретных значениях параметров см. в разделах «Повествование» и «Образование» .

Встроенное намерение Play Game

Встроенное намерение «Играть в игру» предоставляет вашему действию дополнительную видимость для пользователей Ассистента, которые отправляют запросы типа «Окей, Google. Играй в игру».

Дополнительную информацию о разработке игр для Ассистента и рекомендации см. в Руководстве по дизайну игр для Google Assistant .

Настраивать

Action Builder Actions SDK

Чтобы настроить встроенное намерение Play Game, выполните следующие действия:

1. Перейдите в консоль действий .
2. Нажмите «Новый проект» , введите имя проекта и нажмите «Создать проект» .
3. Выберите категорию «Игры» на странице регистрации.

   Для существующих проектов перейдите в раздел «Разработка» > «Вызов» > «Настройки» и включите «Воспроизвести игру» в разделе «Встроенные намерения» .

   

Встроенное намерение рассказывания историй

Встроенное намерение рассказывания историй регистрирует ваше действие для получения дополнительных сведений о рассказывании историй с помощью запросов Ассистента, таких как «Окей, Google. Расскажи мне историю принцессы ».

Действия по рассказыванию историй должны соответствовать следующим общим рекомендациям:

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

Примечание. В рамках программы «Действия для семей» все истории должны иметь соответствующее содержание и соответствовать правилам программы AFF .

Параметры вызова

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

Жанр (Конструктор действий)	Значение параметра (SDK)
Приключение	ADVENTURE
перед сном	BEDTIME
Фантастика	FANTASY
Интерактивный	INTERACTIVE
Принцесса	PRINCESS

Примечание. Все жанры повествования требуют регистрации в Actions for Families и не могут использоваться в сочетании со встроенными намерениями/параметрами, не относящимися к AFF.

Настраивать

Action Builder Actions SDK

Чтобы настроить встроенное намерение рассказывания историй, выполните следующие действия:

1. Перейдите в консоль действий .
2. Нажмите «Новый проект» , введите имя проекта и нажмите «Создать проект» .
3. Выберите категорию «Рассказывание историй» на странице регистрации.

   Для существующих проектов перейдите в раздел «Разработка» > «Вызов» > «Настройки» и включите «Расскажите мне историю» в разделе «Встроенные намерения» .

   
4. Подтвердите регистрацию в Actions for Families и нажмите « Присоединиться» .
5. В разделе «Значение параметра» выберите один или несколько жанров для вашего повествования. Это позволяет пользователям неявно вызывать ваше действие, используя жанр. Например, «Окей, Google, расскажи мне приключенческую историю» .
   Примечание . Используйте опцию «Рекомендовать новый жанр» , чтобы предложить новые жанры. Предложения, добавленные к этой опции , не влияют на возможность обнаружения.
6. Нажмите Применить . Затем нажмите Сохранить .
7. Нажмите «Изменить обработку намерения» для встроенного намерения.
8. Нажмите «Добавить сцену оценки условий» , чтобы автоматически создать сцену с условиями для выбранных вами жанров.
   
9. Перейдите к только что добавленной сцене и настройте вызовы веб-перехватчика, подсказки и переходы для каждого условия.
10. Нажмите Сохранить .

Образование, встроенное в намерение

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

Образовательные действия должны соответствовать следующим руководящим принципам высокого уровня:

• Ваше действие должно быть направлено на обучение или помощь в обучении.

• Ваше действие не предназначено для рекламы или инструментов набора персонала.

• Ваше действие сосредоточено на навыках и знаниях

• Ваше действие учит устоявшимся навыкам и знаниям

• Информация, которую сообщает ваше действие , не основана на мнениях и не является результатом текущих событий.

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

Параметры вызова

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

Тема обучения (Конструктор действий)	Значение параметра (SDK)
Изучите новый язык	LANGUAGE
Узнайте больше о мире природы	WORLD
Изучите новый навык	SKILL
Учитесь вместе с семьей	FAMILY

Примечание. Тема «Учиться вместе с семьей» требует регистрации в Actions for Families и не может использоваться в сочетании с другими темами обучения или встроенными намерениями/параметрами, не относящимися к AFF.

Настраивать

Actions Builder Actions SDK

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

1. Перейдите в консоль действий .
2. Нажмите «Новый проект» , введите имя проекта и нажмите «Создать проект» .
3. Выберите категорию «Образование» во время адаптации проекта.

   Для существующих проектов перейдите в раздел «Разработка» > «Вызов» > «Настройки» и включите «Научите меня чему-то новому» в разделе «Встроенные намерения» .

   
4. В разделе «Значение параметра» выберите один или несколько ресурсов для вашего образовательного опыта. Эти значения позволяют пользователям неявно вызывать ваше действие, используя тему ресурса. Например: «Окей, Google, научи меня новому языку» .
   Ключевой момент : опция «Учиться всей семьей» доступна только в том случае, если ваше действие зарегистрировано в программе «Действия для семей» и не может использоваться совместно с другими образовательными ресурсами.
   Примечание . Используйте опцию «Рекомендовать новый ресурс» , чтобы предложить новые темы обучения. Предложения, добавленные для этой опции , не влияют на возможность обнаружения.
5. Нажмите Применить . Затем нажмите Сохранить .
6. Нажмите «Изменить обработку намерения» для встроенного намерения.
7. На встроенной странице намерений нажмите «Добавить сцену оценки условий» . Это действие автоматически создает сцену с условиями для выбранных учебных ресурсов.
   
8. Перейдите к только что добавленной сцене и настройте вызовы веб-перехватчика, подсказки и переходы для каждого условия.
9. Нажмите Сохранить .