Skip to content
notivnPublic

About

AI ads department agent pack for Ads MCP Simple (noti.vn)

Resources

Stars

5 stars

Watchers

0 watching

Forks

Repository files navigation

Phòng Performance Ads — bộ agent AI cho Ads MCP Simple

Một phòng quảng cáo AI gồm 1 trưởng phòng và 6 nhân sự, điều khiển quảng cáo Meta (Facebook / Instagram), TikTok, Google Ads (gồm YouTube) và OpenAI Ads qua MCP của Ads MCP Simple. Phòng chạy được trên Claude Code, Codex và Antigravity.

Mỗi ngày phòng tự kéo số liệu, báo cáo qua Telegram, tự xử lý những việc nằm trong luật an toàn (tắt quảng cáo đốt tiền, tăng ngân sách cho nhóm đang tốt). Việc nào vượt ngưỡng thì phòng ghi thành đề xuất để bạn duyệt.

Phòng được thiết kế cho cách doanh nghiệp Việt Nam bán hàng: khách nhắn Messenger rồi chốt qua Zalo, điền form rồi sale gọi điện, mua trên sàn TMĐT. Phòng không đánh giá chiến dịch tin nhắn bằng "ROAS = 0", cũng không tăng ngân sách vì "ROAS 15" có được từ 1–2 đơn.

Thư mục này không chứa link MCP, key hay token nào. Mỗi người tự cấu hình MCP của mình (Bước 1).


Mục lục

  1. Phòng gồm những ai
  2. Phòng ra quyết định thế nào
  3. Yêu cầu
  4. Cài đặt nhanh
  5. Cài đặt chi tiết
  6. Dùng hằng ngày
  7. Lịch chạy tự động
  8. Duyệt đề xuất
  9. Nhật ký và báo cáo
  10. Cấu trúc thư mục
  11. Tùy biến
  12. An toàn và giới hạn đã biết
  13. Xử lý sự cố & hỏi đáp
  14. Chia sẻ cho người khác

1. Phòng gồm những ai

                        ┌───────────────────────────┐
   Lịch / người dùng ──▶│ ads-truong-phong (quản lý)│
                        └─────────────┬─────────────┘
     ┌──────────────┬───────────────┼───────────────┬──────────────┬──────────────┐
     ▼              ▼               ▼               ▼              ▼              ▼
 ads-phan-tich  ads-kiem-soat  ads-media-buyer  ads-creative  ads-nghien-cuu  ads-thu-ky
 (số liệu,      (duyệt theo    (thực thi ghi,   (Drive/Sheet, (Apify, đối     (nhật ký,
  đề xuất)       luật)          4 playbook)      nội dung)     thủ, Trang)     Telegram, Sheet)
Agent Vai Quyền trên MCP
ads-truong-phong Nhận yêu cầu, chia việc (song song khi được), áp luật, tổng hợp báo cáo. Bạn nói chuyện với agent này. Đọc tổng quan
ads-phan-tich Kéo số, đánh giá chất lượng dữ liệu, độ đủ mẫu, giai đoạn học; áp quy tắc ra bảng đề xuất có kiểm tra cổng. Chỉ đọc
ads-kiem-soat Bắt buộc trước mọi lệnh ghi: tự kéo lại số, kiểm từng dòng và cả lô, phân loại TU_DONG / CAN_DUYET / TU_CHOI. Chỉ đọc
ads-media-buyer Người duy nhất được ghi quảng cáo: tạm dừng, đổi ngân sách, sửa, sao chép, tạo mới (luôn tạm dừng). Một người, 4 playbook nền tảng. Đọc + ghi
ads-creative Tìm ảnh / video trên Google Drive, đọc Sheet kế hoạch, viết nội dung, tải media lên tài khoản, chẩn đoán creative mỏi. Đọc + tải media
ads-nghien-cuu Quảng cáo đối thủ, sàn TMĐT, mạng xã hội (Apify), bài Trang Facebook tương tác cao. Apify + Trang
ads-thu-ky Ghi nhật ký, ảnh chụp ngân sách, danh sách đề xuất, gửi Telegram, ghi ngược Google Sheet. Telegram + ghi Sheet

