Создайте действия для Google Assistant с помощью Actions SDK (уровень 1).

1. Обзор

Внимание: функция «Действия в диалоге» была устарела 13 июня 2023 года. Для получения дополнительной информации см. раздел « Устаревание функции «Действия в диалоге»» .

Платформа для разработчиков Google Assistant позволяет создавать программное обеспечение для расширения функциональности Google Assistant, виртуального персонального помощника, на более чем миллиарде устройств, включая умные колонки, телефоны, автомобили, телевизоры, наушники и многое другое. Пользователи взаимодействуют с Assistant в диалоге, чтобы выполнять задачи, такие как покупка продуктов или заказ такси. Как разработчик, вы можете использовать платформу для разработчиков Assistant, чтобы легко создавать и управлять удобными и эффективными диалогами между пользователями и вашим собственным сторонним сервисом выполнения заказов.

Этот практический урок охватывает базовые концепции разработки с использованием Actions SDK для Google Assistant; для его выполнения не требуется никакого предварительного опыта работы с платформой. В этом уроке вы создадите простой Action для Google Assistant, который будет предсказывать пользователям их судьбу, когда они начнут свое приключение в мифической стране Гриффинберг. В практическом уроке по Actions SDK уровня 2 вы доработаете этот Action, чтобы персонализировать предсказание пользователя на основе его ввода.

Что вы построите

В этом практическом задании вы создадите простой объект Action со следующими функциями:

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

По завершении этого практического задания ваше готовое действие будет иметь следующий диалоговый сценарий (текст рядом с микрофоном представляет собой ввод пользователя, а текст рядом с говорящим — ответ действия):

Что вы узнаете

• Как создать проект в консоли действий
• Как использовать инструмент gactions для отправки и получения вашего проекта Actions между консолью Actions и локальной файловой системой.
• Как отправить пользователю запрос после того, как он вызовет ваше действие
• Как обработать ввод пользователя и вернуть ответ.
• Как протестировать ваше действие в симуляторе действий
• Как реализовать выполнение заказов с помощью редактора Cloud Functions

Что вам понадобится

В вашей среде должны быть установлены следующие инструменты:

• Среда разработки (IDE) или текстовый редактор на ваш выбор.
• Терминал для выполнения команд оболочки для Node.js и npm.
• Веб-браузер, например, Google Chrome.

Если вы предпочитаете использовать более наглядные инструменты для создания действий, пройдите вместо этого практическое занятие «Создание действий для Google Assistant с помощью Actions Builder (Уровень 1)» , в котором то же действие создается с помощью встроенной в консоль среды разработки Actions Builder.

2. Настройка

В следующих разделах описано, как настроить среду разработки и создать проект Actions.

Проверьте настройки разрешений Google.

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

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

1. Перейдите в раздел «Управление действиями» .
2. Если вы еще этого не сделали, войдите в систему с помощью своей учетной записи Google.
3. Включите следующие разрешения:

• Активность в интернете и приложениях
• В разделе «Активность в Интернете и приложениях» установите флажок « Включать историю и активность Chrome с сайтов, приложений и устройств, использующих сервисы Google ».

Создайте проект Actions

Ваш проект Actions — это контейнер для вашего действия.

Чтобы создать проект Actions для этого практического занятия, выполните следующие шаги:

1. Откройте консоль «Действия» .
2. Нажмите «Создать проект» .
3. Введите название проекта , например, actions-codelab . (Это название предназначено для внутреннего использования. Позже вы сможете задать внешнее название для своего проекта.)

4. Нажмите «Создать проект» .
5. На экране «Какое действие вы хотите создать?» выберите карточку «Пользовательское» .
6. Нажмите «Далее» .
7. На экране «Как вы хотите это построить?» выберите карточку «Пустой проект» .
8. Нажмите « Начать строительство» .

Сохраните идентификатор проекта для вашего действия.

Идентификатор проекта — это уникальный идентификатор вашего действия. Идентификатор проекта необходим для нескольких шагов в этом практическом задании.

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

1. В консоли действий нажмите на три вертикальные точки (вставьте значок сюда).
2. Нажмите «Настройки проекта» .

3. Скопируйте идентификатор проекта**.**

Привязать платежный аккаунт

Если у вас еще нет платежного аккаунта, вам необходимо создать его и связать с вашим проектом в Google Cloud, чтобы в дальнейшем развернуть обработку заказов с помощью Cloud Functions.

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

