Интеграция с клиентом MBBrowser ControlV2

Причина, по которой MBAgent «реально может работать с Mbbrowser», — это коммуникационный протокол под названием Mbbrowser Client ControlV2. В этой статье подробно описано, как MBAgent устанавливает связь с Mbbrowser, и разобраны типичные проблемы.

NOTE

Описание скриншота: скриншот «двойного управления» при одновременной работе MBAgent и Mbbrowser (главное окно Mbbrowser + главное окно MBAgent рядом) будет добавлен в v1.x. В этом разделе сначала описывается текстом.

1. Что такое клиент MBBrowser ControlV2?

Mbbrowser Client ControlV2 — это двусторонний коммуникационный протокол, предоставляемый Mbbrowser наружу и позволяющий другим программам (включая MBAgent):

🔍 Обнаруживать локально запущенные экземпляры Mbbrowser
🤝 Делать handshake с экземплярами Mbbrowser
🔑 Входить через аккаунт Mbbrowser
📦 Загружать конфигурацию Mbbrowser (среды, прокси, отпечаток)
🚀 Запускать / останавливать среды Mbbrowser
🌐 Работать с веб-страницами в средах Mbbrowser

NOTE

Аналогия: ControlV2 — это «протокол пульта управления» Mbbrowser. MBAgent — пульт, Mbbrowser — телевизор.

2. Три режима подключения MBAgent к Mbbrowser

1. Контроллер MBAgent (рекомендуется)

При запуске MBAgent автоматически запускает локальный сервис управления Mbbrowser, к которому подключается Mbbrowser как клиент.

Сценарии использования:

Один экземпляр Mbbrowser
Большинство индивидуальных пользователей
Mbbrowser + MBAgent на одном ПК

2. Контроллер ApiServer

