Первый бот за 5 минут

Эта статья — короткий маршрут «от нуля до работающего бота». Пройдёте 4 шага и получите Telegram-бота, который отвечает клиентам на основе ваших материалов. На каждом шаге есть ссылка на подробную статью, если захотите разобраться глубже.

В платформе есть два ключевых понятия:

• Агент — это «мозг» бота: какая AI-модель используется, как агент себя ведёт и какая у него база знаний.
• Бот — это канал, через который клиент пишет (Telegram, MAX). Бот подключается к агенту: клиент пишет в Telegram, а отвечает агент.

Поэтому порядок всегда такой: сначала создаём агента → наполняем его знаниями → потом подключаем к нему бота.

Что понадобится заранее: доступ в дашборд и аккаунт в Telegram, чтобы создать бота через @BotFather (это бесплатно и занимает минуту).

Шаг 1. Создайте агента

1. В левом меню откройте раздел AI Platform → Агенты.

2. Нажмите кнопку «Создать агента» в правом верхнем углу.

3. Заполните форму:

   • Название агента — обязательное поле. Например, «Консультант Алгоритмика». Это внутреннее имя, клиенты его не видят.
   • Описание — необязательно, для себя (чтобы потом не путать агентов).

4. Выберите языковую модель. Доступно два варианта:

   • GigaChat (💬) — русский язык, быстро. Хороший выбор по умолчанию для большинства школ.
   • OpenAI GPT (🤖) — мощный, многоязычный.

   После выбора провайдера ниже появится список конкретных моделей — можно оставить модель по умолчанию.

5. Нажмите «Создать агента».

После создания платформа автоматически перенесёт вас на страницу настроек агента — на этом шаге её можно просто пропустить и идти дальше. Поведение бота (системный промпт, инструкции) настраивается позже, когда базовый бот уже заработает.

[скриншот: форма «Создать агента» с заполненным названием и выбранной моделью GigaChat]

Подробнее про все параметры агента, температуру и выбор модели — в статье «Создание и настройка агента».

Шаг 2. Загрузите базу знаний

База знаний — это документы и сайты, по которым агент отвечает. Без неё бот будет отвечать общими фразами; с ней — конкретикой по вашей школе: курсы, цены, расписание, условия.

Важно: документы загружаются на странице конкретного агента, а не в общем разделе «База знаний» (тот раздел — только просмотр всех документов сразу).

1. Откройте раздел AI Platform → Агенты и кликните по карточке только что созданного агента.
2. Прокрутите до блока «База знаний».
3. Загрузите материалы одним из способов:
   • Файлы. Перетащите файлы в пунктирную область («Перетащите файлы или нажмите для выбора») или нажмите на неё и выберите файлы вручную. Поддерживаются PDF, DOCX, HTML — до 50 МБ, до 20 файлов за раз.
   • Сайт. Нажмите кнопку «URL», вставьте адрес страницы (например, https://вашшкола.ru/kursy) и нажмите «Добавить» — платформа сама прочитает и проиндексирует страницу.
4. Дождитесь обработки. У каждого документа есть статус:

Когда статус стал «Готов» — знания подключены. В блоке статистики вверху страницы вы увидите, как растёт число документов и векторов.

[скриншот: блок «База знаний» на странице агента с областью загрузки и одним документом в статусе «Готов»]

Подробнее про форматы, переиндексацию и работу с источниками — в статье «База знаний: загрузка документов и сайтов».

Шаг 3. Подключите Telegram-бота

Сначала создайте бота в Telegram, затем привяжите его к агенту.

Создайте бота в Telegram

1. Откройте в Telegram чат с @BotFather.
2. Отправьте команду /newbot.
3. Следуйте подсказкам: придумайте имя и адрес бота.
4. BotFather пришлёт вам токен — длинную строку вида 123456789:ABC-DEF.... Скопируйте её.

Привяжите бота к агенту

1. В левом меню откройте раздел Communication → Боты. Убедитесь, что выбрана вкладка Telegram.
2. Нажмите «Подключить бота».
3. В открывшейся форме:
   • Токен бота — вставьте токен от BotFather.
   • Агент — выберите в выпадающем списке агента, которого создали на шаге 1.
4. Нажмите «Подключить».

Если токен верный, бот появится в списке с галочкой «Активен» и именем агента под ним. Платформа сама настроит приём сообщений — больше ничего делать не нужно.

[скриншот: форма «Подключить нового бота» с полем токена и выпадающим списком агента]

Подробнее про управление ботами, кнопку «Обновить webhooks» и подключение MAX — в статье «Подключение Telegram- и MAX-бота».

Шаг 4. Проверьте бота

1. В списке ботов нажмите на значок внешней ссылки рядом с именем бота (@имя_бота) — откроется чат с ним в Telegram. Либо найдите бота в Telegram по его адресу.
2. Нажмите Start (или напишите «Привет»).
3. Задайте вопрос, ответ на который точно есть в загруженных документах — например, «Сколько стоит курс по программированию?» или «Какие у вас есть курсы для детей 10 лет?».
4. Убедитесь, что бот отвечает по делу и опирается на ваши материалы.

[скриншот: переписка с ботом в Telegram — клиент задаёт вопрос, бот отвечает конкретикой из базы знаний]

Если бот не отвечает или отвечает «не по теме»

• Проверьте статус документов. Зайдите на страницу агента — все нужные документы должны быть в статусе «Готов». Если «Ошибка» — наведите на документ и прочитайте причину, при необходимости загрузите файл заново.
• Проверьте, что бот активен. В разделе Боты у бота должен стоять бейдж «Активен», а под ним — правильное имя агента.
• Проверьте, что агент включён. На странице агента статус должен быть «Активен». Если «Отключён» — нажмите кнопку «Включить».
• Обновите подключение. Если сообщения не доходят, на странице Боты нажмите «Обновить webhooks» — это пересоздаёт связь с Telegram.

Что дальше

Базовый бот готов и отвечает клиентам. Дальше платформа позволяет сделать его умнее и полезнее:

• Настроить поведение — тон общения, приветствие, правила (раздел AI Platform → Поведение).
• Передавать лиды в amoCRM — чтобы заявки из чатов автоматически попадали в вашу воронку.
• Подключить другие каналы — MAX, VK.
• Смотреть аналитику и чаты — какие вопросы задают клиенты и как отвечает бот.

Каждая из этих тем разобрана в отдельных статьях документации.