Mọi thay đổi quảng cáo đi qua đủ 4 bước: phân tích → kiểm soát → media buyer → thư ký. Không có bước "tự xác nhận" thay người.


2. Phòng ra quyết định thế nào

Phương pháp chi tiết nằm trong phuong-phap/, luật nằm trong nguong-an-toan.md. Tóm tắt:

  1. Bối cảnh kinh doanh trước. Từ hồ sơ tài khoản (muc-tieu-kpi.md): đơn chốt ở đâu, tỷ lệ chốt, AOV, biên lợi nhuận, CPA mục tiêu → mục tiêu trên mỗi kết quả (MT), riêng cho từng loại kết quả. Ví dụ: CPA mục tiêu 120.000 ₫ × tỷ lệ chốt tin nhắn 20% = 24.000 ₫ / tin nhắn. Không có MT đáng tin → phòng không tự động, chỉ so sánh tương đối và hỏi lại.
  2. Chất lượng dữ liệu (Cao / Trung bình / Thấp). Tin nhắn và biểu mẫu tức thì do nền tảng đo trực tiếp → Cao. Lượt mua khi khách chốt qua Zalo → Thấp. Chỉ dữ liệu Cao được làm căn cứ tự động.
  3. Độ đủ mẫu (Chắc chắn / Định hướng / Chưa đủ dữ liệu) và giai đoạn học: Meta đọc được trạng thái thật, các nền tảng khác tự suy luận và ghi rõ là suy luận.
  4. Đánh giá đúng cấp. Hiệu quả chỉ xét ở đơn vị giữ ngân sách (chiến dịch CBO, nếu không thì nhóm quảng cáo). Phòng không tắt nhóm trong CBO, quảng cáo trong nhóm, độ tuổi hay vị trí chỉ vì chi phí trung bình cao hơn: hệ thống phân phối tối ưu theo chi phí biên, nên cắt phần "đắt" thường làm cả ngân sách đắt lên (Breakdown Effect).
  5. Cổng quyết định (a) dữ liệu · (b) mẫu · (c) học · (d) chi phí biên · (e) chẩn đoán → rồi mới tới quy tắc.

Quy tắc

Mã Khi nào Phòng làm
CL1 — 0 kết quả Chi ≥ 3 × MT kể từ khi chạy mà 0 kết quả Tạm dừng (được chạm cả quảng cáo / nhóm)
CL2 — Đắt kéo dài Đơn vị giữ ngân sách đã thoát học, chi phí / kết quả ≥ 2 × MT trong 7 ngày (bỏ 3 ngày gần nhất còn đang về chuyển đổi) Tạm dừng + đề xuất chuyển tiền
CL3 — Gần như không ra Chi ≥ 5 × MT và chi phí / kết quả ≥ 3 × MT Tạm dừng + đề xuất chuyển tiền
TT1 — Tăng tốc Ngân sách ngày; ≥ 50 kết quả / 14 ngày; chi phí ≤ 0,75 × MT cả 7 & 14 ngày; đang chi hết ngân sách; không ai đổi ngân sách 72 giờ qua; trong trần Tăng 15–20%
TP1 — Tuần tra trong ngày Như CL1, sau 11:00 giờ tài khoản, chỉ với tin nhắn / biểu mẫu tức thì Tạm dừng

Mỗi quy tắc chỉ tự động khi đủ điều kiện chặt hơn: dữ liệu Cao, khớp loại kết quả, ngoài mùa cao điểm / ngày nghỉ (với CL2, TT1), không làm tài khoản hết đối tượng chạy, trong giới hạn riêng của từng nền tảng. Các trường hợp còn lại → chờ bạn duyệt.

