Tác vụ định thời và vòng lặp

Tác vụ định thời và vòng lặp để MBAgent tự động làm theo chu kỳ, không cần bạn kích hoạt thủ công mỗi lần. Bài này giới thiệu chi tiết cách cấu hình.

---

Một, Tác vụ định thời là gì?

Tác vụ định thời = Tác vụ MBAgent tự động kích hoạt thực thi theo thời gian hoặc khoảng cụ thể.

Cách kích hoạt	Kịch bản áp dụng
Biểu thức Cron	Mỗi ngày 9 giờ, mỗi thứ hai, mỗi ngày 1 hàng tháng, v.v. thời gian cố định
Khoảng cố định	Mỗi 30 phút, mỗi 2 giờ, mỗi 5 giây
Lắng nghe khu vực làm việc	Kích hoạt khi tệp thay đổi
Kích hoạt thủ công	Không định thời, nhưng cần định nghĩa trước

---

Hai, Tạo tác vụ định thời

Bước một: Mở quản lý tác vụ định thời

Trong giao diện chính MBAgent nhấp "Tác vụ" → tab "Tác vụ định thời", hoặc nhập slash command:

/schedule list

Hiển thị tất cả tác vụ định thời hiện tại.

Bước hai: Tác vụ mới

Nhấp nút "+", bật cửa sổ mới:

Tác vụ định thời mới

Tên tác vụ:________________

Mô tả tác vụ:____________________________

Cách kích hoạt:○ Cron○ Khoảng cố định○ Lắng nghe

Biểu thức Cron:________________

[Gợi ý: 0 9 * * * có nghĩa mỗi ngày 9 giờ]

Môi trường Mbbrowser: Tự động / Chỉ định / Nhãn

Số đồng thời: 5

Chờ: 300 giây

Xử lý thất bại:○ Thử lại 3 lần○ Bỏ qua○ Kết thúc

Bước ba: Điền mô tả tác vụ

Mô tả tác vụ là prompt mà AI nhận được mỗi lần tác vụ định thời thực thi. Ví dụ:

Tổng hợp số đơn hàng hôm nay của tất cả cửa hàng, sắp xếp giảm dần theo số tiền,
ghi vào reports/orders-{YYYYMMDD}.xlsx.
Nếu có bất thường (số tiền đơn hàng vượt quá 10000 hoặc dưới 1),
gửi email cho alerts@company.com.

Bước bốn: Chọn cách kích hoạt

1. Biểu thức Cron

Cách dùng phổ biến nhất. Cú pháp biểu thức Cron:

*  *  *  *  *
│  │  │  │  │
│  │  │  │  └── Tuần (0-7, 0=Chủ nhật)
│  │  │  └───── Tháng (1-12)
│  │  └─────── Ngày (1-31)
│  └────────── Giờ (0-23)
└───────────── Phút (0-59)

Ví dụ thường dùng:

Cron	Ý nghĩa
0 9 * * *	Mỗi ngày 9:00
0 9 * * 1-5	Ngày làm việc 9:00
0 0 1 * *	Mỗi ngày 1 hàng tháng 0:00
*/30 * * * *	Mỗi 30 phút
0 */2 * * *	Mỗi 2 giờ
0 18 * * 5	Mỗi thứ sáu 18:00
0 0 1 1 *	Mỗi ngày 1 tháng 1 0:00

2. Khoảng cố định

Đặt thực thi một lần sau mỗi khoảng thời gian:

Trường	Mô tả
Giá trị khoảng	Số
Đơn vị khoảng	Giây / Phút / Giờ / Ngày

Ví dụ: Thực thi mỗi 30 phút một lần.

3. Lắng nghe khu vực làm việc (watchWorkspace)

Kích hoạt khi nội dung thư mục chỉ định thay đổi:

Trường	Mô tả
Đường dẫn lắng nghe	Lắng nghe thư mục nào
Loại sự kiện	Tệp mới / Tệp sửa / Tệp xóa
Lọc tệp	Mẫu tên tệp (như *.xlsx)

Kịch bản áp dụng:

• Tự động xử lý khi nhận tệp đơn hàng mới
• Tự động phân tích lại khi tệp dữ liệu cập nhật

Bước năm: Cấu hình môi trường chạy

• Môi trường Mbbrowser: Có cần mở trình duyệt Mbbrowser không
• Số đồng thời: Mức song song của nhiều môi trường
• Chờ: Thời gian tối đa cho mỗi lần thực thi
• Xử lý thất bại: Cách đối phó khi thất bại

Bước sáu: Lưu

Nhấp "Lưu", tác vụ định thời xuất hiện trong danh sách tác vụ, trạng thái là "Chưa bật".

