# Приложения и компьютер

Чат, задачи и интеграции работают прямо в браузере, без установки, а сайты агент открывает в облаке. Приложения добавляют то, чего браузер не может:

- **на компьютере** агент работает у вас: открывает собственный браузер с вашими входами на сайты, работает с файлами в выбранной папке и выполняет команды;
- **на телефоне** под рукой чаты, задачи и уведомления.

## Где скачать

Все версии собраны на странице [загрузки](/download).

| Устройство | Где взять | Что подходит |
|---|---|---|
| **Mac** | файл `.dmg` на странице загрузки | macOS 13.0 и новее, Apple Silicon и Intel |
| **Windows** | файл `.exe` на странице загрузки | Windows 10 и 11 |
| **Linux** | `.AppImage` или пакет для Debian (`.deb`) | x86_64 |
| **iPhone** | App Store | iOS 16.4 и новее |
| **Android** | RuStore или Google Play | |

Скачивайте приложение только со страницы загрузки или из магазина приложений. Ссылки на файл из писем и мессенджеров не открывайте.

## Как установить приложение на компьютер

### Скачайте файл для своей системы
На странице [загрузки](/download) нажмите кнопку под своей системой. Файл появится в загрузках браузера.

### Установите
- **Mac**: откройте `.dmg` и перетащите приложение в папку **«Программы»**. Запускайте его оттуда, а не из открытого образа диска и не из «Загрузок»: иначе приложение не сможет обновляться.
- **Windows**: запустите `.exe`. Установщик ставит приложение для вашей учётной записи Windows, прав администратора для этого не нужно. Если на компьютере нет компонента WebView2, установщик скачает его сам, поэтому нужен интернет.

### Войдите в тот же аккаунт
Откройте приложение и войдите тем же способом, что и на сайте. После входа компьютер появится в Настройках → **«Устройства и сессии»** в группе **«Этот компьютер»**.

**Система предупреждает при первом запуске**
Так бывает с приложением, скачанным из интернета. Если файл скачан со страницы загрузки, его можно открыть:

- **Mac**: откройте Системные настройки → «Конфиденциальность и безопасность» и нажмите «Открыть всё равно» рядом с названием приложения;
- **Windows**: в окне «Windows защитила ваш компьютер» нажмите «Подробнее», затем «Выполнить в любом случае».

На Windows не запускайте приложение через «Запуск от имени администратора»: оно работает только с обычными правами пользователя и откажется стартовать. Команду, которой нужны права администратора, выполните в отдельном окне PowerShell.

## Как установить приложение на телефон

Откройте страницу [загрузки](/download) с телефона: первой будет кнопка магазина вашей системы, **App Store** для iPhone и **RuStore** или **Google Play** для Android. Установите приложение и войдите в тот же аккаунт.

Если App Store пишет, что приложение несовместимо с вашим iPhone, для него нужна iOS 16.4 или новее. Без обновления iOS пользуйтесь веб-версией в браузере телефона: чаты и задачи в ней те же.

## Как обновлять приложение

### На компьютере

Приложение само проверяет обновления и скачивает их в фоне. Когда есть новая версия, в меню аккаунта появляется карточка **«Обновление»**, а внизу боковой панели значок со стрелкой. Нажмите **«Обновить»**, а когда версия скачана, **«Обновить и перезапустить»**: приложение перезапустится, чаты и работа останутся там, где вы их оставили. В окне обновления есть список **«Что нового»**.

- На Mac и Linux скачанное обновление может установиться и само, пока приложение свёрнуто, тогда под кнопкой написано **«Установится, пока приложение в фоне»**. Кнопка просто ускоряет установку.
- На Windows обновление ставится только по кнопке.

Проверить вручную: Настройки → **«Приложения»** → **«Версия приложения»** → **«Проверить обновления»**. Там же кнопка **«Скопировать данные о версии»**: пришлите эти данные в [поддержку](/help/contacts), если что-то не так.

### На телефоне

Обновления приходят через магазин, из которого вы ставили приложение. Включите автообновление приложений в App Store, RuStore или Google Play.

### В браузере

Веб-версия всегда обновлена до последней, ничего делать не нужно.

## Если пишет «Требуется обновление»

Окно **«Требуется обновление»** значит, что ваша версия больше не поддерживается: старая версия не может работать с сервисом. Закрыть окно нельзя, но данные никуда не пропадают. Нажмите **«Обновить»** (на телефоне: **«Обновить в App Store»**, RuStore или Google Play).

Если кнопка не помогает, смотрите строку под ней:

| Что написано | Что сделать |
|---|---|
| **«Чтобы обновиться, перенесите приложение в папку «Программы»»** | Mac: закройте приложение, перетащите его из образа диска или «Загрузок» в «Программы» и запустите оттуда. |
| **«Чтобы обновиться, скачайте приложение с samreshuuu.ru и установите его заново»** | Windows: приложение когда-то поставлено для всех пользователей и само себя заменить не может. Скачайте установщик со страницы [загрузки](/download) и установите заново. |
| **«Обновление не применилось: приложение осталось на версии …»** | Установите новую версию ещё раз. Если не выходит, нажмите **«Скачать вручную»** и поставьте установщик поверх. |
| **«Загрузка не двигается, проверьте сеть»** | Проверьте интернет на компьютере или нажмите **«Скачать вручную»**. |
| **«Не удалось проверить обновления: …»** | Нажмите **«Повторить»**. Если ошибка повторяется, скачайте установщик со страницы [загрузки](/download). |
| **«Не удалось открыть …»** на телефоне | Откройте магазин приложений сами и обновите приложение там. |

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

## Где работает агент: облако или ваш компьютер

Компьютер подключается входом: установите приложение и войдите в нём в свой аккаунт. Отдельного кода не нужно. Дальше в чате рядом с полем ввода есть выбор **«Где работать»**: **«В облаке»** или ваш компьютер.

- **«В облаке»**: изолированно, без доступа к вашим файлам. Агент открывает сайты в браузере в облаке, со своим профилем и входами. Подходит для поиска, отчётов, открытых страниц и работы с интеграциями.
- **Компьютер**: файлы в выбранной папке, программы и команды этого компьютера, его браузер и сеть. Это нужно там, куда облако не попадает: личный кабинет поставщика, госуслуги для бизнеса, внутренняя админка, сайт без API, страница за корпоративной сетью.

Подключённый компьютер можно выбрать и из веб-версии: агент будет работать на нём, пока на компьютере открыто приложение. Компьютер подключён к одному аккаунту, к тому, под которым в приложении выполнен вход. Что агенту можно на компьютере без вопроса, задаётся в Настройках → **«Возможности»**: [Как агент меняет данные](/help/trust).

Выбранный компьютер не меняется сам, когда пропадает связь. Пока его нет, то, что можно сделать без него, агент делает в облаке, а файлы на компьютере ему не видны; для шага, которому нужен компьютер, агент скажет, что ждёт его. Чтобы работать в облаке, выберите **«В облаке»** явно: локальные файлы от этого в облако не переносятся.

### Офисный компьютер, который работает постоянно

Если агент должен работать на компьютере, за которым никто не сидит, откройте на нём Настройки → **«Устройства и сессии»** → **«Этот компьютер»** и включите:

- **«Запускать при входе в систему»**: приложение стартует вместе с системой и держит связь;
- **«Не давать компьютеру уснуть»**: запрещает сон по бездействию. Закрытая крышка ноутбука и явный «Сон» всё равно усыпляют компьютер, поэтому держите его включённым в сеть и не закрывайте крышку.

В той же группе **«Подключить телефон»**: отсканируйте QR-код телефоном, и он сможет читать и отвечать в чатах этого компьютера. Список подключённых телефонов и кнопка **«Отозвать доступ»** там же.

### Задачи по расписанию на компьютере

Где выполняется [задача](/help/tasks), задаёт её строка **«Где работать»**. Задача **«В облаке»** от вашего компьютера не зависит. Если выбран компьютер, а в момент запуска он не в сети, задача ждёт его:

- в строке расписания стоит **«Ждёт компьютер»**, а вам приходит уведомление;
- когда компьютер появится в сети, задача выполнится один раз, даже если за это время пропущено несколько запусков;
- в облако или на другой компьютер она не переносится.

### Компьютер и коллеги

Ваш компьютер работает только на ваш аккаунт. В [групповом чате](/help/group-chats), где кроме вас есть другой человек, агент не работает с вашим компьютером, браузером, подключёнными сервисами и личной памятью ни на чьи сообщения, в том числе на ваши. Чтобы агент работал на компьютере коллеги, коллега ставит приложение у себя и входит в свой аккаунт.

## Браузер агента на вашем компьютере

Отдельной кнопки «включить браузер» нет. Выберите компьютер в **«Где работать»** и скажите обычной фразой, что сделать: «открой сайт поставщика и выгрузи остатки», «зайди в кабинет и заполни заявку». Агент запустит браузер сам, когда задача этого требует.

При первом запуске появится окно **«Браузер агента»**: нажмите **«Разрешить»**. Выбор сохраняется на 90 дней. Дальше на экране открывается окно браузера, а в чате появляется трансляция **«Локальный браузер · live»**: видно каждый клик, даже если окно свёрнуто.

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

**Ваш обычный браузер не трогается**
Агент работает в отдельном профиле: ваши вкладки, закладки, сессии и сохранённые пароли остаются нетронутыми, и системная связка ключей ему недоступна. Всё, что он делает, видно на экране.

### Экран агента и управление

В шапке чата справа кнопка со знаком монитора, подсказка **«Экран агента»**. На компьютере она открывает панель справа: экран агента, его браузер, изменения и запущенные превью; на телефоне экран агента открывается во весь экран. Кнопка подсвечивается, когда агент работает на экране. В групповом чате её нет.

- **«Вы смотрите»**: агент работает, вы видите его шаги. **«Взять управление»** передаёт экран вам.
- **«Вы управляете»**: экран у вас, агент ждёт. **«Перестать управлять»** возвращает экран агенту.

Когда агенту нужен ваш шаг, в чате встаёт карточка: **«Нужно войти»**, **«Нужно пройти проверку»** (капча), **«Нужно подтвердить оплату»**, а на кнопке экрана появляется точка с подсказкой **«Нужно ваше участие»**. Нажмите **«Открыть страницу»**, сделайте шаг в том же окне браузера и нажмите **«Готово»**: агент проверит страницу и продолжит.

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

Сначала агент проверяет, сохранился ли вход в его профиле. Если сайт просит войти, логин, пароль, код подтверждения, капчу или passkey вводите вы сами, агент их не видит и не вводит. Вход сохраняется в профиле агента, пока сайт не потребует войти снова.

- **Маркетплейсы.** Данные и действия, доступные через API, агент берёт из [интеграций](/help/integrations). Если API не покрывает нужное действие, работу можно поручить через браузер на компьютере; выйдет ли, зависит от доступа в кабинете и проверок сайта.
- **Банки.** Выписки и платежи агент ведёт через подключение банка в [интеграциях](/help/banks). Договоры банков обычно запрещают передавать логин и пароль третьим лицам, поэтому в интернет-банк вы входите сами.
- **Содержимое сайтов агент не слушается.** Текст на странице для него данные: инструкции, встреченные на чужом сайте, он не выполняет и секреты по ним не передаёт.

### Какие браузеры подходят

Только браузеры на Chromium: Google Chrome, Microsoft Edge, Brave, Vivaldi, Opera, Яндекс Браузер, Chromium и Chromium-Gost. Приложение берёт сохранённый выбор, затем поддерживаемый браузер по умолчанию, затем другой установленный браузер из списка; можно попросить агента открыть конкретный. Safari и Firefox не поддерживаются.

Для сайтов с шифрованием по ГОСТ (кабинет ФНС для юрлиц, личный кабинет ЕИС) попросите агента открыть Chromium-Gost: на компьютере должны стоять КриптоПро CSP и плагин КриптоПро, а PIN носителя вводите вы.

### Локальные страницы и адреса

Браузер агента открывает HTML-файлы из доступной агенту рабочей папки и локальные серверы, например `http://localhost:5173` или `http://127.0.0.1:8080`, без отдельного разрешения. Если странице нужен HTTP для модулей, запросов данных или путей вида `/assets/`, агент может запустить dev-сервер проекта и проверить его адрес.

Для другого компьютера или сервиса в вашей локальной сети, например `192.168.1.20:8080`, и для сайта рабочей или городской сети, имя которого на этом компьютере ведёт во внутреннюю сеть, агент предложит карточку доступа. Одобрите её в приложении на компьютере, где работает браузер: карточка разрешает сайт по имени целиком, например `sudir.mos.ru`. Разрешения видны и в **Настройки → «Возможности» → «Браузер агента» → «Локальные адреса»**.

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

## Что значат статусы компьютера

Статус и подсказка, что сделать, видны в Настройках → **«Устройства и сессии»** под именем компьютера.

| Статус | Что значит | Что сделать |
|---|---|---|
| **«Не в сети»**, **«Был в сети …»** | Компьютер спит, выключен или приложение закрыто. | Разбудите компьютер и откройте на нём приложение. |
| **«Нет связи»** | Приложение открыто, но соединение с сервером не проходит. | Прочитайте пояснение под статусом (см. ниже). |
| **«Отключено»** | Связь выключена кнопкой **«Отключить»**. | Нажмите **«Включить»** в приложении на этом компьютере. |
| **«Вход завершён»** | Срок входа истёк или вы вышли. | Войдите в аккаунт в приложении на этом компьютере. |
| **«Нужно обновить приложение»** | Версия на компьютере устарела. | Обновите приложение на этом компьютере. |
| **«Обновляется»** | Приложение перезапускается на обновление. | Подождите: оно скоро вернётся на связь. |

### «Нет связи», хотя компьютер включён

Под статусом написано, где оборвалось соединение:

- **сеть этого компьютера не достаёт до сервера**: проверьте интернет; приложение переподключится само;
- **прокси не пропускает соединение** или **требует входа**: проверьте настройки прокси или попросите администратора сети пропускать соединения с сервером без входа;
- **прокси, через который эта версия не соединяется**: обновите приложение или задайте HTTP- или HTTPS-прокси;
- **не удалось проверить сертификат сервера**: попросите администратора проверить доверенные корневые сертификаты на компьютере и не подменяет ли защищённые соединения антивирус или корпоративный прокси;
- **связь обрывается уже после подключения**: проверять сеть компьютера не нужно, приложение переподключится само. Если связь не вернулась за несколько минут, перезапустите приложение.

## Если браузер не запустился

- «Для этого действия нужна более свежая версия приложения для компьютера. Установите обновление и перезапустите приложение.» Повтор того же действия до обновления не поможет; остальные доступные действия могут продолжать работать.
- «Не удалось подтвердить готовность браузера за отведённое время. Проверьте приложение на компьютере, где запускается браузер.» Чаще всего в окне браузера висит диалог, который ждёт ответа: ответьте на него и повторите запрос.
- «Браузер закрылся во время запуска. Проверьте, открывается ли он обычным способом, или выберите другой браузер.»
- «Порт агента занят программой, которую приложение не запускало. Закройте её и повторите попытку.» Повтор не поможет, пока программа держит порт; можно и перезапустить приложение.
- «Этот браузер не поддерживается. Выберите установленный браузер на Chromium (Chrome, Edge, Яндекс Браузер или Brave) или установите один из них.» Safari и Firefox агент не автоматизирует.
- «Этот браузер на компьютере не установлен. Установите его или выберите другой.»

## Если антивирус ругается на приложение

Приложение по вашему разрешению запускает браузер, выполняет команды и управляет экраном. Антивирус, например Kaspersky, может принять такое поведение за подозрительное.

1. Убедитесь, что приложение скачано со страницы [загрузки](/download).
2. Не выключайте антивирус целиком. Добавьте приложение в доверенные программы по инструкции своего антивируса или отправьте его производителю как ложное срабатывание.
3. Если не помогло, напишите в [поддержку](/help/contacts): приложите отчёт антивируса и данные о версии из Настройки → «Приложения».

## Как выйти и удалить приложение

- **Закрыть окно** не значит выйти: приложение остаётся в Dock или в трее и продолжает задачи в фоне. Полностью закрыть: **«Завершить Сам Решу»** в меню приложения или в трее.
- **Выйти из аккаунта**: **«Выйти»** в меню аккаунта. Вход на этом устройстве завершится, а чаты, агенты и память останутся в аккаунте.
- **Удалить**: на Mac перетащите приложение из «Программ» в Корзину, на Windows удалите его в списке приложений Windows. Мастер удаления Windows предлагает отдельно удалить и данные приложения.

После удаления компьютер остаётся в списке аккаунта. Чтобы закрыть ему доступ, откройте Настройки → **«Устройства и сессии»** и нажмите **«Отозвать»** у этого компьютера. Вернуть доступ можно только с самого компьютера, новым входом.

## Устройства и сессии

В Настройках → **«Устройства и сессии»** собраны:

- **«Этот компьютер»** (в приложении для компьютера) и **«Другие компьютеры»** (в браузере и на телефоне эта группа называется **«Компьютеры»**): статус, переименование (**«Переименовать»**), **«Отключить»** и **«Отозвать»**;
- **«Входы»**: где выполнен вход в аккаунт. **«Завершить»** закрывает один вход, **«Завершить все другие»** закрывает все, кроме текущего.

Если вы не узнаёте вход, завершите его и смените способ входа. Подробнее о защите аккаунта: [Данные и безопасность](/help/security).