К содержанию статьи

Telegram-бот по базе знаний отвечает на вопросы из документов, которые вы выбрали: инструкций, регламентов, описаний продукта. Участнику группы не нужно искать файл и угадывать, в каком разделе написано правило. Он задаёт вопрос боту и проверяет ответ по источнику.

В этой инструкции подключим своего бота к Pragmaticus и настроим ответы в Telegram-группе. Программировать и разворачивать отдельный сервер не потребуется. Для настройки в кабинете нужна роль администратора или владельца организации. Этот канал работает в группах: личная переписка с ботом для ответов по базе знаний не поддерживается.

Как бот находит ответ

Вопрос участника превращается в поисковый запрос по выбранным проектам. Система находит подходящие фрагменты документов и передаёт их языковой модели. Модель составляет ответ и указывает источники. Этот подход называется RAG; механизм подробно разобран в статье «Что такое RAG-система».

База не становится достовернее только потому, что к ней подключили ИИ. Если сроки в двух инструкциях различаются, бот может опереться на неподходящую версию. Поэтому сначала стоит проверить материалы, а затем подключать участников.

Разберём на примере

Один вопрос. Ответ из вашей инструкции.

Учебная схема, не настоящий чат. Все материалы и ответы ниже приведены для примера.

  1. Вопрос в группе

    «Куда отправить заявку на доступ?»

    Участник упоминает бота
  2. Нужный фрагмент

    Инструкция: «Заявки на доступ направляются через форму IT-поддержки».

    Поиск в разрешённых документах
  3. Ответ с источником

    «Отправьте заявку через форму IT-поддержки». Источник: инструкция по доступам.

    Участник проверяет основание

Вопрос → поиск → ответ с источником.

Шаг 1. Подготовьте небольшой проект с документами

Начните с одного понятного сценария: ответы сотрудникам по внутренним инструкциям или консультации партнёрам по продукту. Не смешивайте их в первом пилоте: у этих аудиторий разные вопросы и права доступа.

  1. Создайте проект в кабинете Pragmaticus.
  2. Загрузите действующие документы. Подойдут PDF, DOCX, Markdown и другие поддерживаемые форматы.
  3. Дождитесь завершения обработки. Откройте извлечённый текст и убедитесь, что ключевые правила, числа и таблицы сохранились.
  4. Задайте несколько вопросов в чате кабинета и проверьте источники.

Например, для группы партнёров достаточно начать с условий сотрудничества, описания продукта и инструкции по типовым вопросам. Закрытые коммерческие условия другого отдела добавлять не нужно. Принципы подготовки материалов собраны в чек-листе базы знаний для ИИ.

Шаг 2. Создайте своего бота через BotFather

Откройте официального BotFather, отправьте /newbot и следуйте его подсказкам. Вы получите токен: он позволяет сервису работать от имени созданного бота. Храните его как пароль, не отправляйте в группу и не публикуйте в документах базы знаний.

Для работы с контекстом группы отключите Privacy Mode: отправьте BotFather /setprivacy, выберите бота и значение Disable. Если изменение не вступило в силу в уже подключённой группе, удалите бота из неё и добавьте снова. Правила видимости сообщений описаны в документации Telegram. Участникам группы следует объяснить, что бот получает сообщения для обработки.

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

Шаг 3. Подключите токен в Pragmaticus

В кабинете откройте «Внешние каналы», затем вкладку «Telegram». В поле «Токен бота» вставьте значение от BotFather и нажмите «Сохранить бота».

После сохранения полный токен больше не отображается. Здесь подключается бот вашей организации; добавление в конкретную группу выполняется следующим шагом.

Шаг 4. Свяжите группу с организацией

  1. Добавьте созданного бота в нужную Telegram-группу.
  2. В кабинете нажмите «Выпустить /connect».
  3. Скопируйте команду с одноразовым токеном и отправьте её в эту группу.
  4. Дождитесь сообщения о подключении. Группа появится в кабинете.

Токен подключения показывается один раз и отличается от токена BotFather. Первый связывает группу с организацией, второй даёт сервису доступ к самому боту. Если у вас несколько рабочих групп, подключайте и настраивайте каждую отдельно.

Шаг 5. Выберите знания и права группы

Откройте подключённую группу и настройте основные поля:

Настройка Что проверить перед запуском
Коллекции Выбраны проекты, по которым бот должен искать. Без них базы для ответов нет
Уровень доступа поиска Группе разрешены только подходящие документы
Кто может спрашивать Вопросы разрешены всем участникам или только выбранным людям
Контекст Число последних сообщений соответствует задачам группы
Дополнительные инструкции Заданы тон и контакты сотрудника для сложных вопросов

Для сохранения знаний из переписки отдельно настройте список пользователей с правом записи, обозначенный в интерфейсе как Write allowlist. Пустой список означает, что сохранять документы не может никто. Разрешение задавать вопросы не означает разрешения записывать данные в базу.

Шаг 6. Проверьте ответы в группе

Упомяните бота: @my_company_bot где описан порядок возврата? Также можно ответить на его сообщение. Проверьте не только удобный вопрос с очевидным ответом, но и границы поведения:

Не публикуйте бота сразу в большой группе. Сначала проверьте его с несколькими коллегами на действующих инструкциях, исправьте пробелы и только потом расширяйте аудиторию.

Как сохранять договорённости из переписки

Участник с правом записи может написать «запомни» или «сохрани». Бот предложит черновик из последних сообщений. Проверьте текст; при недостатке контекста доступна кнопка «Больше контекста (+50)». Затем нажмите «В базу», выберите коллекцию и уровень доступа.

Это отдельное действие с подтверждением, а не автоматическое сохранение всей переписки. Для структурированных протоколов с решениями и задачами есть другой сценарий: ИИ-секретарь для Telegram.

Частые вопросы

Почему бот не отвечает без упоминания?

Канал предназначен для вопросов по упоминанию бота или в ответ на его сообщение. Проверьте этот способ обращения, выбранные коллекции и разрешение участнику задавать вопросы.

Можно ли сделать поддержку в личных сообщениях?

В описанном подключении Pragmaticus ответы по базе знаний работают в группах. Если нужен публичный канал для посетителей, рассмотрите консультанта на сайте.

Где смотреть стоимость?

Расходы конкретной группы видны в блоке «Списания» на её странице. Бюджет зависит от модели, объёма контекста и числа вопросов; порядок расчёта разобран в статье о стоимости ИИ-ассистента.

Что делать после изменения инструкции?

Обновите материал в проекте, уберите противоречащие версии и повторите вопросы, которых касается изменение. Проверять нужно и текст ответа, и источник.

С чего начать

Выберите одну рабочую группу и один набор актуальных инструкций. В Pragmaticus сначала проверьте ответы по этим документам, затем подключите своего Telegram-бота и повторите проверку вместе с коллегами. Так будет видно, какие вопросы уже закрывает база, а какие требуют новых материалов.

Ещё статьи