1. Перейдите на страницу оплаты Google Cloud Platform .
2. Нажмите «Добавить платежный аккаунт» или «Создать аккаунт» .
3. Введите платежные данные.
4. Нажмите «Начать бесплатную пробную версию» или «Отправить» и включите оплату .
5. Перейдите на страницу оплаты Google Cloud Platform .
6. Нажмите вкладку «Мои проекты» .
7. Нажмите на три точки под разделом «Действия» рядом с проектом «Действия» для данного практического занятия.
8. Нажмите «Изменить платежные данные» .
9. В выпадающем меню выберите настроенный вами платежный аккаунт.
10. Нажмите «Настроить учетную запись» .

Чтобы избежать дополнительных расходов, выполните действия, описанные в разделе «Очистка проекта» в конце этого практического занятия.

Установите интерфейс командной строки gactions.

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

Ключевой термин :

• Gactions CLI : инструмент, позволяющий инициализировать файлы проектов Actions, отправлять обновления в консоль Actions, развертывать проекты Actions и многое другое.

Для установки инструмента командной строки gactions следуйте инструкциям в разделе «Установка инструмента командной строки gactions» .

Загрузите свой проект Actions

Начните разработку своего действия, загрузив проект Actions из консоли Actions.

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

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

mkdir myproject
cd myproject

2. Чтобы скопировать конфигурацию вашего проекта Actions в локальную файловую систему, выполните следующую команду:

gactions pull --project-id <projectID>

Разберитесь в структуре файлов.

Загруженный из консоли Actions проект представлен в виде YAML- файла. На следующем изображении показано общее представление структуры файла:

Структура файлов состоит из следующих элементов:

• actions/ : Представляет ваш проект Actions. Система вызывает actions.yaml при запуске вашего действия, которое затем вызывает файл custom/global/actions.intent.MAIN.yaml .
• custom/ : Каталог, в котором вы будете работать для изменения вашего действия.
• global/ : В этом каталоге хранятся системные интенты , которые платформа автоматически добавляет в ваш проект. Подробнее о системных интентах вы узнаете позже в этом практическом занятии.
• manifest.yaml : файл, содержащий информацию, которая является переносимой, то есть не привязана к конкретному проекту и может быть перемещена между проектами.
• settings/ : Представляет собой настройки проекта Actions, такие как отображаемое имя, язык по умолчанию и категория.

3. Начните разговор

Пользователи начинают диалог с вашим действием посредством вызова . Например, если у вас есть действие с именем MovieTime , пользователи могут вызвать его, произнеся фразу типа «Привет, Google, поговори с MovieTime», где MovieTime — это отображаемое имя. Для развертывания в продакшене у вашего действия должно быть отображаемое имя; однако для тестирования вашего действия вам не нужно его определять. Вместо этого вы можете использовать фразу «Поговори с моим тестовым приложением» в симуляторе для вызова вашего действия. Подробнее о симуляторе вы узнаете позже в этом разделе.

Необходимо отредактировать основной вызов , чтобы определить, что произойдет после того, как пользователь вызовет ваше действие.

Ключевой термин :

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

По умолчанию ваше действие отображает стандартное приглашение при запуске ( «Начните создавать ваше действие, определив основной вызов»).

Ключевой термин :

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

Для отображения полноэкранных изображений пользователю можно использовать специальную подсказку Canvas . Дополнительную информацию о Canvas см. в документации по интерактивному холсту .

В следующем разделе вы настроите приглашение для основного вызова в файле custom/global/actions.intent.MAIN.yaml .

Настройте основной вызов

Вы можете отредактировать основной запрос на вызов в файле actions.intent.MAIN.yaml .

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

1. Откройте custom/global/actions.intent.MAIN.yaml в текстовом редакторе.
2. Замените текст в поле speech ( Start building your action... ) следующим приветственным сообщением: A wondrous greeting, adventurer! Welcome to the mythical land of Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you're on your way to an epic journey.

actions.intent.MAIN.yaml

handler:
  staticPrompt:
    candidates:
    - promptResponse:
        firstSimple:
          variants:
          - speech: A wondrous greeting, adventurer! Welcome to the mythical land of 
                Gryffinberg! Based on your clothes, you are not from around these lands. 
                It looks like you're on your way to an epic journey.
transitionToScene: actions.scene.END_CONVERSATION

3. Сохраните файл.

