БэкендPython

Как сделать навык Алисы на Python: голосовая викторина с нуля

Создаём навык Алисы на Python: обрабатываем команды, храним состояние викторины, разворачиваем webhook и проверяем ответы в консоли Диалогов.

Кодик

Автор

6 мин чтения

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

Новичок часто начинает с публикации и модерации, не проверив чистую логику диалога, поэтому не понимает, где сломался сценарий. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте голосовую викторину из трёх вопросов с подсчётом очков и командой повторного запуска. Проверка: команда старта показывает первый вопрос, правильный ответ увеличивает счёт, а после третьего вопроса Алиса сообщает результат.

1Соберите минимум

прочитать command и session_state из JSON. Не расширяйте проект до первого успешного запуска.

2Увидьте данные

правильный ответ добавляет один балл. Проверяйте значение, а не отсутствие ошибки.

3Измените правило

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

Как устроен учебный проект навык Алисы

Диалоги отправляют событие в Python handler, функция разбирает command и session_state, а ответ возвращает новую реплику и обновлённое состояние. Держите ввод, логику и отображение раздельно: тогда каждый этап можно проверить отдельно.

ЭтапДействиеПроверяемый результат
Событиепрочитать command и session_state из JSONпустой запуск открывает викторину
Логикасравнить ответ с ожидаемым и обновить scoreправильный ответ добавляет один балл
Ответсформировать response.text и response.ttsконсоль показывает реплику без ошибки формата
Состояниевернуть session_state с индексом вопросаследующая реплика открывает новый вопрос

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

Путь данных в проекте навык Алисы
От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.

Зафиксируйте первый успех Сначала вызовите handler локально с сохранённым JSON-событием и проверьте структуру ответа до подключения Cloud Functions. Сохраните команду запуска и ожидаемый вывод.

Собираем рабочий пример шаг за шагом

Материал сверялся с официальной документацией 2 ноября 2026 года. Создайте файл index.py. В Yandex Cloud Functions выберите актуальный Python 3.14 и точку входа index.handler. Проверьте текущую папку через pwd или Get-Location. Вставьте пример целиком, выполните один раз, затем разбирайте по частям.

QUESTIONS = [
    ("Какой тип хранит истину и ложь в Python?", "bool"),
    ("Как называется функция вывода в консоль?", "print"),
    ("Какой оператор сравнивает значения?", "=="),
]

def handler(event, context):
    command = event.get("request", {}).get("command", "").strip().lower()
    state = event.get("state", {}).get("session", {})
    index = int(state.get("index", 0))
    score = int(state.get("score", 0))

    if command in {"", "начать", "заново"}:
        index, score = 0, 0
        text = "Начинаем. " + QUESTIONS[index][0]
    else:
        if command == QUESTIONS[index][1]:
            score += 1
            prefix = "Верно. "
        else:
            prefix = f"Не совсем. Ответ: {QUESTIONS[index][1]}. "
        index += 1
        if index == len(QUESTIONS):
            text = prefix + f"Ваш результат: {score} из {len(QUESTIONS)}. Скажите заново."
            index = 0
        else:
            text = prefix + QUESTIONS[index][0]

    return {
        "version": event.get("version", "1.0"),
        "session": event.get("session", {}),
        "response": {"text": text, "tts": text, "end_session": False},
        "session_state": {"index": index, "score": score},
    }
Что должно произойти после запуска
  • Первый тестовый запрос возвращает вопрос и session_state со счётом 0.
  • Три последовательных ответа приводят к результату от 0 до 3 и предложению начать заново.
  • Повторный запуск даёт тот же предсказуемый результат.
  • Пустой ввод получает понятное сообщение вместо падения.

Главная функция принимает явный вход и возвращает результат, который можно проверить отдельно от интерфейса. Найдите в примере вход, проверку и место формирования результата.

Хрупкий и проверяемый вариант навык Алисы
Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.

Что происходит внутри и почему это работает

