Запись видео в agent-browser: как выбрать FPS

Запись видео в agent-browser: какой FPS выбрать

Начните с 30 fps. Теперь это значение по умолчанию: обычные клики, состояния при наведении, прокрутка, CSS-переходы и демонстрационные сценарии остаются разборчивыми, но не создают дополнительную нагрузку, характерную для 60 fps.

Допустимый диапазон --fps — от 1 до 60. Высокая частота кадров не всегда делает подтверждение убедительнее. Если страница перерисовывается реже заданной частоты, запрос 60 fps не создаст 60 действительно разных состояний страницы.

Что изменилось в v0.37.0

Теперь рекордер воспринимает видео как привязанное ко времени представление страницы, с которой вы действительно работаете. record start и record restart по умолчанию записывают текущую активную страницу с частотой 30 fps, принимают параметр --fps 1-60 и используют Page.startScreencast из Chrome. Это собственный поток перерисованных кадров Chrome — словно камера подключена напрямую к конвейеру отображения браузера, а не время от времени делает скриншоты.

В релизе v0.37.0 также ужесточили обработку ошибок. Если ffmpeg не найден, у выходного пути нет расширения или указан недопустимый параметр записи, команда завершается до изменения состояния браузера или записи. Если новый дубль не запускается, текущий остаётся сохранным. При переходе на другую страницу во время записи устаревшие ссылки на элементы и состояние фреймов теперь сбрасываются так же, как при обычной навигации.

Для реального цикла QA это существенно. Ошибка в пути к видео не должна незаметно менять тестируемую страницу, а запуск второго дубля не должен уничтожать первый, пока не ясно, что замена действительно записывается.

Надёжная запись видео за пять шагов

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

agent-browser doctor
agent-browser open https://app.example.com/login
agent-browser record start ./login-flow.mp4 --fps 30
agent-browser snapshot -i
agent-browser click @e1
agent-browser wait --url "**/dashboard"
agent-browser record stop

1. Сначала проверьте кодировщик. agent-browser doctor сообщает о наличии ffmpeg и доступных кодировщиках записи. Для MP4 нужен libx264, для WebM — libvpx. Стандартная сборка ffmpeg из Homebrew или репозиториев Debian/Ubuntu обычно включает оба.

2. Откройте нужную страницу в активной вкладке. Если не передавать URL в record start, рекордер подключится к активной странице в её текущем состоянии. Он не перезагрузит её, не откроет новую вкладку и не создаст чистый контекст браузера. Это удобно, когда ошибка зависит от уже загруженного приложения, авторизованной сессии или состояния внутри страницы. Если указать URL, активная вкладка сначала перейдёт по нему, а запись начнётся после загрузки страницы.

3. Выбирайте контейнер по расширению. .mp4 включает H.264 через libx264, а .webm — VP8 через libvpx. Другие расширения передаются ffmpeg с H.264 и сработают только в том случае, если ffmpeg поддерживает соответствующий контейнер. Имя файла без расширения отклоняется.

4. Оставьте проверку результата в автоматизации. В примере wait --url проверяет, открыл ли браузер панель управления. Ролик помогает человеку понять, что произошло, но не превращает пиксели в тестовое утверждение.

5. Остановите запись до закрытия. record stop сохраняет дубль, предварительно сбрасывая буфер. Если сначала закрыть сессию, нужного файла может не оказаться. Используйте record restart, когда требуется завершить один дубль и сразу начать следующий на активной странице.

capturedFrames и frames отвечают на разные вопросы

Считайте эти два счётчика исходным материалом и готовым видео. capturedFrames показывает количество уникальных кадров, созданных страницей. frames — количество кадров, записанных в видеофайл. Статичная страница может выдать совсем мало разных изображений, тогда как ffmpeg будет повторять кадры, чтобы ролик нормально воспроизводился.

У этой схемы есть важная особенность тайминга. Когда страница перестаёт меняться, последний кадр удерживается. Один статичный промежуток сохраняется не более пяти секунд, после чего оставшаяся неизменная часть пропускается. Поэтому короткие паузы в видео видны, а продолжительное бездействие сжимается. Не используйте длительность воспроизведения как секундомер для прогона на стабильность.

Низкое значение capturedFrames не обязательно означает сбой записи: возможно, страница просто оставалась неподвижной. По той же причине 60 fps стоит выбирать лишь для движения, которое действительно нужно рассмотреть. В руководстве по записи указано, что 60 fps примерно удваивает битрейт по сравнению с 30 fps, но количество уникальных кадров по-прежнему зависит от перерисовок страницы.

Какая строка бюджета меняется

Если команда уже использует agent-browser, для базовых видеоподтверждений больше не обязательно покупать ещё одно место в отдельном рекордере. Пакет v0.37.0 распространяется по лицензии Apache-2.0, поэтому у самого рекордера нет платы за пользователя. Дополнительные расходы связаны только с эксплуатацией: настройкой ffmpeg, временем CI, хранением артефактов и минутами, которые сотрудник тратит на просмотр результата.

Это заметно отличается от покупки полноценной платформы для обратной связи или тестирования. Jam Team стоит $14 за автора в месяц при годовой оплате. BugHerd Standard стоит $50 в месяц за пять участников при помесячной оплате и включает видеообратную связь. BrowserStack Automate предлагает один параллельный сеанс Chrome Desktop за $59 в месяц при годовой оплате и включает видеозаписи в набор инструментов отладки.

Эти продукты продают гораздо больше, чем одну запись, поэтому делать вывод об их полной замене неверно. BrowserStack предоставляет управляемую инфраструктуру с разными браузерами. BugHerd и Jam предлагают совместную работу, фиксацию проблем и интеграции. Практический вывод для бюджета гораздо уже: не стоит покупать второй слой захвата, если agent-browser уже выполняет сценарий, а не хватает лишь понятного видео.

Семь сценариев применения — от самого полезного

1. Продуктовые команды разбирают сбои в CI

Если тест входа или оформления заказа нестабилен, продуктовая команда может включить запись с частотой 30 fps непосредственно перед рискованным участком, сохранить проверки URL или элементов и при сбое оставить MP4 как артефакт CI. Инженер увидит баннер согласия, поздно появившееся перекрытие, скачок фокуса или переход, которые могли не попасть в текстовый лог. В результате меньше дорогостоящего времени инженеров уйдёт на попытки воссоздать периодически возникающее состояние.

2. Фронтенд-команды проверяют перетаскивание, прокрутку и анимацию

Фронтенд-инженер может выделить одно короткое взаимодействие, записать его с частотой 60 fps, а затем дополнить ролик скриншотами начального и конечного состояний. Видео покажет, было ли движение между этими состояниями плавным, а скриншоты сохранят точные пиксели. Такой подход окупается, когда дефект находится между двумя снимками: например, выпал кадр или перетаскиваемый объект пересёк целевую область не в тот момент.

3. Команды ИИ-продуктов проверяют поведение браузерного агента

Команда ИИ-продукта может записывать активную авторизованную страницу с частотой 30 fps, пока агент выполняет задачу, а затем приложить видео к журналу команд и проверкам агента. Так проверяющий отличит ошибочный план от ситуации, когда сама страница изменилась во время работы агента. Непрозрачный прогон превращается в свидетельство, которое менеджер продукта и инженер могут обсуждать вместе.

4. QA-инженеры воспроизводят ошибки, зависящие от состояния

QA-инженер может подготовить сессию до выполнения условий ошибки, а затем запустить record start без URL. Поскольку запись подключается на месте, страница не заменяется холодной навигацией. Это полезно, если ошибка зависит от накопленного состояния корзины, модального окна, авторизованного маршрута или другого условия, которое исчезает после перезагрузки.

5. Агентства передают релиз клиенту

Веб-агентство может записать приёмочный сценарий с частотой 30 fps, добавить короткие паузы в точках принятия решений и передать клиенту ролик, темп которого удобен человеку, а не механизму автоматизации. Клиент проверит точный маршрут без доступа к средству запуска тестов. Агентство потратит меньше времени на встречи, где иначе пришлось бы проговаривать уже показанный в артефакте сценарий.

6. Команды надёжности сохраняют таймлайны длительных прогонов

Инженер по надёжности может записывать длительный прогон на стабильность с частотой 10 fps, когда последовательность важнее плавности движения. По сравнению с 30 или 60 fps низкая частота сокращает нагрузку от записи и рост файла. Ролик всё ещё помогает найти видимый момент сбоя, однако статичные промежутки в нём сжимаются, поэтому временные метки нужно брать из логов, а не определять по длительности воспроизведения.

7. Инженеры поддержки эскалируют сложную проблему в браузере

Инженер поддержки может воспроизвести путь клиента в контролируемой учётной записи, записать его с частотой 30 fps, остановить запись и приложить её к эскалации. Команда разработки получит сведения о тайминге и неожиданных перекрытиях, которые часто теряются в письменной заявке. Это приносит пользу только тогда, когда процесс также не допускает попадания секретов и клиентских данных в запись.

Три продукта, которые стоит создать

Лучшая возможность: пакет подтверждений из прогона агента

Создайте небольшой сервис, который превращает один прогон браузерного агента в единый пакет для проверки: результат утверждения, журнал команд, итоговый скриншот, MP4, счётчики кадров и ссылку, опубликованную в Jira или Linear. Продуктовые и инженерные команды готовы платить за такой результат, потому что он встраивается в уже привычный процесс работы с задачами.

Спрос вполне конкретен. По данным о ключевых запросах в США, фразу “bug reporting tool” ищут около 590 раз в месяц, а её CPC составляет $43.80. Расходы на существующие решения тоже заметны: Jam Team стоит $14 за автора в месяц при годовой оплате, а BugHerd Standard — $50 в месяц при помесячной. Минимальная продаваемая версия потребует обёртки для agent-browser, хранилища артефактов, одной интеграции с трекером задач и контрольного списка для удаления чувствительных данных.

Это самая сильная возможность, потому что продаётся передача результата, а не кодек. Слабое место — невысокий технический порог для конкурентов. Публикацию в Jira и хранение видео легко скопировать, поэтому продукт должен особенно хорошо собирать надёжный контекст и не допускать утечки чувствительных данных.

QA-портал для передачи работы клиенту агентства

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

По данным о ключевых запросах в США, фразу “website qa testing” ищут 110 раз в месяц — это на 55% больше, чем годом ранее, а её CPC составляет $23.91. MVP может поддерживать несколько повторно используемых сценариев, запись с частотой 30 fps, комментарии и выбор между одобрением и отклонением. Главная сложность — зрелость конкурентов: тариф Standard у BugHerd уже включает неограниченное количество проектов, клиентских пользователей, скриншоты, метаданные и видеообратную связь. Новому продукту придётся выигрывать за счёт подтверждений, которые создаёт агент, а не очередных меток с комментариями.

Слой пресетов для тестирования движения

Создайте компактный CI-инструмент, который помечает тесты как timeline, default или motion, сопоставляет им 10, 30 или 60 fps и отмечает неожиданные расхождения между захваченными и записанными кадрами. Команды, отвечающие за фронтенд-платформу, будут платить за единообразные подтверждения регрессий анимации и взаимодействия.

По данным о ключевых запросах в США, фразу “automated browser testing” ищут 110 раз в месяц, а её CPC составляет $14.96. Более узкий коммерческий запрос “automated browser testing tools” набирает лишь 20 поисков в месяц, но его CPC составляет $63.21: это признак того, что доступ к небольшой аудитории покупателей обходится дорого. Для MVP нужны манифест тестов, обёртка команд agent-browser, сохранение роликов только при сбое и компактный индекс артефактов.

Слабое место — отрицательная динамика: частотность более широкого запроса снизилась на 18% год к году, а 60 fps увеличивает нагрузку, оставаясь ограниченной скоростью перерисовки страницы. Поэтому начинать стоит с функции внутри продукта для работы с подтверждениями, а не с самостоятельного продукта.

Чего видеозапись не доказывает

Видео обеспечивает наблюдаемость, но не доказывает корректность. Оно не покажет, записана ли нужная строка в базе данных, был ли ответ API допустимым и одинаково ли ведут себя все браузеры и устройства. Храните рядом с ним проверки, логи и скриншоты.

Видео не устраняет и риски окружения. Для записи необходимы ffmpeg в PATH и соответствующий кодировщик. Высокая частота кадров увеличивает нагрузку, длительные записи занимают место на диске, а ограниченные headless-среды могут иметь проблемы с кодеками или GPU. Страница с редкими перерисовками не сможет выдавать 60 уникальных кадров каждую секунду.

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

Наконец, agent-browser записывает подтверждение, но не интерпретирует его. Если после прогона видео должна анализировать модель, понадобится отдельная система, близкая к агентному анализу видео. Не смешивайте этот слой с детерминированной проверкой прохождения теста.

Что сделать в понедельник

На следующей неделе выберите один проблемный сценарий входа, оформления заказа или публикации. Запустите doctor, запишите уже открытую активную страницу с частотой 30 fps, сохраните текущую проверку, вызовите record stop и приложите MP4 к результату теста. Переходите на 60 fps, только если проверяющий не может оценить дефект движения; выбирайте 10 fps, когда в длительном прогоне важна прежде всего последовательность. Пилот успешен, если проверяющий может диагностировать сбой без повторного прогона, а не просто тогда, когда видео выглядит плавным.

Если вашей команде нужен браузерный агент, который создаёт готовые к проверке подтверждения, я могу разработать его под ваш реальный QA-процесс.