Интеграция с Pastukhov Agent

Research Agent управляет Pastukhov Agent и тесно интегрирован с ним на уровне интерфейса: чаты агента, запуск задач и правка документов видны в том же окне, где живут исследования, — без десятка вкладок браузера.

Включение интеграции

Задайте переменные AGENT_API_URL и AGENT_API_KEY — обе вместе: URL вашего экземпляра Pastukhov Agent и его API-ключ. Без них функции интеграции скрыты и в интерфейсе не появляются.

Один помощник — несколько приложений. Research Agent не требует собственных ключей LLM и своих подписок: он работает через вашего Pastukhov Agent, который уже настроен — со своими моделями, навыками, хуками и проверками. Тот же агент может одновременно обслуживать и Analytics Agent, и другие приложения: вы управляете моделями и ключами один раз в центре, а все приложения пользуются ими автоматически.

Раздел Chats

Список чатов агента с фильтрацией и постраничной выдачей, статусы обработки, прогресс и итоги по каждому чату. События транслируются в реальном времени через SignalR-мост: новое сообщение, смена статуса, таймеры и очередь сообщений чата обновляются на экране без перезагрузки. Сам чат открывается в выдвижной панели поверх списка.

Рядом с каждым сообщением — счётчик расхода: сколько «порций текста» (токенов) потрачено, сколько это стоит и с какой скоростью идёт обработка; подробная разбивка появляется по наведению. Статусы инструментов показываются по-русски — Читаю, Создаю, Ищу, Исполняю, Запускаю подагента… — и видно, чем агент занят прямо сейчас. У чата выбираются модель и навык, как у самого агента; после перезагрузки страницы состояние чата — заголовок, таймер, статус — восстанавливается. Изображения и файлы вставляются в сообщение прямо из буфера обмена.

Очередь промптов

Промпт — это просто текстовое задание агенту. Очередь промптов позволяет заранее набросать список таких заданий: агент сам отправит их по очереди, без ручной отправки каждого. Очередь одна на всех — ею пользуются и Research Agent, и интерфейс самого Pastukhov Agent, так что одни и те же строки видны и там, и там. Кнопка промптов стоит в правой части поля ввода сообщения в чате. Подробнее — в разделе Очередь промптов.

Голосовой ввод

Задание агенту можно надиктовать, а не печатать: в поле ввода сообщения есть кнопка микрофона. Распознанная речь появляется в сообщении текстом и уходит агенту как обычное сообщение. Подробнее — в разделе Голосовой ввод.

Мост событий

AgentBridgeService ретранслирует события агента в интерфейс: structuredEvent, messageUpdate, processingStateUpdate, timerUpdate, queueStatusUpdate и другие. queueStatusUpdate относится к очереди сообщений отдельного чата — это не очередь промптов, а сообщения, которые ждут обработки внутри чата. При обрыве связи мост переподключается автоматически — live-картина восстанавливается сама.

«Вызвать агента» из документа

На странице любого исследования кнопка ИИ открывает drawer с промптом. При отправке промпт уходит в Pastukhov Agent ({AGENT_API_URL}/api/remote/chats), в него подставляется путь к документу — плейсхолдеры [path] и [url] резолвятся сервером. Окружение исполнения (например, prod или staging) выбирается из /data/environments.txt; готовый чат открывается из интерфейса.

Обратное направление: agent API

Интеграция двусторонняя. Переменная RESEARCH_AGENT_API_KEY включает машинный интерфейс /api/agent/* для внешних агентов — включая Pastukhov Agent из другого проекта. Доступные команды: /api/agent/search (поиск), /api/agent/fetch (скачивание), /api/agent/extract (извлечение) — а также сессии и контентные API (chunk, links, markdown/clean, telegram/verify). Аутентификация — заголовок X-API-Key с тем же значением; без переменной API возвращает 503.

Статус agent API (включён/выключен, сам ключ не показывается) виден в Settings → Agent API.

← Оглавление документации