# Checklist triển khai Chatbot AI cho web Việt trong 7 ngày Dự án: [Tên website/nhãn hàng] Phiên bản tài liệu: v1.0 Ngày bắt đầu: [..../..../....] — Ngày kết thúc: [..../..../....] Đội dự án: PM [.....], Tech Lead [.....], Data [.....], QA [.....], Content [.....], Legal [.....] --- ## 0) Phạm vi, KPI và theo dõi chung - Mục tiêu tổng: Chatbot AI hỗ trợ khách truy cập web bằng tiếng Việt, đáp ứng nhanh, chính xác, tự động hóa tối đa và có phương án chuyển giao cho người thật. - Kênh: Web chat widget (desktop/mobile), tích hợp CRM/Helpdesk (tuỳ chọn). - Yêu cầu pháp lý: Tuân thủ NĐ 13/2023/NĐ-CP về bảo vệ dữ liệu cá nhân; công bố chính sách bảo mật và điều khoản sử dụng. ### KPI mục tiêu tuần | Chỉ số | Mục tiêu | Ghi chú | |---|---|---| | FRT (First Response Time) | ≤ 2 giây | Thời gian phản hồi đầu tiên | | Tỉ lệ automation | ≥ 60% | % phiên tự xử lý không cần agent | | Độ chính xác câu trả lời | ≥ 80% | Theo bộ câu hỏi chuẩn hóa | | CSAT (hài lòng) | ≥ 4.2/5 | Khảo sát sau phiên | | Chi phí/phiên | ≤ [VND] | Bao gồm hạ tầng + API | | Tỉ lệ chuyển giao | ≤ 20% | Chuyển chat cho người thật | ### Theo dõi chi phí & tokens (tuần) | Ngày | Model | Số phiên test | Input tokens | Output tokens | Tổng tokens | Cost ước tính (VND) | |---|---|---|---:|---:|---:|---:| | 1 | [..] | [..] | [..] | [..] | [..] | [..] | | 2 | [..] | [..] | [..] | [..] | [..] | [..] | | 3 | [..] | [..] | [..] | [..] | [..] | [..] | | 4 | [..] | [..] | [..] | [..] | [..] | [..] | | 5 | [..] | [..] | [..] | [..] | [..] | [..] | | 6 | [..] | [..] | [..] | [..] | [..] | [..] | | 7 | [..] | [..] | [..] | [..] | [..] | [..] | --- ## 1) Ngày 1 — Kickoff & định nghĩa sản phẩm Mục tiêu ngày: - Xác định phạm vi, use-case, giọng thương hiệu, luồng hội thoại, KPI & pháp lý. Checklist chi tiết: - [ ] Xác định 5–10 use-case chính (FAQ, chính sách, đặt hàng, tra cứu, hỗ trợ kỹ thuật) - [ ] Định nghĩa persona & giọng Chatbot (thân thiện, lịch sự, ngắn gọn) - [ ] Vẽ luồng hội thoại cơ bản: chào hỏi, phát hiện ý định, trả lời, fallback, chuyển người thật - [ ] KPI & ngưỡng chấp nhận (FRT, automation, accuracy) - [ ] Chính sách dữ liệu: thông báo thu thập, ẩn thông tin nhạy cảm (PII redaction) - [ ] Kế hoạch mô hình & hạ tầng: model, hosting, CDN, logging, giám sát - [ ] Danh sách tích hợp: CRM/Helpdesk, form liên hệ, analytics - [ ] Phê duyệt phạm vi & timeline Đầu ra: - Tài liệu yêu cầu (PRD mini), sơ đồ luồng, KPI baseline Ghi nhật ký cost/tokens & KPI: | Model | Phiên test | Input tokens | Output tokens | Cost (VND) | FRT trung bình (s) | Tỉ lệ automation (%) | |---|---:|---:|---:|---:|---:|---:| | [..] | [..] | [..] | [..] | [..] | [..] | [..] | Link tài liệu: - Hướng dẫn API: https://platform.openai.com/docs - Thiết kế hội thoại: https://www.nngroup.com/articles/chatbots/ - Bảo vệ dữ liệu VN (NĐ 13/2023/NĐ-CP): [Tra cứu trên Cổng thông tin pháp luật] Ô ký duyệt ngày 1: | Vai trò | Ký tên | Ngày | |---|---|---| | PM/Product Owner | | | | Tech Lead | | | | Legal/Compliance | | | --- ## 2) Ngày 2 — Thu thập dữ liệu & thiết kế ý định Mục tiêu ngày: - Chuẩn hóa FAQ/knowledge base, gắn nhãn ý định, xây prompt hệ thống. Checklist chi tiết: - [ ] Thu thập nguồn: trang chính sách, FAQ, sản phẩm, blog, CSV - [ ] Làm sạch dữ liệu: bỏ HTML dư, hợp nhất trùng lặp, chuẩn tiếng Việt - [ ] Gắn nhãn intents (ý định): chào hỏi, giá, bảo hành, thanh toán, vận chuyển, hỗ trợ kỹ thuật, liên hệ người thật - [ ] Thiết kế khung trả lời tiêu chuẩn (templates) + thẻ nội dung bắt buộc (địa chỉ, hotline, giờ làm) - [ ] Viết Prompt hệ thống: giọng nói, phạm vi, guardrails, từ chối khi thiếu dữ liệu - [ ] Danh sách từ khóa nhạy cảm (PII) cần ẩn hoặc chuyển người thật - [ ] Bộ câu hỏi kiểm thử 50–100 câu cho QA Đầu ra: - Knowledge base chuẩn hóa, bảng intents, prompt hệ thống, bộ test Ghi nhật ký cost/tokens & KPI: | Model | Phiên test | Input tokens | Output tokens | Cost (VND) | FRT (s) | Automation (%) | |---|---:|---:|---:|---:|---:|---:| | [..] | [..] | [..] | [..] | [..] | [..] | [..] | Link tài liệu: - Prompting: https://platform.openai.com/docs/guides/prompt-engineering - Xử lý dữ liệu: https://docs.python.org/3/tutorial/ - Gắn nhãn intents: https://docs.airtable.com/ hoặc https://labelstud.io/ Ô ký duyệt ngày 2: | Vai trò | Ký tên | Ngày | |---|---|---| | Content Lead | | | | Data/ML | | | | PM | | | --- ## 3) Ngày 3 — Xây UI chat & tích hợp API Mục tiêu ngày: - Lập trình widget chat web, kết nối API, quản lý phiên, ghi log. Checklist chi tiết: - [ ] Chọn stack UI: Vanilla JS/React/Next.js; triển khai widget nổi (floating) - [ ] Thiết kế UI tối giản: khung chat, avatar, trạng thái “đang gõ”, nút chuyển người thật - [ ] API server (Node/Next API Route): proxy khóa API, kiểm soát tốc độ - [ ] Quản lý phiên: session ID, conversation context, TTL - [ ] Ghi log: câu hỏi/đáp, tokens, FRT, rating - [ ] Xử lý lỗi & timeout, retry backoff - [ ] Telemetry/Analytics: GA/Segment, sự kiện bắt đầu/kết thúc phiên Đầu ra: - Widget chat hoạt động trên staging, kết nối API ổn định Ghi nhật ký cost/tokens & KPI: | Model | Phiên test | Input tokens | Output tokens | Cost (VND) | FRT (s) | Automation (%) | |---|---:|---:|---:|---:|---:|---:| | [..] | [..] | [..] | [..] | [..] | [..] | [..] | Link tài liệu: - UI web: https://nextjs.org/docs hoặc https://developer.mozilla.org/ - API & Responses: https://platform.openai.com/docs/api-reference - Triển khai: https://vercel.com/docs Ô ký duyệt ngày 3: | Vai trò | Ký tên | Ngày | |---|---|---| | Tech Lead | | | | Frontend Dev | | | | PM | | | --- ## 4) Ngày 4 — RAG & tìm kiếm kiến thức Mục tiêu ngày: - Tích hợp khả năng truy xuất kiến thức (RAG), đánh chỉ mục và truy hồi chính xác. Checklist chi tiết: - [ ] Chia nhỏ tài liệu (chunking), tạo embeddings, lưu vào vector DB (Pinecone/Weaviate/FAISS) - [ ] Triển khai pipeline: truy vấn → truy hồi top-k → tổng hợp trả lời có trích dẫn - [ ] Thiết kế prompt kết hợp: “hạn chế bịa”, dẫn nguồn, từ chối nếu không tìm thấy - [ ] Đánh giá độ tương đồng, tinh chỉnh size chunk & k - [ ] Ghi log trích dẫn nguồn trong câu trả lời - [ ] Kiểm thử với bộ câu hỏi ngày 2 Đầu ra: - RAG chạy trên staging, trả lời kèm nguồn, độ chính xác tăng Ghi nhật ký cost/tokens & KPI: | Model | Phiên test | Input tokens | Output tokens | Cost (VND) | FRT (s) | Automation (%) | |---|---:|---:|---:|---:|---:|---:| | [..] | [..] | [..] | [..] | [..] | [..] | [..] | Link tài liệu: - Embeddings: https://platform.openai.com/docs/guides/embeddings - Vector DB: https://www.pinecone.io/ hoặc https://weaviate.io/developers - RAG patterns: https://docs.langchain.com/docs/use_cases/qa Ô ký duyệt ngày 4: | Vai trò | Ký tên | Ngày | |---|---|---| | Data/ML | | | | Tech Lead | | | | QA | | | --- ## 5) Ngày 5 — Workflow, công cụ & chuyển người thật Mục tiêu ngày: - Thêm hành động tự động (tools), biểu mẫu, và kênh chuyển giao cho agent. Checklist chi tiết: - [ ] Định nghĩa tools: tra cứu đơn hàng, tạo ticket, gửi email, gọi API CRM - [ ] Bắt đầu/điền form: thu thông tin tối thiểu, kiểm tra/ẩn PII - [ ] Logic chuyển người thật: tiêu chí kích hoạt (ý định nhạy cảm, sentiment xấu, 3 lần fallback) - [ ] Tích hợp Helpdesk/Livechat (Zendesk, Freshdesk) hoặc form liên hệ - [ ] Nhận diện rủi ro: nội dung cấm, yêu cầu nhạy cảm → từ chối hoặc escalates - [ ] Ghi nhận tỉ lệ automation và tỉ lệ chuyển giao Đầu ra: - Các hành động chạy được, quy trình chuyển agent hoạt động Ghi nhật ký cost/tokens & KPI: | Model | Phiên test | Input tokens | Output tokens | Cost (VND) | FRT (s) | Automation (%) | Tỉ lệ chuyển giao (%) | |---|---:|---:|---:|---:|---:|---:|---:| | [..] | [..] | [..] | [..] | [..] | [..] | [..] | [..] | Link tài liệu: - Tool calling & function calls: https://platform.openai.com/docs/guides/function-calling - Helpdesk APIs: Zendesk/Freshdesk docs - PII redaction: https://owasp.org/www-project-top-10/ Ô ký duyệt ngày 5: | Vai trò | Ký tên | Ngày | |---|---|---| | Tech Lead | | | | Operations | | | | Legal/Compliance | | | --- ## 6) Ngày 6 — QA, tối ưu hiệu năng & bảo mật Mục tiêu ngày: - Kiểm thử chức năng/tải, giảm FRT, tăng độ chính xác, đảm bảo bảo mật. Checklist chi tiết: - [ ] Chạy bộ test 50–100 câu: accuracy, nhất quán giọng nói, phủ use-case - [ ] Tối ưu FRT: streaming, cache, giảm context, cấu hình timeout hợp lý - [ ] Tối ưu chi phí: giới hạn độ dài, tóm tắt phiên, nén context - [ ] Bảo mật: proxy khóa API, CORS, rate limiting, ẩn PII, mã hóa logs - [ ] Kiểm thử tải: 100–500 phiên đồng thời (staging) - [ ] Khảo sát CSAT thử nghiệm, ghi nhận phản hồi người dùng nội bộ - [ ] Chuẩn bị tài liệu hướng dẫn vận hành Đầu ra: - Báo cáo QA, chỉnh prompt/hyperparameters, checklist bảo mật Ghi nhật ký cost/tokens & KPI: | Model | Phiên test | Input tokens | Output tokens | Cost (VND) | FRT (s) | Automation (%) | Accuracy (%) | |---|---:|---:|---:|---:|---:|---:|---:| | [..] | [..] | [..] | [..] | [..] | [..] | [..] | [..] | Link tài liệu: - Streaming: https://platform.openai.com/docs/guides/streaming - Hiệu năng web: https://web.dev/fast/ - Bảo mật web: https://cheatsheetseries.owasp.org/ Ô ký duyệt ngày 6: | Vai trò | Ký tên | Ngày | |---|---|---| | QA Lead | | | | Tech Lead | | | | PM | | | --- ## 7) Ngày 7 — Ra mắt & giám sát Mục tiêu ngày: - Triển khai production, thiết lập giám sát, quy trình phản hồi/đào tạo liên tục. Checklist chi tiết: - [ ] Triển khai production (domain, SSL, CDN), kiểm tra cuối - [ ] Dashboard giám sát: FRT, automation, accuracy, tokens, cost - [ ] Cảnh báo sự cố: latency, error rate, escalations - [ ] Thu thập phản hồi: nút “Hài lòng/Không hài lòng”, form góp ý - [ ] Quy trình cập nhật KB & prompt định kỳ (tuần) - [ ] Kế hoạch truyền thông: thông báo ra mắt, hướng dẫn người dùng - [ ] Tài liệu bàn giao & đào tạo đội CS/Marketing Đầu ra: - Chatbot chạy trên production, dashboard hoạt động, kế hoạch vận hành Ghi nhật ký cost/tokens & KPI: | Model | Phiên thực tế (ngày) | Input tokens | Output tokens | Cost (VND) | FRT (s) | Automation (%) | CSAT | |---|---:|---:|---:|---:|---:|---:|---:| | [..] | [..] | [..] | [..] | [..] | [..] | [..] | [..] | Link tài liệu: - Monitoring: https://grafana.com/docs/ hoặc https://datadoghq.com/ - Hướng dẫn vận hành: https://12factor.net/ - Triển khai: https://vercel.com/docs Ô ký duyệt ngày 7: | Vai trò | Ký tên | Ngày | |---|---|---| | PM/Product Owner | | | | Tech Lead | | | | Operations | | | --- ## Mẫu Prompt hệ thống (tham khảo, điền riêng cho thương hiệu) - Vai trò: Trợ lý AI của [Tên thương hiệu], giao tiếp bằng tiếng Việt, lịch sự, súc tích. - Phạm vi: Trả lời về sản phẩm/dịch vụ dựa trên KB/RAG; dẫn nguồn khi dùng tài liệu. - Guardrails: - Từ chối khi không có dữ liệu tin cậy, đề xuất chuyển agent. - Không xử lý yêu cầu nhạy cảm (tài chính/PII) — hãy ẩn thông tin và chuyển người thật. - Tôn trọng chính sách và pháp luật; không phát ngôn gây hiểu lầm. - Định dạng trả lời: 2–5 câu, gạch đầu dòng khi cần; chèn link nguồn rút gọn; hỏi tiếp để làm rõ. --- ## Mẫu cấu trúc intents & phản hồi | Intent | Ví dụ câu hỏi | Chính sách trả lời | Nguồn | Tool/Action | Escalate khi | |---|---|---|---|---|---| | Chào hỏi | “Xin chào” | Chào + giới thiệu khả năng | N/A | N/A | N/A | | Giá | “Giá sản phẩm A?” | Trả giá + link sản phẩm | Catalog | N/A | Dữ liệu thiếu | | Bảo hành | “Bảo hành thế nào?” | Tóm tắt + nguồn | Policy | N/A | Yêu cầu PII | | Thanh toán | “Có COD không?” | Câu trả lời + phí, thời gian | Payment Policy | N/A | Chính sách không rõ | | Đơn hàng | “Tra cứu đơn #123” | Hỏi mã, xác thực tối thiểu | CRM | tra cứu | Không khớp thông tin | | Liên hệ | “Gặp nhân viên” | Chuyển người thật | N/A | Create ticket | Người dùng yêu cầu | --- ## Kiểm thử & đánh giá - Bộ test chuẩn hóa (điền câu hỏi): 1) Chính sách, 2) Giá/khuyến mãi, 3) Vận chuyển, 4) Bảo hành/đổi trả, 5) Liên hệ, 6) Kỹ thuật, 7) Truy xuất đơn hàng, 8) Trường hợp ngoại lệ. - Ma trận đánh giá: | Case | Kết quả | Độ chính xác (0–1) | FRT (s) | Có nguồn? | Có hành động? | Ghi chú | |---|---|---:|---:|---|---|---| | 1 | | | | | | | | 2 | | | | | | | --- ## Rủi ro & biện pháp - Rủi ro: Sai thông tin, bịa nguồn, lộ PII, chi phí vượt, latency cao, chuyển giao không kịp. - Biện pháp: - RAG + từ chối khi thiếu dữ liệu; kiểm duyệt nội dung. - PII redaction & giới hạn thông tin nhạy cảm; proxy API. - Giới hạn độ dài context; caching; streaming; theo dõi tokens. - SLA chuyển người thật ≤ 60 giây; dự phòng load. --- ## Tổng kết tuần & chữ ký bàn giao Báo cáo KPI tuần: | Chỉ số | Kết quả | Mục tiêu | Đạt/Không | |---|---:|---:|---| | FRT trung bình (s) | [..] | ≤ 2 | [ ] | | Tỉ lệ automation (%) | [..] | ≥ 60 | [ ] | | Accuracy (%) | [..] | ≥ 80 | [ ] | | CSAT | [..] | ≥ 4.2 | [ ] | | Chi phí/phiên (VND) | [..] | ≤ [..] | [ ] | Tổng hợp cost/tokens: | Model | Tổng phiên | Tổng input tokens | Tổng output tokens | Tổng cost (VND) | |---|---:|---:|---:|---:| | [..] | [..] | [..] | [..] | [..] | Chữ ký bàn giao: | Vai trò | Ký tên | Ngày | |---|---|---| | PM/Product Owner | | | | Tech Lead | | | | QA Lead | | | | Legal/Compliance | | | | Operations | | | --- ## Phụ lục: Tài liệu tham khảo nhanh - OpenAI API Docs: https://platform.openai.com/docs - Prompt Engineering: https://platform.openai.com/docs/guides/prompt-engineering - Embeddings & RAG: https://platform.openai.com/docs/guides/embeddings - Next.js (Web UI): https://nextjs.org/docs - Vercel Deploy: https://vercel.com/docs - OWASP Cheat Sheets (Bảo mật): https://cheatsheetseries.owasp.org/ - Vector DB: https://www.pinecone.io/ | https://weaviate.io/developers - Analytics/Monitoring: https://grafana.com/docs/ | https://datadoghq.com/ - Thiết kế hội thoại: https://www.nngroup.com/articles/chatbots/ Ghi chú in A4: - Sử dụng khổ giấy A4, lề tiêu chuẩn. - Tránh URL quá dài khi in; có thể rút gọn bằng dịch vụ liên kết ngắn. - Dùng phông chữ dễ đọc: 11–12pt; khoảng dòng 1.15–1.2.