Source: https://harnsy.dev/ru/docs/browser

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

# Браузер агентов

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. Входите на сайт сами

1. Откройте экран браузера (шаг 5) и страницу входа сайта.
2. Сами введите логин и пароль, и код, если сайт спросит.
3. Профиль сохранит вход, и агент работает в этом аккаунте.

Агенту ваш пароль не нужен: не давайте его и не вставляйте пароли в сообщения агентам.

На странице профиля видно, на каких сайтах выполнен вход, — только даты (значение cookie не показывается никогда). «⋯» › «Выйти с сайта» устроено так, чтобы стереть данные сайта в профиле и вывести оттуда агентов.

## 5. Смотрите, вмешивайтесь, говорите

Когда у проекта есть профиль, в шапке проекта появляется значок монитора; точка на нём значит, что вкладка ждёт вас. Нажмите его, откроется «Браузер агентов»: профили и вкладки слева, страница справа.

- **Нажмите на страницу**, чтобы работать в ней: мышь и клавиатура уходят в браузер.
- **«Взять управление»** делает вкладку вашей: harnsy устроен так, чтобы агент не нажимал и не печатал в ней, пока вы не нажмёте «Отдать агенту». Вкладка вернётся сама через минуту после того, как вы закрыли экран, или через 15 минут без клавиш и кликов.
- **Когда агенту нужны вы** во вкладке (вход, проверка на робота), об этом скажет полоса над страницей. Сделайте и нажмите «Я вошёл — отдать агенту».
- **«Чат»** открывает рядом со страницей чат с агентом, который работает в этой вкладке. Сообщение несёт заголовок и адрес вкладки. «Снимок» прикладывает картинку страницы, «Область» — её часть.

harnsy не записывает экран; хранится только снимок, который вы приложили к сообщению, вместе с этим сообщением.

## Куда он не попадёт

Браузер открывает только публичные сайты. Он устроен так, чтобы отказывать в адресах самой машины (`localhost`), вашего роутера, принтеров и других компьютеров вашей сети.

## Память, резервные копии

Работающий профиль занимает до 2 ГиБ памяти; Ресурсы › «Браузер узла» показывает, сколько берёт каждый профиль и вкладка, и там же можно усыпить профиль или закрыть вкладку. Входы входят в [резервные копии](https://harnsy.dev/docs/backups) машины и в переезд; профиль с сохранёнными данными больше 50 МБ в копию не входит и помечен «слишком большой для копии»: после восстановления войдите там заново.

## Риски, честно

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

## Если что-то не так

| Что вы видите | Обычно |
| --- | --- |
| «Установить» говорит, что нужен Node.js | установите Node.js 20 или новее и снова нажмите «Установить» |
| браузер не запускается (Ubuntu, сервер) | один раз выполните команду, которую показывает раздел |
| «Браузер остановился: …» | он запустится снова при следующем действии агента; причина в строке |
| «Связь закрыта» на экране | нажмите «Подключиться снова» |
| сайт ответил 403 или проверкой на робота | откройте страницу на экране и посмотрите; см. «Риски» |

[Что это умеет →](https://harnsy.dev/ru/features/browser)

[Есть вопросы? Спросите в группе →](https://t.me/+Cs5Mimdes5UwOGVi)

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. Логотипов нет.
