Все ноды/Integrations/Telegram

Telegram: инструменты агента

Инструмент для ИИ-агента: единый доступ к Telegram-чату — чтение (история/поиск/инфо), модерация (delete/ban/mute/pin) и управление (название/инвайты/заявки). Каждое действие включается отдельно в поле «Разрешённые действия»; список инструментов, который видит модель, фильтруется по типу текущего чата. Чат фиксируется конфигом или берётся из запуска — модель НЕ выбирает его. Есть dry_run и потолок длительности бана/мьюта. promote/demote недоступны принципиально. Использует бота, на которого опубликован сценарий; чтобы взять другого бота через порт «Подключение Telegram», переключите «Источник подключения» на «Внешнее подключение». Для модерации и управления боту нужны права администратора. Подключается ко входу «Расширения агента» ИИ-агента.

Как попробовать

Как применять

Эта нода даёт ИИ-агенту одну ограниченную дверь в Telegram-чат: чтение (история, поиск, информация о чате), модерация (удалить, забанить, замьютить, закрепить) и администрирование (название, инвайты, заявки). Берите её, когда решение принимает модель — «разберись с жалобой», «подведи итог обсуждения». Когда решение принимает граф, дешевле и предсказуемее обычные ноды-действия: Модерация, История группы, Управление чатом.

Как это работает

Нода — не шаг исполнения, а спутник: соедините её выход tool_out со входом extensions агента. Модель видит только действия, отмеченные в «Разрешённых действиях» (по умолчанию — одни чтения), и список дополнительно сужается под тип текущего чата: мьют предлагается только в супергруппе, статус «печатает…» — не в канале.

Чат моделью не выбирается никогда: он берётся из поля «Ограничить чатом» или из текущего Telegram-хода. Выдача админ-прав не предлагается вообще. Каждое реальное действие модерации пишет запись в журнал аудита, а «Пробный прогон» и «Макс. срок бана/мьюта» ограничивают то, что модель успеет сделать.

Частые ошибки

• Разрешить действие мало. Модерации и администрированию нужны права администратора у бота, а чтению истории и поиску — включённая запись истории группы. Без них модель получит отказ и будет извиняться в чате.
• Ошибки не роняют ран. Инструмент возвращает модели текст «Error: …», ран остаётся зелёным. Если агент «отказался», смотрите ход диалога в журнале запуска, а не статус.
• Фильтр по типу чата — это подсказка, а не гарантия. Тип определяется по записанной истории; если записей нет, фильтрация не срабатывает и модель может вызвать действие, которое Telegram здесь отвергнет.
• Запуск не из Telegram. С пустым «Ограничить чатом» чата неоткуда взять, и любой вызов вернёт ошибку. Для веб-чата или расписания задайте чат явно.
• Инъекция через сообщение группы. Сообщение участника — это текст, который читает модель, и он может содержать просьбу кого-нибудь забанить. Включайте только нужные действия, держите потолок длительности и на отладке — «Пробный прогон».
• Потолок 0 разрешает вечный бан. Значение по умолчанию — сутки.

Входы

Выходы

Настройки