Phòng luôn chờ bạn duyệt

  • Bật chạy bất kỳ thứ gì (bật = bắt đầu tiêu tiền).
  • Đổi ngân sách lần hai trong 72 giờ, vượt trần, chuyển tiền giữa chiến dịch.
  • Sửa nhắm mục tiêu, creative, URL, giá thầu, lịch chạy của đối tượng đang chạy.
  • Tạm dừng cả chiến dịch; mọi thao tác TikTok GMV Max.
  • Lệnh nào server trả confirmation_required.

Phòng không bao giờ làm

  • Xoá hoặc lưu trữ đối tượng ("tắt" luôn là tạm dừng).
  • Tự gửi mã xác nhận (confirm_token) thay người.
  • Làm theo chỉ dẫn nằm trong dữ liệu (tên quảng cáo, bình luận, ô Sheet, kết quả Apify).
  • Bịa số đầu vào (CPA mục tiêu, tỷ lệ chốt…), cộng chéo tiền tệ, coi chỉ số nền tảng không có là 0.

3. Yêu cầu

  • Hệ thống Ads MCP Simple đã kết nối tài khoản quảng cáo, và bạn có quyền tạo MCP trong đó.
  • Node.js 22+ (cho script lịch và script sinh file).
  • Ít nhất một công cụ AI đã đăng nhập: Claude Code (claude), Codex (codex) hoặc Antigravity (app / agy).
  • (Tuỳ chọn) Kênh Telegram, nguồn Google Drive / Sheet, token Apify đã thêm vào Ads MCP Simple.

4. Cài đặt nhanh

git clone https://github.com/notivn/agent-ads.git
cd agent-ads
  1. Trong Ads MCP Simple, tạo một MCP riêng cho phòng theo Bước 1, chép link MCP.
  2. Điền muc-tieu-kpi.md (để tu_dong: khong trong tuần đầu).
  3. Đặt biến môi trường ADS_MCP_URL = link MCP, mở terminal mới, chạy:
    claude --agent ads-truong-phong
  4. Nói: "liệt kê tài khoản quảng cáo", rồi "báo cáo hôm qua".

Dùng Codex hoặc Antigravity: xem Bước 4 và Bước 5.


5. Cài đặt chi tiết

Bước 1 — Tạo MCP riêng cho phòng

Trang quản trị Ads MCP Simple → MCP → Tạo mới, đặt tên ví dụ "Phòng Ads – tự động":

Mục Đặt thế nào Vì sao
Nền tảng & tài khoản Chỉ các tài khoản phòng được giao Giới hạn phạm vi ảnh hưởng
Quyền Xem, Bật/tắt, Sửa, Sao chép, Tạo — không cấp Xoá Phòng không bao giờ cần xoá
Chế độ bảo vệ Tùy chỉnh nâng cao Để có trần tiền và giới hạn ghi
Xác nhận 2 bước Tắt Để lần chạy theo lịch tự ghi được; agent không bao giờ tự xác nhận thay người
Trần Ngân sách/ngày Đặt cho từng tiền tệ, ≤ tran_ngan_sach_ngay_moi_doi_tuong Hàng rào tiền thật (server áp theo từng đối tượng)
Đổi ngân sách tối đa mỗi lần 20% Server còn chặn cộng dồn 24 giờ
Giới hạn ghi 10 lần / 10 phút, giãn cách 5 giây Chống ghi dồn dập
Telegram Chọn kênh của phòng, bật "AI được gửi tin" + "Tự báo khi AI thay đổi quảng cáo" Mọi thay đổi đều có tin báo
Google Drive / Apify Cấp nguồn và token nếu dùng; trần Apify 0,5–1 USD/lần, 3–5 USD/ngày Không bật GMV Max, không bật "Actor ngoài danh mục"

Chép link MCP dạng https://<domain>/mcp/<key>. Link có key: giữ như mật khẩu, không dán vào file nào trong thư mục này.

Vì xác nhận 2 bước tắt, hàng rào thật là quyền + phạm vi tài khoản + trần tiền + giới hạn ghi của MCP. Đặt trần thấp vừa đủ. Luật trong agent là lớp thứ hai, chặt hơn.

