Браузер агента

Внутри DevMachine ADE у агента есть свой браузер. В нём агент открывает ваш dev-сервер или любую страницу, делает снимки, читает текст и ошибки консоли, нажимает кнопки и вводит текст. Так он проверяет, работает ли то, что сделал. Вы видите те же страницы и последнее действие агента и можете взять управление на себя.

#Как включить

Браузер включён по умолчанию, делать ничего не нужно. За него отвечает модуль «Браузер» в «Настройки → Модули». Если браузер агенту не нужен, выключите модуль.

Чтобы агент поработал в браузере, попросите его об этом, например: «открой localhost:3000 и проверь форму входа».

#Как открыть

• Нажмите кнопку «Другие инструменты» в шапке окна, сразу после кнопок инструментов, и выберите «Браузер». Кнопку браузера можно вынести в шапку: «Настройки → Расположение панелей → Кнопки в верхней панели».
• Когда агент работает в браузере, вид «Браузер» сам выходит на передний план, но не чаще раза в 30 секунд.

#Как пользоваться

• Панель браузера. В ней — «Назад по истории вкладки», «Вперёд по истории вкладки», «Перезагрузить», адресная строка («Адрес, например localhost:3000») и «Новая вкладка». Открыть страницу можете и вы: введите адрес.
• Что делает агент. В панели подписано последнее действие агента: «Агент: …».
• «Перехватить». Кнопка с ладонью справа в шапке вида «Браузер», рядом с кнопкой «Агент». Нажмёте — и на месте кнопки появится «Вернуть агенту», а над страницей — строка «Браузер у вас: действия агента в нём ждут, пока вы не вернёте управление». Пока вы не нажмёте «Вернуть агенту», агент в браузере ничего не делает. Пригодится, чтобы самому войти на сайт, закрыть всплывающее окно или показать нужную страницу.
• «Агент». Показывает разговор рядом с браузером.
• Окна вашего приложения. Если вы собираете приложение на Electron или Chromium и запускаете его на этом компьютере с портом удалённой отладки (--remote-debugging-port), агент может делать снимки его окон и по ним проверять результат.

#Что агенту можно

Что агенту можно делать в браузере, зависит от уровня в «Настройки → Безопасность агента → Подключения», блок «Браузер»:

Инструменты самой страницы — функции, которые страница сама объявила для агентов по стандарту WebMCP; если они есть, агент вызывает их и обходится без кликов по интерфейсу.

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

#Вход на сайты

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

#Ограничения

• Все адреса проходят через сетевую политику агента: и те, что открывает агент, и те, что вводите вы. Её настраивают в «Настройки → Безопасность агента», на вкладке «Где работает» (см. Ограничения агента). Вместо закрытого адреса браузер покажет «Закрыто сетевой политикой агента: …». Когда ограничения агента включены, порты этого компьютера открываются только у сервисов, которые агент запустил сам. Dev-сервер, запущенный агентом, откроется, а тот, что вы запустили сами, и чужой проброс портов — нет.
• Страницы с диска (file://) открываются, кроме закрытых мест: ~/.ssh, ~/.aws, ~/.kube, ~/.koder, связки ключей, файлы .env.
• Браузер отменяет загрузки файлов, не даёт страницам разрешений (камера, геолокация, уведомления) и сам закрывает окна alert и confirm.
• Вид «Браузер» нельзя вынести в отдельное окно.
• В проекте на сервере браузер работает на вашем компьютере: localhost в нём — ваш компьютер, а не сервер. Порты сервера агент пробрасывает сам.

#Данные

Снимки страниц, их текст и консоль уходят в модель. Секреты в тексте и консоли перед этим маскируются, а в снимке остаются как есть: это картинка. Не открывайте агенту страницы с секретами. Если нужно, чтобы агент точно не открыл браузер, поставьте уровень «Закрыт». Подробнее — на странице Данные и приватность.

#Что дальше

• Инструменты агента
• Ограничения агента
• Доступ агента к базам, кластерам и очередям
• Модули