Bài 12: Agent Trở Thành Cộng Sự Tức Thì

BƯỚC 01 — Chọn 1 tín hiệu để agent theo dõi:

Không cần nghĩ lớn. Ngày đầu tiên agent làm việc chủ động, mục tiêu chỉ là một tín hiệu đơn giản — khi nó xảy ra, agent nhắn anh em.

3 lựa chọn dễ nhất — chọn 1 hợp với business của anh em:

• Tín hiệu 01 · Đơn mới: Có đơn hàng vừa vào. Data anh em đã có sẵn (bảng orders từ nhiệm vụ Sepay). Chỉ cần thêm 1 MCP function đọc đơn mới trong X phút gần đây. Agent nhắn anh em khi có đơn.
  "Đơn mới: chị Hà, 450k, 2 sản phẩm. Tổng hôm nay: 3 đơn."
• Tín hiệu 02 · Form/lead mới: Có người mới điền form. Data anh em đã có sẵn (bảng waitlist hoặc customers từ nhiệm vụ form). Chỉ cần thêm 1 MCP function đọc lead mới. Agent nhắn anh em.
  "Anh Minh vừa điền form, SĐT 0903xxx. Khách thứ 5 hôm nay."
• Tín hiệu 03 · Báo cáo sáng: Tổng kết 24h qua. Đơn giản nhất — không cần theo dõi tức thì. Cron chạy 8h mỗi sáng, agent tổng hợp đơn + khách + doanh thu tối qua. Phù hợp nếu business anh em chậm, không cần biết ngay lập tức.
  "8h sáng. Tối qua chốt 3 đơn, 1.2tr. 2 khách mới điền form."

Nên chọn Tín hiệu 01 hoặc 02: Vì nó bắn ra tức thì khi có chuyện — cho anh em thấy ngay tính tức thì. Tín hiệu 03 dễ nhất nhưng chỉ chạy 1 lần/ngày, ít cảm giác bất ngờ. Muốn hăng hái? Làm cả 3 — 1 nhắn tức thì (01 hoặc 02) + 1 báo sáng (03).

BƯỚC 02 — Vibe thêm 1 MCP function:

Mở agent coding ngay trong thư mục website trên máy. Dán đoạn hướng dẫn đơn giản này vào agent:

💡 Đừng tự viết prompt dài hơn: Agent coding đã hiểu codebase của anh em. Anh em chỉ cần nói mục tiêu ngắn gọn. Prompt dài quá sẽ làm nó bị bó khuôn, khó sáng tạo giải pháp phù hợp.

BƯỚC 03 — Hiểu sự nâng cấp:

Bộ não thứ 2 của anh em đang ở đâu? Từ Bài 4 anh em đã xây bộ não thứ 2 — file brain.db chứa brand voice, knowledge, business info. Nó đang nằm trên máy anh em, im lặng.

Hôm nay anh em đánh thức nó dậy và kết nối với goClaw. Từ giờ, agent đọc được brand voice, biết giọng anh em, biết nguyên tắc anh em — lần đầu agent nói chuyện "như anh em", không phải ChatGPT generic.

💡 Hiểu kiểu đơn giản nhất: brain.db = cuốn sổ tay của anh em ở nhà. goClaw = cộng sự ở văn phòng. Hôm nay anh em photocopy cuốn sổ, mang qua văn phòng, đưa cho cộng sự đọc. Vậy thôi.

BƯỚC 04 — Export brain.db ra markdown:

goClaw đọc được markdown, không đọc được SQLite trực tiếp. Cần chuyển đổi. AI làm giúp:

💡 Không có brain.db? Có thể anh em đã skip Bài 4 hoặc lưu brand voice ở chỗ khác. Dùng prompt này thay thế: "Tạo thư mục vault-ready/ với 3 file markdown: brand-voice.md, my-business.md, knowledge-base.md. Hỏi tôi từng câu ngắn (tone, từ dùng, sản phẩm, USP, 3 kiến thức quan trọng), viết file dựa trên câu trả lời. Làm từng file một."

BƯỚC 05 — Upload vào Knowledge Vault:

Knowledge Vault là thư viện tài liệu trong goClaw. Agent dùng nó để tra cứu mỗi khi trả lời — giống Google search riêng cho agent.

Cách 1 — Tải lên qua Dashboard (đơn giản nhất)

• Mở https://app.yourdomain.com → đăng nhập goClaw Dashboard.
• Sidebar → Core → Knowledge Vault (hoặc Documents tùy phiên bản).
• Bấm Upload → chọn từng file trong thư mục vault-ready/.
• Chờ trạng thái chuyển đã xử lý xong.

Cách 2 — Đồng bộ hệ thống file (nếu Cách 1 không có giao diện)

💡 Lạc trong Dashboard? Chụp màn hình chỗ anh em đang đứng → dán vào Claude (hoặc agent coding anh em đang dùng) → hỏi "tôi đang tìm Knowledge Vault để tải file, bấm đâu tiếp?". Nhanh hơn đi tìm menu.

BƯỚC 06 — Hiểu 4 Context Files cốt lõi:

Ngoài Knowledge Vault (tra cứu khi cần), mỗi agent có một bộ file định nghĩa nó là ai — gọi là **Context Files**. Đây là file agent đọc mỗi lần trước khi trả lời. Hôm nay viết 4 file quan trọng nhất:

• SOUL.md (Linh hồn — "Tôi là ai"): Cá tính, giọng điệu, phong cách nói chuyện. Đây là file quyết định agent nói "như chị Lan bán khóa tự tin, gần gũi" hay "như trợ lý robot cứng nhắc".
• USER.md (Về anh em — "Tôi đang làm việc với ai"): Tên anh em, business đang làm, cách giao tiếp ưa thích. Agent gọi anh em đúng tên, nhớ anh em là ai, adjust theo thói quen.
• AGENTS.md (Nguyên tắc — "Tôi được/không được làm gì"): Hướng dẫn vận hành — agent được phép làm gì (nhắn báo đơn mới, trả lời khách), không được làm gì (giảm giá tự tiện, hứa ngày ship, xóa dữ liệu). Hàng rào an toàn.
• HEARTBEAT.md (Thói quen — "Tôi tự kiểm tra gì mỗi 5-10 phút"): Checklist agent đọc mỗi lần "tim đập". Đây là file kích hoạt tính tức thì — nó bảo agent tự gọi MCP function đã build ở Phần 1 để kiểm tra có tín hiệu mới không.

BƯỚC 07 — Để AI viết nháp 4 file:

Không tự viết — để AI đọc brain.db và soạn sẵn 4 file. Dán vào agent coding:

💡 Sau khi AI viết nháp xong: Đọc kỹ, chỉnh 10-20% cho đúng giọng thật. Chỗ nào nghe "giống AI viết" thì viết lại.

BƯỚC 08 — Upload 4 file vào agent:

• Dashboard → Sidebar → Core → Agents.
• Chọn agent Telegram anh em đã tạo ở nhiệm vụ trước.
• Tab Files (hoặc Context tùy phiên bản).
• Tải lên (hoặc dán nội dung) từng file: SOUL.md, USER.md, AGENTS.md, HEARTBEAT.md.
• Lưu lại.

💡 Không thấy thẻ Files? Chụp màn hình Dashboard agent của anh em → dán vào Claude (hoặc agent coding anh em đang dùng) → "tôi muốn tải lên 4 file MD làm context cho agent này, thẻ nào?". Mỗi version goClaw bố cục hơi khác. Nếu không có UI: bảo agent coding SSH vào VPS, copy file vào thư mục context của agent (thường ~/.goclaw/agents/[tên-agent]/).

BƯỚC 09 — Bật Heartbeat:

Giống tim đập — cứ đều đặn N phút một lần, agent tự đọc file HEARTBEAT.md và làm theo checklist. Đây là cơ chế biến agent từ phản ứng thành chủ động.

