定时任務とループ

NOTE

本記事の翻訳作業はまだ完了していません。 中国語版原文は 中文版 を参照してください。

定时任務とループにより MBAgent は 自動で周期的に作業 し、毎回手動でトリガする必要がなくなります。本記事では設定方法を詳しく紹介します。

---

一、什么是定时任務？

定时任務 = 特定時刻または間隔で自動トリガされる MBAgent タスク。

トリガ方式	適用シーン
Cron 式	毎日 9 時、毎週月曜、毎月 1 日などの固定時刻
固定間隔	30 分ごと、2 時間ごと、5 秒ごと
ワークスペース監視	ファイル変化時にトリガ
手動トリガ	不定期だが事前定義が必要

---

二、定时任務の作成

第一步：定时任務管理を開く

MBAgent メイン画面で 「タスク」 → 「定时任務」 タブをクリックするか、slash command を入力：

/schedule list

現在のすべての定时任務を表示します。

第二步：タスクを新規作成

「+」 ボタンをクリックし、新規ウィンドウがポップアップ：

新規ウィンドウには次のフィールドが含まれます：タスク名、タスク説明、トリガ方式（Cron / 固定間隔 / 監視）、Cron 式、候鳥環境、並列数、タイムアウト、失敗処理など。

第三步：タスク説明を記入

タスク説明は定时任務が毎回実行される際に AI が受け取るプロンプトです。例：

本日全店舗の注文数を集計し、金額降順に並べ、
reports/orders-{YYYYMMDD}.xlsx に書込。
異常（注文金額が 10000 を超えるまたは 1 を下回る）がある場合、
alerts@company.com にメール送信。

第四步：トリガ方式を選択

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 月 1 日 0:00

2. 固定間隔

毎回何時間ごとに実行するかを設定：

項目	説明
間隔値	数字
間隔単位	秒 / 分 / 時 / 日

例：30 分ごとに 1 回実行。

3. ワークスペース監視（watchWorkspace）

指定フォルダの内容が変化した時にトリガ：

項目	説明
監視パス	監視するフォルダ
イベントタイプ	新規ファイル / ファイル変更 / ファイル削除
ファイルフィルタ	ファイル名パターン（例：*.xlsx）

適用シーン：

• 新規注文ファイル受信時の自動処理
• データファイル更新時の自動再分析

第五步：実行環境を設定

• 候鳥環境：候鳥ブラウザを開く必要があるか
• 並列数：複数環境の並列度
• タイムアウト：各実行の最長時間
• 失敗処理：失敗時の対応

第六步：保存

「保存」 をクリックすると、定时任務がタスクリストに表示され、状態は「未有効」。

第七步：有効化

タスクを選択し、「有効化」 ボタンをクリック。MBAgent が計画通りに自動実行します。

---

三、定时任務の管理

すべての定时任務を表示

/schedule list

有効化 / 一時停止

• 有効化：タスクを選択 → 「有効化」 ボタンをクリック
• 一時停止：タスクを選択 → 「一時停止」 ボタンをクリック（設定は保持するが実行しない）

タスク削除

1. タスクを選択
2. 「削除」 ボタンをクリック
3. 削除を確認

実行履歴の表示

1. タスクを選択
2. 「履歴」 タブをクリック
3. 各実行の：トリガ時刻 / 状態 / 所要時間 / 結果を表示

即時実行（手動トリガ）

1. タスクを選択
2. 「即時実行」 ボタンをクリック

---

四、MBAgent Daemon

Daemon = バックグラウンド常駐プロセスで、定时任務が あなたが MBAgent を能動的に起動していなくても計画通り実行 できるようにします。mbAgent の daemon は 2 種類のバックグラウンドホストをサポート：

• 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」と明示；schedules モジュールの PID 検出は Windows で直接 false を返し、launchd / SCM / Windows Service 登録ブランチなし

インストール方法（macOS / Linux）

1. 「設定 → 定时任務」 に入る
2. 「Daemon をインストール」 ボタンをクリック
3. 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 のアンインストール

1. 「設定 → 定时任務」 に入る
2. 「Daemon をアンインストール」 ボタンをクリック
3. macOS は launchctl bootprint gui/$UID sh.mbagent.scheduler を実行；Linux は systemctl --user disable --now コマンドを案内

WARNING

アンインストール前にすべての定时任務を一時停止、さもないとアンインストール後にタスクが失敗。

NOTE

Windows ユーザー：現在「無人」での定时任務実行には、MBAgent メインプロセスを起動したままにする必要があります。長期無人実行が必要な場合は、Windows タスクスケジューラで mbagent schedule tick をスタートアップ自動起動のスケジュールタスクとしてパッケージ化できます（これは変通策であり、mbAgent Daemon ではありません）。

---

五、循環監視（より高度）

循環タスク = 固定間隔で反復実行される簡略版の定时任務。

定时任務との違い

次元	定时任務	循環タスク
トリガ時刻	正確な時刻点	固定間隔
設定複雑度	高（cron 式）	低（間隔値）
適合シーン	毎日 9 時に日報	30 分ごとに在庫確認
失敗処理	詳細	シンプル

循環タスクの作成

1. タスクパネルを開く
2. 新規タスク作成時に 「循環タスク」 を選択
3. 設定：
   • 間隔（X 秒/分/時ごと）
   • 終了条件（N 回実行後停止 / 永不停止）
4. 保存し有効化

典型的な循環タスク

• 30 分ごとに店舗在庫を確認し、閾値を下回った時に通知
• 毎時候鳥アカウント Token の期限切れ確認
• 5 分ごとにメールボックス新規注文確認
• ウェブページ変化の継続監視

---

六、長期目標（Goal）

長期目標 = MBAgent が長期目標を中心に 自主的に反復 し、目標達成または手動終了まで続行。

