Облачный браузер

Облачный браузер — одна общая Chromium-сессия для пользователя и агента. Внутри сессии можно открыть несколько вкладок, сохранить авторизацию и передавать управление.

Чем Облачный браузер отличается от Превью

	Облачный браузер	Превью
Главная задача	Открывать сайты и выполнять реальные пользовательские сценарии	Проверять разрабатываемое приложение до публикации
Что открывает	Обычные https://-адреса, внешние сервисы и опубликованные приложения	Dev-сервер текущего рабочего стола по порту 3000–9999, кроме 8000
Состояние	Общий Chromium-профиль, несколько вкладок, cookies и сохранённые входы	Текущая локальная версия кода и состояние выбранного dev-сервера
Управление	Пользователь и агент передают друг другу право взаимодействия	Интерфейс локальной проверки; передавать управление общей браузерной сессией не требуется
Инструмент основного агента	promto_browser	promto_preview
Команда в профессиональном терминале	promto browser ...	promto preview screenshot --current --port <порт>

Кнопка Открыть отдельно во вкладке Превью по-прежнему открывает локальный preview-контур. Она не создаёт вкладку Облачного браузера и не использует его сохранённый профиль.

Браузер нужен, например, чтобы:

• открыть документацию или сайт-референс;
• войти во внешний сервис;
• проверить опубликованный URL;
• заполнить форму или пройти сценарий в сохранённом аккаунте;
• сравнить внешний сайт с локальным приложением.

Превью нужно, чтобы увидеть свежие изменения из /home/user, проверить порт, мобильную ширину и Console до публикации. Не вводите в Браузер sandbox-адреса localhost, 127.0.0.1 или 0.0.0.0.

Если задача затрагивает оба контура, используйте их раздельно: внешний сайт — в Браузере, локальную реализацию — в Превью.

Запуск

1. Если плитки Браузера ещё нет на рабочем столе, откройте Настройки и включите приложение.
2. Откройте приложение Браузер на рабочем столе или в Dock.
3. Нажмите Запустить браузер.
4. Дождитесь запуска Chromium.
5. Если ранее был сохранён профиль, выберите Продолжить с профилем.
6. Откройте нужный сайт и при необходимости войдите в аккаунт самостоятельно.

Профиль и cookies могут сохраняться между сессиями. Провайдерский ключ при этом не передаётся в пользовательский браузер или sandbox.

Управление

Одновременно браузером управляет только один участник:

• Управляю я — запросить интерактивное управление;
• Передать агенту — освободить управление для агента;
• режим просмотра — видеть происходящее без возможности конфликтующих кликов.

Если агент или другая вкладка уже владеет управлением, дождитесь освобождения либо вернитесь в активную вкладку. Управление подтверждается ограниченной по времени сессией и освобождается, когда активная вкладка перестаёт его поддерживать.

Панель действий

• Логи — Console текущей вкладки и журнал действий пользователя и агента за 14 дней.
• Обновить состояние — получить актуальные вкладки и статус.
• Сбросить профиль — безвозвратно удалить сохранённые входы, вкладки и историю действий.
• Завершить сессию — сохранить допустимое состояние профиля и остановить браузер.

Сброс профиля и завершение доступны только когда текущий пользователь может изменять сессию.

Безопасная авторизация

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

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

1. Нажмите Обновить состояние или Повторить.
2. Проверьте предупреждение в верхней части приложения.
3. Если облачный провайдер не настроен, действие должен выполнить администратор.
4. Не запускайте несколько новых сессий подряд: на рабочее пространство предусмотрена одна сессия с несколькими вкладками.

Логи

Используйте Console текущей вкладки, чтобы найти ошибку страницы, а журнал действий — чтобы проверить, кто и какое действие запускал. При обращении в поддержку передайте время, адрес страницы и безопасный текст ошибки без cookies, токенов и персональных данных.

Инструкции и CLI для агента

Отдельной focused-инструкции с English title и topic для Облачного браузера нет.

Основной доверенный инструмент в режиме агента — promto_browser. Его действия называются workspace_status, start, stop, list_tabs, open_tab, activate_tab, close_tab, navigate, observe, click, fill, type, press, select, check, uncheck, scroll, wait, screenshot, logs и run_steps.

В профессиональном терминале используется реальный CLI promto-browser или его универсальная форма promto browser:

promto browser status
promto browser start
promto browser tabs
promto browser open --url https://example.com
promto browser observe --tab-id <tab-id>
promto browser click --tab-id <tab-id> --snapshot-id <snapshot-id> --ref <ref>
promto browser fill --tab-id <tab-id> --label "Search" --value "Promto"
promto browser screenshot --tab-id <tab-id>
promto browser logs --tab-id <tab-id>

Для надёжного действия агент сначала получает snapshot_id и ref через observe, а затем кликает по этой ссылке. run_steps принимает от 1 до 20 шагов. Эти инструменты работают с общей облачной Chromium-сессией и её сохранённым профилем; локальный Chromium или Playwright не являются заменой.

Готовый промпт для агента

Используй только доверенный tool promto_browser. Сначала определи контур: если нужно проверить локальное приложение из текущего рабочего пространства, не используй Браузер — перейди к promto_preview и фактическому порту. Для внешнего или опубликованного сайта вызови workspace_status, при необходимости start, затем list_tabs. Открой <URL> через open_tab или активируй существующую вкладку. Один раз вызови observe, сохрани полученные tab_id, snapshot_id и ref и выполняй действия по ref; после изменения страницы получай новый snapshot. В конце сделай screenshot и проверь logs. Если управление сейчас у меня, остановись и попроси передать его агенту. Не используй локальный Chromium или Playwright и не проси у меня пароль или код второго фактора.