Часто задаваемые вопросы (FAQ) MBAgent

В этой статье собраны частые вопросы и решения по использованию MBAgent. Если вашей проблемы здесь нет — обратитесь в поддержку Mbbrowser.

---

1. Установка и запуск

Q1.1: Двойной клик по иконке MBAgent не даёт реакции

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

• Mbbrowser не запущен
• Аккаунт Mbbrowser не выполнен вход
• Недостаточно прав на рабочий каталог

Решение:

1. Запустите Mbbrowser и войдите
2. Проверьте, существует ли рабочий каталог MBAgent
3. Запустите MBAgent с правами администратора

Q1.2: После запуска постоянно отображается «Выберите рабочий каталог»

Причина: основная программа Mbbrowser не запущена, MBAgent не может прочитать информацию об аккаунте.

Решение:

1. Закройте MBAgent
2. Запустите Mbbrowser и войдите
3. Перезапустите MBAgent

Q1.3: После запуска китайский отображается как «крякозябры»

Решение:

1. Параметры Windows → Время и язык → Язык → Язык интерфейса Windows → 简体中文 (Китай)
2. Перезагрузите компьютер

Q1.4: При установке «Установлена более новая версия»

Решение:

1. Панель управления → Программы и компоненты → удалите старую версию Mbbrowser
2. Удалите C:\Program Files\Mbbrowser
3. Установите новую версию

---

2. Подключение к Mbbrowser

Q2.1: MBAgent показывает «Waiting for Mbbrowser CDP»

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

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

Решение:

1. Запустите Mbbrowser
2. Проверьте: Mbbrowser → Настройки → включён ли ControlV2
3. Отключите брандмауэр / антивирус

Q2.2: ИИ не может работать с Mbbrowser

Шаги диагностики:

1. Перейдите в «Настройки → Проверка официальных сервисов»
2. Кликните «Начать проверку» для «Клиент MBBrowser ControlV2»
3. Посмотрите конкретный провалившийся шаг

Q2.3: ИИ постоянно не может работать с Mbbrowser

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

• Квота аккаунта Mbbrowser исчерпана
• Среда Mbbrowser повреждена
• Проблемы с сетью

Решение:

1. Проверьте квоту ИИ аккаунта Mbbrowser
2. Вручную протестируйте среду в Mbbrowser
3. Обратитесь в поддержку Mbbrowser

Q2.4: Можно ли управлять удалённым Mbbrowser?

✅ Да, но нужно:

1. Запустить Mbbrowser на удалённой машине
2. Открыть порт ControlV2
3. В MBAgent настроить удалённый IP + порт

⚠️ Используйте только в доверенных сетях (VPN / интранет).

---

3. Модели и Provider

Q3.1: Список моделей пуст

Причина: у аккаунта Mbbrowser не подключена квота моделей ИИ.

Решение:

1. Откройте консоль Mbbrowser
2. Перейдите в «Модели ИИ» → подключите квоту
3. Вернитесь в MBAgent → обновите список моделей

Q3.2: После переключения Provider список не изменился

Решение:

1. Проверьте, настроен ли API Key у этого Provider
2. Проверьте успешность тестового подключения
3. Перезапустите MBAgent

Q3.3: Собственный Provider не подключается

Решение:

1. Проверьте правильность API Key и Base URL
2. Проверьте сетевую доступность (ping / curl)
3. Посмотрите журналы MBAgent (%LOCALAPPDATA%\mbagent\logs\)

Q3.4: Модель отвечает очень медленно

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

• Проблемы с сетью
• Перегрузка модели
• Слишком длинный контекст

Решение:

1. Переключитесь на более быструю модель
2. Сожмите историю сессии (/compact)
3. Проверьте сеть

---

4. Задачи и расписание

Q4.1: Запланированная задача не сработала, как ожидалось

Решение:

1. Проверьте cron-выражение
2. Проверьте, запущен ли MBAgent (Daemon не установлен)
3. Посмотрите историю задачи
4. Убедитесь в правильности системного времени

Q4.2: Задачи не выполняются при спящем режиме ПК

Решение:

1. Установить MBAgent Daemon
2. Настроить ПК не засыпать
3. Настроить таймеры пробуждения

Q4.3: Задачи постоянно падают

Решение:

1. Запустить задачу вручную — посмотреть ошибку
2. Проверить онлайн-статус Mbbrowser
3. Упростить описание задачи, отлаживать шаг за шагом
4. Обратиться в поддержку Mbbrowser

Q4.4: Запланированная задача расходует слишком много токенов

Решение:

1. Используйте дешёвые модели
2. Отключите «Показывать ход рассуждений»
3. Уменьшите частоту выполнения
4. Оптимизируйте промпт

---

5. Файлы и вложения

Q5.1: Загрузка большого файла не удалась

Ограничения:

• Для одного файла рекомендуется < 50 МБ
• Для сверхбольших файлов (>100 МБ) используйте инструмент чтения пути ИИ

Решение:

1. Сжать файл (zip)
2. Использовать инструмент Read, чтобы ИИ читал сам
3. Загружать частями

Q5.2: ИИ не видит изображение

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

• Текущая модель не поддерживает мультимодальность
• Изображение слишком большое
• Формат изображения не поддерживается

Решение:

1. Переключитесь на модель с поддержкой мультимодальности (gpt-5, claude-sonnet-4)
2. Сжать изображение
3. Сконвертировать в JPG / PNG

Q5.3: Файл, изменённый ИИ, не сохранился

Решение:

1. Не нажали ли случайно «Отклонить»?
2. Есть ли права на запись в рабочем каталоге?
3. Проверьте, не записал ли банк памяти ИИ неправильный путь

---

6. Права и безопасность

Q6.1: Как отозвать неправильную операцию ИИ?

Шаги:

1. Немедленно нажмите Esc, чтобы остановить ИИ
2. Посмотрите журнал операций
3. Вручную откатите неправильные действия ИИ

Q6.2: ИИ удалил мои файлы — как восстановить?

Случай 1: файл внутри песочницы (рабочий каталог)

• Если включено «резервное копирование» — восстановить из бэкапа
• Иначе нужны профессиональные инструменты восстановления

Случай 2: файл вне песочницы (системный каталог)

• ⚠️ Такие операции по умолчанию блокируются
• Если это произошло — немедленно обратитесь в поддержку Mbbrowser

Профилактика:

• Перед операциями ИИ с важными файлами делайте резервные копии
• Используйте режим Ask (всплывающее подтверждение)

Q6.3: Безопасен ли API Key?

✅ Безопасен:

• MBAgent не загружает API Key
• Key хранится только в Windows Credential Manager
• При удалении MBAgent учётные данные очищаются

⚠️ Рекомендации:

• Регулярно ротируйте API Key
• Не вставляйте открытый Key в банк памяти или сессии

---

7. Банк памяти ИИ

Q7.1: ИИ как будто не «помнит» то, что я говорил раньше

Решение:

1. Проверьте, есть ли запись в банке памяти ИИ
2. Попросите ИИ запомнить заново и подтвердите
3. Проверьте, не менялся ли рабочий каталог

Q7.2: ИИ использовал неправильную память

Решение:

1. Отредактируйте эту память
2. Исправьте или удалите

Q7.3: Как сделать резервную копию банка памяти?

1. Найдите каталог: %LOCALAPPDATA%\mbagent\memory\
2. Скопируйте всю папку
3. Сохраните в безопасном месте

---

8. Интерфейс и отображение

Q8.1: Интерфейс тормозит

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

• Недостаточно системных ресурсов
• Загружено слишком много сессий / KMS / MCP
• Проблемы с рендерингом темы

Решение:

1. Закройте ненужные вкладки
2. Уменьшите количество сессий
3. Смените тему (тёмная < светлая)
4. Перезапустите MBAgent

Q8.2: Шрифт отображается некорректно

Решение:

1. Проверьте целостность системных шрифтов
2. В настройках MBAgent переключите шрифт

Q8.3: Панель вкладок не видна

Решение:

1. Настройки → Интерфейс и навигация → Какие вкладки показывать → отметьте все
2. Перезапустите MBAgent