Алиса не хранит переменные Python между репликами как обычная программа. Состояние нужно явно вернуть в session_state, чтобы платформа передала его в следующем запросе. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Cloud Functions для навыков Алисы не тарифицируются по правилам Диалогов, но функция всё равно должна иметь корректную точку входа и права на запуск.

ЧастьЗа что отвечаетЧто проверить
Requestсодержит команду и сведения о сессииcommand нормализован перед сравнением
Quizвыбирает вопрос и считает баллыиндекс не выходит за границы списка
Responseвозвращает текст, tts и новое состояниеversion и session сохранены

Не сравнивайте всю фразу пользователя с одним вариантом без нормализации. Для учебной викторины достаточно lower и strip, а для реального навыка добавьте синонимы и тесты на разговорные ответы. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.

Проверьте границу Отправьте пустую команду, неверный ответ, правильный ответ и слово заново. Каждый случай должен приводить к предсказуемому состоянию. Меняйте одно условие за прогон, чтобы видеть причину.

Проверяем проект и добавляем свою функцию

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

Проверка своими руками
  1. Сохраните ожидаемый результат: команда старта показывает первый вопрос, правильный ответ увеличивает счёт, а после третьего вопроса Алиса сообщает результат.
  2. Измените правило: добавьте синонимы для одного ответа и тест на смешанный регистр. Сначала предскажите итог.
  3. Передайте граничное значение и убедитесь, что приложение не падает.
  4. Верните корректные данные и объясните роли трёх основных частей.
Готово, если выполняются все пункты
  • пустой запуск открывает викторину
  • правильный ответ добавляет один балл
  • консоль показывает реплику без ошибки формата
  • следующая реплика открывает новый вопрос

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

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

Что запомнить и куда двигаться дальше

После локальных тестов подключите функцию в консоли Диалогов, пройдите сценарий голосом и только затем готовьте имя, описание и модерацию навыка. Для закрепления откройте в статье про Yandex Cloud Functions, в первом боте MAX и в Telegram-боте на Python.

Как изучить тему в Кодике

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

ШагЧто разобратьМини-проверка
1. ОсноваСловари, списки, функции и условия PythonОбъясните вход и выход функции.
2. ИнструментФормат request, response и session_state АлисыПовторите команду по памяти.
3. ПроектЧистую функцию викторины и тестовые JSON-событияПроверьте два сценария.
4. РефакторингСинонимы, журналирование и публикацию навыкаРазделите ввод, логику и вывод.

Закрепите проект, восстановив ключевую функцию по памяти и добавив собственный граничный случай. Базовый синтаксис закрепите через курс Python.

Состояние в глобальной переменной

Следующий запрос может попасть в другой процесс. Возвращайте session_state.

Нет version и session

Ответ не соответствует контракту платформы. Сохраняйте служебные поля.

Сразу модерация

Ошибка диалога смешивается с настройками публикации. Сначала тестируйте webhook.

Точное сравнение без нормализации

Слово с заглавной буквы считается неверным. Используйте strip и lower.

Сверяйтесь с первичной документацией. Команды и ограничения примера проверены по официальному источнику 1. Если версия инструмента изменилась, официальный источник важнее старого скриншота.

Что получится в итоге

Готовый результат проекта: Как сделать навык Алисы на Python: голосовая викторина с нуля
Финальный экран показывает результат, состояние операции и понятное сообщение об ошибке без раскрытия секретов.

Короткие ответы
Где хранить номер вопроса между репликами?

Верните его в session_state, чтобы платформа прислала значение в следующем событии.

Зачем тестировать handler локально?

Так можно отделить ошибку Python и формата JSON от облака и настроек Диалогов.

Что проверять первым, если навык Алисы не запускается?

Версию среды, текущую папку, команду запуска и первую строку ошибки.

Как понять, что проект навык Алисы работает?

Проверьте основной сценарий, неверный ввод, повторный запуск и один граничный случай.

Можно ли начать с готового кода?

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

Сделайте один осознанный шаг дальше

Выберите одно улучшение и проведите его от ввода до результата.

Если не хватает основы, перейдите курс Python, затем восстановите ключевую функцию без подсказки.