Подключение через встроенный ApiServer Mbbrowser (интерфейс http://127.0.0.1:8186).

Сценарии использования:

Удалённое управление Mbbrowser
Mbbrowser на другой машине
Скрипты автоматизации (Selenium / Puppeteer / Playwright)

3. Тот же экземпляр

MBAgent и Mbbrowser находятся в одном экземпляре клиента и общаются напрямую внутри.

Сценарии использования:

Разработка и отладка
Сценарии, чувствительные к производительности

3. Первое подключение к Mbbrowser

Предусловия

✅ Mbbrowser запущен и выполнен вход в аккаунт ✅ MBAgent установлен ✅ Рабочий каталог, выбранный при запуске MBAgent, имеет права

Авто-поток подключения

MBAgent автоматически выполняет следующий поток при запуске:

[1] Запустить локальный сервис ControlV2
    ↓
[2] Сканировать локальные экземпляры Mbbrowser
    - Через UDP-broadcast / сканирование локальных портов
    - Найти порт ControlV2 Mbbrowser
    ↓
[3] Handshake
    - Обмен номерами версий протокола
    - Согласование метода шифрования
    ↓
[4] Вход в аккаунт
    - MBAgent входит в ControlV2 от имени аккаунта Mbbrowser
    - Авто-чтение Token
    ↓
[5] Загрузка конфигурации
    - Загрузка всех сред аккаунта Mbbrowser
    - Загрузка конфигурации прокси аккаунта Mbbrowser
    ↓
[6] Проверка возможностей
    - Тест запуска / остановки сред
    - Тест接管 веб-страницы
    - Тест файловых операций
    ↓
[7] Подключение успешно ✅

Просмотр состояния подключения

Перейдите в «Настройки → Проверка официальных сервисов»
Кликните «Клиент MBBrowser ControlV2»
Кликните «Начать проверку»
Через несколько секунд отобразится:
- ✅ Норма: все проверки пройдены
- ⚠️ Аномалия: какой шаг провалился
- ⚪ Не включено: ControlV2 не включён
- ⏳ Проверка: идёт проверка

4. Чтение результатов проверки

✅ Норма

Отображается:

Mbbrowser Client ControlV2 доступен для использования
Real-time readiness round-trip detection verified connection, login, configuration, and executable capability.

Значит, MBAgent может нормально работать с Mbbrowser.

⚠️ Аномалия: сбой подключения

Возможные причины:

Mbbrowser не запущен
Порт ControlV2 занят
Брандмауэр блокирует

Решение:

Убедитесь, что Mbbrowser запущен
Проверьте: Mbbrowser → Настройки → включён ли ControlV2
Отключите брандмауэр / антивирус и попробуйте снова

⚠️ Аномалия: аккаунт не выполнен вход

Возможные причины:

Token аккаунта Mbbrowser истёк
MBAgent не прочитал Token

Решение:

Заново войдите в аккаунт внутри Mbbrowser
Перезапустите MBAgent

⚠️ Аномалия: сбой загрузки конфигурации

Возможные причины:

У аккаунта Mbbrowser нет созданных сред
Сбой подключения к базе данных Mbbrowser

Решение:

Создайте среду внутри Mbbrowser
Перезапустите MBAgent

⚠️ Аномалия: проверка возможностей не пройдена

Возможные причины:

Версия Mbbrowser несовместима с MBAgent
Недостаточно прав системы

Решение:

Убедитесь, что Mbbrowser — последней версии
Запустите MBAgent с правами администратора
Обратитесь в поддержку Mbbrowser

5. Переключение экземпляров управления Mbbrowser

Если локально есть несколько экземпляров Mbbrowser (сценарий разработки), можно переключаться:

Шаг 1: просмотр всех экземпляров Mbbrowser

Перейдите в «Настройки → Клиент MBBrowser ControlV2»
Кликните «Экземпляр Mbbrowser»
Отобразится список обнаруженных экземпляров:

Экземпляр Mbbrowser #1 (по умолчанию)
  - Порт: 8186
  - Версия: v3.0.0
  - Состояние: подключён

Экземпляр Mbbrowser #2 (dev)
  - Порт: 8286
  - Версия: v3.0.0
  - Состояние: не подключён

Шаг 2: переключение

Выберите целевой экземпляр Mbbrowser
Нажмите кнопку «Переключить»
MBAgent отключится от текущего экземпляра и подключится к новому
Внимание: переключение остановит все текущие операции Mbbrowser

TIP

Повседневное использование: 99% пользователей хватает одного экземпляра Mbbrowser; переключение не нужно.

6. Как ИИ работает с Mbbrowser

Когда MBAgent получает команду «работать с Mbbrowser», он автоматически выполняет следующий поток:

[1] ИИ разбирает задачу
    «Открой магазин 223223, проверь сегодняшние заказы»
    ↓
[2] Вызов интерфейса ControlV2
    - control.browser.start({ environment_id: "223223" })
    ↓
[3] Mbbrowser запускает среду
    - Создать / переиспользовать среду 223223
    - Применить отпечаток / прокси / cookies
    - Вернуть browser_handle
    ↓
[4] MBAgent接管 страницы через CDP
    - attach({ handle })
    - Получать скриншоты страницы, структуру DOM
    ↓
[5] ИИ анализирует страницу + принимает решение
    «Увидел страницу заказов, дальше извлекаю числа»
    ↓
[6] Выполнить действие
    - click / type / extract
    ↓
[7] Завершить задачу, закрыть среду (или оставить открытой)
    ↓
[8] Оформить результат для пользователя
    «Сегодня 23 заказа, на сумму $1234.56»

Ключевые понятия

handle: «дескриптор среды», возвращаемый Mbbrowser MBAgent — ссылка на конкретную среду
attach: MBAgent接管 страницу среды Mbbrowser
CDP: Chrome DevTools Protocol — протокол, лежащий в основе Mbbrowser

7. Часто задаваемые вопросы

Q1: MBAgent показывает «Waiting for Mbbrowser CDP» после запуска

Причина: Mbbrowser не запущен, или среда не запущена.

Решение:

Убедитесь, что Mbbrowser запущен и выполнен вход
Запустите среду вручную внутри Mbbrowser
MBAgent автоматически перехватит

Q2: ИИ не может работать со средой Mbbrowser

Возможные причины:

Аномалия ControlV2 (см. проверку официальных сервисов)
Закончилась квота аккаунта Mbbrowser
Среда Mbbrowser повреждена

Решение:

В Настройки → Проверка официальных сервисов посмотрите, нормален ли ControlV2
Проверьте квоту ИИ аккаунта Mbbrowser
Вручную протестируйте эту среду внутри Mbbrowser

Q3: Чёрный экран после接管 страницы Mbbrowser

Возможные причины:

Mbbrowser только что запущен, среда ещё не готова
Аккаунт Mbbrowser требует двухфакторной проверки

Решение:

Подождите 5-10 секунд и попробуйте снова
Пройдите проверку вручную внутри Mbbrowser

Q4: Может ли MBAgent управлять удалённым Mbbrowser?

❌ Нет. Подключение MBAgent к клиенту Mbbrowser ControlV2 жёстко ограничено адресом 127.0.0.1 на уровне реализации (ControlClientError::NonLoopbackEndpoint); любой IP, не являющийся loopback, отклоняется. Даже если порт ControlV2 Mbbrowser выставлен наружу (например, 0.0.0.0:8186), MBAgent сразу откажет в соединении на этапе handshake.

Правильный способ удалённого управления Mbbrowser:

Используйте скрипты Selenium / Puppeteer / Playwright для удалённого вызова встроенного ApiServer Mbbrowser (http://127.0.0.1:8186) — см. выше раздел 2 «Три режима подключения MBAgent к Mbbrowser → 2. Контроллер ApiServer»
В этом сценарии MBAgent не участвует; это обычный HTTP-клиент, вызывающий ApiServer-интерфейсы Mbbrowser

NOTE

Почему ограничение loopback:

Сам протокол ControlV2 не имеет строгой аутентификации; открытие TCP-порта в публичную сеть означает «отдать управление аккаунтом Mbbrowser кому угодно»
MBAgent и Mbbrowser предполагаются на одной машине и в одном контексте аккаунта; loopback — это граница с наименьшим риском

Q5: Можно ли пользоваться MBAgent без работы с Mbbrowser?

✅ Конечно. Базовые функции MBAgent (чат, документы, код, база знаний) не зависят от Mbbrowser. Только когда вы явно просите работать со средами аккаунтов Mbbrowser — устанавливается подключение ControlV2.

8. Лучшие практики

Порядок запуска

Рекомендуемый порядок:

Mbbrowser (сначала запустить и войти)
MBAgent (затем — авто-подключение)

Не наоборот.

Когда долго не используете

Если долго не работаете со средами Mbbrowser:

Закройте в MBAgent входы в боковой панели «RAG-база знаний Mbbrowser» и «Клиент MBBrowser ControlV2»
Уменьшите число операций Mbbrowser в задачах
Сэкономьте ресурсы аккаунта Mbbrowser

Командная работа

Если несколько сотрудников делят один аккаунт Mbbrowser:

MBAgent каждого может подключаться независимо
Но одновременная работа с одной средой приведёт к конфликту
Рекомендуется работать посменно или открывать независимые подаккаунты Mbbrowser для каждого

Дальше: Управление правами и безопасность → Спокойно поручайте ИИ работу.

Интеграция с клиентом MBBrowser ControlV2 ​

1. Что такое клиент MBBrowser ControlV2? ​

2. Три режима подключения MBAgent к Mbbrowser ​

1. Контроллер MBAgent (рекомендуется) ​

2. Контроллер ApiServer ​

3. Тот же экземпляр ​

3. Первое подключение к Mbbrowser ​

Предусловия ​

Авто-поток подключения ​

Просмотр состояния подключения ​

4. Чтение результатов проверки ​

✅ Норма ​

⚠️ Аномалия: сбой подключения ​

⚠️ Аномалия: аккаунт не выполнен вход ​

⚠️ Аномалия: сбой загрузки конфигурации ​

⚠️ Аномалия: проверка возможностей не пройдена ​

5. Переключение экземпляров управления Mbbrowser ​

Шаг 1: просмотр всех экземпляров Mbbrowser ​

Шаг 2: переключение ​

6. Как ИИ работает с Mbbrowser ​

Ключевые понятия ​

7. Часто задаваемые вопросы ​

Q1: MBAgent показывает «Waiting for Mbbrowser CDP» после запуска ​

Q2: ИИ не может работать со средой Mbbrowser ​

Q3: Чёрный экран после接管 страницы Mbbrowser ​

Q4: Может ли MBAgent управлять удалённым Mbbrowser? ​

Q5: Можно ли пользоваться MBAgent без работы с Mbbrowser? ​

8. Лучшие практики ​

Порядок запуска ​

Когда долго не используете ​

Командная работа ​

Интеграция с клиентом MBBrowser ControlV2

1. Что такое клиент MBBrowser ControlV2?

2. Три режима подключения MBAgent к Mbbrowser

1. Контроллер MBAgent (рекомендуется)

2. Контроллер ApiServer

3. Тот же экземпляр

3. Первое подключение к Mbbrowser

Предусловия

Авто-поток подключения

Просмотр состояния подключения

4. Чтение результатов проверки

✅ Норма

⚠️ Аномалия: сбой подключения

⚠️ Аномалия: аккаунт не выполнен вход

⚠️ Аномалия: сбой загрузки конфигурации

⚠️ Аномалия: проверка возможностей не пройдена

5. Переключение экземпляров управления Mbbrowser

Шаг 1: просмотр всех экземпляров Mbbrowser

Шаг 2: переключение

6. Как ИИ работает с Mbbrowser

Ключевые понятия

7. Часто задаваемые вопросы

Q1: MBAgent показывает «Waiting for Mbbrowser CDP» после запуска

Q2: ИИ не может работать со средой Mbbrowser

Q3: Чёрный экран после接管 страницы Mbbrowser

Q4: Может ли MBAgent управлять удалённым Mbbrowser?

Q5: Можно ли пользоваться MBAgent без работы с Mbbrowser?

8. Лучшие практики

Порядок запуска

Когда долго не используете

Командная работа