Протестируйте основной вызов в симуляторе.

Консоль Actions предоставляет веб-инструмент для тестирования вашего Action, называемый симулятором . Интерфейс имитирует аппаратные устройства и их настройки, поэтому вы можете взаимодействовать с вашим Action так, как если бы он работал на смарт-дисплее, телефоне, колонке или KaiOS.

Актуальную информацию об использовании симулятора консоли Actions, а также в случае возникновения проблем на следующих этапах, см. на странице «Симулятор» .

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

Вы можете использовать команду gactions deploy preview для тестирования вашего действия в консоли без обновления версии проекта Actions. При выполнении этой команды никакие изменения, внесенные в локальную файловую систему, не будут распространены на развернутые версии вашего проекта Actions, но вы сможете протестировать их в предварительной версии.

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

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

gactions deploy preview

При выполнении этой команды вы можете получить уведомление о проблемах с проверкой. Если ваши файлы уже были загружены, вы можете игнорировать это уведомление.

В результате вы должны получить сообщение примерно следующего вида:

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. Скопируйте предоставленный URL-адрес и вставьте его в браузер.
3. Чтобы вызвать действие в симуляторе, введите Talk to my test app в поле «Ввод» и нажмите Enter .

Совет: Вы также можете нажать на кнопку «Поговорить с моим тестовым приложением» в разделе «Предложения» , которая обрабатывается так же, как и голосовой или текстовый ввод пользователя.

В качестве альтернативы вы можете щелкнуть значок микрофона и сказать «Поговори с моим тестовым приложением» , чтобы вызвать действие.

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

Просмотреть журналы событий

На вкладке «Тест» в консоли «Действия» отображается панель журналов событий , в которых история переписки представлена ​​в виде отдельных записей. Каждая запись в журнале событий отображает события, произошедшие во время соответствующего хода разговора.

В настоящее время у вашего действия есть один журнал событий, в котором отображаются как ввод пользователя ( «Поговорить с моим тестовым приложением» ), так и ответ вашего действия. На следующем снимке экрана показан журнал событий вашего действия:

Если вы нажмете на стрелку вниз рядом с Talk to my test app в журнале событий, вы увидите события, расположенные в хронологическом порядке, которые произошли в этом эпизоде ​​разговора:

• userInput : Соответствует вводу пользователя ( «Поговорите с моим тестовым приложением» ).
• interactionMatch : Соответствует основному ответу вашего действия, который был вызван вводом пользователя. Если вы развернете эту строку, щелкнув стрелку, вы увидите подсказку, которую вы добавили для основного вызова ( A wondrous greeting, adventurer!... ).
• endConversation : Соответствует выбранному переходу в Main invocation интент-объекте, который в данный момент завершает диалог. Подробнее о переходах вы узнаете в следующем разделе этого практического занятия.

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

4. Создайте диалог для вашего действия.

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

Ключевые термины :

• Сцена : базовый элемент вашего действия, который обрабатывает ввод пользователя и, как правило, генерирует ответ для пользователя. Пользовательские интенты часто активируют другие сцены, но сцены также могут активироваться и другими способами.
• Пользовательский интент : определяет пользовательский ввод, который может понять действие. Вы определяете обучающие фразы для этих интентов. Когда пользователи говорят что-то, что соответствует или похоже на обучающую фразу, срабатывает соответствующий интент.
• Обучающие фразы : примеры того, что пользователь может сказать, чтобы соответствовать определенному намерению. Механизм понимания естественного языка (NLU) Ассистента автоматически расширяет эти обучающие фразы, включая другие похожие фразы.
• Переход : Определяет, к какой сцене будет осуществлен переход после выполнения условия.

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

Например, представьте себе гипотетическое действие, предоставляющее пользователю факты о животных. Когда пользователь вызывает это действие, срабатывает Main invocation , который запускает переход к сцене под названием Facts. Этот переход активирует сцену Facts , которая отправляет пользователю следующий запрос: Would you like to hear a fact about cats or dogs? В сцене Facts находится пользовательский интент под названием Cat , содержащий обучающие фразы, которые пользователь может произнести, чтобы услышать факт о кошке, например : «Я хочу услышать факт о кошке» или «кошка» . Когда пользователь запрашивает факт о кошке, срабатывает интент « Cat , который запускает переход к сцене под названием Cat fact. Сцена Cat fact активируется и отправляет пользователю запрос, включающий факт о кошке.

