Get started
Yandex Cloud Functions

Creating skills for Alice

As an example, we'll create a skill called Parrot, which repeats everything a user writes or says. We implement our example in two programming languages: Python and Node.js.

To add skills based on a function to Alice:

  1. Prepare the skill code.
  2. Create a function.
  3. Create a version of the function.
  4. Add the function link to Alice's skill.
  5. Test the skill.

More about developing Alice's skills.

Prepare the code for Alice's skill

To create versions of functions, you can use one of the code upload formats. As an example, we'll upload the code in a ZIP archive.

  1. Download a sample file from GitHub: parrot.py.
  2. Create a ZIP archive named parrot-py.zip with the parrot.py file.
  1. Download a sample file from GitHub: index.js.
  2. Create a ZIP archive named parrot-js.zip and add the index.js file.

Create a function

Once created, the function will only contain information about itself, like its name, description, and unique ID. The skill's code will be added to the function when you create a version.

  1. In management console, select the folder where you want to create your function.

  2. Click Create resource.

  3. Choose Function.

  4. Enter a function name.

    • Length — from 3 to 63 characters.
    • The name may contain lowercase Latin letters, numbers, and hyphens.
    • The first character must be a letter. The last character can't be a hyphen.

  5. Click Create.

Create the version of the function

Choose the programming language and create a version of the function.

  1. In the management console, open Cloud Functions in the folder where you want to create the function version.
  2. Select the function to create the version for.
  3. Under Latest version, click Create in editor.
  4. Set the version parameters:
    • Runtime environment: python37.
    • Timeout, seconds: 2.
    • RAM: 128 MB.
    • Service account: Not selected.
  5. Prepare the function code:
    • Method: ZIP archive.
    • File: parrot-py.zip.
    • Entry point: parrot.handler.
  6. Click Create version.
  1. In the management console, open Cloud Functions in the folder where you want to create the function version.
  2. Select the function to create the version for.
  3. Under Latest version, click Create in editor.
  4. Set the version parameters:
    • Runtime environment: nodejs12.
    • Timeout, seconds: 2.
    • RAM: 128 MB.
    • Service account: Not selected.
  5. Prepare the function code:
    • Method: ZIP archive.
    • File: parrot-js.zip.
    • Entry point: index.handler.
  6. Click Create version.

  1. Go to Alice's skill page in your dashboard.

  2. Open the Settings tab.

  3. Under Backend, select Function in Yandex.Cloud.

  4. Select the desired function from the drop-down list.

    Warning

    The list shows the functions that you're allowed to view. To attach a function to a skill, you need permission to launch the function. This permission is part of the serverless.functions.invoker, editor, and higher roles.

  5. Click Save at the bottom of the page to save changes.

Test the skill

  1. Open the Testing tab on the skill page in your dashboard.
  2. If everything is set up correctly, the Chat section will display a message inviting you to start a conversation: Hello! I'll repeat anything you say to me..
  3. Send a message and make sure the response is the same.
In this article: