Программистам

Создайте функцию

Если вы не работали с Yandex Cloud

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

Создайте в Yandex Cloud функцию для навыка:

1. Откройте консоль управления.
2. Выберите Cloud Functions.
3. Нажмите кнопку Создать функцию.
4. Введите имя функции. Условия:

   • длина — от 3 до 63 символов;
   • может содержать строчные буквы латинского алфавита, цифры и дефисы;
   • первый символ — буква, последний — не дефис.

   Например, my-first-function.

5. Нажмите кнопку Создать.
6. Если у вас нет платежного аккаунта, зарегистрируйте его.

Платежный аккаунт необходим для любых сервисов Yandex Cloud, даже бесплатных. Функции Cloud Functions для навыков Алисы не тарифицируются — Yandex Cloud не будет списывать деньги с вашей карты.

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

Создайте версию функции

Каждая версия функции — это исходный код на языке программирования. Поддерживаются Node.js, Python, Go, Java, .NET Core, PHP, R, Bash.

Вне зависимости от таймаута в настройках версии Яндекс Диалоги будут ждать ответа функции не больше 4,5 секунды.

Откроется страница функции, где в блоке История версий появится ваша версия с тегом $latest.

Укажите функцию в настройках навыка

После того как навык заработает, зарегистрируйте его:

1. Перейдите в консоль разработчика навыка.
2. Создайте навык и перейдите на вкладку Настройки.
3. В блоке Backend выберите вариант Функция в Yandex Cloud.
4. Из выпадающего списка выберите функцию.
5. Заполните обязательные поля в блоках Основные настройки и Публикация в каталоге.
6. Внизу страницы нажмите кнопку Сохранить.

В списке отображаются функции, которые вы имеете право просматривать. Но навык заработает, только если вы имеете право запускать функцию. Разрешение на запуск входит в роли Yandex Cloud serverless.functions.invoker, editor и выше.

Проверьте работу навыка

1. На странице навыка откройте вкладку Тестирование.
2. Если все настроено правильно, навык предложит начать беседу: «Hello! I'll repeat anything you say to me».
3. Отправьте сообщение с любым текстом и убедитесь, что вам пришел такой же ответ.
4. Попробуйте изменить код навыка. Откройте функцию во вкладке Редактор в консоли Yandex Cloud и отредактируйте код:

   Измените приветственную фразу

   Найдите строку и измените текст в кавычках. Например:

   • Node.js
   • Python

   До: let text = 'Hello! I\'ll repeat anything you say to me.'

   После: let text = 'Hello! I\'ll repeat anything you say to me twice.'

   До: text = 'Hello! I\'ll repeat anything you say to me.'

   После: text = 'Hello! I\'ll repeat anything you say to me twice.'

   Измените ответ

   Добавьте еще один повтор реплики:

   • Node.js
   • Python

   До: text = request['original_utterance'];

   После: text = request['original_utterance'].concat('\n').repeat(2);

   До: text = event['request']['original_utterance']

   После: text = '\n'.join(2*[event['request']['original_utterance']])

   Чтобы сохранить новую версию функции, нажмите Создать версию. Проверьте изменения в навыке.

5. Попробуйте заменить код и среду выполнения в рамках одной функции. Функция останется активной, и накопленная статистика сохранится.

Что дальше

• Попробуйте выполнить другие функции, которые возвращают в ответе изображения и проигрывают звуки.
• Узнайте обо всех дополнительных возможностях в протоколе работы Яндекс Диалогов и модели программирования Cloud Functions.

Полезные ссылки

• Видео «Школа Алисы. Как бесплатно разместить навык в Yandex Cloud»
• Видео «Навык за 20 минут»