Примеры и рецепты

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

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

Вход и навигация

Агент может выполнять вход в веб-приложения с использованием ваших учётных данных и перемещаться по защищённым страницам.

"Перейди на app.example.com, войди с моими учётными данными и перейди на страницу Отчёты"

Что происходит под капотом:

1. Открытие и навигация — агент открывает браузер и переходит на страницу входа.
2. Снимок страницы — создаётся снимок доступности для поиска полей ввода email/пароль и кнопки входа. Каждому элементу присваивается ссылка вроде @e3, @e5, @e7.
3. Заполнение и отправка — вводится ваш email и пароль в соответствующие поля, затем нажимается кнопка входа.
4. Ожидание и продолжение — агент ждёт загрузки страницы после входа, затем переходит на целевую страницу.

Если вы уже вошли на сайт в браузере, агент может использовать эту сессию — повторный вход не требуется.

Заполнение сложной формы

Агент может обрабатывать формы с множеством полей, включая выпадающие списки, флажки и текстовые области.

"Заполни форму поддержки на нашем внутреннем инструменте — установи приоритет на High, категорию на Billing и опиши проблему как 'Клиент был дважды обращён за подпиской'"

Агент создаёт снимок формы, идентифицирует каждое поле по его метке, заполняет текстовые поля, выбирает значения из выпадающих списков и нажимает кнопку отправки.

Извлечение данных со страницы

Используйте выполнение JavaScript для извлечения структурированных данных с любой веб-страницы.

"Перейди на нашу аналитическую панель и извлеки топ-10 метрик из таблицы сводки"

Что делает агент:

// Агент выполняет JavaScript прямо в контексте страницы
Array.from(document.querySelectorAll('table.summary tr'))
  .slice(0, 10)
  .map(row => ({
    metric: row.cells[0].textContent,
    value: row.cells[1].textContent
  }))

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

Мониторинг сетевого трафика

Просмотрите, какие API-запросы делает страница — полезно для отладки или обнаружения внутренних конечных точек.

"Открой панель, нажми кнопку обновления и покажи, какие API-запросы она делает"

Агент использует инспекцию сети для перехвата всех HTTP-запросов, инициированных страницей, отображая URL, методы, коды статуса и размеры ответов. Особенно мощно для обнаружения внутренних API.

Создание целевых скриншотов

Захватите конкретные элементы или области вместо всей страницы.

"Сделай скриншот только графика доходов на панели"

Агент может целиться в скриншоты по следующим критериям:

• Ссылка на элемент — создайте снимок страницы, найдите ссылку на график и захватите только этот элемент.
• CSS-селектор — целитесь на элементы, например, div[data-testid="revenue-chart"].
• Координаты — захватите определённую пиксельную область.

Отправка клавиатурных сокращений

Активируйте специфичные для приложения клавиатурные сокращения для расширенных рабочих процессов.

"Открой палитру команд с помощью Cmd+K и найди 'billing'"

Агент может отправлять любую комбинацию клавиш, включая модификаторы (Shift, Control, Alt, Meta/Cmd).

Многоэтапные рабочие процессы

Объединяйте несколько действий с браузером в сложные рабочие процессы.

"Перейди на наш портал HR, проверь профиль каждого сотрудника и собери их должности и отделы в электронную таблицу"

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

Советы для лучших результатов

• Будьте конкретны в том, что хотите — «Извлеки имена сотрудников и их email из таблицы» лучше, чем «получи данные».
• Упомяните, если вы уже вошли — экономит время, пропуская этап входа.
• Опишите структуру страницы, если она сложная — «данные находятся на второй вкладке, в разделе Сводка».
• Попросите конкретный формат вывода — «положи это в электронную таблицу» или «оформи как таблицу».

Устранение неполадок

• Страница не загружается? — агент повторит попытку навигации. Если проблема сохраняется, проверьте правильность URL и доступность сайта.
• Не может найти элемент? — агент повторно создаёт снимок страницы после навигации. Если элементы загружаются динамически, может потребоваться подождать или прокрутить страницу.
• Вход не работает? — некоторые сайты используют CAPTCHA или многофакторную аутентификацию, которые браузер не может автоматизировать. Возможно, потребуется войти вручную, а затем позволить агенту продолжить.
• Взаимодействия кажутся ненадёжными? — агент повторно создаёт снимок и повторяет попытку. Динамические страницы с анимациями могут потребовать краткого ожидания между действиями.