Интеграция СЭО 3KL с искусственным интеллектом
1. Общая информация
1.1. Использование отечественных поставщиков ИИ (например, Яндекса) и локальных языковых моделей
2. Возможности
2.1. Включение и использование подсистемы ИИ (на примере OpenAI-совместимого сервиса)
2.2. Создание резюме содержания страницы с помощью ИИ
2.3. Генерация текста с помощью ИИ
2.4. Генерация изображения с помощью ИИ
2.5. Проверка с помощью ИИ ответов слушателей в элементе курса «Задание»
3. Права
4. Глобальные настройки требуются права Администратора
4.1. Страница «Поставщики ИИ»
4.1.1. Поставщик API Azure AI
4.1.2. Поставщик API OpenAI-совместимый
4.2. Страница «Размещения ИИ»
5. Примеры и решения
5.1. Рекомендации по подключению ИИ от сервиса Yandex (cloud)
5.2. Рекомендации по подключению ИИ от сервиса BotHub
Вебинар от 20.05.2025г. Moodle 4.5: что нового? (СЭО 3KL версии 4.5)
Анонс СЭО 3KL 4.5.11b: проверка Заданий с помощью ИИ, доработки элемента курса «Занятие 3KL»
1. Общая информация
Начиная с версии 4.5.4b в СЭО 3KL внедрена подсистема искусственного интеллекта (далее — ИИ), которая предназначена для использования в учебном процессе функциональных возможностей внешних сервисов-поставщиков ИИ и реализует следующие действия в системе:
- создание резюме представленного на странице текста;
- генерация текстового контента на основе текста подсказки пользователя (через редактор TinyMCE);
- генерация изображений для иллюстрации представленного текста (через редактор TinyMCE).
Базовый функционал подсистемы ИИ может быть расширен за счет установки дополнительных плагинов. Начиная с версии 4.5.11b, в СЭО 3KL реализована возможность проверки с помощью искусственного интеллекта ответов слушателей в элементе курса «Задание».
Для того, чтобы начать использование подсистемы ИИ, необходимо:
- самостоятельно выбрать сервис ИИ, удовлетворяющий вашим потребностям и интеграция с которым поддерживается в СЭО 3KL;
- создать аккаунт/учетную запись на выбранном сервисе и получить необходимые для настройки интеграции реквизиты;
- настроить в СЭО 3KL подключение к сервису ИИ и действия, которые должен выполнять данный поставщик ИИ;
- включить в СЭО 3KL необходимые действия.
1.1. Использование отечественных поставщиков ИИ (например, Яндекса) и локальных языковых моделей
Исторически сложилось, что компания OpenAI, стала первопроходцем в области разработки и изучения искусственного интеллекта, и ее спецификация API, на текущий момент является негласным техническим стандартом, поддерживаемым подавляющим большинством разработчиков и сервисов современного рынка нейросетей.
Заявленная в СЭО 3KL поддержка API OpenAI (Поставщик API OpenAI-совместимый) позволяет реализовать интеграцию с практически любыми поставшиками ИИ:
- внешними (облачными) отечественными или зарубежными сервисами (Yandex Cloud, Cloud.ru, BotHub и т. п.);
- локальными LLM (Llama, Qwen3, DeepSeek-R1 Distill и т. п.).
2. Возможности
2.1. Включение и подготовка к использованию подсистемы ИИ (на примере OpenAI-совместимого сервиса)
Администратор СЭО открывает страницу «Поставщики ИИ» (Администрирование->Основные->Искусственный интеллект (ИИ)->Поставщики ИИ), включает поставщика ИИ «Поставщик API OpenAI-совместимый» (переключатель в столбце «Включено») и переходит по ссылке на страницу настроек поставщика (Рис. 2.1.1).
На странице «Поставщик API OpenAI-совместимый» администратор СЭО:
- указывает параметры подключения к поставщику (в первую очередь, вводит ключ API) (поз. 1 Рис. 2.1.2);
- включает те действия, которые должны выполняться в системе при помощи это поставщика (поз. 2 Рис. 2.1.2);
- последовательно переходит по ссылке «Настройки» включенных действий и выполняет их настройку: указывает пути к модели ИИ и конечной точке API (Рис. 2.1.3).
На странице «Размещения ИИ» (Администрирование->Основные->Искусственный интеллект (ИИ)->Размещения ИИ) администратор СЭО указывает (включает переключатели), в каких интерфейсах системы и какие действия будут доступны пользователям (Рис. 2.1.4):
| Область размещения действий ИИ | Доступные действия, которые могут быть включены/отключены в настройках размещения (см. поз 1 Рис. 2.1.4) | Примечание |
| Текстовый редактор |
Создание текста Создание изображения |
Действия реализованы через инструмент редактора «Создать контент с помощью ИИ».
Чтобы инструмент был доступен в панели инструментов редактора, необходимо предварительно включить подплагин «Размещение ИИ» (Администрирование->Плагины->Текстовые редакторы->Редактор TinyMCE->Основные настройки).
|
| Course Assistance | Краткое изложение текста | Действие реализовано через кнопку «Резюмировать», доступную на страницах системы, при включенном действии, под меню вторичной навигации (Рис. 2.1.5). |
2.2. Создание резюме содержания страницы с помощью ИИ
Пользователь, находясь на странице выбранного элемента курса (ресурса), нажимает кнопку «Резюмировать». Подсистема ИИ генерирует краткое изложение контента страницы в отдельном модальном окне (Рис. 2.2.1).
Ознакомившись с предложенным текстом пользователь имеет возможность отправить запрос на изменение резюме (кнопка «Восстановить», расположенная внизу модального окна) или скопировать предложенный вариант (кнопка «Копировать»).
2.3. Генерация текста с помощью ИИ
Преподаватель, при наполнении учебным материалом новой информационной страницы элемента курса «Лекция», использует инструмент «Создать контент с помощью ИИ» редактора «TinyMCE» и выбирает в меню инструмента пункт «Создать текст с помощью ИИ» (Рис. 2.3.1).
В левом поле открывшегося модального окна «Создание текста с использованием ИИ» преподаватель набирает краткий запрос на формирование тематического текста и нажимает кнопку «Создать текст» (Рис. 2.3.2).
Сгенерированный ИИ фрагмент текста пользователь может добавить в текстовое поле редактора при помощи кнопки «Вставить >» или перегенерировать повторно, нажав кнопку «Восстановить» (Рис. 2.3.3).
2.4. Генерация изображения с помощью ИИ
Слушателю необходимо проиллюстрировать изображением свой ответ на вопрос типа «мульти-эссе» в элементе курса «Тест». Он использует инструмент «Создать контент с помощью ИИ» редактора «TinyMCE» и выбирает в меню инструмента пункт «Создать изображение с помощью ИИ» (Рис. 2.4.1).
В открывшемся модальном окне «Создание изображения с помощью ИИ» (Рис. 2.4.2) пользователь формирует запрос на генерацию изображения:
- создает описание необходимого изображения в поле «Опишите изображение, которое должен создать ИИ»;
- указывает качество и форму требуемого изображения (при необходимости);
- нажимает кнопку «Создать изображение».
Сервис ИИ генерирует изображение по созданному запросу (Рис. 2.4.3).
Если полученное изображение не удовлетворяет пользователя, он имеет возможность перегенерировать его, нажав кнопку «Восстановить».
Если изображение соответствует требованиям пользователя, он нажимает кнопку «Далее>» и, на следующем этапе (Рис. 2.4.4), может скорректировать:
- текст описания к изображению;
- размер изображения.
После нажатия кнопки «Сохранить изображение», сгенерированнная картинка отобразится в окне редактора ответа пользователя на вопрос Теста (Рис. 2.4.5).
2.5. Проверка с помощью ИИ ответов слушателей в элементе курса «Задание»
Для реализации возможности проверки ответов слушателей курса с помощью ИИ, преподаватель/создатель курса выполняет предварительную настройку элемента курса «Задание»: включает в настройках элемента курса «Задание» опцию «Оценивание с помощью ИИ»; формирует инструкции (промпты) по проверке для ИИ; настраивает критерии оценивания (Рис. 2.5.1).
По итогам настройки на странице проверки ответа на Задание становится доступна кнопка «Оценить AI» (Рис. 2.5.2), нажав на которую преподаватель запускает процедуру оценивания работы слушателя с помощью искусственного интеллекта.
Результаты оценивания будут автоматически сохранены в СЭО 3KL и отобразятся в интерфейсе страницы (Рис. 2.5.3).
Преподаватель имеет возможность ознакомится с оценкой и, при необходимости, изменить ее.
3. Права
| Право | Описание | Установлено по умолчанию для роли* |
| moodle/ai:acceptpolicy | Принимать политики ИИ | Администратор СЭО |
| moodle/ai:fetchanyuserpolicystatus | Получать согласие пользователей с политикой ИИ | Администратор СЭО |
| moodle/ai:fetchpolicy | Получать согласие пользователей с политикой ИИ | Администратор СЭО |
| aiplacement/courseassist:summarise_text | Резюмировать текст | Администратор СЭО, Управляющий, Преподаватель, Слушатель |
| aiplacement/editor:generate_image | Создавать изображения с помощью ИИ в текстовом редакторе HTML | Администратор СЭО,Управляющий, Преподаватель, Слушатель |
| aiplacement/editor:generate_text | Создавать текст с помощью ИИ в текстовом редакторе | Администратор СЭО,Управляющий, Преподаватель, Слушатель |
4. Глобальные настройки требуются права Администратора
Такая роль назначается Представителю Заказчика (Диспетчеру-администратору) по умолчанию. Если, по каким-то причинам, у вашего Диспетчера-администратора иная роль — вы можете обратиться в техническую поддержку с соответствующей заявкой на расширение существующего набора прав Диспетчера-администратора.
Важно! Неосторожные действия Администратора СЭО могут повредить систему и контент таким образом, что исправление последствий вмешательства выйдет за рамки гарантийной технической поддержки. В случае внесения правок в глобальные настройки рекомендуем сначала убедиться в том, что вы полностью понимаете, за что отвечают данные настройки. Если у вас возникают сомнения в назначении глобальных настроек — обратитесь за помощью в техническую поддержку.
Подробная информация в статье «Полный административный доступ».
Доступ к настройкам подсистемы ИИ организован через административный раздел «Искусственный интеллект (ИИ)» (Рис. 4.1).
4.1. Страница «Поставщики ИИ»
Функционал страницы позволяет управлять (включать/отключать) использованием в СЭО 3KL преднастроенных сервисов-поставщиков ИИ, а также (перейдя по ссылке «Настройки» выбранного поставщика) — настраивать как сами подключения к сервисами, так и выполнение ИИ действий с помощью этих сервисов (Рис. 4.1.1).
Процесс настройки поставщика ИИ состоит из следующих этапов:
1) Настройка подключения к выбранному поставщику ИИ. Выполняется на странице настроек поставщика ИИ (см. поз. 1 Рис. 4.1.1, Рис. 4.1.1.а) с использованием реквизитов из вашего аккаунта/учетной записи на сервисе ИИ.
2) Настройка действия, которое должно выполняться в СЭО 3KL с использованием выбранного поставщика ИИ. Выполняется на странице настроек действия, доступной из раздела «Действия» на странице настроек поставщика ИИ (поз. 1 Рис. 4.1.1.а). Здесь необходимо прописать корректный путь для запросов к API поставщика ИИ (модель, идентификатор ресурса и т.п. — зависит от конкретного сервиса). Доступны в личном кабинете или в разделе документации сервиса ИИ.
4.1.1. Поставщик API Azure AI
Настройки поставщика «Поставщик API Azure AI».
- Ключ API Azure AI, Конечная точка API Azure AI. Реквизиты для подключения к поставщику. Доступны в личном кабинете вашей учетной записи на сервисе.
- Опция «Установить ограничение скорости на уровне всего сайта». Если установлена, в настройках становится доступно поле «Максимальное количество запросов по всему сайту» (Рис. 4.1.1.б), в котором необходимо указать, какое максимальное количество запросов к сервису ИИ может быть отправлено в течение часа из среды электронного обучения от всех пользователей системы.
- Опция «Установить ограничение скорости для пользователя». Если установлена, в настройках становится доступно поле «Максимальное количество запросов на пользователя» (Рис. 4.1.1.в), в котором необходимо указать, какое максимальное количество запросов к сервису ИИ может быть отправлено в течение часа из среды электронного обучения от произвольного пользователя системы.
Настройки действия «Создание текста» поставщика «Поставщик API Azure AI».
- ID размещения. Уникальный идентификатор конкретной модели ИИ (локальный путь к модели) внутри сервиса «Azure AI», по которому будет обрабатываться запрос. Доступен в личном кабинете сервиса при выборе модели ИИ.
- Версия API, Системная инструкция. Служебная информация, необходимая при формировании запроса к ИИ. Рекомендуется использовать значения по умолчанию.
Настройки действия «Создание изображения» поставщика «Поставщик API Azure AI».
- ID размещения. Уникальный идентификатор конкретной модели ИИ (локальный путь к модели) внутри сервиса «Azure AI», по которому будет обрабатываться запрос. Доступен в личном кабинете сервиса при выборе модели ИИ.
- Версия API. Служебная информация, необходимая при формировании запроса к ИИ. Рекомендуется использовать значения по умолчанию.
Настройки действия «Краткое изложение текста» поставщика «Поставщик API Azure AI».
- ID размещения. Уникальный идентификатор конкретной модели ИИ (локальный путь к модели) внутри сервиса «Azure AI», по которому будет обрабатываться запрос. Доступен в личном кабинете сервиса при выборе модели ИИ.
- Версия API, Системная инструкция. Служебная информация, необходимая при формировании запроса к ИИ. Рекомендуется использовать значения по умолчанию.
4.1.2. Поставщик API OpenAI-совместимый
Настройки поставщика «Поставщик API OpenAI-совместимый».
- Ключ API OpenAI, ID организации OpenAI. Реквизиты для подключения к поставщику. Доступны в личном кабинете вашей учетной записи на сервисе.
- Опция «Установить ограничение скорости на уровне всего сайта». Если установлена, в настройках становится доступно поле «Максимальное количество запросов по всему сайту» (Рис. 4.1.2.б), в котором необходимо указать, какое максимальное количество запросов к сервису ИИ может быть отправлено в течение часа из среды электронного обучения от всех пользователей системы.
- Опция «Установить ограничение скорости для пользователя». Если установлена, в настройках становится доступно поле «Максимальное количество запросов на пользователя» (Рис. 4.1.2.в), в котором необходимо указать, какое максимальное количество запросов к сервису ИИ может быть отправлено в течение часа из среды электронного обучения от произвольного пользователя системы.
Настройки действия «Создание текста» поставщика «Поставщик API OpenAI-совместимый».
- Модель ИИ. Название модели, с помощью которой будет обрабатываться запрос. Информацию о доступных моделях ИИ можно получить в личном кабинете или документации сервиса.
- Конечная точка API. Путь (конкретный веб-адрес на сервере сервиса ИИ), по которому отправляются запросы на генерацию контента. Информацию можно получить в личном кабинете или документации сервиса.
- Системная инструкция. Служебная информация, необходимая при формировании запроса к ИИ. Рекомендуется использовать значения по умолчанию.
Настройки действия «Создание изображения» поставщика «Поставщик API OpenAI-совместимый».
- Модель ИИ. Название модели, с помощью которой будет обрабатываться запрос. Информацию о доступных моделях ИИ можно получить в личном кабинете или документации сервиса.
- Конечная точка API. Путь (конкретный веб-адрес на сервере сервиса ИИ), по которому отправляются запросы на генерацию контента. Информацию можно получить в личном кабинете или документации сервиса.
Настройки действия «Краткое изложение текста» поставщика «Поставщик API OpenAI-совместимый».
- Модель ИИ. Название модели, с помощью которой будет обрабатываться запрос. Информацию о доступных моделях ИИ можно получить в личном кабинете или документации сервиса.
- Конечная точка API. Путь (конкретный веб-адрес на сервере сервиса ИИ), по которому отправляются запросы на генерацию контента. Информацию можно получить в личном кабинете или документации сервиса.
- Системная инструкция. Служебная информация, необходимая при формировании запроса к ИИ. Рекомендуется использовать значения по умолчанию.
4.2. Страница «Размещения ИИ»
Функционал страницы позволяет управлять (включать/отключать) размещением (отображением в интерфейсах СЭО 3KL) инструментов ИИ, а также (перейдя по ссылке «Настройки» выбранного размещения) — возможными действиями этих инструментов.
Доступные инструменты и действия:
- Размещение - текстовый редактор (инструмент «Создать контент с помощью ИИ» в текстовом редакторе). Действия (Рис. 4.2.2):
- Создание текста.
- Создание изображения.
- Размещение - Course Assistance (Ассистент курса). Действия (Рис. 4.2.3):
- Краткое изложение текста.
5. Примеры и решения
5.1. Рекомендации по подключению ИИ от сервиса Yandex (cloud)
1) Используя аккаунт Yandex ID, войти на платформу Yandex Cloud и последовательно создать:
2) Привязать облако к платежному аккаунту.
3) Создать сервисный аккаунт на Yandex Cloud. В процессе создания назначить сервисному аккаунту следующие роли из каталога:
- ai.languageModels.user (позволяет использовать модели генерации текста);
- ai.imageGeneration.user (позволяет использовать модели генерации изображений YandexART).
4) Сгенерировать в сервисном аккаунте ключ API, ввести полученный ключ в поле «Ключ API OpenAI» страницы настроек «Поставщик API OpenAI-совместимый» СЭО 3KL.
5) Указать в СЭО 3KL следующие настройки действий:
| Название действия | Значение поля «Модель ИИ» | Значение поля «Конечная точка API» |
| Создание текста | gpt://идентификатор_каталога*/yandexgpt-5-lite | https://ai.api.cloud.yandex.net/v1/chat/completions |
| Создание изображения | art://идентификатор_каталога*/aliceai-image-art-3.0 | https://ai.api.cloud.yandex.net/v1/images/generations |
| Краткое изложение текста | gpt://идентификатор_каталога*/yandexgpt-5-lite | https://ai.api.cloud.yandex.net/v1/chat/completions |
_____________________________________
* — Вместо текста «идентификатор_каталога» в строке «Модель ИИ» необходимо подставить значение вашего идентификатора каталога, который вы получили на шаге 1).
5.2. Рекомендации по подключению ИИ от сервиса BotHub
1) Создать на платформе учетную запись.
2) Оплатить тариф, позволяющий создавать и использовать ключ API.
3) В личном кабинете платформы перейти в раздел «BotHub для разработчиков», сгенерировать ключ API и ввести полученный ключ в поле «Ключ API OpenAI» страницы настроек «Поставщик API OpenAI-совместимый» СЭО 3KL.
4) Указать в СЭО 3KL следующие настройки действий:
| Название действия | Значение поля «Модель ИИ» | Значение поля «Конечная точка API» |
| Создание текста | по умолчанию | https://bothub.chat/api/v2/openai/v1/chat/completions |
| Создание изображения | по умолчанию | https://bothub.chat/api/v2/openai/v1/images/generations |
| Краткое изложение текста | по умолчанию | https://bothub.chat/api/v2/openai/v1/chat/completions |