Браузер агентов
harnsy может запустить браузер на вашей машине для ваших агентов. Агент открывает страницу, читает её, нажимает и заполняет форму; вы видите тот же браузер на живом экране в дашборде и можете вмешаться в любой момент. Он работает на вашей машине, с вашими входами, и ничего не идёт через нас. В любой редакции.
Что нужно.
- Linux или macOS.
- Node.js 20 или новее на машине.
- Около 189 МБ скачать и около 420 МБ на диске. Всё ложится в
~/.harnsy/browser/: в систему ничего не ставится, права администратора не нужны.
Если установлен Google Chrome, браузер запускает его; иначе — собственный Chromium harnsy. Браузер говорит по-английски, какой бы ни был язык машины.
1. Установите
Откройте дашборд на этой машине: Настройки › Браузеры › «Установить». Раздел показывает два шага и их процент. Если шаг не удался, он скажет почему; «Подробности» покажут больше, «Попробовать снова» повторит. harnsy устроен так, чтобы ставить его могли только вы, с дашборда самой машины: не агент и не телефон, вошедший снаружи.
Когда всё готово, harnsy создаёт первый профиль — «Основной».
Ubuntu 23.10 и новее или сервер. Браузер может не запуститься сразу. Тогда раздел покажет одну команду, которую нужно один раз выполнить в терминале этой машины (или установите Google Chrome). Если браузер работает без своей защиты, раздел покажет предупреждение: не оставляйте так.
2. Профили
Профиль — отдельная память браузера: его входы, cookie и данные сайтов. Заводите по одному на задачу или аккаунт: «Работа», «Магазин». Так устроено, что агенту с «Работой» «Магазин» не выдаётся.
- «+ Профиль», имя, «Добавить».
- Профиль засыпает, если им 15 минут никто не пользовался, и сам просыпается при следующем действии. «⋯» › «Усыпить» закрывает его сразу, сначала сохранив входы.
- «Удалить» сначала спросит: все входы, сохранённые в профиле, сотрутся.
3. Выдайте профиль роли
Пока вы не разрешили, у агента нет браузера. На странице профиля в «Кому выдан» нажмите «Изменить» и выберите проекты и роли. Выдавайте только ролям, которым нужны сайты. Их агенты получают инструменты браузера (открыть, нажать, ввести, прочитать), а ваших паролей и cookie harnsy им не передаёт.
Инструментами они пользуются, не спрашивая вас каждый раз. Чтобы спрашивали на каждое действие, включите это в подключении профиля: Настройки › Сервисы для агентов › MCP.
4. Входите на сайт сами
- Откройте экран браузера (шаг 5) и страницу входа сайта.
- Сами введите логин и пароль, и код, если сайт спросит.
- Профиль сохранит вход, и агент работает в этом аккаунте.
Агенту ваш пароль не нужен: не давайте его и не вставляйте пароли в сообщения агентам.
На странице профиля видно, на каких сайтах выполнен вход, — только даты (значение cookie не показывается никогда). «⋯» › «Выйти с сайта» устроено так, чтобы стереть данные сайта в профиле и вывести оттуда агентов.
5. Смотрите, вмешивайтесь, говорите
Когда у проекта есть профиль, в шапке проекта появляется значок монитора; точка на нём значит, что вкладка ждёт вас. Нажмите его, откроется «Браузер агентов»: профили и вкладки слева, страница справа.
- Нажмите на страницу, чтобы работать в ней: мышь и клавиатура уходят в браузер.
- «Взять управление» делает вкладку вашей: harnsy устроен так, чтобы агент не нажимал и не печатал в ней, пока вы не нажмёте «Отдать агенту». Вкладка вернётся сама через минуту после того, как вы закрыли экран, или через 15 минут без клавиш и кликов.
- Когда агенту нужны вы во вкладке (вход, проверка на робота), об этом скажет полоса над страницей. Сделайте и нажмите «Я вошёл — отдать агенту».
- «Чат» открывает рядом со страницей чат с агентом, который работает в этой вкладке. Сообщение несёт заголовок и адрес вкладки. «Снимок» прикладывает картинку страницы, «Область» — её часть.
harnsy не записывает экран; хранится только снимок, который вы приложили к сообщению, вместе с этим сообщением.
Куда он не попадёт
Браузер открывает только публичные сайты. Он устроен так, чтобы отказывать в адресах самой машины (localhost), вашего роутера, принтеров и других компьютеров вашей сети.
Память, резервные копии
Работающий профиль занимает до 2 ГиБ памяти; Ресурсы › «Браузер узла» показывает, сколько берёт каждый профиль и вкладка, и там же можно усыпить профиль или закрыть вкладку. Входы входят в резервные копии машины и в переезд; профиль с сохранёнными данными больше 50 МБ в копию не входит и помечен «слишком большой для копии»: после восстановления войдите там заново.
Риски, честно
- Сайты могут заметить автоматизацию. Некоторые просят пройти проверку на робота или блокируют визит. Проверку можно пройти самому на экране.
- У сайтов свои правила. Некоторые запрещают автоматическую работу с аккаунтом и могут его заблокировать. Если правила сайта это запрещают, не давайте его агентам. За соблюдение правил сайтов, которые вы даёте агентам, отвечаете вы.
- Агент может действовать в каждом аккаунте своего профиля. Не держите важные входы в профиле, который выдан многим ролям.
- Страницам нельзя доверять. На странице может быть текст, обращённый к агенту. harnsy помечает то, что пришло со страницы, как внешние данные, а не команду. Агента всё равно можно этим запутать: давайте браузер только ролям, которым он нужен для работы, и следите за ними на важных сайтах.
Если что-то не так
| Что вы видите | Обычно |
|---|---|
| «Установить» говорит, что нужен Node.js | установите Node.js 20 или новее и снова нажмите «Установить» |
| браузер не запускается (Ubuntu, сервер) | один раз выполните команду, которую показывает раздел |
| «Браузер остановился: …» | он запустится снова при следующем действии агента; причина в строке |
| «Связь закрыта» на экране | нажмите «Подключиться снова» |
| сайт ответил 403 или проверкой на робота | откройте страницу на экране и посмотрите; см. «Риски» |
Есть вопросы? Спросите в группе →
Anthropic, Claude Code, OpenAI, ChatGPT, Codex, OpenCode, pi, Telegram, Discord, GitHub, Apple, macOS, iOS, iPhone, Safari, Google, Android, Chrome, Microsoft, Windows, Windows Security, Defender и QR Code — названия продуктов их владельцев. harnsy не связан с ними и не одобрен ими. iOS — товарный знак Cisco, используемый Apple по лицензии; QR Code — зарегистрированный товарный знак DENSO WAVE INCORPORATED. Логотипов нет.