Рисунок 1. Схема типичного диалога в действии, созданном с помощью Actions SDK.

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

Переход от основного вызова к сцене

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

Чтобы создать эту сцену и добавить к ней переход, выполните следующие шаги:

1. Откройте custom/global/actions.intent.MAIN.yaml в текстовом редакторе.
2. Замените текст в поле transitionToScene ( actions.scene.END_CONVERSATION ) следующим: transitionToScene: Start

actions.intent.MAIN.yaml

handler:
  staticPrompt:
    candidates:
    - promptResponse:
        firstSimple:
          variants:
          - speech: Welcome to the mythical land of  Gryffinberg! Based on your clothes,
              you are not from around these lands. It looks like you're on your way
              to an epic journey.
transitionToScene: Start

Это указывает вашему действию перейти от основного вызова к Start сцене.

3. Сохраните файл.
4. В терминале создайте новую директорию scenes в директории custom :

mkdir custom/scenes 

5. Создайте в каталоге scenes новый файл с именем Start.yaml , который будет представлять собой start сцену в вашем действии:

touch custom/scenes/Start.yaml 

6. Откройте Start.yaml в текстовом редакторе.
7. Вставьте следующий код в файл Start.yaml :

Start.yaml

onEnter:
  staticPrompt:
    candidates:
    - promptResponse:
        firstSimple:
          variants:
          - speech: Before you continue on your quest, would you like your fortune
              told?

В коде файла Start.yaml есть поле onEnter , которое обозначает первый этап жизненного цикла сцены.

Ключевые термины:

• OnEnter : Этап, который выполняется при активации сцены. OnEnter определяет, что происходит, когда пользователь входит в сцену.

В этом случае подсказка (« Before you continue on your quest... ») добавляется в очередь подсказок, когда пользователь впервые входит в Start сцену.

Ключевые термины:

• Очередь подсказок: Подсказки добавляются друг к другу в очередь. Прежде чем пользователь сможет ответить, Ассистент покажет ему все подсказки из очереди.

Добавить подсказки

В этом разделе вы можете добавить всплывающие подсказки, которые ваш Action обрабатывает как пользовательский ввод. Под этим подсказкой ( Before you continue on your quest, would you like your fortune told? ) отображаются всплывающие подсказки Yes и No , предназначенные для пользователей устройств с экранами.

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

1. Обновите код в Start.yaml в соответствии со следующим фрагментом кода, который включает код для настройки подсказок:

Start.yaml

onEnter:
  staticPrompt:
    candidates:
    - promptResponse:
        firstSimple:
          variants:
          - speech: Before you continue on your quest, would you like your fortune
              told?
        suggestions:
        - title: "Yes"
        - title: "No"

2. Сохраните файл.

Проверьте свои действия в симуляторе.

На этом этапе ваше действие должно перейти от основного вызова к Start сцене и спросить пользователя, хочет ли он, чтобы ему гадали. В имитируемом окне также должны появиться фишки с подсказками.

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

1. В терминале выполните следующую команду:

gactions deploy preview

В результате вы должны получить сообщение примерно следующего вида:

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. Скопируйте предоставленный URL-адрес и вставьте его в браузер.
3. Нажмите «Тест» , чтобы перейти в симулятор.
4. Введите в поле ввода « Talk to my test app и нажмите Enter . Ваше действие должно ответить приглашением к Main invocation и добавленным приглашением Start сцене: «Прежде чем продолжить свой квест, хотели бы вы, чтобы вам предсказали судьбу?» , с отображением фишек с подсказками.

На следующем скриншоте показано это взаимодействие:

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

5. Нажмите на значок с подсказкой «Да» или « Нет» , чтобы ответить на запрос. (Вы также можете сказать «Да» или «Нет» или ввести Yes или No в поле ввода .)

Когда вы отвечаете на запрос, ваше действие выдает сообщение о том, что оно не может понять ваш ввод: «Извините, я не расслышал. Можете попробовать еще раз?» Поскольку вы еще не настроили свое действие на понимание и реагирование на ввод «Да» или «Нет» , ваше действие сопоставляет ваш ввод с намерением NO_MATCH .

Ключевые термины:

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

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

Добавьте намерения yes и no .

Теперь, когда пользователи могут отвечать на вопрос, заданный вашим действием, вы можете настроить его так, чтобы оно понимало ответы пользователей ( «Да» или «Нет» ). В следующих разделах вы создадите пользовательские интенты, которые будут совпадать с ответами пользователя «Да» или «Нет», и добавите эти интенты в Start сцену.