Bước bảy: Bật

Chọn tác vụ, nhấp nút "Bật". MBAgent sẽ tự động thực thi theo kế hoạch.

---

Ba, Quản lý tác vụ định thời

Xem tất cả tác vụ định thời

/schedule list

Bật / Tạm dừng

• Bật: Chọn tác vụ → Nhấp nút "Bật"
• Tạm dừng: Chọn tác vụ → Nhấp nút "Tạm dừng" (giữ cấu hình nhưng không thực thi)

Xóa tác vụ

1. Chọn tác vụ
2. Nhấp nút "Xóa"
3. Xác nhận xóa

Xem lịch sử thực thi

1. Chọn tác vụ
2. Nhấp tab "Lịch sử"
3. Hiển thị mỗi lần thực thi: thời gian kích hoạt / trạng thái / thời gian tiêu hao / kết quả

Thực thi ngay (Kích hoạt thủ công)

1. Chọn tác vụ
2. Nhấp nút "Chạy ngay"

---

Bốn, MBAgent Daemon

Daemon = Một tiến trình thường trú nền, để tác vụ định thời ngay cả khi bạn không chủ động khởi động MBAgent cũng có thể thực thi theo kế hoạch. Daemon của mbAgent hỗ trợ hai host nền:

• macOS: launchd (ghi vào ~/Library/LaunchAgents/sh.mbagent.scheduler.plist)
• Linux: systemd --user (ghi vào ~/.config/systemd/user/mbagent-scheduler.service)

Tình trạng hỗ trợ mỗi nền tảng

Nền tảng	Trạng thái	Mô tả
macOS	✅ Đã hỗ trợ	Cài đặt tự động launchctl bootstrap gui/$UID
Linux	✅ Đã hỗ trợ	Tạo tệp unit, người dùng cần tự thực thi systemctl --user enable --now
Windows	⏳ Chưa hỗ trợ	Mã đã chú thích rõ "Windows daemon support is deferred"; module schedules phát hiện PID trên Windows trực tiếp trả về false, không có nhánh đăng ký launchd / SCM / Windows Service

Cách cài đặt (macOS / Linux)

1. Vào "Cài đặt → Tác vụ định thời"
2. Nhấp nút "Cài đặt Daemon"
3. macOS sẽ tự động launchctl bootstrap; Linux sẽ ghi tệp unit vào ~/.config/systemd/user/, và nhắc lệnh systemctl --user enable --now cần thực thi

Trạng thái Daemon

MBAgent Scheduler daemon
  Trạng thái: Đang chạy
  PID: 12345
  pidfile: ~/.local/share/mbagent/scheduler.pid
  Tác vụ đã tải: 12

Gỡ cài đặt Daemon

1. Vào "Cài đặt → Tác vụ định thời"
2. Nhấp nút "Gỡ cài đặt Daemon"
3. macOS sẽ thực thi launchctl bootprint gui/$UID sh.mbagent.scheduler; Linux sẽ đưa ra lệnh systemctl --user disable --now

WARNING

Gỡ cài đặt trước tiên tạm dừng tất cả tác vụ định thời, nếu không sau khi gỡ cài đặt tác vụ sẽ thất bại.

NOTE

Người dùng Windows: Hiện tại nếu cần thực thi tác vụ định thời "không có người trực", vẫn cần giữ tiến trình chính MBAgent đang chạy. Nếu cần không có người trực dài hạn, có thể dùng chương trình kế hoạch tác vụ của Windows để đóng gói mbagent schedule tick thành tác vụ khởi động cùng máy (đây là phương án thay thế, không phải mbAgent Daemon).

---

Năm, Giám sát vòng lặp (Nâng cao hơn)

Tác vụ vòng lặp = Phiên bản đơn giản của tác vụ định thời thực thi lặp lại theo khoảng cố định.

Sự khác biệt với tác vụ định thời

Chiều	Tác vụ định thời	Tác vụ vòng lặp
Thời gian kích hoạt	Điểm thời gian chính xác	Khoảng cố định
Độ phức tạp cấu hình	Cao (biểu thức cron)	Thấp (giá trị khoảng)
Kịch bản phù hợp	Mỗi ngày 9 giờ chạy báo cáo hàng ngày	Mỗi 30 phút kiểm tra tồn kho
Xử lý thất bại	Chi tiết	Đơn giản

Tạo tác vụ vòng lặp

1. Mở bảng tác vụ
2. Khi tạo tác vụ mới chọn "Tác vụ vòng lặp"
3. Đặt:
   • Khoảng (mỗi X giây/phút/giờ)
   • Điều kiện kết thúc (dừng sau khi chạy N lần / không bao giờ dừng)