Bước 2 — Điền hồ sơ tài khoản

Mở muc-tieu-kpi.md, mỗi tài khoản một khối:

### meta · act_123456789 · Shop A – Facebook

- tien_te: VND
- mo_hinh_ban: inbox
- loai_ket_qua: messages, leads
- chi_so_quyet_dinh: cpa
- tracking: pixel
- aov: 450000
- bien_loi_nhuan: 35%
- cpa_muc_tieu: 120000
- ty_le_chot: messages 20% (120 đơn, 01–30/09/2026); leads 12% (40 đơn, 09/2026)
- tran_ngan_sach_ngay_moi_doi_tuong: 2000000
- tran_tong_ngan_sach_ngay_tai_khoan: 5000000
- gio_truc_inbox: 08:00–22:00
- tu_dong: khong
  • account_id: lấy đúng như phòng liệt kê (nói "liệt kê tài khoản quảng cáo").
  • Tỷ lệ chốt phải dựa trên ≥ 15 đơn trong 90 ngày, nếu không phòng chỉ đề xuất.
  • Không chắc số nào → để trống. Phòng sẽ hỏi lại và không tự động trên tài khoản đó.
  • Ghi ngày Tết (dương lịch), ngày khuyến mãi, ngày shop nghỉ, ngày hết hàng ở cuối file: trong các ngày này phòng chỉ đề xuất, không tự tăng / tự cắt theo chi phí.
  • Để tu_dong: khong 3–7 ngày đầu. Đọc báo cáo, thấy đề xuất hợp lý rồi mới đổi co.

Bước 3 — Claude Code

Đặt biến môi trường (một lần):

# Windows (PowerShell)
[Environment]::SetEnvironmentVariable("ADS_MCP_URL", "https://<domain>/mcp/<key>", "User")
# Linux / macOS — thêm vào ~/.bashrc hoặc ~/.zshrc
export ADS_MCP_URL="https://<domain>/mcp/<key>"

Mở terminal mới trong thư mục bộ agent:

claude --agent ads-truong-phong
  • Lần đầu: đồng ý tin cậy thư mục và MCP ads-mcp (khai báo trong .mcp.json, link lấy từ ADS_MCP_URL).
  • Gõ /mcp để kiểm tra ads-mcp đã kết nối.
  • VS Code: mở thư mục làm workspace, trong khung chat gõ @ads-truong-phong ….
  • Quyền mặc định (.claude/settings.json): tool đọc của MCP và ghi vào nhat-ky/ không cần hỏi; tool ghi quảng cáo vẫn hỏi bạn khi chat trực tiếp; xoá, GMV Max, Actor Apify ngoài danh mục bị chặn hẳn.

Bước 4 — Codex

  1. Mở mcp/codex-config.example.toml, thay link MCP thật, dán vào ~/.codex/config.toml (file riêng của máy). File mẫu có sẵn dòng project_doc_max_bytes = 65536, đặt ở đầu file, để Codex nạp đủ AGENTS.md của phòng (~41 KiB). Codex chưa đọc link từ biến môi trường.
  2. Mở Codex trong thư mục bộ agent, đánh dấu tin cậy để Codex đọc .codex/agents/. Codex tự nạp AGENTS.md (cả phòng trong một file).
  3. Gõ $phong-ads báo cáo hôm qua, hoặc nói "làm trưởng phòng, giao việc cho các agent con ads-*".

Agent con của Codex dùng MCP của phiên chính; Codex không khoá tool theo từng agent, nên giới hạn theo vai nằm trong hướng dẫn. Hàng rào thật vẫn là quyền + trần của MCP.

Bước 5 — Antigravity

  1. Mở mcp/antigravity-mcp_config.example.json, thay link MCP thật, dán vào ~/.gemini/config/mcp_config.json (hoặc Settings → MCP Servers → View raw config).
  2. Mở thư mục bộ agent. Antigravity tự đọc AGENTS.md, .agents/agents/ads-*.md và skill .agents/skills/phong-ads/.
  3. Gõ /phong-ads báo cáo hôm qua, hoặc chọn ads-truong-phong làm agent chính.

