Доступ к браузеру

Часть работы скрыта за входом по логину — ваш бухгалтерский портал, панель поставщика, внутренний инструмент. Ассистент Plank может работать в браузере на этих сайтах от вашего имени. Вы входите один раз, а он выполняет рутинную работу внутри.

Доступность: Доступ к браузеру доступен всем — и в веб-приложении, и в мобильном приложении Plank. Включать ничего не нужно: сессии браузера появляются вкладками рядом с вашими файлами, как только ассистент их откроет.

Раньше это была бета-функция, которую включали в настройках. Если вы включили её какое-то время назад, а ассистент по-прежнему говорит, что браузера у него нет, — значит его пространство работает с теми настройками, с которыми запустилось: откройте Настройки и в них раздел Настройки (тот, где тема и язык), нажмите Перезапустить ассистента и попробуйте снова. Запустится свежий процесс ассистента. Он один на все ваши пространства, поэтому остановится всё, чем он занят в любом из них; файлы и история переписки не пострадают.

Как это работает

1. Ассистент сначала спрашивает, потом открывает вкладку браузера. Сначала он пробует подключиться через API сервиса (см. «Предпочитаете API? Просто скажите» ниже). Если API нет — или он в процессе работы попадает на сайт, где нужен вход, — он спрашивает вас, прежде чем что-либо открывать. Когда вы согласитесь, он создаёт для этого сайта отдельный облачный браузер: рядом с вашими файлами появляется новая вкладка с названием сайта. На вкладке имя показано в приведённом виде — kaspi-business читается как Kaspi Business, — поэтому ориентируйтесь на сайт, а не на точное написание. Наведите курсор на вкладку, чтобы увидеть имя целиком. Ассистент сообщает вам в чате — например, «Я открыл сессию QuickBooks. Откройте вкладку QuickBooks и войдите, затем сообщите мне, когда закончите».
2. Вы входите. Нажмите на вкладку браузера. Вы увидите живой браузер для этого сайта. Войдите так же, как делаете это обычно.
3. Вы передаёте управление обратно. Сообщите ассистенту, что вы вошли. Он подхватывает работу и продолжает внутри сайта. Вы можете в любой момент переключаться между вкладкой браузера и своими файлами — живая сессия остаётся открытой в фоне.

Один вход — и он запомнен навсегда

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

Чтобы использовать несколько аккаунтов на одном сайте, попросите ассистента давать каждому отдельное имя (например, «QuickBooks — личный» и «QuickBooks — рабочий»). Каждый появится как отдельная вкладка. Если два имени на вкладках выглядели бы одинаково, обе вкладки покажут точные имена, которые выбрал ассистент, — чтобы вы всегда понимали, какую закрываете.

Ваш пароль остаётся вашим

Вы вводите свои учётные данные напрямую в окно браузера. Plank и ИИ никогда не видят ваш пароль — они видят только страницы после того, как вы вошли. Каждое действие ассистента в браузере записывается в журнал.

Управление сессиями

Перейдите в Настройки → Сессии браузера, чтобы увидеть каждый сайт, к которому вы подключены, и когда каждая сессия использовалась в последний раз. В каждой строке показано приведённое имя, а под ним — собственное имя сессии у ассистента, если они различаются: именно его ассистент называет в чате. Нажмите Отозвать, чтобы выйти из аккаунта ассистента на сайте; в подтверждении сессия названа так же, как её называет ассистент. Также можно закрыть вкладку браузера в просмотрщике файлов — её закрытие немедленно завершает сессию. В любом случае ваш сохранённый вход остаётся, поэтому следующая сессия для этого сайта начнётся уже авторизованной.

Выгрузка файлов с сайта

Попросите ассистента получить файл с нужного сайта и сохранить его прямо в рабочее пространство — например: «зайди в OneDrive и сохрани тот отчёт в reports/» или «выгрузи список заказов с портала поставщика и сохрани в reports/orders.csv». Ограничение — примерно 25 МБ.

