Бесплатный урок

Контракт бота и секреты

Контракт бота и секреты — Telegram-бот с локальной AI-моделью. Один приватный сценарий; Token не является текстом prompt; Сначала инъекция зависимостей. Практическое задание: Практика: Контракт бота и секреты.

Демо-версия. Материалы проходят редакторскую проверку.

Что рассмотрим

  • Один приватный сценарий
  • Token не является текстом prompt
  • Сначала инъекция зависимостей

Один приватный сценарий

Учебный бот получает короткий текст разрешённого пользователя, передаёт локальной Ollama и готовит ответ в том же приватном чате. Он не публикует каналы, не выполняет shell и не читает файлы по просьбе модели. Нужны Node.js с fetch, отдельный тестовый бот и установленная локальная модель. Первую половину курса можно пройти на офлайн-fixtures без Telegram-токена. Fixtures проверяют программу, но не доказывают настоящую доставку сообщений или скорость модели на вашем оборудовании.

Token не является текстом prompt

BotFather выдаёт token для управления ботом; создание или отзыв выполняет владелец отдельно. В курсе token не создаём и не публикуем. Храните настоящее значение в защищённом файле либо secret-manager, не в коде, screenshot или shell history. Bot API включает token в URL, поэтому необработанный fetch-error или debug-журнал может его раскрыть. Программа должна возвращать очищенный код ошибки, не полный URL. Если token попал в чужой доступ, удаление строки из Git не заменяет отзыв.

Сначала инъекция зависимостей

Разделите Telegram transport, проверку доступа, model adapter и обработку update на функции. Основной handler получает зависимости аргументами, поэтому тест подставляет фиктивную модель и send-функцию, только записывающую вызов в массив. В этом режиме сети нет вообще. Не маскируйте fixture под ответ настоящей модели: обозначьте её явно. Учебный набор файлов — policy.mjs, model.mjs, transport.mjs, worker.mjs и offline.test.mjs. Добавляйте постепенно; ранние модули не должны автоматически запускать polling при импорте в тест.

Практическое задание

Практика: Контракт бота и секреты

Перейти к обучению

Программа курса

  1. Контракт бота и секреты
  2. Allowlist до модели
  3. Адаптер локальной модели
  4. Bot API transport и long polling
  5. Состояние и неизвестная доставка
  6. Офлайн-тест и контролируемый запуск