Контракт бота й секрети
Контракт бота й секрети — 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 при імпорті.
Практичне завдання
Практика: Контракт бота й секрети
Перейти до навчання