Што такое Telegram-бот
Бот - гэта як супрацоўнік за стойкай: ён атрымлівае паведамленні і адказвае па правілах, якія вы яму задалі. Бот можа проста адказваць на каманды, а можа стаць агентам: падключыце да яго AI, і ён будзе разумець свабодныя запыты.
Крок 1. Стварыце бота ў BotFather
- У Telegram знайдзіце афіцыйнага бота @BotFather.
- Адпраўце каманду
/newbot. - Прыдумайце імя бота і яго username (ён павінен заканчвацца на
bot). - BotFather пашле токен - доўгі радок. Гэта пароль вашага бота: нікому яго не паказвайце і не ўстаўляйце ў чаты.
Крок 2. Захавайце токен бяспечна
Токен кладзём у файл .env у тэчцы праекта, а гэты файл дадаём у .gitignore, каб ён не трапіў у GitHub. Калі вы ўсё ж паказалі токен, у BotFather абярыце бота і перавыпусціце токен: стары перастане працаваць.
Крок 3. Няхай AI збярэ бота
Я нятэхнічны чалавек. Дапамажы сабраць майго першага Telegram-бота. Токен ляжыць у файле .env пад імём TELEGRAM_BOT_TOKEN. Бот павінен адказваць на каманду /start прывітаннем і паўтараць мае паведамленні. Тлумач кожны крок простымі словамі і дапамажы запусціць бота на маім кампутары.
Крок 4. Праверце
Запусціце бота на сваім кампутары, знайдзіце яго ў Telegram і напішыце /start. Калі ён адказаў, у вас атрымаўся першы бот.
Крок 5. Зрабіце бота агентам
Каб бот разумеў свабодныя запыты, падключаем AI праз ключ доступу (API-ключ). Ключ - гэта сакрэт і грошы: за выкарыстанне AI спаганяецца плата, таму ў асабістым кабінеце правайдара пастаўце ліміт выдаткаў. Папрасіце AI: "Падключы да бота Claude, ключ у .env як ANTHROPIC_API_KEY, і зрабі так, каб бот адказваў на пытанні па [вашай тэме]".
Крок 6. Зрабіце бота бяспечным
- Абмяжуйце бота: няхай адказвае толькі вам (па вашым Telegram ID) або вашай камандзе.
- Не прымайце і не перасылайце ў бота даныя кліентаў і камерцыйную тайну.
- Токен і ключы толькі ў абароненым файле або ў наладах хостынгу.
Крок 7. Куды выкласці
Пакуль бот працуе на вашым кампутары, ён адказвае толькі тады, калі кампутар уключаны. Каб ён працаваў заўсёды, яго выкладаюць на хостынг або на свой сервер (гл. гайд "Як купіць свой сервер і выкочваць на яго свае працы").
Зробім гэта разам, крок за крокам
На сустрэчах праграмы мы праходзім гэтыя крокі разам: вы не застанецеся адны з тэрміналам. Не ўпэўненыя, ці падыходзіць фармат? Запішыцеся на бясплатны 15-хвілінны званок.