Создать намерение yes

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

1. В терминале создайте новую директорию с именем intents в директории custom :

mkdir custom/intents 

2. Создайте новый файл с именем yes.yaml в каталоге intents :

touch custom/intents/yes.yaml

3. Откройте файл yes.yaml в текстовом редакторе.
4. Вставьте следующий фрагмент кода, содержащий обучающие фразы, в файл yes.yaml :

да.yaml

trainingPhrases:
- of course
- let's do it
- ok
- sure
- "y"
- "yes"

5. Сохраните файл.

Добавьте намерение yes в Start сцену.

Теперь Action может понимать, когда пользователь выражает намерение «да» . Вы можете добавить пользовательское намерение yes в сцену « Start , поскольку пользователь отвечает на запрос Start (« Прежде чем продолжить свой квест, хотели бы вы узнать свою судьбу?» ).

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

1. Откройте custom/scenes/Start.yaml в текстовом редакторе.
2. Добавьте обработчики intentEvents и yes в конец файла Start.yaml :

Start.yaml

intentEvents:
- handler:
    staticPrompt:
      candidates:
      - promptResponse:
          firstSimple:
            variants:
            - speech: Your future depends on the item you choose to use for your quest. Choose wisely! Farewell, stranger.
  intent: "yes"
  transitionToScene: actions.scene.END_CONVERSATION

Когда подтверждается yes ответ, в очередь подсказок добавляется сообщение «Ваше будущее зависит от предмета, который вы выберете для своего задания...» . Затем сцена Start переходит к системной сцене actions.scene.END_CONVERSATION , которая отображает подсказки из очереди и завершает разговор.

Проверьте намерение yes в симуляторе.

На этом этапе ваше действие понимает, когда пользователь хочет услышать свою судьбу, и возвращает соответствующий ответ.

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

1. В терминале выполните следующую команду:

gactions deploy preview

В результате вы должны получить сообщение примерно следующего вида:

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. Скопируйте предоставленный URL-адрес и вставьте его в браузер.
3. Нажмите «Тест» , чтобы перейти в симулятор.
4. Чтобы протестировать ваше действие в симуляторе, введите Talk to my test app в поле «Ввод» и нажмите Enter .
5. Введите Yes в поле ввода и нажмите Enter . В качестве альтернативы, нажмите на значок подсказки «Да» .

Ваше действие отвечает пользователю и сообщает ему, что его судьба зависит от выбранной им помощи. Затем ваше действие завершает сессию, поскольку вы настроили переход End conversation для намерения yes .

no создавать намерение

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

Для создания этого намерения выполните следующие шаги:

1. В терминале создайте новый файл с именем no.yaml в каталоге intents :

touch custom/intents/no.yaml

2. Откройте no.yaml в текстовом редакторе.
3. Вставьте следующие тренировочные фразы в файл no.yaml :

no.yaml

trainingPhrases:
- nope
- I don't want
- "n"
- "no"
- nah
- no thanks

4. Сохраните файл.

no добавлять намерение в Start сцену

Теперь действие может понимать, когда пользователь выражает «нет» или что-то похожее на «нет» , например, «нет» . Вам нужно добавить пользовательский интент no в Start сцену, потому что пользователь отвечает на запрос Start (« Прежде чем продолжить свой квест, не хотите ли узнать свою судьбу?» ).

Чтобы добавить этот интент для сцены Start , выполните следующие шаги:

1. Откройте custom/scenes/Start.yaml в текстовом редакторе.
2. Добавьте следующий обработчик ошибки no ниже обработчика ошибки yes в Start.yaml :

Start.yaml

- handler:
    staticPrompt:
      candidates:
      - promptResponse:
          firstSimple:
            variants:
            - speech: I understand, stranger. Best of luck on your quest! Farewell.
  intent: "no"
  transitionToScene: actions.scene.END_CONVERSATION

3. Сохраните файл.

Проверка no намерения в симуляторе.

На этом этапе ваше действие понимает, когда пользователь не хочет слышать свою судьбу, и возвращает соответствующий ответ.

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

1. В терминале выполните следующую команду:

gactions deploy preview

