Перейти к содержанию

Подключение облачной функции Яндекса

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

Чтобы провести первый запуск, нужно подключить облачную функцию Яндекса к Диалогам.

  1. Перейдите по ссылке. Примите условия и нажмите кнопку Войти.

  2. Введите название нового облака и нажмите кнопку Создать.

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

  4. Откройте консоль управления.

  5. Выберите Cloud Functions.

    choose-cloud-functions.png

  6. Нажмите кнопку Создать функцию.

    create-cloud-function.png

  7. Введите имя функции. Условия:

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

  8. Нажмите кнопку Создать.

    commit-cloud-function.png

  9. Выберите Python и нажмите кнопку Продолжить.

    lang-cloud-function.png

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

Каждая версия функции — это исходный код на языке программирования.

  1. Откройте созданный файл index.py:

    index-cloud-function.png

  2. Скопируйте код и вставьте его вместо функции handler

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
    from typing import Any

from aliceio import Dispatcher, Skill
from aliceio.types import AliceResponse, Message, Response
from aliceio.webhook.yandex_functions import (
    OneSkillYandexFunctionsRequestHandler,
    RuntimeContext,
)

dp = Dispatcher()
skill = Skill(skill_id="...")  # Вставьте айди навыка
requests_handler = OneSkillYandexFunctionsRequestHandler(dp, skill)

@dp.message()
async def message_handler(
    message: Message,
    ycf_context: RuntimeContext,
) -> AliceResponse:
    text = "Привет!" if message.session.new else message.original_utterance
    text += (
        "\n\nПеред отправкой у меня осталось "
        f"{ycf_context.get_remaining_time_in_millis()} миллисекунд"
    )
    return AliceResponse(response=Response(text=text))

# Нужно поставить эту функцию как точку входа
async def main(event: dict[str, Any], context: RuntimeContext) -> Any:
    return await requests_handler(event, context)
    # аналогично:
    # return await requests_handler.handle(event, context)

    paste-code-cloud-function.png

  3. Создайте файл requirements.txt и добавьте туда aliceio:

    create-file.png

    fill-filename.png

    fill-requirements.png

  4. Измените точку входа на index.main:

    fill-entrypoint.png

  5. Сохраните изменения в конце страницы:

    save-changes.png

    save-changes-process.png

Подключите функцию к Диалогам

В настройках навыка выберите Backend -> Функция в Яндекс Облаке -> accountname/cloudname/funcname

skill-function-settings.png

Тестирование

Перейдите на вкладку Тестирование и проверьте работу вашего навыка:

testing.png

Дополнительные возможности

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

https://yandex.cloud/ru/docs/functions/concepts/runtime/execution-context https://yandex.cloud/ru/docs/functions/lang/python/context