⚠ = case solo (đổi/cần state) — bỏ tick sẵn nhưng TICK ĐƯỢC để trộn; bạn tự đảm bảo phù hợp. Trộn solo → cảnh báo khi Chạy.
Chỉ hiện case reactive (single/auto). Monitor chạy riêng — xem Testcase Editor.
—
Tùy chọn — để trống thì AI/bot tự xử như cũ.
—
Điều khiển ẩn (do màn hẹp)
Chuyển phiên
Giao diện
Công cụ
đang kết nối…
⚠
🔑 Đăng nhập Zalo bằng mã QR
⚠ Bỏ dấu check "Đồng bộ tin nhắn sang thiết bị này" trên màn hình đăng nhập Zalo.
Bấm 🔳 Tạo QR để bắt đầu.
Mở Zalo trên điện thoại → Quét mã QR.
💡 Đề xuất nội dung phù hợp màn hình điện thoại
🔍 Nhận xét tin gốc (trong ngữ cảnh hội thoại)
đang phân tích…
✨ Nội dung đề xuất (giữ văn phong & ngôn ngữ gốc)
đang tạo đề xuất…
🖼 Đề xuất về hình ảnh
🗂 Phiên đang chạy
Chưa có phiên nào đang chạy.
⏳ Phiên chờ (RAM/slot)
🎭 Persona Studio
⚠️ Ảnh giấy tờ là dữ liệu cá nhân nhạy cảm (NĐ13). Khuyến nghị
dùng giấy tờ mẫu/giả lập để test; không dùng giấy tờ thật của người khác khi chưa được
đồng ý. Ảnh chỉ lưu local dưới config/personas/documents/ — đã gitignore,
TUYỆT ĐỐI không commit lên GitHub. AI có thể đọc sai → hãy kiểm tra & sửa tay trước khi lưu.
📝 Testcase Editor — Thư viện testcase
ID
Mode
Phase
Capability
Tiền đề
Mục tiêu
Thông tin chung
expectationsByCapability — mỗi dòng 1 tiêu chí bắt buộc (mustHave) theo từng mức:
Mode SINGLE
Mode AUTO (role-play khách)
successCriteria — tiêu chí thành công (mỗi dòng 1 ý):
Mode MONITOR (lắng nghe proactive)
Monitor chấm bằng từ khóa + cửa sổ thời gian + số lần, KHÔNG dùng AI. passCriteria/failConditions ở chế độ này chỉ hiển thị, không ảnh hưởng kết quả. ⚠ Trong lúc monitor chạy, KHÔNG chat tay với OA này từ Zalo app — bot trả lời tin đó sẽ bị tính nhầm thành tin chủ động.
monitorConfig:
Tổng thời lượng lắng nghe (giờ). Mặc định 24 nếu bỏ trống. Chạy trong journey thì lấy theo đồng hồ journey.
Bao lâu quét màn hình chat một lần để tìm tin mới của bot (giây). Mặc định 15. Nhỏ hơn = nhạy hơn nhưng tốn CPU.
Bao lâu chụp ảnh màn hình + báo còn sống một lần (giây). Mặc định 300. Đây là ảnh hiển thị trên Console.
Bao lâu ghi điểm khôi phục một lần (giây). Mặc định 60. Dùng để chạy tiếp đúng chỗ nếu service khởi động lại.
Chỉ là nhãn hiển thị — đặt tên cho mốc thời gian (vd 'deposit'). Không ảnh hưởng việc chấm.
⚠ NÊN ĐỂ TRỐNG — khi trống, mốc gốc = thời điểm bấm Chạy. Nếu điền một thời điểm đã qua, mọi cửa sổ kỳ vọng cũng đã qua → case chắc chắn trượt mà không có cảnh báo.
expectedEvents
negativeEvents
Sự kiện KHÔNG được phép xảy ra — bot nhắn tin chứa từ khóa cấm là case trượt. Áp dụng suốt toàn bộ thời lượng nghe (không có cửa sổ thời gian). ⚠ Chỉ cần có 1 sự kiện cấm, monitor sẽ nghe hết durationHours chứ không dừng sớm khi đã đủ kỳ vọng.
🗑 Xóa testcase
🧭 Journey Editor — Thư viện hành trình
Tên
OA
Persona
Chặng
Mô tả
Thông tin chung
Journey mở hội thoại với OA này ngay đầu hành trình. Chạy với --oa vẫn ép đổi được.
MỘT người xuyên suốt. Trống = ngẫu nhiên lúc chạy (--persona vẫn thắng).
Journey LUÔN chạy thời gian thật. Bot chạy trên máy chủ theo lịch thật, độc lập hoàn toàn với tester — nén đồng hồ chỉ rút ngắn thời gian NGHE của tester chứ không rút ngắn lịch của bot, nên chỉ đẻ ra kết quả "không có tin chủ động" giả. Muốn kiểm nhanh một chặng: dùng ô ▶ thử chặng cạnh nút Chạy.
Mốc thời gian (clock.anchors)
Tên mốc + giá trị "T+N[d|h|m]" (vd booking = T+0 · checkin = T+3d · checkout = T+6d). Cửa sổ của chặng lắng nghe neo vào mốc; chặng dùng mốc CHƯA khai sẽ bị chặn khi lưu (mốc sai ở runtime bị nuốt im lặng thành T+0 — nên chặn từ đây).
Bối cảnh khách mang theo (context)
Điều khách "đã biết & nhớ" từ đầu hành trình (tripType, nights, guests…). Giá trị dạng số/danh sách JSON giữ nguyên dạng khi lưu; còn lại lưu chuỗi.
Các chặng (segments) — chạy đúng thứ tự từ trên xuống
💬 đối thoại = khách chủ động nhắn (case single/auto, chung 1 phiên) · 📡 lắng nghe = chờ bot CHỦ ĐỘNG nhắn (case monitor, cửa sổ neo theo mốc) · 🏨 tại quầy = gọi thẳng OnePMS để mô phỏng khách nhận phòng / trả tiền. "Đạt trạng thái" (achieves) khai chặng này thiết lập xong gì (booked/checked-in/checked-out) — dùng để cảnh báo chặng sau đặt sai thứ tự.
⚙️ Cấu hình
Tông màu (giao diện)
✓ Áp ngay · lưu trên trình duyệt
Đổi tông áp dụng ngay (không cần restart). Lưu ở trình duyệt này (localStorage), không ảnh hưởng người khác.
🔒 Quản lý khai thác tool (tester)
✓ Có hiệu lực ngay (lần chạy sau)
Ghi vào config/tool-availability.json — server đọc LẠI mỗi lần chạy, không cần restart. Mục bị TẮT: tester bấm chạy sẽ bị chặn ở server (403) kèm đúng câu thông báo bạn gõ ở đây. Mặc định BẬT — không khai = cho phép.
1 · OA × nền tảng
(đa-OA) Tắt một OA thì mọi lần chạy trỏ OA đó bị chặn ở server, kể cả gọi API trực tiếp. Dùng cho OA nội bộ. ⚠ Đây là công tắc TOÀN CỤC, không phải phân quyền theo tester — tool chưa có định danh tester; việc “chỉ vài người dùng OA nội bộ” do Zalo chặn (OA không public) và do dropdown OA ẩn mặc định ở đầu trang.
2 · Mode test × nền tảng
Tắt mode nào thì mục tương ứng trong ô Chế độ chạy ở đầu trang tự chuyển xám (🔒, rê chuột thấy lý do) — chỉ với tester, admin vẫn thấy đầy đủ. Tắt cả single/auto/scripted/monitor mới khóa được mục “Case lẻ”.
3 · Từng testcase × nền tảng
Quyền analyst — chỉ xem. Cần super-admin để sửa.
Hành vi test & OA
✓ Có hiệu lực ngay (lần chạy sau)
Ghi vào config/runtime.json — runner đọc MỖI lần chạy, không cần restart.
Chỉ để hiển thị — OA thật lấy từ file testcase. Đổi ở đây không ảnh hưởng lần chạy.
Khách "suy nghĩ" bao lâu trước khi gõ mỗi tin (ms, ngẫu nhiên trong khoảng). Tăng = giống người thật hơn nhưng chạy chậm; quá nhỏ dễ bị chặn vì nhắn dồn.
Khách "suy nghĩ" bao lâu trước khi gõ mỗi tin (ms, ngẫu nhiên trong khoảng). Tăng = giống người thật hơn nhưng chạy chậm; quá nhỏ dễ bị chặn vì nhắn dồn.
Tốc độ gõ: số mili-giây cho mỗi ký tự. Tăng = gõ chậm, tin dài lâu gửi hơn.
Trần tổng thời gian gõ 1 tin (ms), dù tin dài mấy. Chỉ có tác dụng khi tin quá dài so với tốc độ gõ ở trên.
Nghỉ giữa 2 testcase khi chạy nhiều case (ms, ngẫu nhiên trong khoảng). Tăng = an toàn hơn với giới hạn của Zalo/bot; giảm = chạy nhanh nhưng dễ bị chặn.
Nghỉ giữa 2 testcase khi chạy nhiều case (ms, ngẫu nhiên trong khoảng). Tăng = an toàn hơn với giới hạn của Zalo/bot; giảm = chạy nhanh nhưng dễ bị chặn.
Bot im lặng bao lâu thì coi là đã trả lời xong (ms) — dùng để gộp nhiều tin bot gửi liên tiếp thành 1 lượt chấm. Giảm quá nhỏ sẽ cắt ngang, chấm thiếu ý bot đang nói dở.
(Chỉ cho chế độ theo dõi) Hai tin bot cách nhau dưới mức này được tính là cùng 1 lần bot chủ động nhắn. Phải nhỏ hơn 15 giây.
Sau lượt cuối, nếu bot vừa báo kiểu "đang xử lý, vui lòng chờ" thì tool nán lại nghe thêm tối đa ngần này (ms) mà KHÔNG gửi gì — để nhận nốt tin xác nhận (thường kèm mã booking). Bot không báo gì như vậy thì KHÔNG chờ giây nào. Đặt 0 = tắt. Tin đến muộn KHÔNG tham gia chấm điểm.
Ngưỡng thời gian phản hồi đầu (ms) — chỉ áp cho testcase chế độ "single". ⚠ Điền số ở đây sẽ áp cho MỌI case single không tự khai ngưỡng riêng; bot hiện trả lời khoảng 8-16s nên đặt dưới ~16000 sẽ khiến các case FAIL vì thời gian dù nội dung đúng. Để trống = không ràng buộc thời gian (mặc định).
Review ảnh (assessImages)
Tắt để tiết kiệm chi phí AI — ảnh bot vẫn hiển thị, chỉ KHÔNG chấm điểm.
Đánh giá nội dung (assessContent) — PP4
Tắt để verify HẠ TẦNG rẻ nhất (spawn/pool/grid/restart chạy được không) — BỎ chấm AI pass/fail (analyzeReply/judgeSingle/summarize). Khách VẪN role-play (auto/journey vẫn sinh tin, gửi/nhận/đo). Kết quả = "skip-đánh-giá" (không pass/fail). Tắt = mọi lượt thành "không chấm", chỉ chạy hội thoại (tiết kiệm chi phí AI).
Bỏ dấu tin khách (applyDiacriticsTransform)
Bật để test khả năng hiểu ngôn ngữ — khách có persona "bỏ dấu" sẽ gõ KHÔNG DẤU thật (vd "phòng đêm"→"phong dem"). Tắt = tin sạch (demo). Chỉ áp tin AUTO/journey (AI sinh); case single dùng input viết sẵn — muốn không dấu thì viết input không dấu. Chỉ áp khi khách có thiết lập bỏ dấu + tiếng Việt + chế độ tự động (case "single" dùng câu viết sẵn nên không bị đổi).
Tự ghi nhận mã booking (captureBooking) — #45
Bật để tool tự bắt mã booking bot tạo ra khi chạy TC và giữ mã trong ô "🔖 Mã booking" cho tới khi bot xác nhận đã huỷ / không tìm thấy. Chỉ tốn AI ở run CÓ dấu hiệu booking (bộ lọc rẻ chặn phần còn lại), và không bao giờ đổi kết quả chấm. Tắt = không ghi nhận thêm; mã đã lưu vẫn còn.
Đồng bộ OnePMS cuối hội thoại (pmsSyncAfterRun) — #58
Bật để tool đọc lại booking từ OnePMS ngay sau khi hội thoại kết thúc (browser đã đóng) rồi ghi phần LỆCH giữa lời bot và PMS vào nhật ký — đây là cách đo khả năng truyền đạt của bot. CHỈ ĐỌC: không đổi gì trên PMS, không đổi kết quả chấm, không bao giờ tự đóng mã. Máy chưa cấu hình OnePMS thì mục này tự động không làm gì.
Hiện khi chạy phase/case CẦN trạng thái (đã đặt/nhận/trả phòng) mà ô mã booking để trống. Hiệu lực ngay.
Môi trường (.env)
⚠ Cần restart để áp dụng
⚠ Đổi xong phải khởi động lại dịch vụ mới có hiệu lực.
Ghi vào .env (backup .env.bak trước) — chỉ có hiệu lực sau khi restart Console/test.
để trống = giữ key cũ
🔄 Cần restart thủ công
node index.js console
💳 Hoá đơn & Thanh toán — —
—
Ghi nhận thanh toán (ĐỔI DỮ LIỆU THẬT trên OnePMS)
🎯 Capability Editor — chỉnh mức
Chỉ đổi MỨC key có sẵn — đổi xong áp ngay từ lần chạy sau (không cần restart).