長期目標の作成

1. MBAgent メイン画面で slash command を入力：

   /goal start この 20 店舗のコンバージョン率を継続的に最適化、毎週分析レポート出力

2. MBAgent が目標を受け、自主的に計画：
   • 第 1 週：ベースラインデータ収集
   • 第 2 週：低コンバージョン店舗の識別
   • 第 3 週：最適化プラン策定
   • 継続反復...

長期目標状態の確認

/goal status

表示：

目標 #1 - 20 店舗のコンバージョン率を継続最適化
  状態: 進行中
  実行日数: 14 日
  現在フェーズ: 第 3 週（最適化プラン策定）
  完成度: 45%
  次回評価: 2026-10-01

長期目標の終了

/goal stop

---

七、研究タスク（Research）

研究タスク = MBAgent が特定テーマを深く研究し、構造化レポートを出力。

研究タスクの作成

/research start 2026 年 Amazon 新政策が中小売家に与える影響を研究

研究フロー

[1] 研究テーマを分解
    - サブテーマ 1: 新政策全文章解釈
    - サブテーマ 2: 中小売家への影響
    - サブテーマ 3: 対応戦略
    - サブテーマ 4: 業界事例
    ↓
[2] 資料を並行収集
    - 候鳥 RAG 知識ベースを呼び出し
    - WebSearch を呼び出し
    - WebFetch を呼び出し
    ↓
[3] 分析と総合
    - キー情報を抽出
    - 事実を検証
    - 観点を要約
    ↓
[4] レポート出力
    - 構造化 Markdown
    - ソース引用
    - 図表を含む

研究レポートの確認

1. 「研究」 サイドバーを開く
2. 完了済の研究タスクを選択
3. レポートを確認

---

八、ベストプラクティス

時刻選択

✅ 推奨：

• 業務低ピーク期（深夜、夜中）
• 候鳥アカウント枠更新前（月末）
• 候鳥ブラウザアイドル時

❌ 避ける：

• ピーク時間帯（昼間作業時間帯）
• 複数タスク重複（CPU / メモリ占用過大）
• 跨時区敏感時刻（双 11 など）

タスク分解

✅ 良い方法：

• 大きいタスクを複数の小さい定时任務に分解
• 各タスクは 1 つの目標に集中
• タスク間に相互依存なし

❌ 悪い方法：

• 1 つの大きいタスクで多くのことを行う
• タスク間強依存（A 失敗が B 失敗につながる）

エラー処理

• ✅ アラート通知を設定（失敗時にメール / WeChat 送信）
• ✅ 合理的なタイムアウトを設定（待ちすぎない）
• ✅ 失敗時にログを保持（切り分けやすく）

リソース管理

• ✅ 並列数を制限（複数タスクで CPU を使い果たさない）
• ✅ リソース占用を監視（タスクパネルにリソースモニタあり）
• ✅ 重要タスクは独立 Daemon / 独立プロセスを使用（他のタスクの影響を受けない；Windows は現在 Daemon なし、独立 MBAgent インスタンスで重要タスクを担当可能）

---

九、典型シーン

シーン 1：毎日販売日報

タスク名: 毎日販売日報
トリガ: Cron 0 9 * * * (毎日 9 時)
説明: 昨日全店舗の注文データを集計し、日報を生成、reports/daily-{YYYYMMDD}.xlsx に書込、
     日報内容を wechat-bot に送信。

シーン 2：在庫監視

タスク名: 在庫監視
トリガ: 固定間隔 30 分
説明: 全店舗の商品在庫を確認し、10 件を下回るものを alerts/low-stock-{YYYYMMDD}.csv に記録、
     運営チームにメール送信。
終了条件: 永遠に実行

シーン 3：アカウント健康巡回

タスク名: アカウント健康巡回
トリガ: Cron 0 */6 * * * (6 時間ごと)
説明: 全候鳥アカウントのログイン状態、Cookie 完全性、IP 異常を確認、
     health-check/{YYYYMMDD-HH}.json にレポート出力。
失敗処理: 3 回リトライ後スキップ

シーン 4：自動データバックアップ

タスク名: データバックアップ
トリガ: Cron 0 3 * * * (毎日深夜 3 時)
説明: AI メモリバンク、KMS、すべてのセッションを backup/{YYYYMMDD}/ にバックアップ。
終了条件: 永遠に実行

---

十、よくあるご質問

Q1：定时任務が予期通りトリガされない

切り分け：

1. cron 式が正しいか確認
2. MBAgent が起動しているか確認（未インストール Daemon）
3. タスク履歴のエラー情報を確認
4. システム時刻が正しいか確認

Q2：PC スリープ時にタスクが実行されない

解決：

1. macOS / Linux：Daemon をインストール（launchd / systemd-user にタスクを起動させる）
2. Windows：現在 Daemon 未サポート、Windows タスクスケジューラ + mbagent schedule tick 変通策を使用
3. PC をスリープしないよう設定（コントロールパネル → 電源）
4. ウェイクアップタイマーを設定

Q3：タスクが常に失敗する

切り分け：

1. 単独実行でエラーを確認
2. 候鳥ブラウザがオンラインか確認
3. ネットワーク接続を確認
4. タスク説明を簡略化し、段階的に切り分け

Q4：定时任務の Token 消費が多すぎる

解決：

1. 安価なモデルを使用（gpt-5-mini）
2. 「思考過程表示」を閉じる
3. タスク説明を短縮
4. 実行頻度を減らす

Q5：複数 PC 間で定时任務を同期できる？

現在クラウド同期未サポート。推奨：

1. 各 PC で個別設定
2. または統一タスク管理ファイル + Git 同期を使用

下一步：使いこなしのコツとベストプラクティス