---

9. Оптимизация производительности

Q9.1: MBAgent занимает много памяти

Нормальный диапазон:

• В простое: 200-500 МБ
• Сложная задача: 1-2 ГБ
• Высокий параллелизм: 2-4 ГБ

Оптимизация:

1. Закрыть ненужные сессии
2. Уменьшить число параллельных задач
3. Удалить неиспользуемые MCP-сервисы

Q9.2: ИИ отвечает медленно

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

• Задержка сервера модели
• Проблемы с сетью
• Слишком длинный контекст

Оптимизация:

1. Переключитесь на более быструю модель
2. Сожмите историю
3. Проверьте сеть

---

10. Обновления и апгрейды

Q10.1: Как обновить MBAgent?

MBAgent обновляется вместе с Mbbrowser:

1. Mbbrowser при запуске авто-проверяет новую версию
2. Появляется подсказка об обновлении
3. Нажмите «Обновить сейчас»
4. Перезапустите после обновления

Q10.2: После обновления данные пропали?

Не должны:

• Банк памяти ИИ, сессии, KMS — всё сохраняется
• Только файлы конфигурации могут сброситься

Если данные пропали:

1. Проверьте каталог резервных копий
2. Восстановите из бэкапа
3. Обратитесь в поддержку Mbbrowser

Q10.3: Можно ли откатиться на старую версию?

Можно, но нужно:

1. Сделать резервную копию текущих данных
2. Удалить текущую версию
3. Установить старую версию
4. Восстановить данные

⚠️ Внимание: старая версия может не поддерживать новые функции.

---

11. Коды ошибок

BROWSER_AUTO_UNAVAILABLE

Значение: автоматизация браузера недоступна. Причина: браузер Playwright MCP не запущен. Решение:

1. Установить Node.js и npx
2. Позволить MBAgent автоматически установить Playwright
3. Перезапустить MBAgent

CONTROL_V2_DISCOVERING

Значение: идёт обнаружение экземпляров клиента Mbbrowser. Причина: только что запущен или идёт сканирование. Решение: подождите несколько секунд и повторите.

CONTROL_V2_HANDSHAKE_SPEC_MISMATCH

Значение: версии спецификации ControlV2 у MBAgent и клиента Mbbrowser различаются. Решение:

1. Обновить Mbbrowser до последней версии
2. Обновить MBAgent до последней версии

TOOL_ENABLE_PREREQUISITE_MISSING

Значение: не выполнены предусловия инструмента. Решение:

1. Проверьте, включён ли соответствующий Skill
2. Проверьте уровень авторизации аккаунта Mbbrowser

RAG-база знаний Mbbrowser сейчас недоступна

Значение: аномалия сервиса RAG-базы знаний Mbbrowser official. Решение:

1. Проверьте валидность аккаунта Mbbrowser
2. Проверьте сеть
3. Обратитесь в поддержку Mbbrowser

Клиент MBBrowser ControlV2 сейчас недоступен

Значение: аномалия протокола ControlV2 Mbbrowser. Решение:

1. Перезапустить Mbbrowser
2. Перезапустить MBAgent
3. Проверьте: Mbbrowser → Настройки → ControlV2

---

12. Получение помощи

Официальные каналы

• Официальная документация: https://help.mbbrowser.com/mbagent
• Консоль Mbbrowser: https://www.mbbrowser.com/console
• WeChat поддержки: см. официальный сайт Mbbrowser
• Email поддержки: support@mbbrowser.com

Самостоятельная диагностика

1. Посмотрите журнал MBAgent: %LOCALAPPDATA%\mbagent\logs\
2. Посмотрите журнал Mbbrowser
3. Используйте «Настройки → Проверка официальных сервисов» для проверки статуса сервисов

Сообщение о проблеме

При обращении в поддержку, пожалуйста, предоставьте:

• Номер версии MBAgent
• Номер версии Mbbrowser
• Версия Windows
• Полное сообщение об ошибке
• Шаги выполнения
• При необходимости — файлы журналов

---

Вернуться: Интро MBAgent или Загрузка и установка MBAgent.