Расписание и циклы

Расписание и циклы позволяют MBAgent автоматически работать по расписанию, без необходимости каждый раз запускать вручную. В этой статье подробно описано, как их настроить.

1. Что такое запланированная задача?

Запланированная задача = задача MBAgent, автоматически запускаемая в определённое время или через интервал.

Способ триггера	Сценарий
Cron-выражение	9 утра ежедневно, понедельник, 1-е число месяца и т. д.
Фиксированный интервал	каждые 30 минут, каждые 2 часа, каждые 5 секунд
Слушатель рабочей области	триггер при изменении файлов
Ручной запуск	не по расписанию, но предопределена

2. Создание запланированной задачи

Шаг 1: откройте управление запланированными задачами

В главном окне MBAgent нажмите «Задача» → «Запланированная задача» или введите slash-команду:

/schedule list

Отобразятся все текущие запланированные задачи.

Шаг 2: новая задача

Кликните кнопку «+» — появится окно новой задачи с полями: имя задачи, описание задачи, способ триггера (Cron / фиксированный интервал / слушатель), cron-выражение, среда Mbbrowser (авто / указать / тег), параллелизм, таймаут, обработка ошибок, кнопки «Сохранить» и «Отмена».

Шаг 3: заполните описание задачи

Описание задачи — это промпт, который ИИ получает при каждом запуске. Например:

Свести сегодняшние заказы всех магазинов, отсортировать по убыванию суммы,
записать в reports/orders-{YYYYMMDD}.xlsx.
Если есть аномалии (сумма заказа > 10000 или < 1),
отправить письмо на alerts@company.com.

Шаг 4: выберите способ триггера

1. Cron-выражение

Самый распространённый способ. Синтаксис cron:

*  *  *  *  *
│  │  │  │  │
│  │  │  │  └── День недели (0-7, 0=воскресенье)
│  │  │  └───── Месяц (1-12)
│  │  └─────── День (1-31)
│  └────────── Час (0-23)
└───────────── Минута (0-59)

Частые примеры:

Cron	Значение
`0 9 * * *`	Каждый день в 9:00
`0 9 * * 1-5`	По будням в 9:00
`0 0 1 * *`	1-е число каждого месяца в 0:00
`/30 * * *`	Каждые 30 минут
`0 /2 * *`	Каждые 2 часа
`0 18 * * 5`	Каждую пятницу в 18:00
`0 0 1 1 *`	Каждый 1 января в 0:00

2. Фиксированный интервал

Настройка выполнения через определённое время:

Поле	Описание
Значение интервала	Число
Единица интервала	Секунды / Минуты / Часы / Дни

Например: выполнять каждые 30 минут.

3. Слушатель рабочей области (watchWorkspace)

Триггер при изменении содержимого указанной папки:

Поле	Описание
Путь слушателя	Какую папку слушать
Тип события	Новый файл / Изменён файл / Удалён файл
Фильтр файлов	Шаблон имени файла (например, `*.xlsx`)

Сценарии:

Авто-обработка при поступлении нового файла заказов
Авто-реанализ при обновлении файла данных

Шаг 5: настройте среду выполнения

Среда Mbbrowser: нужно ли открывать Mbbrowser
Параллелизм: параллелизм по средам
Таймаут: максимальная длительность каждого выполнения
Обработка ошибок: как реагировать на сбой

Шаг 6: сохраните

Кликните «Сохранить» — задача появится в списке со статусом «Не включена».

Шаг 7: включите

Выберите задачу и нажмите кнопку «Включить». MBAgent будет автоматически запускать по плану.

3. Управление запланированными задачами

Просмотр всех запланированных задач

/schedule list

Включение / пауза

Включить: выбрать задачу → кнопка «Включить»
Пауза: выбрать задачу → кнопка «Пауза» (конфигурация сохраняется, но не выполняется)

Удаление задачи

Выберите задачу
Кнопка «Удалить»
Подтвердите удаление

Просмотр истории выполнения

Выберите задачу
Кнопка «История»
Для каждого выполнения отображаются: время триггера / состояние / длительность / результат

Немедленный запуск (ручной триггер)

Выберите задачу
Кнопка «Запустить сейчас»

4. MBAgent Daemon

Daemon — фоновый резидентный процесс, позволяющий запланированным задачам выполняться по плану даже если вы не запускали MBAgent активно. Daemon в mbAgent поддерживает два фоновых хоста:

macOS: launchd (запись в ~/Library/LaunchAgents/sh.mbagent.scheduler.plist)
Linux: systemd --user (запись в ~/.config/systemd/user/mbagent-scheduler.service)

Поддержка по платформам

Платформа	Статус	Описание
macOS	✅ Поддерживается	Авто `launchctl bootstrap gui/$UID` при установке
Linux	✅ Поддерживается	Генерация unit-файла; пользователь сам выполняет `systemctl --user enable --now`
Windows	⏳ Пока не поддерживается	В коде явно отмечено «Windows daemon support is deferred»; PID-обнаружение в модуле schedules на Windows сразу возвращает `false`, без веток launchd / SCM / Windows Service

Метод установки (macOS / Linux)

Перейдите в «Настройки → Запланированные задачи»
Нажмите кнопку «Установить Daemon»
macOS автоматически выполнит launchctl bootstrap; Linux запишет unit-файл в ~/.config/systemd/user/ и покажет команду systemctl --user enable --now

Состояние Daemon

MBAgent Scheduler daemon
  Состояние: работает
  PID: 12345
  pidfile: ~/.local/share/mbagent/scheduler.pid
  Загружено задач: 12

Удаление Daemon

Перейдите в «Настройки → Запланированные задачи»
Нажмите кнопку «Удалить Daemon»
macOS выполнит launchctl bootprint gui/$UID sh.mbagent.scheduler; Linux покажет команду systemctl --user disable --now

WARNING

Перед удалением поставьте все задачи на паузу, иначе после удаления задачи будут падать.

NOTE

Пользователям Windows: сейчас для «автономного» выполнения запланированных задач по-прежнему нужно держать запущенным главный процесс MBAgent. Для долгосрочной автономной работы можно использовать Windows Task Scheduler, упаковав mbagent schedule tick в задачу автозапуска (это обходное решение, а не mbAgent Daemon).

5. Циклический мониторинг (расширенный)

Циклическая задача = упрощённая версия запланированной задачи, повторяющаяся через фиксированные интервалы.

Отличия от запланированной задачи

Измерение	Запланированная задача	Циклическая задача
Время триггера	Точный момент	Фиксированный интервал
Сложность настройки	Высокая (cron-выражение)	Низкая (значение интервала)
Подходящий сценарий	Ежедневный отчёт в 9 утра	Проверка остатков каждые 30 минут
Обработка ошибок	Детальная	Простая

Создание циклической задачи

Откройте панель задач
При создании новой задачи выберите «Циклическая задача»
Настройте:
- Интервал (каждые X секунд/минут/часов)
- Условие завершения (остановить после N запусков / никогда)
Сохраните и включите

Типовые циклические задачи

Каждые 30 минут проверять остатки магазинов, уведомлять при падении ниже порога
Каждый час проверять, не истёк ли Token аккаунта Mbbrowser
Каждые 5 минут проверять почту на новые заказы
Непрерывный мониторинг изменений на веб-странице

6. Долгосрочная цель (Goal)

Долгосрочная цель = пусть MBAgent итерирует автономно вокруг долгосрочной цели, пока цель не будет достигнута или вы не остановите вручную.

Создание долгосрочной цели

Введите slash-команду в главном окне MBAgent:

/goal start Непрерывно оптимизировать конверсию этих 20 магазинов, выпускать еженедельный аналитический отчёт

MBAgent принимает цель и начинает самостоятельное планирование:
- Неделя 1: собрать базовые данные
- Неделя 2: выявить магазины с низкой конверсией
- Неделя 3: сформулировать план оптимизации
- Непрерывная итерация...

Просмотр статуса долгосрочной цели

/goal status

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

Цель #1 - Непрерывная оптимизация конверсии 20 магазинов
  Состояние: в работе
  Идёт: 14 дней
  Текущая фаза: неделя 3 (формулирование плана оптимизации)
  Завершённость: 45%
  Следующая оценка: 2026-10-01

Остановка долгосрочной цели

/goal stop

7. Исследовательская задача (Research)

Исследовательская задача = MBAgent глубоко исследует тему и выдаёт структурированный отчёт.

Создание исследовательской задачи

/research start Исследовать влияние новой политики Amazon 2026 на малых продавцов

Поток исследования

[1] Разбиение темы
    - Подтема 1: полный текст новой политики
    - Подтема 2: влияние на малых продавцов
    - Подтема 3: стратегии реагирования
    - Подтема 4: отраслевые кейсы
    ↓
