навык Алисы можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. Навык Алисы работает как HTTPS-обработчик: получает JSON с репликой пользователя и возвращает JSON с текстом и голосовым ответом. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.
Новичок часто начинает с публикации и модерации, не проверив чистую логику диалога, поэтому не понимает, где сломался сценарий. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте голосовую викторину из трёх вопросов с подсчётом очков и командой повторного запуска. Проверка: команда старта показывает первый вопрос, правильный ответ увеличивает счёт, а после третьего вопроса Алиса сообщает результат.
прочитать command и session_state из JSON. Не расширяйте проект до первого успешного запуска.
правильный ответ добавляет один балл. Проверяйте значение, а не отсутствие ошибки.
После успеха добавьте синонимы для одного ответа и тест на смешанный регистр. Так копирование станет практикой.
Как устроен учебный проект навык Алисы
Диалоги отправляют событие в 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, пока старые тесты не проходят. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.
- Сохраните ожидаемый результат: команда старта показывает первый вопрос, правильный ответ увеличивает счёт, а после третьего вопроса Алиса сообщает результат.
- Измените правило: добавьте синонимы для одного ответа и тест на смешанный регистр. Сначала предскажите итог.
- Передайте граничное значение и убедитесь, что приложение не падает.
- Верните корректные данные и объясните роли трёх основных частей.
- пустой запуск открывает викторину
- правильный ответ добавляет один балл
- консоль показывает реплику без ошибки формата
- следующая реплика открывает новый вопрос
После изменения повторите основной и ошибочный сценарии, чтобы новое поведение не сломало исходный результат. Полезная правка проходит от нового ввода до видимого результата.

Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.
Что запомнить и куда двигаться дальше
После локальных тестов подключите функцию в консоли Диалогов, пройдите сценарий голосом и только затем готовьте имя, описание и модерацию навыка. Для закрепления откройте в статье про Yandex Cloud Functions, в первом боте MAX и в Telegram-боте на Python.
Как изучить тему в Кодике
Сначала разберите формат входных данных и одну функцию, затем подключайте внешний сервис или интерфейс. Сначала восстановите главную функцию и проверьте её на трёх значениях.
| Шаг | Что разобрать | Мини-проверка |
|---|---|---|
| 1. Основа | Словари, списки, функции и условия Python | Объясните вход и выход функции. |
| 2. Инструмент | Формат request, response и session_state Алисы | Повторите команду по памяти. |
| 3. Проект | Чистую функцию викторины и тестовые JSON-события | Проверьте два сценария. |
| 4. Рефакторинг | Синонимы, журналирование и публикацию навыка | Разделите ввод, логику и вывод. |
Закрепите проект, восстановив ключевую функцию по памяти и добавив собственный граничный случай. Базовый синтаксис закрепите через курс Python.
Следующий запрос может попасть в другой процесс. Возвращайте session_state.
Ответ не соответствует контракту платформы. Сохраняйте служебные поля.
Ошибка диалога смешивается с настройками публикации. Сначала тестируйте webhook.
Слово с заглавной буквы считается неверным. Используйте strip и lower.
Что получится в итоге

Финальный экран показывает результат, состояние операции и понятное сообщение об ошибке без раскрытия секретов.
Где хранить номер вопроса между репликами?
Верните его в session_state, чтобы платформа прислала значение в следующем событии.
Зачем тестировать handler локально?
Так можно отделить ошибку Python и формата JSON от облака и настроек Диалогов.
Что проверять первым, если навык Алисы не запускается?
Версию среды, текущую папку, команду запуска и первую строку ошибки.
Как понять, что проект навык Алисы работает?
Проверьте основной сценарий, неверный ввод, повторный запуск и один граничный случай.
Можно ли начать с готового кода?
Да. Добейтесь результата, измените одно правило и восстановите ключевую функцию без копирования.
Выберите одно улучшение и проведите его от ввода до результата.
Если не хватает основы, перейдите курс Python, затем восстановите ключевую функцию без подсказки.