Онлайн-школы добавляют к урокам AI-тьютора: студент задаёт вопрос по материалу и получает объяснение со ссылкой на урок. Ниже — типовая архитектура такого ассистента на Heli API: какие компоненты нужны, как не превратить тьютора в решебник и как держать расход под контролем.
Архитектура
- База знаний: тексты уроков, конспекты и расшифровки видео режутся на фрагменты по 300–800 токенов с пометкой курса и урока. Расшифровку видео можно получить через /v1/audio/transcriptions.
- Эмбеддинги: openai/text-embedding-3-small через /v1/embeddings, векторы — в pgvector, Qdrant или другой векторной базе.
- Поиск: по вопросу находятся 3–5 ближайших фрагментов, только из курса, на котором учится студент.
- Ответ: быстрая модель, например deepseek/deepseek-v4-flash или openai/gpt-5.4-mini, отвечает по найденным фрагментам и ссылается на урок.
Промпт наставника
Правило про домашние задания — решение школы, а не техническая гарантия: модель может его нарушить, если студент настойчиво просит. Проверяйте ответы на типичных попытках получить готовое решение и при необходимости добавьте второй, проверочный запрос.
system = """Ты тьютор курса «{course_title}».
Отвечай только по материалам ниже. Если ответа в них нет, скажи об этом
и предложи задать вопрос куратору.
Не решай домашние задания целиком: объясни идею, дай подсказку или похожий пример.
В конце укажи урок, на который опирается ответ.
Материалы:
{context}"""Квоты и расход
- Квоту на студента, например число вопросов в день, считайте в своём backend (Redis или таблица в базе): лимиты Heli задаются на аккаунт, проект или ключ, а не на ваших пользователей.
- Передавайте внутренний ID студента в поле user — в журнале Heli будет видно, на кого приходится расход. Используйте ID, а не email.
- Ограничьте длину истории диалога и max_tokens ответа.
- Задайте ключу тьютора месячный бюджет во вкладке «Лимиты» с письмами при 50, 80, 90 и 100% и резервной моделью при исчерпании.
Качество
Перед запуском соберите 50–100 реальных вопросов студентов и проверьте ответы с методистом: правильность, ссылку на урок и отказ отвечать вне курса. Логируйте вопросы, на которые база знаний не нашла ответа, — это список пробелов в материалах курса. Если среди учеников есть несовершеннолетние, согласуйте обработку их данных с юристом.
Попробуйте Heli
Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.