• Dashboard → Agent detail (trang chi tiết agent) → thẻ Config (cấu hình).
• Phần Heartbeat → bật Enabled (kích hoạt).
• Interval (khoảng thời gian giữa 2 lần tim đập): đặt 5m (5 phút) — đủ tức thì để cảm nhận, chưa tốn nhiều chi phí AI.
• Active Hours (giờ hoạt động): chọn giờ agent làm việc (ví dụ 7h-23h) — tránh chạy lúc 3h sáng tốn chi phí AI vô ích.
• Model (chọn mô hình AI): chọn model rẻ cho Heartbeat (Haiku hoặc GPT-4o-mini) — Heartbeat chỉ kiểm tra nhẹ, không cần Sonnet.
• Lưu lại.

BƯỚC 10 — (Tùy chọn) Thêm cron báo sáng:

Heartbeat lo việc bất ngờ. Cron lo việc đúng giờ. Nếu anh em muốn có thêm báo sáng cố định 8h mỗi ngày, thiết lập thêm 1 cron:

Cấu hình Cron Jobs:

• Dashboard → Automation (tự động hoá) hoặc Cron Jobs (lịch tự động).
• Bấm Add (thêm mới). Điền:
  • Name (tên): morning-briefing
  • Schedule (lịch chạy): 0 8 * * * (8h sáng mỗi ngày)
  • Timezone (múi giờ): Asia/Ho_Chi_Minh
  • Agent: chọn agent Telegram của anh em
  • Message (tin nhắn giao cho agent): "Chào sáng. Tổng kết 24h qua: có bao nhiêu đơn, doanh thu, khách mới. Báo ngắn gọn."
  • Channel / Target (kênh gửi / người nhận): Telegram chat của anh em
• Lưu lại.

💡 Không biết cú pháp cron? Hỏi AI: "Cho tôi cron expression cho 8h sáng mỗi ngày, Việt Nam." → AI trả 0 8 * * * + timezone Asia/Ho_Chi_Minh. Xong.

BƯỚC 11 — Test 3 cấp:

Đừng đợi mai test. Làm 3 thử nhanh ngay bây giờ:

• Test 1 — Giọng (kiểm tra Context Files): Trong Telegram, hỏi agent:
  "Bạn là ai?" → trả lời theo SOUL.md (không phải "Tôi là AI assistant...")
  "Bạn có được phép giảm giá cho khách không?" → theo AGENTS.md (thường: "không, cần hỏi sếp trước")
  Trả lời đúng → Context Files đang hoạt động. Trả lời generic → xem troubleshoot bên dưới.
• Test 2 — Nhắn tức thì (quan trọng nhất hôm nay): Tùy tín hiệu anh em chọn:
  Tín hiệu 01 (đơn mới) → tự tạo 1 đơn test qua trang bán hàng (hoặc thêm trực tiếp vào DB) → chờ 5-10 phút.
  Tín hiệu 02 (form mới) → tự điền form trên landing page → chờ 5-10 phút.
  Trong vòng 10 phút, Telegram phải tự bật tin nhắn từ agent, kèm chi tiết. Đây là khoảnh khắc bất ngờ — agent đang chủ động làm việc thay anh em.
• Test 3 — Cron báo sáng (chỉ nếu làm Bước 10): Dashboard → Cron Jobs → morning-briefing → bấm Run Now. Telegram phải nhận tin báo sáng trong 30 giây.

⚡ Nếu Test 2 không nhắn — Kiểm tra theo thứ tự:

1. Agent có đọc HEARTBEAT.md không? Dashboard → Agent → xem nhật ký Heartbeat. Phải thấy heartbeat đã chạy gần đây.
2. MCP function có trả data đúng không? Gọi thẳng qua Telegram: "Dùng tool [tên function] xem có gì mới không." — nếu nó trả được, MCP ok.
3. Cơ chế "đã nhắn" — có thể đơn đã được đánh dấu nhắn rồi từ Heartbeat trước. Tạo đơn mới hoàn toàn để thử.
4. Vẫn không được? Chụp nhật ký Heartbeat → dán vào agent coding → "agent không nhắn khi có đơn mới, sửa lỗi giúp."

Hoàn thành khi:

• Agent trả lời đúng giọng anh em (không còn generic)
• Agent tự nhắn trước khi anh em hỏi — khi có đơn/form mới