Раздел «Агент» — интеграция с Pastukhov Agent: внутри Telegram Agent появляется чат с помощником, которому можно поручить «займись каналом», «разбери очередь», «посмотри источники» — обычным языком. Без настройки все поверхности чата скрыты, а остальной продукт работает как обычно.
Настройка
Достаточно двух переменных окружения при запуске: AGENT_API_URL — адрес вашего Pastukhov Agent и AGENT_API_KEY — его API-ключ. После этого появляются кнопки «Вызвать агента» и панель чата. Как задать переменные — в разделе Установка.
Где вызывать
Кнопки «Вызвать агента» есть на странице канала, в очереди канала и в проектах комментирования. В промпт автоматически подставляется контекст — название канала и его @имя — так что агенту не нужно угадывать, о каком канале речь.
Чаты
Список чатов с фильтром: поиск по названию или по метке плюс отбор «С метками», «Без меток» или по конкретной метке. У каждого чата в строке — метка, время последнего обновления, длительность обработки, число сообщений, скорость сообщений и токенов в секунду, стоимость, число правок файлов, окружение и навык. Новые чаты появляются в списке сами, в реальном времени: активный чат показывает «обработка» и счётчики, работающий — кнопку остановки. Тот же список с тем же фильтром открывает кнопка «Чаты» внизу боковой панели — чужие разделы покидать не нужно.
Метки чатов — свои пометки, чтобы нужный диалог не потерялся среди сотен: у метки есть название, значок и цвет. Метка ставится прямо в шапке открытого чата и в строке списка, меняется сразу во всех открытых вкладках, а чат при этом не «прыгает» вверх в списке. Управление метками — «Управление метками чатов»: здесь метки создаются, переименовываются и удаляются; при удалении приложение подскажет, сколько чатов останется без метки.
Панель чата
Чат открывается панелью внизу экрана. Сообщения агента — в Markdown, вызовы инструментов — компактными карточками: правки файлов с различиями, списки задач; у текущей задачи — закреплённая панель. Сообщения, ожидающие очереди работающего чата, показаны однострочными строками над полем ввода (приостановленные — цветом предупреждения): их можно править, ставить на паузу или убрать. Прямо в панели — итоговые счётчики токенов и стоимости, а отправленное сообщение появляется на экране сразу, не дожидаясь ответа сервера.
Голосовой ввод
Задание агенту можно не печатать, а наговорить: в поле ввода есть кнопка микрофона — она появляется, когда распознавание речи включено в настройках вашего Pastukhov Agent. Кнопка работает и в панели чата, и в строках очереди промптов. Речь распознаётся и вставляется в поле туда, где вы печатали, — остаётся поправить и отправить. Подробнее — в разделе Голосовой ввод.
Файлы в сообщениях
Прямо в поле ввода можно вставить содержимое буфера обмена — кнопкой вставки на компьютере или сочетанием Ctrl+V. Скриншот, картинка или файл загружаются в папку проекта, а в текст сообщения подставляется путь к ним: агенту понятно, о каком файле речь, и он может его открыть или поправить. Текст из буфера вставляется туда, где стоит курсор. На телефоне вместо кнопки вставки — скрепка: она открывает выбор файлов. Слишком большой файл или неподходящий тип не загрузятся — приложение скажет, в чём дело. Это выручает, когда нужный документ лежит у вас на компьютере, а не в проекте: не нужно сначала переносить его руками.
Промпты и автоотправка
Кнопка «Промпты» внизу боковой панели открывает общий список заданий: строки «текст + окружение + навык», которые можно заготовить заранее. Задания уходят по одному — сначала самые нижние, то есть самые старые; отправленная строка исчезает из списка. Это способ поставить агенту серию задач и заняться другими делами.
Можно включить автоматическую отправку — и очередь поедет сама: приложение запускает задания одно за другим, а вы занимаетесь другими делами. В настройках автоотправки задаётся, сколько чатов работают одновременно и как часто проверять очередь; там же — тонкости для тех, кто ставит задания пакетами: сохранять ли изменения проекта перед отправкой задания, приостанавливать ли автоисправление до конца очереди, отправлять ли в часы пиковых нагрузок и переходить ли к запущенному чату. Пустые строки не отправляются — они удаляются, а когда очередь заканчивается, автоотправка выключается сама.
Навыки и окружения
При создании чата можно выбрать навык (скилл) из списка агента — набор инструкций для специализированной работы — и окружение (модель). Выбор запоминается и становится значением по умолчанию для следующих чатов. Навык честно показывается у чата, под которым он создан.
Звуки и фон
Пока чат работает в фоне, приходят звуки: новое сообщение, ошибка, завершение. Сводка активных чатов — с таймером и стоимостью — живёт на главной и страницах каналов: её можно свернуть в одну кнопку с итогами. Тихий режим выключает звуки.
Лицензия
Отправка сообщений и ответов на вопросы агента требует действующей лицензии — без неё приложение предложит ввести ключ (голосовой ввод и вставка файлов упираются в то же ограничение — это тоже отправка в чат). Ключ активируется в диалоге лицензии, и в нём видно, какие продукты он покрывает. Всё остальное в продукте — каналы, публикации, расписание, очередь, источники, комментарии, аналитика — работает и без лицензии. Важное преимущество: чат — единственное, что закрыто лицензией. Подробнее — на странице Лицензирование.
Внешний API (v1)
Все разделы продукта доступны и для скриптов и интеграций: каналы, боты, аккаунты, источники, очередь, сообщения, авторы, комментарии, расписание и аналитика. API-ключи создаются в настройках — полный ключ показывается один раз, дальше только его начало; отозвать ключ можно в любой момент, и он перестанет работать сразу. Интерактивная документация со всеми командами открывается по ссылке из настроек и позволяет пробовать запросы прямо в браузере. Ошибки API приходят с кодом, понятным текстом и подсказкой, что исправить.
Что дальше
О самом Pastukhov Agent — его возможностях и установке — читайте в разделе Pastukhov Agent на этом сайте. Как развернуть Telegram Agent вместе с интеграцией — в разделе Установка.