Bài 6 — Bản đồ 5 lớp & Manager Agent (trước khi build)

Bạn đã có n8n Cloud, biết canvas, và đã kết nối Telegram + Google Sheets (Bài 3–5). Bài này là bản đồ trước khi build — đừng nhảy thẳng vào AI Agent nếu chưa hoàn thành Phần 2.

Kiến trúc 5 lớp — thứ tự build

┌─────────────────────────────────────────────────────────────┐
│  LỚP 1 — INPUT (Trigger)                                    │
│  Telegram: text · voice · ảnh · video · file                │
└───────────────────────────┬─────────────────────────────────┘
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  LỚP 2 — MANAGER AGENT (Bộ não)                             │
│  AI Agent + System Prompt → quyết định gọi Tool nào         │
└───────┬─────────────┬─────────────┬─────────────┬───────────┘
        ▼             ▼             ▼             ▼
┌──────────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────┐
│ LỚP 3       │ │ Google   │ │ Google   │ │ Google Drive     │
│ Google Sheet │ │ Docs     │ │ Drive    │ │ /media/products  │
│ CRM data    │ │ draft bài│ │ ảnh/video│ │                  │
└──────┬───────┘ └────┬─────┘ └────┬─────┘ └────────┬─────────┘
       └──────────────┴────────────┴──────────────────┘
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  LỚP 4 — OMNICHANNEL MXH                                    │
│  Facebook Fanpage · YouTube Shorts · TikTok · IG · LinkedIn │
└───────────────────────────┬─────────────────────────────────┘
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  LỚP 5 — SAGE MARKETING (sagemkt.io.vn)                     │
│  HTTP POST API · schedule · publish · analytics sync        │
└─────────────────────────────────────────────────────────────┘

Manager Agent vs Tool workflow

• Manager Agent (Phần 4): Một AI Agent node đọc intent → quyết định gọi tool nào
• Tool workflow: wf-save-sheet, wf-create-doc, wf-publish-facebook... — mỗi cái là Execute Workflow riêng
• Trigger layer (Phần 3): Chỉ chuẩn hóa input Telegram → JSON thống nhất cho Manager
• Không cần 4 Sub-Agent riêng biệt ngay từ đầu — Manager + Tools đủ cho MVP hero

Luồng dữ liệu zero → hero

[Telegram: text / voice / ảnh]
        ↓ Phần 3 — Trigger normalize
[JSON unified payload]
        ↓ Phần 4 — Manager Agent + Tools
        ├── save_sheet → Google Sheets (Phần 5)
        ├── create_doc → Google Docs (Phần 5)
        ├── upload_drive → Google Drive (Phần 5)
        ├── publish_social → Facebook/Shorts/TikTok (Phần 6)
        └── post_sage → Sage Marketing API (Phần 7)
        ↓ Phần 8 — Capstone ghép + test E2E

Bài tập — checklist trước Phần 3 (kèm cách tự kiểm tra)

Đừng qua Phần 3 nếu chưa tick hết. Mỗi mục có cách verify cụ thể để bạn chắc chắn thật sự làm được, không phải đoán.

• ✅ n8n Cloud đăng nhập được, timezone Asia/Ho_Chi_Minh — Verify: tạo node Set với field now = {{ $now }}, Execute, output phải hiện đúng giờ VN (lệch UTC +7).
• ✅ Workflow sandbox chạy Manual Trigger + Set node — Verify: mở 00-sandbox, bấm Execute, cả 2 node viền xanh.
• ✅ Telegram Bot credential OK — Verify: nhắn cho bot, Telegram Trigger bắt được tin và đọc ra message.chat.id.
• ✅ Google Sheets OAuth OK — Verify: node Google Sheets append thử 1 dòng, mở Google Sheet thấy dòng mới xuất hiện.
• ✅ Google Sheet Auto Marketing Tracker có tab Products — Verify: hàng 1 có đủ 4 cột product_id, name, description, created_at.
• Vẽ sơ đồ 5 lớp trên giấy (Trigger → Manager → Google → MXH → Sage) — dán cạnh màn hình khi build để luôn biết mình đang ở lớp nào.

Nếu một mục fail: quay lại đúng bài tương ứng (Bài 3 cho timezone, Bài 4 cho sandbox, Bài 5 cho Telegram/Sheets) và xem mục Lỗi thường gặp ở cuối bài đó.