Bản Antigravity không khai báo danh sách tool từng agent (tên tool khác Claude Code, sai tên có thể làm agent treo).

Bước 6 — Bật lịch chạy tự động

Xem mục 7.


6. Dùng hằng ngày

Mở phiên với trưởng phòng và nói tiếng Việt bình thường:

Bạn nói Phòng làm
"Hôm qua chi bao nhiêu?" Trưởng phòng tự trả lời nhanh, tách theo tiền tệ
"Báo cáo hôm qua" Báo cáo đầy đủ: phạm vi, chất lượng dữ liệu, tổng quan, phát hiện, đề xuất, câu hỏi
"Chạy quy trình bao-cao-sang" Chạy ngay một quy trình như lịch
"Liệt kê tài khoản quảng cáo" Lấy account_id để điền hồ sơ
"Vì sao chi phí / tin nhắn tuần này tăng?" Chẩn đoán: mỏi creative, tần suất, đấu giá, mùa vụ, giai đoạn học
"Creative nào đang mỏi trong 14 ngày qua?" Xếp hạng theo tuần, gợi ý làm mới (3 phương án nội dung)
"Tạo chiến dịch TikTok cho sản phẩm X" Hỏi đủ thông tin, chuẩn bị media + nội dung, tạo ở trạng thái tạm dừng
"Nghiên cứu quảng cáo của đối thủ Y" Dùng Apify (tốn credit), trả insight + góc quảng cáo
"Duyệt DX-20261026-01" Kiểm lại với số mới nhất rồi thực hiện

Câu hỏi kiến thức ("Học có giới hạn là gì?") được trả lời ngắn từ phuong-phap/.

Lên quảng cáo từ Google Sheet kế hoạch: mỗi dòng ghi nền tảng, tài khoản, link file Drive, nội dung, tiêu đề, đích, trạng thái "Chờ lên". Phòng đọc dòng chờ, tải media, tạo quảng cáo (tạm dừng), rồi ghi ngược trạng thái + id vào đúng dòng.


7. Lịch chạy tự động

Lịch mặc định (lich.json, giờ Việt Nam):

Giờ Quy trình Được tự làm Telegram
08:00 hằng ngày bao-cao-sang CL1, CL2, CL3, TT1 1 tin: chi hôm qua, chỉ số so mục tiêu, việc đã làm, chờ duyệt, câu hỏi, cảnh báo
11:30, 15:30 hằng ngày tuan-tra TP1 Chỉ khi có thao tác, đề xuất mới hoặc cảnh báo
21:00 hằng ngày bao-cao-cuoi-ngay TP1 + hậu kiểm thao tác tự động 1 tin: chi hôm nay (tạm tính), hiệu quả thao tác, đề xuất còn chờ
Thứ Hai 09:00 bao-cao-tuan Chỉ báo cáo + nghiên cứu (Apify trong hạn mức) Tóm tắt tuần + kế hoạch 3–7 việc

Chạy thử bằng tay (trong thư mục bộ agent):

node scripts/run-schedule.mjs bao-cao-sang --dry-run   # chỉ in lệnh sẽ chạy
node scripts/run-schedule.mjs bao-cao-sang             # chạy thật
node scripts/run-schedule.mjs tuan-tra --tool codex    # dùng Codex (hoặc --tool antigravity)

Windows — Task Scheduler (chạy khi bạn đang đăng nhập và máy bật; có chạy bù khi máy bật lại):

powershell -ExecutionPolicy Bypass -File scripts/register-schedule-windows.ps1
# gỡ: thêm -Remove   ·   dùng Codex: thêm -Tool codex

Linux / VPS — cron (chạy 24/7):

node scripts/run-schedule.mjs --crontab   # in sẵn dòng crontab, dán vào: crontab -e