Для облачных хранилищ, таких как OneDrive, Google Drive и SharePoint, ассистент нажимает на кнопку «Скачать» прямо в браузере, и файл захватывается через вашу авторизованную сессию — даже если сами байты файла идут с другого домена. Для сайтов с обычной ссылкой на скачивание он также может получить файл напрямую по ссылке. Большинство стандартных кнопок экспорта поддерживаются одним из этих способов. Небольшое число сайтов с нестандартными сценариями экспорта может не подойти — ассистент сообщит, если файл не удаётся захватить.

Загрузка файла на сайт

Вы также можете попросить ассистента прикрепить файл из рабочего пространства к кнопке загрузки на сайте — например: «загрузи счёт из invoices/jan.pdf на портал поставщика» или «прикрепи подписанный договор к полю загрузки в этой форме». Ассистент нажимает кнопку загрузки, а Plank читает файл прямо из вашего рабочего пространства и помещает его в диалоговое окно выбора — вам не нужно предварительно скачивать его. Файлы небольшого размера работают хорошо; очень большие файлы могут не успеть загрузиться в зависимости от скорости сайта.

Сохраните настройку, которую будете повторять

После того как вы провели ассистента по задаче в браузере, скажите «сохрани это как браузерную автоматизацию». Она появится отдельной записью в боковой панели Интеграции с кнопкой Запустить — нажмите её в любой момент, чтобы повторить тот же сценарий с уже настроенным входом. Чтобы запускать её по расписанию или при входящем сообщении, создайте обычное расписание или триггер с теми же инструкциями.

Предпочитаете API? Просто скажите

Многие сервисы можно подключить через их API — без браузера и без живой сессии. Ассистент сначала пробует именно этот путь и предлагает браузер, только когда подходящего API нет или подключение через API не сработало. Предлагая браузер, он объясняет, почему.

Если вы предпочитаете войти сами, так и скажите — «просто дай мне ссылку» — и ассистент пришлёт вам адрес, который вы откроете в своём браузере, где вы уже вошли. Для сервисов с OAuth это и есть обычный порядок: вы подтверждаете вход в своём браузере и вставляете адрес перенаправления обратно в чат.

У некоторых сайтов нет ни API, ни OAuth — внутренний инструмент, портал поставщика постарше. Там сессия браузера — единственный способ войти, и ассистент так и скажет, а не пришлёт ссылку, которая никуда не ведёт.

Сказать об этом достаточно один раз для каждого сервиса. Ассистент запомнит ваш выбор и больше не будет спрашивать про него.

Полезно знать

• Вкладки появляются автоматически. Когда ассистент открывает сессию браузера, вкладка появляется в просмотрщике файлов без каких-либо дополнительных действий. Вы можете переключиться на неё, уйти и вернуться — живой просмотр остаётся активным.
• На телефоне живой просмотр мелкий. Облачный браузер рисуется в десктопном размере и масштабируется под экран — работать можно, но для формы входа удобнее повернуть телефон горизонтально. На то, что ассистент делает внутри сайта, это не влияет.
• Некоторые сайты сопротивляются автоматизации. Большинство повседневных рабочих инструментов работают хорошо. Некоторые сайты с высоким уровнем безопасности (отдельные банки, отдельные системы расчёта зарплаты) могут запросить дополнительную проверку сессии или попросить подтвердить вход ещё раз.

Для ассистента — управление браузером (справочник по инструментам)

Этот раздел — для ИИ, управляющего браузером. Прочитайте его перед нетривиальной работой в браузере.

Не открывайте браузер первым действием. Если сессия для этого сайта уже есть (browser_list_integrations), используйте её. Иначе сначала идите по пути учётных данных — существующие ключи в scripts/<provider>/, руководство по провайдеру, OAuth-релей (ссылка, которую пользователь открывает в СВОЁМ браузере). Только когда подходящего API нет или он не сработал, объясните одной строкой почему и СПРОСИТЕ, прежде чем вызывать browser_request_user_login. Затем запишите их ответ через plank_memory_add с привязкой к сервису, чтобы спрашивать один раз на сервис, а не каждый ход.