4. Lưu và bật

Tác vụ vòng lặp điển hình

• Mỗi 30 phút kiểm tra tồn kho cửa hàng, thông báo khi dưới ngưỡng
• Mỗi giờ kiểm tra Token tài khoản Mbbrowser có hết hạn không
• Mỗi 5 phút kiểm tra đơn hàng mới trong hộp thư
• Liên tục giám sát thay đổi của một trang web

---

Sáu, Mục tiêu dài hạn (Goal)

Mục tiêu dài hạn = Để MBAgent quanh một mục tiêu dài hạn tự chủ lặp, cho đến khi mục tiêu hoàn thành hoặc bạn dừng thủ công.

Tạo mục tiêu dài hạn

1. Trong giao diện chính MBAgent nhập slash command:

   /goal start Liên tục tối ưu tỷ lệ chuyển đổi của 20 cửa hàng này, mỗi tuần xuất một báo cáo phân tích

2. MBAgent chấp nhận mục tiêu, bắt đầu tự chủ lập kế hoạch:
   • Tuần 1: Thu thập dữ liệu baseline
   • Tuần 2: Xác định cửa hàng chuyển đổi thấp
   • Tuần 3: Xây dựng kế hoạch tối ưu
   • Lặp liên tục...

Xem trạng thái mục tiêu dài hạn

/goal status

Hiển thị:

Mục tiêu #1 - Liên tục tối ưu tỷ lệ chuyển đổi 20 cửa hàng
  Trạng thái: Đang tiến hành
  Đã chạy: 14 ngày
  Giai đoạn hiện tại: Tuần 3 (Xây dựng kế hoạch tối ưu)
  Tiến độ: 45%
  Đánh giá tiếp theo: 2026-10-01

Kết thúc mục tiêu dài hạn

/goal stop

---

Bảy, Tác vụ nghiên cứu (Research)

Tác vụ nghiên cứu = MBAgent nghiên cứu sâu một chủ đề nào đó, xuất báo cáo có cấu trúc.

Tạo tác vụ nghiên cứu

/research start Nghiên cứu tác động của chính sách mới của Amazon 2026 đối với người bán vừa và nhỏ

Quy trình nghiên cứu

[1] Phân rã chủ đề nghiên cứu
    - Chủ đề con 1: Giải thích đầy đủ chính sách mới
    - Chủ đề con 2: Tác động đối với người bán vừa và nhỏ
    - Chủ đề con 3: Chiến lược ứng phó
    - Chủ đề con 4: Trường hợp ngành
    ↓
[2] Thu thập dữ liệu song song
    - Gọi thư viện kiến thức RAG Mbbrowser
    - Gọi WebSearch
    - Gọi WebFetch
    ↓
[3] Phân tích và tổng hợp
    - Trích xuất thông tin chính
    - Xác minh sự thật
    - Tóm tắt quan điểm
    ↓
[4] Xuất báo cáo
    - Markdown có cấu trúc
    - Trích dẫn nguồn
    - Bao gồm biểu đồ

Xem báo cáo nghiên cứu

1. Vào thanh bên "Nghiên cứu"
2. Chọn tác vụ nghiên cứu đã hoàn thành
3. Xem báo cáo

---

Tám, Thực hành tốt nhất

Lựa chọn thời gian

✅ Đề xuất:

• Thời kỳ thấp điểm nghiệp vụ (rạng sáng, đêm khuya)
• Trước khi hạn ngạch tài khoản Mbbrowser làm mới (cuối tháng)
• Trình duyệt Mbbrowser nhàn rỗi

❌ Tránh:

• Thời kỳ cao điểm (thời gian làm việc ban ngày)
• Nhiều tác vụ chồng chéo (CPU/bộ nhớ chiếm quá lớn)
• Thời gian nhạy cảm xuyên múi giờ (như ngày 11 tháng 11)

Phân rã tác vụ

✅ Cách làm tốt:

• Phân rã tác vụ lớn thành nhiều tác vụ định thời nhỏ
• Mỗi tác vụ tập trung một mục tiêu
• Tác vụ không phụ thuộc lẫn nhau

❌ Cách làm xấu:

• Một tác vụ lớn làm quá nhiều việc
• Tác vụ phụ thuộc mạnh (A thất bại dẫn đến B thất bại)

Xử lý lỗi

• ✅ Cấu hình thông báo cảnh báo (gửi email/WeChat khi thất bại)
• ✅ Đặt chờ hợp lý (không chờ quá lâu)
• ✅ Giữ nhật ký khi thất bại (thuận tiện khắc phục)

Quản lý tài nguyên