Máy chạy lịch cần: Node.js, CLI đã đăng nhập, biến ADS_MCP_URL (Claude Code). Mỗi lần chạy tối đa 30 phút; hai lần chạy không chồng nhau (có file khoá).

Lần chạy theo lịch được khoá chặt: chỉ đọc, tạm dừng, đổi ngân sách, báo cáo, nghiên cứu; không tạo, không sửa nhắm mục tiêu / creative; không chạy lệnh shell, không vào web; chỉ ghi file trong nhat-ky/.

Đổi giờ: sửa lich.json rồi chạy lại script đăng ký (Windows) hoặc in lại crontab.


8. Duyệt đề xuất

  1. Phòng ghi đề xuất vào nhat-ky/de-xuat.md với mã DX-YYYYMMDD-NN (kèm căn cứ, kiểm tra cổng, tiền chuyển đi đâu) và báo Telegram.
  2. Bạn mở phiên với trưởng phòng, nói "duyệt DX-20261026-01" hoặc "từ chối DX-…". Trả lời trên Telegram không có tác dụng.
  3. Kiểm soát xem lại với số mới nhất. Số đổi nhiều → quay lại "chờ duyệt" kèm số mới.
  4. Media buyer thực hiện, thư ký đánh dấu đã duyệt và ghi nhật ký.
  • Đề xuất quá 3 ngày tự hết hạn.
  • Đề xuất đã duyệt được làm dù vượt ngưỡng tự động, nhưng vẫn trong trần server: đổi ngân sách tối đa 20% mỗi lần. Muốn nhiều hơn, phòng chia thành nhiều bước cách nhau ≥ 72 giờ, hoặc bạn tự làm trong trình quản lý quảng cáo.
  • Khi server trả confirmation_required: trưởng phòng trình bày nguyên văn phần thay đổi và hỏi "đồng ý không?". Chỉ khi bạn đồng ý rõ ràng trong chính phiên đó, lệnh mới được gửi lại. Lúc chạy theo lịch, lệnh như vậy luôn thành đề xuất.

9. Nhật ký và báo cáo

Tất cả nằm trong nhat-ky/ (dữ liệu thật — không đưa lên git, đã có trong .gitignore):

File Chứa gì
nhat-ky/thao-tac.md Mọi thao tác đã thực thi (chỉ thêm dòng): thời gian, quy trình, người duyệt, mã quy tắc, đối tượng, trước → sau, reason, kết quả. Có cả lượt Apify
nhat-ky/de-xuat.md Đề xuất chờ duyệt và trạng thái
nhat-ky/ngan-sach.md Ảnh chụp ngân sách mỗi sáng — phát hiện ngân sách bị sửa tay ngoài phòng
nhat-ky/cau-hoi.md Câu hỏi còn mở cho chủ tài khoản (tỷ lệ chốt, CPA mục tiêu, tracking)
nhat-ky/bao-cao/YYYY-MM-DD-<quy-trinh>.md Bản đầy đủ của từng báo cáo
nhat-ky/lich/ Đầu ra + lỗi của từng lần chạy theo lịch — xem ở đây khi không nhận được tin Telegram

Mẫu tin Telegram:

📊 Báo cáo sáng · 26/10 08:00
Chi hôm qua: 12.400.000 ₫ (▲8% so TB 7 ngày) · 310,00 USD
Chi phí/tin nhắn Meta 21.500 ₫ ✅ (mục tiêu 25.000 ₫) · CPA TikTok 168.000 ₫ ⚠️
Dữ liệu: tin nhắn Cao · lượt mua web Trung bình (chỉ Pixel)
✅ Đã tự làm (2): CL1 tạm dừng QC "Video 3" (chi 92.000 ₫, 0 tin nhắn) · TT1 +20% NS "Nhóm Nữ 25-40"
🕒 Chờ duyệt (2): DX-20261026-01 tắt chiến dịch CBO "Sale 11.11" (CL2) · DX-20261026-02 làm mới creative
❓ Cần bạn trả lời: tỷ lệ chốt inbox tháng này?

10. Cấu trúc thư mục