Сначала смотрите, потом действуйте. browser_snapshot возвращает дерево доступности страницы и индекс «Targetable elements» со ссылками ref. Указывайте цель по ref (точно) или по роли + доступному имени. browser_navigate принимает только http(s) — никаких javascript: URL. Снимок — самый медленный шаг: действуйте по всем видимым полям из ОДНОГО снимка, прежде чем делать следующий; пересоздавайте снимок только после перехода, открытия/закрытия диалога или когда ref перестаёт совпадать (страница перерисовалась). Если снимок сообщает, что список усечён, — сузьте его (ниже), а не прокручивайте вслепую.

Поля выбора (picker/chooser). В некоторые поля нельзя печатать — их значение ВЫБИРАЕТСЯ из всплывающего окна (справочники, модальные окна «выберите элемент», каскадные деревья). browser_snapshot помечает их как «picker field (read-only)». Не используйте browser_type на них (это молча ничего не делает, а обязательное пустое поле блокирует отправку). Вместо этого нажмите соседний элемент, открывающий выбор (надпись бывает разной — Select, Choose, Lookup, Browse, значок лупы/▾, возможно на языке сайта); такие триггеры, кнопки панели, строки списков и кнопки «Сохранить» появляются в снимке как кнопки, даже если сайт сделал их обычным кликабельным текстом с JS-обработчиком. Сделайте СВЕЖИЙ снимок — элементы диалога включаются, даже если он внутри iframe или во всплывающем окне. Чтобы сузить длинный список, введите запрос в поле поиска и нажмите кнопку поиска — НЕ Enter (избегайте submit:true в поиске по списку), потому что на некоторых корпоративных формах Enter отправляет основную форму и уводит со страницы, теряя несохранённый черновик. Затем выберите строку результата по ref и нажмите Confirm/OK. Поле форматированного текста (редактор причины/описания) выглядит как textbox с пустым или общим именем внутри секции ── Frame: about:blank ── — заполняйте его через browser_type по его ref, как обычное поле.

Скачать файл в рабочее пространство (browser_download). Одна явная кнопка: click:{role,name}; прямая ссылка того же домена: url. Многошаговые/скрытые загрузки (OneDrive, SharePoint, Drive): ARM/COLLECT — browser_download(label, arm:true), запустите загрузку обычными кликами/переходом, затем browser_download(label, collect:true, save_to). Лимит ~25 МБ; save_to — путь относительно рабочего пространства. В списке файлов, где у каждой строки одинаковое имя чекбокса, ограничьте клик строкой по имени файла. Скрытую кнопку «Скачать» откройте через browser_press_key или используйте режим зрения.

Загрузить файл из рабочего пространства на сайт (browser_upload). Передайте path файла и ref (предпочтительно) либо role+name элемента загрузки; диалог выбора файла заполняется за вас. Скрытый/стилизованный <input type=file> (часто на корпоративных формах — выглядит как textbox с именем вида __landray_filefd_... или кнопка «Choose File») заполняется НАПРЯМУЮ по его ref, без клика. Несколько файлов: extra_paths. Для загрузки из меню/флайаута, не видимого в снимке, используйте browser_upload_at с координатами со скриншота.

Режим зрения — крайнее средство, только для элементов, которых нет в снимке (canvas, просмотрщик PDF/не-DOM): browser_screenshot (1536×864), затем browser_click_at(x,y) / browser_type_at(x,y,text,submit).

Сохранить повторяемую автоматизацию. Создайте scripts/browser/<slug>.md, первые строки которого — <!-- @plank-browser-automation / name: <название> / login: <ТОЧНАЯ метка входа, которую переиспользует сценарий> / -->, далее сам сценарий в виде промпта. Он появится в боковой панели «Интеграции» с кнопкой «Запустить».