Автоматизация веб-форм через API с ИИ-заполнением

1. Опишите задачу

   Сформулируйте цель так, как поставили бы задачу внимательному ассистенту: все значения, которые нужны форме, и что считается успехом («сообщи номер подтверждения»). Если URL формы известен, начинайте прямо с неё.

2. Агент заполняет форму

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

3. Вы подтверждаете, он отправляет

   По умолчанию агент останавливается перед покупками, бронированиями, сообщениями, удалениями и подачей заявок и показывает вам значения формы. Вы отвечаете подтверждением, и запуск завершается с answer, а если вы задали схему — ещё и с data по ней.

curl https://lovelyrouter.com/v1/browser/runs \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "goal": "Request a quote for 500 blue 750 ml water bottles with our logo, delivered to 12 Main St, Springfield, IL 62701 by December 1, 2026. Contact: Ada Lovelace, ada@example.com. Submit the form and tell me the quote reference.",
    "start_url": "https://supplier.example.com/quote",
    "approve": "submit",
    "output_schema": {"quote_reference": "string", "confirmation_message": "string"},
    "webhook": "https://api.example.com/hooks/browser"
  }'

Запрос сразу возвращает 202, а агент работает в фоне. С "approve": "submit" он останавливается перед кнопкой отправки, и ваш вебхук получает подписанное событие run.waiting: его needs содержит prompt для человека, значения формы в fields, надпись кнопки в action и скриншот. Подтвердите:

curl https://lovelyrouter.com/v1/browser/runs/brun_5b7d9f1a3c5e7a9b1d3f5a7c/reply \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"approve": true}'

Агент нажимает кнопку и завершает работу; приходит run.finished с answer и JSON в data. Если вместо этого ответить {"approve": false, "reason": "Wrong address"}, агент не отправит форму: он прочитает причину и попробует другой путь или сообщит, почему не получилось.

Сохраните каждую учётную запись один раз через PUT /v1/browser/vault/{name}: её value, kind (password, username, text или totp) и origins, где её разрешено вводить. Передайте имена в secrets запуска. Модель видит только имена вроде portal_password; значение вводится лишь на разрешённом вами сайте, поэтому поддельная страница входа его не получит.

Чтобы наблюдать за запуском, добавьте "stream": true, "screen": true и получайте каждый шаг и экран браузера по мере выполнения. Когда на странице появляется CAPTCHA, агент даёт вам ссылку Live View; вы решаете её, отвечаете {"done": true}, и он продолжает. Используйте агента только в аккаунтах, которыми вы владеете или которые вам разрешено использовать; подробности — в Политике допустимого использования.

Вы платите за шаг: $0.006 в быстром режиме и $0.012 в точном режиме для выбора дат, карт и нестандартных виджетов. Модели включены в цену, платы за запуск нет. Вход занимает от 4 до 8 шагов, длинная многостраничная форма — от 15 до 25. В каждый шаг входит одна минута; более долгое ожидание человека стоит $0.005 в минуту, а сами паузы как шаги не тарифицируются. Запуск резервирует max_steps, умноженное на цену шага, плюс одно ожидание длительностью до human_timeout_minutes, а затем списывает фактически использованное. Запуск, который завершился ошибкой или был остановлен вами, оплачивает только выполненные шаги. См. цены и страницу браузерного агента с результатами бенчмарка.