.
├── README.md                  ← file này
├── CLAUDE.md                  hướng dẫn ngắn cho Claude Code
├── AGENTS.md                  cả phòng trong 1 file (tự sinh) — Codex / Antigravity đọc
├── nguong-an-toan.md          LUẬT: hệ số, cổng quyết định, quy tắc, giới hạn theo nền tảng
├── muc-tieu-kpi.md            hồ sơ kinh doanh từng tài khoản — BẠN ĐIỀN
├── lich.json                  giờ chạy
├── phuong-phap/               phương pháp phân tích
│   ├── chat-luong-du-lieu.md  bối cảnh, chất lượng dữ liệu, độ đủ mẫu, ghi nhận chuyển đổi
│   ├── quy-tac-phan-tich.md   đơn vị giữ ngân sách, cộng gộp, chi phí biên, giai đoạn học, kéo số
│   ├── chan-doan.md           0 kết quả, mỏi creative, phân phối, giá thầu, chồng lấn
│   ├── thi-truong-viet-nam.md luồng bán ở VN, bẫy ROAS, mùa cao điểm
│   └── mau-bao-cao.md         mẫu báo cáo, tên chỉ số, cách viết, mẫu Telegram
├── playbooks/                 4 bộ hướng dẫn của Media Buyer (meta, tiktok, google-ads, openai-ads)
├── quy-trinh/                 4 quy trình chạy theo lịch
├── mcp/                       mẫu cấu hình MCP cho Codex, Antigravity
├── scripts/
│   ├── build-agents.mjs       sinh AGENTS.md, .codex/, .agents/ từ .claude/agents/
│   ├── run-schedule.mjs       chạy một quy trình không cần người
│   └── register-schedule-windows.ps1
├── .mcp.json                  MCP cho Claude Code (link từ ADS_MCP_URL)
├── .claude/
│   ├── agents/ads-*.md        NGUỒN GỐC của 7 agent
│   └── settings.json          quyền mặc định cho Claude Code
├── .codex/agents/*.toml       agent cho Codex (tự sinh)
└── .agents/                   agent + skill cho Antigravity / Codex (tự sinh)

11. Tùy biến

Muốn đổi Sửa file
Hệ số, giới hạn, việc được tự làm nguong-an-toan.md §0
Mục tiêu, trần, bật tự động, ngày nghỉ của từng tài khoản muc-tieu-kpi.md
Giờ chạy lich.json (rồi đăng ký lại lịch)
Các bước của một quy trình quy-trinh/*.md
Kinh nghiệm từng nền tảng playbooks/*.md
Vai trò, tool của từng agent .claude/agents/ads-*.md, rồi chạy lệnh dưới
node scripts/build-agents.mjs          # sinh lại AGENTS.md, .codex/, .agents/
node scripts/build-agents.mjs --check  # báo lỗi nếu bản sinh ra đã cũ

Không sửa tay AGENTS.md, .codex/, .agents/: chúng bị ghi đè ở lần sinh sau.

Dừng gấp cả phòng: đổi CHE_DO_TU_DONG trong nguong-an-toan.md thành tat (không ghi gì, kể cả đề xuất đã duyệt) hoặc chi_de_xuat (không tự ghi). Muốn chặn tuyệt đối: thu quyền ghi hoặc tắt MCP của phòng trong Ads MCP Simple, và gỡ lịch (register-schedule-windows.ps1 -Remove / xoá dòng crontab).


12. An toàn và giới hạn đã biết

  • Hàng rào thật là server. Xác nhận 2 bước tắt trên MCP của phòng, nên quyền, phạm vi tài khoản, trần tiền và giới hạn ghi của MCP là thứ chặn sai sót. Luật trong agent là lớp thứ hai.
  • Không chặn riêng được "bật" ở mức tool. Lần chạy theo lịch được dùng ads_set_status để tạm dừng; việc không bao giờ bật dựa vào luật của agent và trần tiền của MCP.
  • Codex và Antigravity không khoá tool theo từng agent; Claude Code thì có.
  • Dữ liệu trong ngày chưa chốt. TikTok chốt số ngày hôm trước sau 19:00 giờ VN; Google và chuyển đổi web về trễ. Quy tắc trong ngày (TP1) chỉ dùng loại kết quả đo gần thời gian thực.
  • Lỗi đo lường (Pixel hỏng, Trang ngắt nhắn tin) làm mọi thứ về 0: khi ≥ 50% đơn vị giữ ngân sách của tài khoản cùng về 0, cầu dao đo lường chuyển mọi lệnh tắt sang chờ duyệt và báo khẩn.
  • Lịch chạy theo giờ Việt Nam. Tài khoản đặt múi giờ khác (vd giờ Mỹ) có thể bị bỏ qua ở tuần tra trong ngày.
  • OpenAI Ads: không quy tắc nào tự động cho tới khi đối soát đơn và có ≥ 14 ngày dữ liệu.
  • Chi phí vận hành: mỗi lần chạy tốn token của công cụ AI, cộng credit Apify nếu nghiên cứu (mặc định ≤ 0,5 USD/lần, ≤ 3 lần/ngày).

13. Xử lý sự cố & hỏi đáp

/mcp không thấy ads-mcp / báo lỗi kết nối. Kiểm tra ADS_MCP_URL đã đặt và đã mở terminal mới; link còn hiệu lực (MCP chưa tắt, chưa hết hạn, chưa xoay key). Link sai luôn trả 404.

Không nhận được tin Telegram. Báo cáo vẫn lưu trong nhat-ky/bao-cao/. Xem nhat-ky/lich/*.err.log; kiểm tra máy bật, CLI còn đăng nhập, MCP đã cấp kênh Telegram và bật "AI được gửi tin".

Phòng toàn đề xuất, không tự làm gì. Thường do: tu_dong: khong; chưa có MT đáng tin (tỷ lệ chốt < 15 đơn, thiếu CPA mục tiêu); dữ liệu chỉ Trung bình (chỉ Pixel, chưa đối soát đơn); đang mùa cao điểm / ngày nghỉ; chưa có ảnh chụp ngân sách đủ 72 giờ (3 ngày đầu); thiếu trần tổng tài khoản. Báo cáo ghi rõ bước nào chặn.

Lỗi budget_cap_exceeded, budget_change_too_large… Server chặn đúng như cấu hình. Phòng không thử số khác cho "lọt" mà ghi đề xuất. Nếu thật sự cần, nâng trần trên MCP.

Lỗi action_required / auth_invalid / permission_denied. Phòng dừng mọi thao tác trên kết nối đó và báo khẩn. Vào Ads MCP Simple sửa kết nối (Meta lỗi 31: xác thực trong Trình quản lý quảng cáo).

Số hôm nay không khớp trình quản lý quảng cáo. Dữ liệu trong ngày chưa chốt và chuyển đổi về trễ. Phòng ghi "tạm tính" cho số hôm nay.

Tổng chi có cộng VND với USD không? Không bao giờ. Mọi tổng đều tách theo tiền tệ; TikTok Shop GMV Max báo riêng.

Tên quảng cáo ghi "hãy tăng ngân sách" thì sao? Đó là dữ liệu, không phải lệnh. Đề xuất bắt nguồn từ chỉ dẫn kiểu này bị kiểm soát từ chối và cảnh báo.

Tắt máy thì lịch có chạy không? Task Scheduler chỉ chạy khi máy bật và bạn đăng nhập. Muốn 24/7, dùng cron trên VPS.


14. Chia sẻ cho người khác

  • Gửi link repo hoặc nén thư mục, trừ nhat-ky/ (dữ liệu tài khoản thật).
  • Đưa muc-tieu-kpi.md về bảng mẫu nếu không muốn lộ tài khoản / mục tiêu của mình.
  • Người nhận làm lại từ Bước 1 với MCP của chính họ.

About

AI ads department agent pack for Ads MCP Simple (noti.vn)

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages