Создание навыка Алисы

В качестве примера будет создан навык <q>Попугай</q>, который повторяет все, что ему написал или сказал пользователь. Пример реализован на двух языках программирования: Python и Node.js.

Чтобы добавить навык Алисы на основе функции:

1. Подготовьте облако к работе.
2. Подготовьте код навыка.
3. Создайте функцию и версию функции.
4. Добавьте ссылку на функцию в навык Алисы.
5. Протестируйте работу навыка.

Если созданные ресурсы больше не нужны, удалите их.

Подробнее о разработке навыка Алисы.

Перед началом работы {#before-you-begin}

{% include before-you-begin %}

Подготовьте код для навыка Алисы {#prepare-code}

Для создания версии функции вы можете воспользоваться одним из форматов загрузки кода. Для примера код будет загружен в формате ZIP-архива.

{% list tabs group=programming_language %}

• Python {#python}

  1. Скачайте с GitHub файл с примером: parrot.py.
  2. Создайте ZIP-архив parrot-py.zip с файлом parrot.py.

• Node.js {#node}

  1. Скачайте с GitHub файл с примером: index.js.
  2. Создайте ZIP-архив parrot-js.zip с файлом index.js.

{% endlist %}

Создайте функцию и версию функции {#create-function}

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

1. В [консоли управления]({{ link-console-main }}) выберите каталог, в котором будет создана функция.

2. Нажмите кнопку {{ ui-key.yacloud.iam.folder.dashboard.button_add }} и выберите {{ ui-key.yacloud.iam.folder.dashboard.value_serverless-functions }}.

3. Введите имя функции. Требования к имени:

   {% include name-format %}

4. Нажмите кнопку {{ ui-key.yacloud.common.create }}.

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

   {% list tabs group=programming_language %}

   • Python {#python}

     1. В списке языков программирования выберите {{ python-full-ver }}.

     2. Отключите опцию {{ ui-key.yacloud.serverless-functions.item.editor.label_with-template }} и нажмите {{ ui-key.yacloud.serverless-functions.item.editor.button_action-continue }}.

     3. Подготовьте код функции:

        • В поле {{ ui-key.yacloud.serverless-functions.item.editor.field_code-source }} выберите {{ ui-key.yacloud.serverless-functions.item.editor.value_method-zip-file }} и прикрепите созданный ранее архив parrot-py.zip.
        • В поле {{ ui-key.yacloud.serverless-functions.item.editor.field_entry }} укажите parrot.handler.

     4. Задайте параметры версии:

        • {{ ui-key.yacloud.serverless-functions.item.editor.field_timeout }}: 2.
        • {{ ui-key.yacloud.serverless-functions.item.editor.field_resources-memory }}: 128 {{ ui-key.yacloud_portal.common.units.label_megabyte }}.
        • Значение остальных параметров оставьте по умолчанию.

     5. Нажмите кнопку {{ ui-key.yacloud.serverless-functions.item.editor.button_deploy-version }}.

   • Node.js {#node}

     1. В списке языков программирования выберите {{ nodejs-full-ver }}.

     2. Отключите опцию {{ ui-key.yacloud.serverless-functions.item.editor.label_with-template }} и нажмите {{ ui-key.yacloud.serverless-functions.item.editor.button_action-continue }}.

     3. Подготовьте код функции:

        • В поле {{ ui-key.yacloud.serverless-functions.item.editor.field_code-source }} выберите {{ ui-key.yacloud.serverless-functions.item.editor.value_method-zip-file }} и прикрепите созданный ранее архив parrot-js.zip.
        • В поле {{ ui-key.yacloud.serverless-functions.item.editor.field_entry }} укажите index.handler.

     4. Задайте параметры версии:

        • {{ ui-key.yacloud.serverless-functions.item.editor.field_timeout }}: 2.
        • {{ ui-key.yacloud.serverless-functions.item.editor.field_resources-memory }}: 128 {{ ui-key.yacloud_portal.common.units.label_megabyte }}.
        • Значение остальных параметров оставьте по умолчанию.

     5. Нажмите кнопку {{ ui-key.yacloud.serverless-functions.item.editor.button_deploy-version }}.

   {% endlist %}

Добавьте ссылку на функцию в навык Алисы {#add-link}

1. Перейдите на страницу навыка Алисы в личном кабинете.

2. Нажмите Создать диалог. В открывшемся окне выберите Навык.

3. На вкладке Настройки:

   1. В поле Имя навыка задайте уникальное имя создаваемого навыка.
   2. В поле Backend выберите вариант Функция в {{ yandex-cloud }}. В выпадающем списке выберите созданную ранее функцию.

   {% note warning %}

   В списке отображаются функции, которые вы имеете право просматривать. Чтобы прикрепить функцию к навыку, вам необходимо разрешение на запуск функции. Это разрешение входит в роли {{ roles-functions-invoker }}, {{ roles-editor }} и выше.

   {% endnote %}

   1. Внизу страницы нажмите кнопку Сохранить.

Протестируйте работу навыка {#test}

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

Как удалить созданные ресурсы {#clear-out}

Чтобы прекратить работу навыка, удалите функцию.