В результате вы должны получить сообщение примерно следующего вида:

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. Скопируйте предоставленный URL-адрес и вставьте его в браузер.
3. Нажмите «Тест» , чтобы перейти в симулятор.
4. Введите в поле ввода текст Talk to my test app и нажмите Enter .
5. Введите No в поле ввода и нажмите Enter . Или нажмите на значок подсказки No .

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

5. Обеспечить выполнение

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

Ключевой термин :

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

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

В этом практическом задании вы будете использовать редактор Cloud Functions для редактирования и развертывания кода выполнения.

Ключевой термин :

• Редактор Cloud Functions : интегрированный редактор для проектов Actions, который можно использовать для редактирования и развертывания кода выполнения с помощью Cloud Functions для Firebase .

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

Создайте свою самореализацию.

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

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

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

mkdir webhooks 

2. Создайте новый файл с именем ActionsOnGoogleFulfillment.yaml в каталоге webhooks :

touch webhooks/ActionsOnGoogleFulfillment.yaml

3. Откройте файл ActionsOnGoogleFulfillment.yaml в текстовом редакторе.
4. Добавьте обработчик greeting и содержимое inlineCloudFunction в файл ActionsOnGoogleFulfillment.yaml :

ActionsOnGoogleFulfillment.yaml

handlers:
- name: greeting
inlineCloudFunction:
  executeFunction: ActionsOnGoogleFulfillment

Файл ActionsOnGoogleFulfillment.yaml определяет обработчики веб-перехватчиков (например, обработчик greeting ) и указывает вашему действию использовать Cloud Functions в качестве конечной точки веб-перехватчика.

5. Создайте новую директорию ActionsOnGoogleFulfillment в директории webhooks :

mkdir webhooks/ActionsOnGoogleFulfillment

6. Создайте новый файл с именем index.js в каталоге ActionsOnGoogleFulfillment :

touch webhooks/ActionsOnGoogleFulfillment/index.js

7. Откройте index.js в текстовом редакторе.
8. Добавьте следующий код в index.js :

index.js

const { conversation } = require('@assistant/conversation');
const functions = require('firebase-functions');

const app = conversation({debug: true});

app.handle('greeting', conv => {
 let message = 'A wondrous greeting, adventurer! Welcome back to the mythical land of Gryffinberg!';
 if (!conv.user.lastSeenTime) {
   message = 'Welcome to the mythical land of  Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you\'re on your way to an epic journey.';
 }
 conv.add(message);
});


exports.ActionsOnGoogleFulfillment = functions.https.onRequest(app);

Этот код определяет обработчик greeting , который отправляет соответствующее приветствие.

пользователь.

9. Сохраните файл.
10. Создайте новый файл с именем package.json в каталоге ActionsOnGoogleFulfillment :

touch webhooks/ActionsOnGoogleFulfillment/package.json

В файле package.json указываются зависимости и другие метаданные для вашего веб-хука.

11. Откройте package.json в текстовом редакторе.
12. Скопируйте код из этого репозитория GitHub и вставьте его в файл package.json .
13. Сохраните файл.

Разберитесь в коде.

Ваша система выполнения заказов, использующая библиотеку Actions on Google Fulfillment для Node.js , отвечает на HTTP-запросы от Google Ассистента.

В предыдущем фрагменте кода вы определяете обработчик greeting , который проверяет, посещал ли пользователь ранее данное действие, используя свойство lastSeenTime . Если свойство lastSeenTime не определено, пользователь является новым и получает приветствие, предназначенное для новых пользователей. В противном случае сообщение подтверждает возвращение пользователя и генерирует измененное приветствие.

Обновите основной вызов, чтобы он запускал веб-перехватчик.

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

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

1. Откройте custom/global/actions.intent.MAIN.yaml в текстовом редакторе.
2. Замените код в файле actions.intent.MAIN.yaml следующим кодом:

actions.intent.MAIN.yaml

handler:
  webhookHandler: greeting
transitionToScene: Start

3. Сохраните файл.

Теперь, когда ваш основной запрос будет выполнен успешно, будет вызван обработчик веб-перехватчика greeting .

Проверьте обновленный вызов основной функции в симуляторе.

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

1. В терминале выполните следующую команду:

Поскольку эта команда развертывает веб-перехватчик и устанавливает зависимости, ее выполнение может занять больше времени, чем выполнение предыдущих команд.

gactions deploy preview

