WebBrowser показывает приложение вам и агенту
WebBrowser — это живая поверхность Chromium внутри Canvas. Подключённый CodingAgent может наблюдать, взаимодействовать, ждать, отлаживать и проверять ту же страницу, которую видите вы.
Откройте демонстрацию WebBrowser в Kavor (открывается в новой вкладке) в другой вкладке во время чтения.
Browser как инструмент разработки
Для разработки веб-приложения CodingAgent недостаточно редактировать файлы. Ему нужно открыть приложение, взаимодействовать с ним, ждать реальных состояний и исследовать происходящее в browser.
Connection CodingAgent + WebBrowser предоставляет широкую поверхность операций через Kavor:
- наблюдать: читать состояние страницы, получать accessibility snapshot и screenshots;
- взаимодействовать: нажимать, заполнять поля, вводить текст, выбирать, прокручивать, перетаскивать, загружать файлы и отвечать на диалоги;
- синхронизировать: ждать selector, текст, URL, состояние загрузки, отсутствие сетевой активности или заданное условие;
- отлаживать: читать сообщения console, сетевые requests и сохранённые тела responses;
- проверять: воспроизводить bug, выполнять E2E-flow и сохранять визуальное доказательство;
- изолировать сценарии: блокировать, продолжать или подменять сетевые ответы в контролируемом тесте;
- управлять страницами: открывать, выбирать и закрывать вкладки, отслеживать загрузки и решать задачи аутентификации.
Цель не в том, чтобы спрятать browser за автоматизацией, а в том, чтобы состояние и действия оставались проверяемыми.
Практический цикл для веб-приложения
Начните с WebBrowser и CodingAgent в одном компоненте. Если приложение запущено локально, подключите и Terminal, который запускает сервер.
Попросите агента сначала наблюдать страницу, затем воспроизвести сбойный путь, собрать доказательства из console, сети или screenshot, изменить код в заданной области и снова проверить весь путь. Результат и оставшиеся риски запишите в Sticky Note.
Начальный prompt:
Открой подключённое приложение в WebBrowser. Сначала наблюдай страницу и воспроизведи сценарий без изменения кода. Затем опиши вероятную причину, предложи минимальное изменение и проверь весь путь с визуальными доказательствами и данными console.
Три примера разработки с доказательствами
Воспроизвести ошибку формы
С сервером в Terminal и приложением в WebBrowser попросите:
Воспроизведи отправку с неправильным e-mail, затем с правильным адресом. До изменения кода запиши состояние полей, показанное сообщение и наличие request. После разрешённого исправления повтори оба пути и проверь исправление адреса без перезагрузки страницы.
Ожидается видимое поведение вместе с наблюдаемыми requests. Screenshot сообщения сам по себе не доказывает, что отправка заблокирована; сеть помогает проверить этот критерий.
Узнать, почему страница пуста
Посмотри страницу, изучи ошибки console и найди request, связанный с отсутствующим содержимым. Различи сетевую ошибку, неожиданный ответ и сбой rendering. Запиши нужный URL, status и доступные доказательства. Если тело ответа нельзя наблюдать, укажи это ограничение.
Ожидается расследование по признакам, позволяющим различить причины, до изменения кода. Отсутствие содержимого не доказывает, что backend сломался.
Проверить восстановление после сетевого сбоя
В тестовом приложении под вашим контролем задайте временный сценарий:
Имитируй ответ с ошибкой только для request загрузки из Specification. Проверь сообщение об ошибке и возможность повтора. Затем удали временное правило и подтверди восстановление обычного пути. Сохрани результаты и заверши тест с очищенными сетевыми правилами.
Ожидается проверка сбоя и восстановления в изолированном сценарии. Используйте тестовые endpoints и данные; симуляция должна быть достаточно точной, чтобы не менять посторонние requests.
Тот же browser для человека
WebBrowser можно использовать и как обычную страницу Workspace: открыть документацию, посмотреть видео или оставить справочную страницу, пока агенты работают.
YouTube и другие обычные страницы — естественный сценарий. Streaming-сервисы вроде Netflix могут требовать аутентификацию, DRM, разрешения или особые условия системы, поэтому Kavor не гарантирует воспроизведение конкретного сервиса.
Общая поверхность, а не невидимый browser
Агент и человек используют одну живую страницу. Вы видите действия и можете вмешаться; у агента нет скрытого приватного окна; постоянные вкладки принадлежат отдельному browser profile Kavor, общему для его WebBrowsers; расширения, история и cookies внешнего Chrome автоматически не используются.
Содержимое страницы считается недоверенным. WebBrowser также не является удалённым browser-сервисом или общим разрешением на работу с filesystem машины.
Ограничения и осторожность
Управляйте жизненным циклом и звуком
В настройках Node Shutdown закрывает работающие страницы, а Start снова открывает Browser. Сохранённые вкладки и данные сайтов, включая входы, остаются; неотправленные формы и другое состояние в памяти могут потеряться. Выключение не означает очистку cookies или удаление Node.
Mute browser audio выключает звук всех вкладок и всплывающих окон этого Browser. Выбор звука и явное намерение открыть или выключить сохраняются; смена Workspace или повторный монтаж UI не должны их отменять.
Работающая страница может оставаться доступной агенту вне видимого Canvas. Не нужно держать все страницы и процессы открытыми: завершайте сессию через Shutdown, а не рассчитывайте, что уход с экрана её закроет.
CAPTCHA, passkeys, разрешения сайта, сертификаты и prompts аутентификации могут требовать вашего участия. Ссылки snapshot устаревают после навигации или изменения DOM. Сетевые правила временны и должны быть очищены после теста. Профиль разработки принимает самоподписанные, просроченные сертификаты и сертификаты частных центров, что снижает защиту от враждебной сети. Будьте осторожны перед входом в чувствительные сервисы.
Snapshot может пропускать cross-origin frames, а истории console и сети ограничены. Агент должен сообщать наблюдаемые доказательства, а не выдумывать то, что не смог проверить.
При смене Workspace в том же окне Kavor сохраняет отображаемую страницу. Подключённый CodingAgent может продолжать работать с ней, пока виден другой Workspace. Закрытие вкладки, удаление Node или завершение сессии прекращает эту непрерывность.
Connection и Guardrail
Прямая пара CodingAgent + WebBrowser помещает browser в достижимый компонент агента. Через действительные пути граф может включать Specification, Files, Terminal, Sticky Note и другие CodingAgents; визуальная близость или упоминание в сообщении доступ не создают.
У WebBrowser сейчас нет собственного Guardrail. Ограничения других ресурсов графа сохраняются: read-only File остаётся read-only, Terminal сохраняет свои средства управления, а Specification следует lifecycle.
Что дальше
- Изучите контракт CodingAgent + WebBrowser в матрице Connections.
- Прочитайте, как CodingAgents видят и строят Canvas.
- Объедините browser, код и доказательства в первом цикле.
- Определите ожидаемое поведение в Specification до проверки приложения.