Викиверситет
ruwikiversity
https://ru.wikiversity.org/wiki/%D0%97%D0%B0%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0
MediaWiki 1.46.0-wmf.23
first-letter
Медиа
Служебная
Обсуждение
Участник
Обсуждение участника
Викиверситет
Обсуждение Викиверситета
Файл
Обсуждение файла
MediaWiki
Обсуждение MediaWiki
Шаблон
Обсуждение шаблона
Справка
Обсуждение справки
Категория
Обсуждение категории
Портал
Обсуждение портала
Факультет
Обсуждения факультета
TimedText
TimedText talk
Модуль
Обсуждение модуля
Event
Event talk
Введение в схемотехнику/Электрический ток
0
3196
165850
165822
2026-04-15T06:06:25Z
AKA MBG
551
rm red link
165850
wikitext
text/x-wiki
Школьный курс физики включает изучение [[w:Электричество|электрических]] и [[w:Магнетизм|магнитных]] явлений. В этом разделе мы повторим школьный материал, необходимый для перехода к изучению схемотехники. Кроме того, поскольку ''общая физика'' и ''схемотехника'' — различные области знаний, мы сделаем акцент на том, какие положения особенно важны для схемотехники, и какие представляют интерес только для физики.
== Определение ==
=== Общефизическое ===
'''[[w:Электрический ток|Электри́ческий ток]]''' — направленное движение электрически [[w:Электрический заряд|заряженных]] частиц, например, под воздействием [[w:Электрическое поле|электрического поля]]. Такими частицами могут являться: в [[w:Проводники|проводниках]] — [[w:электрон|электроны]], в [[w:электролит|электролитах]] — [[w:ион|ионы]] и так далее.
Разберём это определение более подробно:
* «'''''направленное''' движение''»: чтобы говорить о наличии электрического тока, необходимо, чтобы большое число заряженных частиц двигалось в каком-либо одном направлении. В противном случае (например, при хаотичном [[w:Броуновское движение|броуновском движении]] заряженных частиц) электрического тока нет, поскольку в целом перемещение заряда равно нулю.
* «''электрически заряженных частиц''»: носителем заряда могут быть электроны или другие частицы (либо квазичастицы — «[[w:Дырка|дырки]]») в зависимости от того, в какой среде имеет место электрический ток. С точки зрения схемотехники обычно не важно, каковы носители заряда, интерес представляют лишь количественные показатели: какой заряд перенесён и за какое время.
=== В рамках схемотехники ===
Приведенное выше определение описывает электрический ток как физическое явление, но для схемотехники оно несколько «избыточно». В рамках схемотехники не рассматриваются отдельные частицы, несущие заряд, поскольку математический аппарат для рассмотрения отдельных частиц был бы слишком сложен. Поэтому определение с частицами оставляем для [[w:Общая физика|общей физики]] (раздел [[w:Электричество|электричество]]), а при изучении схемотехники будем понимать электрический ток как ''перемещение некоторого количества [[w:Электрический заряд|заряда]]'', не акцентируя внимание на том, чем этот заряд переносится.
Итак, в рамках схемотехники будем понимать электрический ток как перетекание заряда из одного места в другое. При этом заряд можно понимать как некую «жидкость», имеющую нулевую массу и объем, которая может течь по [[w:Проводник|проводникам]].
== Численное описание электрического тока ==
=== Электрический заряд ===
Для любого тела можно рассматривать различные его количественные характеристики: массу, объем и т.п. Одной из таких характеристик является '''электрический заряд'''. [[w:Электрический заряд|Электрический заряд]] — это количественная характеристика тела, которая определяет, насколько сильно тело будет участвовать в [[w:Электромагнитное взаимодействие|электромагнитных взаимодействиях]].
Заряд — знакопеременная величина (в отличие от массы, объёма, длины и других характеристик), то есть значения заряда могут быть как положительными, так и отрицательными.
Носителями заряда являются заряженные [[w:Элементарная частица|элементарные частицы]]:
* [[w:Электрон|электрон]] имеет заряд <math>~{e_0}=-1,602176487(40)~{\cdot}~10^{-19}</math> [[w:Кулон|Кл]]
* [[w:Протон|протон]] такой же заряд, но со знаком плюс.
Это значит, что если тело имеет положительный заряд, то в нем число протонов чуть больше, чем электронов; если тело заряжено отрицательно, то в нем больше электронов. Если же заряд тела нулевой, то в нём количество электронов и протонов одинаково, такое тело никак не проявляет себя в электромагнитных взаимодействиях.
=== Электрическое напряжение ===
В общей физике используется такое [[w:Электрическое напряжение|определение напряжения]]:
<blockquote>
'''Напряже́ние''' между точками <math>A</math> и <math>B</math> электрической цепи или электрического поля — отношение [[w:Механическая работа|работы]] [[w:электрическое поле|электрического поля]] при переносе пробного [[w:электрический заряд|электрического заряда]] из точки <math>A</math> в точку <math>B</math> к величине пробного заряда.
</blockquote>
Знать и понимать это определение желательно, но не обязательно. В определении напряжение выражается через ''механическую работу'' и ''электрическое поле'' (а это понятия из разделов [[w:Механика|механика]] и [[w:Электростатика|электростатика]] общей физики), поэтому определение может быть слишком сложным для неподготовленного читателя.
К счастью, для начального понимания схемотехники нет необходимости использовать общефизическое определение напряжения. Можно начать с такого упрощенного определения:
<blockquote>
'''Напряжение''' между точками <math>A</math> и <math>B</math> электрической цепи — скалярная величина, измеряемая [[w:Вольтметр|вольтметром]]. Один щуп вольтметра должен быть подключен к точке <math>A</math>, другой — к точке <math>B</math>.
</blockquote>
Таким образом, мы не интересуемся физическим смыслом напряжения, а рассматриваем его как некую первичную величину, которую можно непосредственно измерить. Для схемотехники важен не физический смысл напряжения, а то, как напряжение преобразуется в электрических схемах и как другие параметры (токи и заряды) связаны с напряжением.
Очень важно понимать, ''как именно'' измеряется напряжение и от какого уровня оно отсчитывается:
* Напряжение всегда измеряется ''между двумя точками электрической схемы''
* Нужно понимать, какая из точек принята за ''начальную'', и какая за ''конечную''
=== Аналогия напряжение-высота ===
[[File:Voltage-height-analogy 1.png|thumb|500px|'''Рис. 1'''. Аналогия между отсчетом высоты и напряжения]]
Часто для лучшего понимания физических понятий используются [[w:Аналогия|аналогии]], то есть подобие описываемой сущности и какой-либо другой, хорошо известной. Для лучшего понимания ''электрического напряжения'' рассмотрим одну из таких аналогий: '''напряжение-высота'''. Аналогия заключается в том, что отсчет напряжений подобен отсчету разности высот.
На рисунке 1 изображены 5 горизонтальных линий (обозначены буквами ''D'', ''G'', ''A'', ''B'', ''C''). Линии находятся на разной высоте над поверхностью Земли, высота отсчитывается по синей шкале; кроме того, линии находятся под разным напряжением, которое отсчитывается по зеленой шкале. Рассмотрим различные утверждения в терминах высот и напряжений:
#
{| class="wikitable"
|-
! №
! Высота
! Напряжение
! Комментарий
|-
| 1
| Перепад высот от линии ''A'' к линии ''B'' равен 4 см.
| Напряжение между линиями ''A'' и ''B'' равно 4 В.
|
|-
| 2
| Перепад высот от линии ''B'' к линии ''A'' равен -4 см.
| Напряжение между линиями ''B'' и ''A'' равно -4 В.
|
|-
| 3
| Линия ''C'' на высоте 7 см (относительно уровня земли).
| Напряжение на линии ''C'' равно 7 В (относительно земли).
| Начальная точна не указана, значит от уровня нуля
|-
| 4
| Линия ''D'' на высоте -2 см (относительно уровня земли).
| Напряжение на линии ''D'' равно -2 В (относительно земли).
| Начальная точна не указана, значит от уровня нуля
|}
<!--
[[File:Digital spannungspruerfer.JPG|thumb|Вольтметр показывает 236 вольт]]
[[File:01 - Set of Energizer Batteries.jpg|thumb|Щелочная батарейка — источник электрической энергии с напряжением 1.5 [[w:Вольт|вольта]]]]
-->
=== Сила тока ===
Определение [[w:Сила тока|силы тока]] из общей физики:
<blockquote>
'''Сила тока''' (часто просто «'''ток'''») в [[w:Проводник|проводник]]е — [[w:Cкалярная величина|скалярная величина]], численно равная [[w:Электрический заряд|заряду]] <math> \delta q\,\! </math>, протекающему в единицу времени <math> \delta t\,\! </math> через сечение [[w:Проводник|проводника]]. Обозначается буквой <math> I\,\! </math>:<br />
<math> I = \frac{\delta q}{\delta t} </math>
</blockquote>
Согласно закону [[w:Закон Ома|закону Ома]], сила тока равна отношению [[w:Электрическое напряжение|напряжения]] <math> U\,\! </math> к [[w:Электрическое сопротивление|сопротивлению]] <math> R\,\! </math> (закон Ома для <strong>неполной цепи</strong>):
<math> I = \frac{U}{R} </math>,
или же отношением [[w:Электродвижущая сила|ЭДС]] к сумме внутреннего и внешнего сопротивлений:
<math> I = \frac{\mathcal E}{R+r} </math>
[[Категория:Введение в схемотехнику]]
o44e3zyajxzaya0l8wc1rrzlsx7asgv
Навыки Алисы
0
29080
165839
160034
2026-04-14T13:09:01Z
SemyonDudenkov
36586
165839
wikitext
text/x-wiki
== Навыки Алисы/Разработка интерактивного квеста ==
'''Учебный проект: голосовой навык Алисы «Petrozavodsk Quiz».'''
Проект оформлен подстраницами в формате курса «Навыки Алисы».
== Подстраницы ==
* [[Навыки Алисы/Разработка интерактивного квеста]] — цель проекта, функциональность и архитектура.
* [[Навыки Алисы/Архитектура навыка (черновик)]] — схема архитектуры для согласования с преподавателем.
* [[Навыки Алисы/Установка и локальный запуск]] — запуск проекта и тестирование.
* [[Навыки Алисы/Интеграция с Яндекс Диалогами]] — webhook payload и формат ответов.
* [[Навыки Алисы/Yandex Cloud Functions]] — развёртывание и публикация webhook.
== Что показывает проект ==
* реализацию диалогового сценария для Алисы;
* управление состоянием игровой сессии;
* проверку ответов с защитой от ложных совпадений;
* автоматические тесты и деплой в Yandex Cloud Functions.
== Статус оформления ==
* Подготовлены тексты подстраниц.
* Следующий шаг: загрузка иллюстраций на Викисклад и вставка в страницы курса.
3z5ords0d2b0c3cf2c620tkhr8wf5ql
165848
165839
2026-04-14T13:41:50Z
SemyonDudenkov
36586
/* Статус оформления */
165848
wikitext
text/x-wiki
== Навыки Алисы/Разработка интерактивного квеста ==
'''Учебный проект: голосовой навык Алисы «Petrozavodsk Quiz».'''
Проект оформлен подстраницами в формате курса «Навыки Алисы».
== Подстраницы ==
* [[Навыки Алисы/Разработка интерактивного квеста]] — цель проекта, функциональность и архитектура.
* [[Навыки Алисы/Архитектура навыка (черновик)]] — схема архитектуры для согласования с преподавателем.
* [[Навыки Алисы/Установка и локальный запуск]] — запуск проекта и тестирование.
* [[Навыки Алисы/Интеграция с Яндекс Диалогами]] — webhook payload и формат ответов.
* [[Навыки Алисы/Yandex Cloud Functions]] — развёртывание и публикация webhook.
== Что показывает проект ==
* реализацию диалогового сценария для Алисы;
* управление состоянием игровой сессии;
* проверку ответов с защитой от ложных совпадений;
* автоматические тесты и деплой в Yandex Cloud Functions.
== Материалы курса ==
* Структура курса оформлена в виде тематических подстраниц.
* В подстраницах представлены описание архитектуры, интеграции webhook, локального запуска и развёртывания.
* Иллюстративные материалы (скриншоты и схема архитектуры) добавляются после согласования и загрузки на Викисклад.
hypuslz8jh19bzqc0e4ds5hxw3lo4bo
165849
165848
2026-04-14T13:44:12Z
SemyonDudenkov
36586
165849
wikitext
text/x-wiki
== Навыки Алисы/Разработка интерактивного квеста ==
'''Учебный проект: голосовой навык Алисы «Petrozavodsk Quiz».'''
Проект оформлен подстраницами в формате курса «Навыки Алисы».
== Подстраницы ==
* [[Навыки Алисы/Разработка интерактивного квеста]] — цель проекта, функциональность и архитектура.
* [[Навыки Алисы/Архитектура навыка (черновик)]] — схема архитектуры для согласования с преподавателем.
* [[Навыки Алисы/Установка и локальный запуск]] — запуск проекта и тестирование.
* [[Навыки Алисы/Интеграция с Яндекс Диалогами]] — webhook payload и формат ответов.
* [[Навыки Алисы/Yandex Cloud Functions]] — развёртывание и публикация webhook.
== Что показывает проект ==
* реализацию диалогового сценария для Алисы;
* управление состоянием игровой сессии;
* проверку ответов с защитой от ложных совпадений;
* автоматические тесты и деплой в Yandex Cloud Functions.
== Материалы курса ==
* Структура курса оформлена в виде тематических подстраниц.
* В подстраницах представлены описание архитектуры, интеграции webhook, локального запуска и развёртывания.
* Иллюстративные материалы (скриншоты и схема архитектуры) добавляются после согласования и загрузки на Викисклад.
== Публичная версия навыка ==
* Ссылка на опубликованный навык: [https://dialogs.yandex.ru/store/skills/7edd79b2-petrozavodsk-quiz Petrozavodsk Quiz в каталоге навыков Алисы].
aq7p92hdqvfxtj0sq379ndi2u0kxu16
Участник:Отвертка бормашина
2
30156
165853
165835
2026-04-15T06:30:02Z
AKA MBG
551
Откат правки [[Special:Contributions/LNTG|LNTG]] ([[User talk:LNTG|обсуждение]]) к последней версии [[User:Отвертка бормашина|Отвертка бормашина]]
165721
wikitext
text/x-wiki
{|style="{{float right}} width: 242px; border: #99B3FF solid 1px; text-align: center"
|-
| '''Общая информация'''
|-
|
|-
|{{Наблюдатель|Отвертка бормашина}}
|-
ry45mrv3054ipvwg3obmw4tvaqpkh52
Обсуждение участника:Krutoi baton
3
30210
165852
165826
2026-04-15T06:28:07Z
AKA MBG
551
Введение в схемотехнику
165852
wikitext
text/x-wiki
{{Template:Welcome|realName=|name=Krutoi baton}}
-- [[Участник:New user message|New user message]] ([[Обсуждение участника:New user message|обсуждение]]) 22:10, 13 апреля 2026 (UTC)
== Введение в схемотехнику ==
Привет! Посмотрите варианты оформления, выберите, что больше подходит: [https://ru.wikiversity.org/w/index.php?title=%D0%92%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B2_%D1%81%D1%85%D0%B5%D0%BC%D0%BE%D1%82%D0%B5%D1%85%D0%BD%D0%B8%D0%BA%D1%83%2F%D0%9E%D0%B1%D0%BE%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D1%8F&diff=165851&oldid=165838 diff].
Я написал сообщение на Вашей странице обсуждения на Викискладе по поводу категорий и названия файлов на Викискладе.
Посмотрите [[:шаблон:Курс]] и как он используется в других курсах ([[:Категория:Все курсы]]). Можете такой же шаблон поставить и заполнить на первой странице курса "Введение в схемотехнику". -- [[Участник:AKA MBG|Andrew Krizhanovsky]] ([[Обсуждение участника:AKA MBG|обсуждение]]) 06:28, 15 апреля 2026 (UTC)
n2xfs16sw0pz7pwfsay4943c14ok2x6
Введение в схемотехнику/Обозначения
0
30211
165851
165838
2026-04-15T06:24:10Z
AKA MBG
551
оформление: мини и gallery
165851
wikitext
text/x-wiki
'''Обозначения компонентов''' достаточно важно, для того, чтобы схемотехники понимали чужие схемы и могли делать по ним электрическое цепи
== Потребители тока ==
[[File:Обозначение лампы в схемотехнике.png|мини|Обозначение лампы в схемотехнике]]
[[File:Обозначение мотора в схемотехнике.png|мини|Обозначение мотора]]
Итак, чтобы обозначить потребителей тока, используются следующие обозначения:
* [[w:Лампа|Лампа]]: окружность с крестом внутри, концы которого лежат на окружности
* [[w:Мотор|Мотор]]: окружность с буквой М посередине; с концов, куда идет подключение к нему, ставятся прямоугольники, часть которых находится за окружностью, но не рисуется
== Полупроводниковые элементы ==
Полупроводниковых элементов много - транзисторы, диоды, микросхемы...
* [[w:Транзистор|Транзистор]] ('''относится только для биполярных транзисторов, для MOSFET другие обозначения!'''): кружок, из которого идет три выхода - один из них идет к отрезку, лежачего между концом окружности, с которым пересекается соединение, и оси центра окружности. Этот отрезоок не будет касаться окружности (внутри нее) и будет перпендикулярен соединению. От этого отрезка под углом 30 или 45 градусов в обе стороны (вниз и вверх) идут контакты, вплоть до окружности. У эмиттера у конца соединения его с окружностью рисуется стрелочка - "внутрь" транзистора для P-N-P и "из" транзистора для N-P-N
<gallery>
PNP-транзистор в схемотехнике.png|PNP-транзистор
NPN-транзистор в схемотехнике.png|NPN-транзистор
</gallery>
c1ccpmiyu3nixb8y77fpeawz5ga0ynw
Навыки Алисы/Разработка интерактивного квеста
0
30212
165840
2026-04-14T13:10:23Z
SemyonDudenkov
36586
Новая страница: «== Навыки Алисы/Разработка интерактивного квеста == '''Подстраница курса «Навыки Алисы».''' Эта подстраница описывает учебный навык «Petrozavodsk Quiz»: голосовую викторину о достопримечательностях Петрозаводска. == Цель навыка == Навык должен: * задавать пользо...»
165840
wikitext
text/x-wiki
== Навыки Алисы/Разработка интерактивного квеста ==
'''Подстраница курса «Навыки Алисы».'''
Эта подстраница описывает учебный навык «Petrozavodsk Quiz»: голосовую викторину о достопримечательностях Петрозаводска.
== Цель навыка ==
Навык должен:
* задавать пользователю вопросы о достопримечательностях;
* проверять правильность ответа;
* давать подсказки по шагам (текстовая и визуальная);
* подсчитывать итоговый результат.
== Пользовательский сценарий ==
1. Пользователь говорит: «старт».
2. Навык задаёт 5 вопросов по достопримечательностям.
3. После ошибки даётся первая подсказка.
4. После второй ошибки показывается вторая подсказка (изображение, если доступно).
5. После завершения игры выводится счёт и предложение сыграть снова.
== Компоненты проекта ==
; '''Game Engine (game_engine.py)'''
: Игровая логика, команды, проверка ответов, подсказки, подсчёт результата.
; '''Landmarks Data (landmarks.py)'''
: База данных из достопримечательностей Петрозаводска с подсказками и источниками.
; '''Webhook Handler (alice_handler.py)'''
: Принимает запросы от Яндекс.Алисы и формирует ответ навыка.
; '''Cloud Function Entry Point (cloud_function.py)'''
: Точка входа для развёртывания в Yandex Cloud Functions.
== Архитектура (черновик на согласование) ==
Перед публикацией финальной иллюстрации на Викисклад схема архитектуры направляется преподавателю на согласование.
Краткая структура:
* Алиса/Яндекс Диалоги -> webhook;
* `cloud_function.py` -> `alice_handler.py`;
* `alice_handler.py` -> `game_engine.py` + `landmarks.py`;
* состояние игры передаётся через `session_state`.
== Иллюстрации (после загрузки на Викисклад) ==
Здесь планируется разместить 2 удачных скриншота диалога:
[[Файл:Petrozavodsk Quiz - Диалог 1.png|мини|800px|Скриншот 1: старт игры и первый вопрос]]
[[Файл:Petrozavodsk Quiz - Диалог 2.png|мини|800px|Скриншот 2: подсказка с изображением и правильный ответ]]
== Учебный результат ==
В рамках курса демонстрируются:
* проектирование диалогового интерфейса;
* разбиение приложения на модули;
* тестирование Python-проекта;
* публикация webhook-навыка в облаке.
ogehwn2del8uf23aoniylv6z90bysi6
165846
165840
2026-04-14T13:35:26Z
SemyonDudenkov
36586
/* Иллюстрации (после загрузки на Викисклад) */
165846
wikitext
text/x-wiki
== Навыки Алисы/Разработка интерактивного квеста ==
'''Подстраница курса «Навыки Алисы».'''
Эта подстраница описывает учебный навык «Petrozavodsk Quiz»: голосовую викторину о достопримечательностях Петрозаводска.
== Цель навыка ==
Навык должен:
* задавать пользователю вопросы о достопримечательностях;
* проверять правильность ответа;
* давать подсказки по шагам (текстовая и визуальная);
* подсчитывать итоговый результат.
== Пользовательский сценарий ==
1. Пользователь говорит: «старт».
2. Навык задаёт 5 вопросов по достопримечательностям.
3. После ошибки даётся первая подсказка.
4. После второй ошибки показывается вторая подсказка (изображение, если доступно).
5. После завершения игры выводится счёт и предложение сыграть снова.
== Компоненты проекта ==
; '''Game Engine (game_engine.py)'''
: Игровая логика, команды, проверка ответов, подсказки, подсчёт результата.
; '''Landmarks Data (landmarks.py)'''
: База данных из достопримечательностей Петрозаводска с подсказками и источниками.
; '''Webhook Handler (alice_handler.py)'''
: Принимает запросы от Яндекс.Алисы и формирует ответ навыка.
; '''Cloud Function Entry Point (cloud_function.py)'''
: Точка входа для развёртывания в Yandex Cloud Functions.
== Архитектура (черновик на согласование) ==
Перед публикацией финальной иллюстрации на Викисклад схема архитектуры направляется преподавателю на согласование.
Краткая структура:
* Алиса/Яндекс Диалоги -> webhook;
* `cloud_function.py` -> `alice_handler.py`;
* `alice_handler.py` -> `game_engine.py` + `landmarks.py`;
* состояние игры передаётся через `session_state`.
== Иллюстрации (после загрузки на Викисклад) ==
Здесь планируется разместить 2 удачных скриншота диалога:
[[Файл:Petrozavodsk-Quiz-dialog-start.png|мини|800px|Скриншот 1: старт игры и первый вопрос]]
[[Файл:Petrozavodsk-Quiz-dialog-hints2.png|мини|800px|Скриншот 2: подсказка с изображением и правильный ответ]]
== Учебный результат ==
В рамках курса демонстрируются:
* проектирование диалогового интерфейса;
* разбиение приложения на модули;
* тестирование Python-проекта;
* публикация webhook-навыка в облаке.
5fjpvovmxpkumcc7neeb68bghyium3h
165847
165846
2026-04-14T13:38:40Z
SemyonDudenkov
36586
/* Учебный результат */
165847
wikitext
text/x-wiki
== Навыки Алисы/Разработка интерактивного квеста ==
'''Подстраница курса «Навыки Алисы».'''
Эта подстраница описывает учебный навык «Petrozavodsk Quiz»: голосовую викторину о достопримечательностях Петрозаводска.
== Цель навыка ==
Навык должен:
* задавать пользователю вопросы о достопримечательностях;
* проверять правильность ответа;
* давать подсказки по шагам (текстовая и визуальная);
* подсчитывать итоговый результат.
== Пользовательский сценарий ==
1. Пользователь говорит: «старт».
2. Навык задаёт 5 вопросов по достопримечательностям.
3. После ошибки даётся первая подсказка.
4. После второй ошибки показывается вторая подсказка (изображение, если доступно).
5. После завершения игры выводится счёт и предложение сыграть снова.
== Компоненты проекта ==
; '''Game Engine (game_engine.py)'''
: Игровая логика, команды, проверка ответов, подсказки, подсчёт результата.
; '''Landmarks Data (landmarks.py)'''
: База данных из достопримечательностей Петрозаводска с подсказками и источниками.
; '''Webhook Handler (alice_handler.py)'''
: Принимает запросы от Яндекс.Алисы и формирует ответ навыка.
; '''Cloud Function Entry Point (cloud_function.py)'''
: Точка входа для развёртывания в Yandex Cloud Functions.
== Архитектура (черновик на согласование) ==
Перед публикацией финальной иллюстрации на Викисклад схема архитектуры направляется преподавателю на согласование.
Краткая структура:
* Алиса/Яндекс Диалоги -> webhook;
* `cloud_function.py` -> `alice_handler.py`;
* `alice_handler.py` -> `game_engine.py` + `landmarks.py`;
* состояние игры передаётся через `session_state`.
== Иллюстрации (после загрузки на Викисклад) ==
Здесь планируется разместить 2 удачных скриншота диалога:
[[Файл:Petrozavodsk-Quiz-dialog-start.png|мини|800px|Скриншот 1: старт игры и первый вопрос]]
[[Файл:Petrozavodsk-Quiz-dialog-hints2.png|мини|800px|Скриншот 2: подсказка с изображением и правильный ответ]]
== Учебный результат ==
В рамках курса демонстрируются:
* проектирование диалогового интерфейса;
* разбиение приложения на модули;
* хранение и передача состояния диалога между запросами;
* настройка логики подсказок и ограничений попыток;
* работа с данными предметной области (список достопримечательностей, алиасы, источники);
* обработка граничных случаев и защита от ложных совпадений ответов;
* тестирование Python-проекта;
* регрессионная проверка сценариев после доработок;
* публикация webhook-навыка в облаке;
* подготовка проектной документации для Викиверситета и Викисклада.
20kgx65gd0qf71owsab9es9oaclxyhp
Навыки Алисы/Интеграция с Яндекс Диалогами
0
30213
165841
2026-04-14T13:12:25Z
SemyonDudenkov
36586
Новая страница: «== Навыки Алисы/Интеграция с Яндекс Диалогами == '''Подстраница курса «Навыки Алисы».''' Эта подстраница показывает формат webhook-запроса и ответа навыка для Яндекс Диалогов. == Минимальный payload == <syntaxhighlight lang="json"> { "request": { "original_utterance": "старт", "command": "стар...»
165841
wikitext
text/x-wiki
== Навыки Алисы/Интеграция с Яндекс Диалогами ==
'''Подстраница курса «Навыки Алисы».'''
Эта подстраница показывает формат webhook-запроса и ответа навыка для Яндекс Диалогов.
== Минимальный payload ==
<syntaxhighlight lang="json">
{
"request": {
"original_utterance": "старт",
"command": "старт"
},
"session": {
"new": true,
"user_id": "user-123",
"application": {
"application_id": "app-123"
}
}
}
</syntaxhighlight>
== Что делает обработчик ==
* читает `request` и `session`;
* определяет пользователя;
* запускает игру или продолжает текущую;
* добавляет `session_state` для сохранения прогресса;
* возвращает JSON формата Яндекс Диалогов.
== Формат ответа ==
<syntaxhighlight lang="json">
{
"version": "1.0",
"response": {
"text": "Ответ навыка",
"end_session": false,
"card": {
"type": "BigImage",
"image_id": "12345/abcde",
"title": "Вторая подсказка",
"description": "Посмотри на изображение и попробуй ответить еще раз."
}
},
"session_state": {
"in_progress": true,
"score": 2,
"asked_count": 3
}
}
</syntaxhighlight>
== Проверка ==
Проверяй webhook через:
<syntaxhighlight lang="bash">
python verify_webhook.py https://твой-url
</syntaxhighlight>
08n49mecrw42zpa91sp50tz6jfi3qbo
Навыки Алисы/Yandex Cloud Functions
0
30214
165842
2026-04-14T13:13:40Z
SemyonDudenkov
36586
Новая страница: «== Навыки Алисы/Yandex Cloud Functions == '''Подстраница курса «Навыки Алисы».''' Эта подстраница описывает развёртывание webhook в Yandex Cloud Functions. == Почему Cloud Functions == * нет спящего сервера; * нет зависимости от платного always-on плана; * хорошо подходит для webhook навыков Алисы;...»
165842
wikitext
text/x-wiki
== Навыки Алисы/Yandex Cloud Functions ==
'''Подстраница курса «Навыки Алисы».'''
Эта подстраница описывает развёртывание webhook в Yandex Cloud Functions.
== Почему Cloud Functions ==
* нет спящего сервера;
* нет зависимости от платного always-on плана;
* хорошо подходит для webhook навыков Алисы;
* удобно публиковать новую версию из zip-архива.
== Точка входа ==
Для функции используется:
<syntaxhighlight lang="python">
def handler(event, context):
...
</syntaxhighlight>
Entry point в настройках функции: `cloud_function.handler`.
== Шаги развёртывания ==
1. Открой Yandex Cloud Console.
2. Создай функцию в разделе Cloud Functions.
3. Загрузи код архивом `alice-ycf-deploy.zip` из корня репозитория.
4. Укажи entry point `cloud_function.handler`.
5. Создай HTTP-trigger.
6. Возьми публичный URL и используй его как webhook в Яндекс Диалогах.
== Проверка ==
После публикации проверь:
<syntaxhighlight lang="bash">
python verify_webhook.py https://твой-url
</syntaxhighlight>
izevqxtqz1uvn6wor5dwn4c0jbscw5o
Навыки Алисы/Установка и локальный запуск
0
30215
165843
2026-04-14T13:14:11Z
SemyonDudenkov
36586
Новая страница: «== Навыки Алисы/Установка и локальный запуск == '''Подстраница курса «Навыки Алисы».''' Эта подстраница описывает локальную установку проекта и запуск на компьютере. == Требования == * Python 3.11+ * Git * Интернет нужен только для развёртывания и проверки публичн...»
165843
wikitext
text/x-wiki
== Навыки Алисы/Установка и локальный запуск ==
'''Подстраница курса «Навыки Алисы».'''
Эта подстраница описывает локальную установку проекта и запуск на компьютере.
== Требования ==
* Python 3.11+
* Git
* Интернет нужен только для развёртывания и проверки публичного webhook
== Локальный запуск ==
1. Создай виртуальное окружение:
<syntaxhighlight lang="bash">
python -m venv .venv
source .venv/bin/activate
</syntaxhighlight>
2. Установи зависимости:
<syntaxhighlight lang="bash">
pip install -r requirements.txt
</syntaxhighlight>
3. Запусти тесты:
<syntaxhighlight lang="bash">
python -m unittest discover -s tests -v
</syntaxhighlight>
4. Попробуй игру в CLI:
<syntaxhighlight lang="bash">
python demo_cli.py
</syntaxhighlight>
== Команды ==
* <code>старт</code> — начать игру
* <code>помощь</code> — показать правила
* <code>сдаюсь</code> — показать правильный ответ
* <code>заново</code> — начать заново
== Проверка перед публикацией ==
* Прогнать тесты: <code>python -m unittest discover -s tests -p 'test_*.py'</code>
* Обновить zip-архив для облака.
* Убедиться, что публичный webhook отвечает кодом 200.
bu1x2to6ydmnxfh8fl889pkbhz2u2m9
Файл:Petrozavodsk-Quiz-dialog-start.png
6
30216
165844
2026-04-14T13:30:18Z
SemyonDudenkov
36586
165844
wikitext
text/x-wiki
phoiac9h4m842xq45sp7s6u21eteeq1
Файл:Petrozavodsk-Quiz-dialog-hints2.png
6
30217
165845
2026-04-14T13:33:33Z
SemyonDudenkov
36586
165845
wikitext
text/x-wiki
phoiac9h4m842xq45sp7s6u21eteeq1
Обсуждение участника:Jamresdiuch
3
30218
165854
2026-04-15T09:02:52Z
New user message
3844
Добавление [[Template:Welcome|приветствия]] на страницу обсуждения нового участника
165854
wikitext
text/x-wiki
{{Template:Welcome|realName=|name=Jamresdiuch}}
-- [[Участник:New user message|New user message]] ([[Обсуждение участника:New user message|обсуждение]]) 09:02, 15 апреля 2026 (UTC)
6r4rqj8wo0fpulno0v4ryudkt88j5aa