Если вы получаете ошибку 403, связанную с Cloud Build API, или ошибку 403, связанную с привязкой платежного аккаунта, см. раздел «Включение, отключение или изменение выставления счетов для проекта» . Для развертывания с использованием Cloud Functions необходимо связать платежный аккаунт с вашим проектом в Google Cloud. После привязки платежного аккаунта снова запустите gactions deploy preview . Чтобы избежать списания средств, выполните действия, описанные в разделе «Очистка проекта» в конце этого руководства.

В результате вы должны получить сообщение примерно следующего вида:

✔ Done. You can now test your changes in Simulator with this URL: http://console.actions.google.com/project/{project-id}/simulator?disableAutoPreview

2. Скопируйте предоставленный URL-адрес и вставьте его в браузер.
3. Чтобы протестировать ваше действие в симуляторе, введите Talk to my test app в поле «Ввод» и нажмите Enter .

Поскольку вы уже тестировали своё действие в этом практическом задании, вы не являетесь новым пользователем, поэтому вы получаете следующее сокращённое приветствие: « Чудесное приветствие, искатель приключений! Добро пожаловать обратно в мифическую страну Гриффинберг!...»

6. Визуализируйте действия с помощью конструктора действий.

SDK Actions совместим с веб-IDE Actions Builder , интегрированной в консоль Actions. Вы можете отправить содержимое вашей локальной файловой системы в черновик вашего Action в консоли с помощью команды gactions push . В отличие от gactions deploy preview , которая позволяет тестировать Action только в симуляторе, gactions push перемещает все содержимое из локальных файлов в Actions Builder.

Консоль Actions предоставляет визуальное представление конфигурации вашего Action. Визуальное отображение конфигурации вашего Action может быть полезно во время разработки и не влияет на версию Action, используемую для тестирования.

При выполнении команды gactions push текущий черновик вашего проекта Actions будет перезаписан, если вы работаете в режиме совместной работы.

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

1. В терминале выполните следующую команду, чтобы отправить свой проект в консоль Actions:

gactions push

В результате вы должны получить сообщение примерно следующего вида:

✔ Done. Files were pushed to Actions Console, and you can now view your project with this URL: https://console.actions.google.com/project/{project-id}/overview. If you want to test your changes, run "gactions deploy preview", or navigate to the Test section in the Console.

2. Скопируйте предоставленный URL-адрес и вставьте его в браузер.
3. В консоли «Действия» нажмите «Разработка» в верхней панели навигации.
4. Щелкните стрелку раскрывающегося списка рядом с пунктом «Сцены» и выберите «Начало» . Вы должны увидеть визуальное представление Start сцены вашего действия, как показано на следующем снимке экрана:

Приведите свой проект в порядок [рекомендуется]

Внимание : Практический урок 2-го уровня « Создание действий для Google Assistant с использованием Actions SDK (Уровень 2)» основан на проекте, созданном вами в этом практическом уроке. Если вы планируете выполнить практический урок 2-го уровня, не удаляйте свой проект; вместо этого вы можете удалить его в разделе «Очистка проекта» в конце практического урока 2-го уровня.

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

1. Для удаления облачного проекта и ресурсов выполните действия, описанные в разделе «Завершение (удаление) проектов» .

Убедитесь, что на странице настроек Google Cloud Platform вы выбрали правильный проект для удаления.

2. Необязательно: чтобы немедленно удалить свой проект из консоли «Действия», выполните действия, описанные в разделе «Удаление проекта» . Если вы не выполните этот шаг, ваш проект будет автоматически удален примерно через 30 дней.

7. Поздравляем!

Вы знаете основы создания действий для Google Ассистента с помощью Actions SDK.

Что вы осветили

• Как настроить проект Actions в консоли Actions
• Как использовать Actions SDK для сборки проекта Actions в локальной файловой системе
• Как добавить подсказку в основной вызов, чтобы пользователи могли начать диалог с вашим действием?
• Как создать диалоговый интерфейс с использованием сцен, намерений, переходов, подсказок и реализации.
• Как протестировать ваше действие с помощью симулятора действий

Узнать больше

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

• Официальный сайт документации по разработке действий для Google Ассистента.
• Действия на странице Google GitHub для примеров кода и библиотек
• Официальное сообщество Reddit для разработчиков, работающих с Assistant.

Follow @ActionsOnGoogle on Twitter for the latest announcements and tweet with #AoGDevs to share what you build!

Опрос обратной связи

Before you go, please fill out a brief survey about your experience.