qvib.pro
EN

Сценарий для браузерного/computer-use агента

Для чего: дать агенту, который кликает в браузере/ОС, надёжный сценарий — цель, пошаговый флоу, верификация каждого шага и стоп-условия.

бесплатно MCP профи
$ Ты — агент, управляющий браузером (клики, ввод, навигация). Пройди сценарий н…

Когда использовать

Агент управляет браузером или экраном (Playwright-агент, computer-use, Claude in Chrome) и должен пройти реальный флоу: заполнить форму, выгрузить отчёт, проверить, что фича работает. Роль — QA/оператор-постановщик. Результат: сценарий, где каждый шаг проверяется по тому, что видно на экране, а не «вслепую».

Промт (бери и вставляй)

Ты — агент, управляющий браузером (клики, ввод, навигация). Пройди сценарий ниже.

ЦЕЛЬ: «<ВСТАВЬ: что должно произойти на экране в конце>».
СТАРТ: <URL или экран, с которого начинаем>.
ВХОДНЫЕ ДАННЫЕ: <логин-демо / тестовые значения для формы>.

Работай так:
1. На КАЖДОМ шаге сначала опиши, что видишь на экране (ключевые элементы), потом действие.
2. Формат шага: «Вижу: … → Делаю: <клик/ввод по тексту/роли элемента> → Проверяю: <что должно измениться>».
3. Действуй по видимым подписям/ролям элементов; если нужного элемента нет — НЕ кликай наугад: сделай скриншот, опиши экран и предложи, что не так.
4. После каждого действия убедись, что результат наступил (нужный текст/состояние появились). Не наступил — не иди дальше.
5. СТОП-УСЛОВИЯ: цель достигнута; либо ошибка/неожиданный экран; либо <N> шагов исчерпаны.

НЕЛЬЗЯ: вводить реальные платёжные/секретные данные; подтверждать необратимое (оплата, удаление) без явного разрешения; уходить с нужного домена.

В конце: прошёл ли флоу, на каком шаге что было, скриншот итогового экрана.

Приём: «вижу → делаю → проверяю» на каждом шаге привязывает действия к реальному состоянию экрана и не даёт агенту кликать вслепую по воображаемой странице.

Пример заполнения

Цель: «оформить тестовый заказ и увидеть страницу „Спасибо за заказ“». Старт: демо-магазин. Данные: тестовая карта 4242…, адрес-заглушка.

Ожидаемый ход ИИ: «Вижу: каталог, кнопка „В корзину“ → Делаю: клик по „В корзину“ у товара X → Проверяю: счётчик корзины стал 1»; далее переход в корзину, чекаут, ввод тестовых данных, и финальная проверка — на экране заголовок «Спасибо за заказ» + номер. Перед «Оплатить» останавливается, если это не тестовый платёж.

Вариации

  • Регрессионная проверка. «Пройди этот флоу и сверь с эталоном: что изменилось/сломалось по сравнению с описанием».
  • Извлечение данных. «Зайди на страницу, дождись загрузки, выпиши таблицу X в JSON» — браузер как источник данных.
  • Только до формы. «Дойди до экрана оплаты, заполни поля, но НЕ нажимай „Оплатить“ — покажи скриншот» — безопасный прогон.

Про-советы

  • Заставляйте описывать экран ПЕРЕД действием: агенты на computer-use чаще всего ошибаются, кликая по элементу, которого уже/ещё нет (не дождались загрузки). «Проверяю» после шага ловит это сразу.
  • Целься по тексту/роли элемента, а не по координатам: «кнопка с подписью „Войти“» переживает мелкие изменения вёрстки, пиксельные координаты — нет.
  • Жёстко перечисляйте «нельзя» для необратимого (оплата, удаление, отправка реальных данных) и используйте демо/тестовые контуры — браузерный агент действует в живом интерфейсе, цена ошибки реальная.