[2] Параллельный сбор материалов
    - Вызов RAG-базы знаний Mbbrowser
    - Вызов WebSearch
    - Вызов WebFetch
    ↓
[3] Анализ и синтез
    - Извлечение ключевой информации
    - Проверка фактов
    - Обобщение точек зрения
    ↓
[4] Вывод отчёта
    - Структурированный Markdown
    - Ссылки на источники
    - Графики

Просмотр исследовательского отчёта

Перейдите в боковую панель «Исследование»
Выберите завершённую исследовательскую задачу
Просмотрите отчёт

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

Выбор времени

✅ Рекомендуется:

Внепиковые часы (раннее утро, поздняя ночь)
Перед обновлением квоты аккаунта Mbbrowser (конец месяца)
Когда Mbbrowser простаивает

❌ Избегайте:

Часы пик (рабочие часы днём)
Перекрытие нескольких задач (CPU / память слишком нагружены)
Чувствительные моменты в разных часовых поясах (например, 11.11)

Декомпозиция задач

✅ Хорошие практики:

Разбивать большие задачи на несколько маленьких запланированных
Каждая задача фокусируется на одной цели
Задачи не зависят друг от друга

❌ Плохие практики:

Одна большая задача делает слишком много
Сильные зависимости между задачами (сбой A приводит к сбою B)

Обработка ошибок

✅ Настройте оповещения (email / WeChat при сбое)
✅ Задайте разумный таймаут (не ждать слишком долго)
✅ При сбое сохраняйте журналы (для отладки)

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

✅ Ограничивайте параллелизм (не давайте нескольким задачам съедать весь CPU)
✅ Мониторьте ресурсы (в панели задач есть монитор ресурсов)
✅ Важные задачи — отдельный Daemon / отдельный процесс (чтобы не зависеть от других задач; на Windows пока нет Daemon, можно выделить отдельный экземпляр MBAgent для важных задач)

9. Типовые сценарии

Сценарий 1: Ежедневный отчёт о продажах

Имя задачи: Ежедневный отчёт о продажах
Триггер: Cron 0 9 * * * (каждый день в 9 утра)
Описание: Свести вчерашние данные заказов всех магазинов, сформировать отчёт, записать в reports/daily-{YYYYMMDD}.xlsx,
          и отправить содержимое отчёта в wechat-bot.

Сценарий 2: Мониторинг остатков

Имя задачи: Мониторинг остатков
Триггер: фиксированный интервал 30 минут
Описание: Проверить остатки всех магазинов, записать те, что ниже 10 штук, в alerts/low-stock-{YYYYMMDD}.csv,
          и отправить письмо команде операций.
Условие завершения: выполнять всегда

Сценарий 3: Аудит здоровья аккаунтов

Имя задачи: Аудит здоровья аккаунтов
Триггер: Cron 0 */6 * * * (каждые 6 часов)
Описание: Проверить статус входа, целостность cookies, аномалии IP для всех аккаунтов Mbbrowser,
          вывести отчёт в health-check/{YYYYMMDD-HH}.json.
Обработка ошибок: повторить 3 раза, затем пропустить

Сценарий 4: Авто-резервное копирование данных

Имя задачи: Резервное копирование данных
Триггер: Cron 0 3 * * * (каждый день в 3 часа ночи)
Описание: Резервное копирование банка памяти ИИ, KMS, всех сессий в backup/{YYYYMMDD}/.
Условие завершения: выполнять всегда

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

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

Решение:

Проверьте правильность cron-выражения
Проверьте, запущен ли MBAgent (на Windows пока нет Daemon — должен быть запущен главный процесс; на macOS/Linux с установленным Daemon возможен автономный триггер)
Посмотрите сообщения об ошибках в истории задачи
Убедитесь, что системное время правильное

Q2: Задачи не выполняются, когда компьютер в спящем режиме

Решение:

macOS / Linux: установить Daemon (launchd / systemd-user будет будить задачи)
Windows: Daemon не поддерживается; используйте Windows Task Scheduler + mbagent schedule tick как обходное решение (см. примечание в конце раздела 4 MBAgent Daemon)
Настроить компьютер не засыпать (Панель управления → Электропитание)
Настроить таймеры пробуждения

Q3: Задачи постоянно падают

Решение:

Запустить задачу вручную один раз — посмотреть ошибку
Проверить, онлайн ли Mbbrowser
Проверить сетевое соединение
Упростить описание задачи, отлаживать шаг за шагом

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

Решение:

Используйте дешёвые модели (gpt-5-mini)
Отключите «Показывать ход рассуждений»
Сократите описание задачи
Уменьшите частоту выполнения

Q5: Можно ли синхронизировать запланированные задачи между несколькими ПК?

Облачная синхронизация пока не поддерживается. Рекомендуется:

Настраивать на каждом ПК отдельно
Или использовать единый файл управления задачами + Git-синхронизацию

Дальше: Советы и лучшие практики → Опыт опытных пользователей.

Расписание и циклы ​

1. Что такое запланированная задача? ​

2. Создание запланированной задачи ​

Шаг 1: откройте управление запланированными задачами ​

Шаг 2: новая задача ​

Шаг 3: заполните описание задачи ​

Шаг 4: выберите способ триггера ​

1. Cron-выражение ​

2. Фиксированный интервал ​

3. Слушатель рабочей области (watchWorkspace) ​

Шаг 5: настройте среду выполнения ​

Шаг 6: сохраните ​

Шаг 7: включите ​

3. Управление запланированными задачами ​

Просмотр всех запланированных задач ​

Включение / пауза ​

Удаление задачи ​

Просмотр истории выполнения ​

Немедленный запуск (ручной триггер) ​

4. MBAgent Daemon ​

Поддержка по платформам ​

Метод установки (macOS / Linux) ​

Состояние Daemon ​

Удаление Daemon ​

5. Циклический мониторинг (расширенный) ​

Отличия от запланированной задачи ​

Создание циклической задачи ​

Типовые циклические задачи ​

6. Долгосрочная цель (Goal) ​

Создание долгосрочной цели ​

Просмотр статуса долгосрочной цели ​

Остановка долгосрочной цели ​

7. Исследовательская задача (Research) ​

Создание исследовательской задачи ​

Поток исследования ​

Просмотр исследовательского отчёта ​

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

Выбор времени ​

Декомпозиция задач ​

Обработка ошибок ​

Управление ресурсами ​

9. Типовые сценарии ​

Сценарий 1: Ежедневный отчёт о продажах ​

Сценарий 2: Мониторинг остатков ​

Сценарий 3: Аудит здоровья аккаунтов ​

Сценарий 4: Авто-резервное копирование данных ​

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

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

Q2: Задачи не выполняются, когда компьютер в спящем режиме ​

Q3: Задачи постоянно падают ​

Q4: Запланированные задачи расходуют слишком много токенов ​

Q5: Можно ли синхронизировать запланированные задачи между несколькими ПК? ​

Расписание и циклы

1. Что такое запланированная задача?

2. Создание запланированной задачи

Шаг 1: откройте управление запланированными задачами

Шаг 2: новая задача

Шаг 3: заполните описание задачи

Шаг 4: выберите способ триггера

1. Cron-выражение

2. Фиксированный интервал

3. Слушатель рабочей области (watchWorkspace)

Шаг 5: настройте среду выполнения

Шаг 6: сохраните

Шаг 7: включите

3. Управление запланированными задачами

Просмотр всех запланированных задач

Включение / пауза

Удаление задачи

Просмотр истории выполнения

Немедленный запуск (ручной триггер)

4. MBAgent Daemon

Поддержка по платформам

Метод установки (macOS / Linux)

Состояние Daemon

Удаление Daemon

5. Циклический мониторинг (расширенный)

Отличия от запланированной задачи

Создание циклической задачи

Типовые циклические задачи

6. Долгосрочная цель (Goal)

Создание долгосрочной цели

Просмотр статуса долгосрочной цели

Остановка долгосрочной цели

7. Исследовательская задача (Research)

Создание исследовательской задачи

Поток исследования

Просмотр исследовательского отчёта

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

Выбор времени

Декомпозиция задач

Обработка ошибок

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

9. Типовые сценарии

Сценарий 1: Ежедневный отчёт о продажах

Сценарий 2: Мониторинг остатков

Сценарий 3: Аудит здоровья аккаунтов

Сценарий 4: Авто-резервное копирование данных

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

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

Q2: Задачи не выполняются, когда компьютер в спящем режиме

Q3: Задачи постоянно падают

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

Q5: Можно ли синхронизировать запланированные задачи между несколькими ПК?