ИИ-агент для телеграм помогает выполнять поручения из рабочего чата: модель предлагает действие, а сервер проверяет права, вызывает разрешённый инструмент и записывает результат в журнал. Здесь разобран текстовый сценарий с вызовом инструментов и проверкой прав; голосовые сообщения и сценарии на конструкторах рассмотрены в отдельных материалах. Контур работает, когда список инструментов и допуски описаны заранее.
Чем отличается от бота
Начните с поручения, результат которого можно проверить: получить статус заявки или подготовить черновик задачи. Время и качество выполнения измерьте на собственном рабочем потоке вместе с проверкой человеком.
Бот может работать по заранее заданным сценариям. В описанном здесь варианте модель выбирает инструмент по смыслу поручения, а сервер проверяет допустимость вызова. Модель разбирает поручение и предлагает инструмент; действие выполняет сервер после проверки прав, а результат возвращается в чат. Близкая механика «сообщение превращается в задачу» разобрана в статье про бота для задач — здесь же фокус на вызове инструментов и допуске.
Голосовые сообщения и их распознавание — соседняя связка со своими ограничениями, она разобрана в материале про голосового бота в телеграм. Сценарии на webhook-конструкторах решают другую задачу: там ветвление задают правилами, здесь модель предлагает инструмент из разрешённого списка. Наш контур текстовый: сотрудник пишет поручение обычным сообщением, агент действует в рамках допуска.
- Решает сам, какой инструмент вызвать под конкретное поручение.
- Сервер сопоставляет Telegram ID с учётной записью сотрудника и проверяет его права перед действием.
- Спрашивает подтверждение на шагах с последствиями.
- Пишет журнал: поручение, решение, инструмент, результат.
Чтобы отделять поручения от обсуждения, задайте явный формат команды или запросите подтверждение распознанного действия. «Напомни клиенту из сделки про счёт до пятницы» — это поручение; «как думаешь, стоит ли писать клиенту?» — вопрос, на который агент отвечает советом, без вызова инструментов. Промпт помогает разобрать формулировку, но проверку чата, пользователя, параметров и подтверждения выполняет сервер.
Из чего собран контур
Контур собирается из четырёх частей. Первая — слушатель обновлений чата: он получает доступные боту обновления через Bot API, отбирает разрешённые чаты и только затем передаёт поручение модели. Вторая — модель через API с системным промптом: она распознаёт поручение и выбирает инструмент. Третья — реестр инструментов: задачи в трекере, запросы к CRM, черновики писем, каждый со своим допуском. Четвёртая — журнал действий, куда пишется всё, что агент решил и сделал.
В системном промпте описывают доступные инструменты, случаи подтверждения и порядок ответа при нехватке данных. Эти ограничения дополнительно закрепляют в серверном коде. Модели передают описания доступных инструментов и их параметров. Сервер всё равно сверяет выбранный вызов со списком разрешений и проверяет аргументы. При подключении нового инструмента обновляют описание, серверную проверку прав, журнал и тесты подтверждения.
- Слушатель: сервер проверяет ID чата и пользователя; сообщения из других чатов прекращает обрабатывать.
- Модель: вызов API вашим ключом, расход запросов учитывайте по данным API и своему журналу.
- Инструменты: у каждого список разрешённых параметров и границы применения.
- Журнал: хранится в вашей инфраструктуре, доступ у владельца контура.
Допуски стоит дробить по уровням. Первый — чтение: сводки и статусы доступны только сотрудникам с правом чтения соответствующих данных. Второй — запись внутрь: задачи в трекере и черновики писем сотрудникам. Третий — действия наружу: письма клиентам, выгрузки контактов, изменения в CRM. Чем выше уровень, тем жёстче подтверждение и тем короче список разрешённых параметров.
Запуск за шесть шагов
- Выберите модель через API после проверки качества разбора русских поручений, формата вызова инструментов и условий обработки данных.
- Опишите инструменты. Для каждого — название, назначение, параметры и допуск: кто и в каких пределах может им пользоваться.
- Опишите в системном промпте доступные инструменты, порядок ответов и случаи запроса уточнения. Правила прав и подтверждений закрепите на сервере.
- Подключите слушатель чата. Настройте получение обновлений бота и серверный список разрешённых ID чатов. Учитывайте режим приватности Telegram: в группе бот может получать лишь сообщения, адресованные ему; личные обращения отсеивайте на сервере.
- Включите подтверждения. Для действий с последствиями сервер сначала сохраняет черновик и показывает его уполномоченному сотруднику. При нажатии кнопки проверьте ID подтвердившего, срок действия запроса и неизменность параметров.
- Заведите журнал и порядок разбора. По согласованному графику владелец проверяет ошибочные вызовы, возвраты и правила доступа.
Первый контур запускают на одном типе поручений — например, напоминания клиентам о счёте. Подключайте следующий тип поручения после проверки прав, журнала и сценариев отказа на первом.
Чем короче список инструментов на старте, тем раньше агент выходит на предсказуемое поведение — и тем спокойнее отдел принимает нового «коллегу».
Какие поручения в вашем чате повторяются чаще всего?
Подтверждение действий
| Действие агента | Когда спрашиваем подтверждение | Кто подтверждает |
|---|---|---|
| Черновик письма клиенту | Всегда перед отправкой | Руководитель отдела продаж |
| Задача в трекере | При смене сроков или ответственного | Автор поручения |
| Выгрузка из CRM | При передаче контактов наружу | Владелец базы |
| Сводка по проекту | Только чтение, подтверждение излишне | Без подтверждения |
Для подтверждения можно использовать кнопку в чате: сервер показывает конкретное действие и параметры, а затем проверяет, кто нажал кнопку. При истечении срока подтверждения сервер прекращает выполнение и отмечает запрос в журнале.
Подтверждение должно относиться к конкретному действию с показанными параметрами. Право разрешить действие остаётся у человека. из регламента допуска агента
Если ответственный молчит, поручение живёт по таймеру: сначала напоминание в чат, потом передача заместителю из списка, и лишь затем возврат в очередь с пометкой «без подтверждения». Самостоятельного выполнения тут нет — таймер эскалирует, а право решать сохраняется за людьми.
Допуск и журнал
Начните с одного рабочего чата и двух инструментов: напоминание о счёте и создание задачи в трекере. Метрика первого месяца — доля поручений, закрытых без возврата. Типичная ошибка — выдать агенту право менять допуски самому: перечень инструментов пополняет только владелец контура.
Журнал — та часть, которая превращает агента из игрушки в управляемую систему. Каждая запись содержит поручение дословно, выбор модели, вызванный инструмент с параметрами, подтверждение и результат. По журналу видно, где агент справляется уверенно, а какие решения возвращают чаще всего, — именно эти точки разбирают в первую очередь.
Разбор журнала превращается в регулярную настройку: владелец смотрит возвраты и уточняет описания инструментов, добавляет правила в системный промпт, переносит спорные действия на уровень выше с подтверждением. После каждой правки повторяйте тесты на разрешённые и запрещённые действия. Журнал помогает найти повторяющиеся сбои и уточнить правила.
Затраты складываются из запросов к модели, работы сервера и времени владельца контура. Условия тарификации зависят от выбранного провайдера и меняются. Оценивайте стоимость по фактическому числу запросов, объёму сообщений и времени сопровождения. Смету под ваш набор инструментов и требования к безопасности считаем после бесплатного Discovery-часа: логику цены и состав работ описываем на странице про ИИ-агентов для бизнеса.