- 26
- Типов шагов в потоке
- 7
- Переиспользуемых браузерных агентов
- 1
- Эндпоинт n8n, 3 режима выполнения
Технологии
- Node.js
- Express
- Playwright
- Alpine.js
- n8n
- Server-Sent Events
- ngrok
Задача
Многошаговые браузерные автоматизации — войти, найти, выполнить действие, подтвердить и так далее — трудно компоновать, переиспользовать и запускать из других инструментов. Когда каждая кампания пишется как разовый скрипт, нет ни переиспользования, ни прозрачности происходящего, ни удобного способа запустить её не-разработчику или оркестратору вроде n8n.
Подход
Я построил платформу на Node.js / Express и Playwright с визуальным конструктором потоков, предлагающим 26 типов шагов (переменные, условия, циклы, обработка ошибок, вложенные потоки), которые связывают семь переиспользуемых браузерных агентов. Любой агент можно встроить как шаг, а его результаты передаются в следующие шаги. Платформа предоставляет единый эндпоинт /n8n/execute с тремя режимами — сохранённый поток, встроенные шаги или устаревший конвейер агентов — плюс управление сессиями в памяти с TTL, встроенное управление туннелями для облачных триггеров и логи в реальном времени через Server-Sent Events.
Результаты
Переиспользуемые компонуемые автоматизации, которые не-разработчик может собрать визуально и запустить одним HTTP-запросом. Сессии сохраняются между шагами, поэтому многоэтапные потоки ведут себя как один связный запуск, а живой SSE-лог делает каждое выполнение наблюдаемым в реальном времени.
Инженерные решения
- Визуальный конструктор потоков с 26 типами шагов — переменные, условия, циклы, обработка ошибок, вложенные потоки и встроенные шаги-агенты.
- Семь переиспользуемых браузерных агентов, собираемых в сценарии; результаты каждого агента передаются в следующие шаги.
- Единый эндпоинт /n8n/execute с тремя режимами (сохранённый поток, встроенные шаги, устаревший конвейер) для внешнего запуска.
- Управление браузерными сессиями в памяти с TTL в 2 часа, общими для всех шагов потока.
- Встроенное управление туннелями (ngrok) для облачных триггеров и потоковая передача логов через Server-Sent Events.
Скриншоты и схемы
Реальные снимки интерфейса и графики — исходный код закрыт, бренды клиентов не показаны.
Подробный разбор
В основе — движок потоков, который рассматривает браузерных агентов как компонуемые строительные блоки. Поток — это упорядоченный граф типизированных шагов: управление выполнением (условия, циклы, обработка ошибок), данные (переменные), композиция (вложенные потоки) и шаги run_agent, вызывающие настоящего браузерного агента. Поскольку запущенная браузерная сессия разделяется между шагами и живёт по TTL, поток может один раз выполнить вход и использовать эту сессию до конца запуска — именно это делает возможными реалистичные многоэтапные автоматизации.
Интеграция была приоритетной задачей: единый эндпоинт /n8n/execute с тремя режимами позволяет оркестратору запустить сохранённый поток, передать шаги напрямую или откатиться к устаревшему конвейеру агентов, а встроенное управление туннелями открывает его для n8n Cloud без дополнительной инфраструктуры. Логи SSE в реальном времени передают каждый шаг в дашборд, чтобы операторы видели запуск по мере его выполнения.