• ✅ Giới hạn số đồng thời (không để nhiều tác vụ cùng lúc chiếm đầy CPU)
• ✅ Giám sát chiếm dụng tài nguyên (giám sát tài nguyên trong bảng tác vụ)
• ✅ Tác vụ quan trọng dùng Daemon / tiến trình độc lập (tránh bị tác vụ khác ảnh hưởng; Windows hiện không có Daemon, có thể dùng phiên bản MBAgent độc lập đảm nhận tác vụ quan trọng)

---

Chín, Kịch bản điển hình

Kịch bản 1: Báo cáo bán hàng hàng ngày

Tên tác vụ: Báo cáo bán hàng hàng ngày
Kích hoạt: Cron 0 9 * * * (Mỗi ngày 9 giờ)
Mô tả: Tổng hợp dữ liệu đơn hàng hôm qua của tất cả cửa hàng, tạo báo cáo hàng ngày, ghi vào reports/daily-{YYYYMMDD}.xlsx,
     và gửi nội dung báo cáo hàng ngày đến wechat-bot.

Kịch bản 2: Giám sát tồn kho

Tên tác vụ: Giám sát tồn kho
Kích hoạt: Khoảng cố định 30 phút
Mô tả: Kiểm tra tồn kho sản phẩm của tất cả cửa hàng, sản phẩm dưới 10 cái ghi vào alerts/low-stock-{YYYYMMDD}.csv,
     gửi email cho nhóm vận hành.
Điều kiện kết thúc: Chạy vĩnh viễn

Kịch bản 3: Kiểm tra sức khỏe tài khoản

Tên tác vụ: Kiểm tra sức khỏe tài khoản
Kích hoạt: Cron 0 */6 * * * (Mỗi 6 giờ)
Mô tả: Kiểm tra trạng thái đăng nhập, tính toàn vẹn Cookie, IP bất thường của tất cả tài khoản Mbbrowser,
     xuất báo cáo vào health-check/{YYYYMMDD-HH}.json.
Xử lý thất bại: Thử lại 3 lần rồi bỏ qua

Kịch bản 4: Sao lưu dữ liệu tự động

Tên tác vụ: Sao lưu dữ liệu
Kích hoạt: Cron 0 3 * * * (Mỗi ngày rạng sáng 3 giờ)
Mô tả: Sao lưu thư viện trí nhớ AI, KMS, tất cả phiên vào backup/{YYYYMMDD}/.
Điều kiện kết thúc: Chạy vĩnh viễn

---

Mười, Câu hỏi thường gặp

Q1: Tác vụ định thời không kích hoạt như mong đợi

Khắc phục:

1. Kiểm tra biểu thức cron có đúng không
2. Kiểm tra MBAgent có khởi động không (Windows hiện không hỗ trợ Daemon, phải giữ tiến trình chính chạy; macOS/Linux cài đặt Daemon mới có thể "không có người trực" kích hoạt)
3. Xem thông tin lỗi trong lịch sử tác vụ
4. Xác nhận thời gian hệ thống đúng

Q2: Máy tính ngủ đông thì tác vụ không thực thi

Giải pháp:

1. macOS / Linux: Cài đặt Daemon (để launchd / systemd-user đánh thức tác vụ)
2. Windows: Hiện không hỗ trợ Daemon, vui lòng dùng phương án thay thế "Chương trình kế hoạch tác vụ Windows + mbagent schedule tick" (xem phần NOTE cuối Bốn, MBAgent Daemon)
3. Đặt máy tính không ngủ đông (Control Panel → Power)
4. Đặt timer đánh thức

Q3: Tác vụ liên tục thất bại

Khắc phục:

1. Chạy riêng một lần, xem thông tin lỗi
2. Kiểm tra trình duyệt Mbbrowser có trực tuyến không
3. Kiểm tra kết nối mạng
4. Đơn giản hóa mô tả tác vụ, khắc phục từng bước

Q4: Tác vụ định thời tiêu hao quá nhiều Token

Giải pháp:

1. Dùng mô hình rẻ (gpt-5-mini)
2. Đóng "hiển thị quá trình suy nghĩ"
3. Rút ngắn mô tả tác vụ
4. Giảm tần suất thực thi

Q5: Có thể đồng bộ tác vụ định thời trên nhiều máy tính không?

Tạm thời không hỗ trợ đồng bộ trên đám mây. Đề xuất:

1. Cấu hình riêng trên mỗi máy tính
2. Hoặc dùng tệp quản lý tác vụ thống nhất + Git đồng bộ

---

Bước tiếp theo: Mẹo sử dụng và thực hành tốt nhất → Tóm tắt kinh nghiệm của người dùng lâu năm.