Nền Tảng AI Tư Vấn & Đặt Hàng Tự Động Cho Thương Mại Điện Tử
Sử dụng AI để tư vấn sản phẩm, xử lý đơn hàng, phân loại khách hàng và đặt lịch tư vấn online một cách tự động.
- Giới Thiệu
- Tính Năng
- Công Nghệ
- Kiến Trúc Hệ Thống
- Cài Đặt
- Sử Dụng
- API Documentation
- Tài Liệu
- Đóng Góp
- License
AT Shop AI Assistant là nền tảng chatbot thông minh được phát triển cho AT Shop Vietnam – hệ thống thương mại điện tử chuyên về thời trang và phụ kiện.
Khai thác sức mạnh của Groq LLM (Llama 3) kết hợp LangChain, hệ thống giúp khách hàng:
- 🧠 Tư vấn sản phẩm — Gợi ý trang phục, size, màu sắc, và combo ưu đãi.
- 🛒 Xử lý đơn hàng — Thêm sản phẩm vào giỏ, tính tổng và xác nhận đơn.
- 👤 Thu thập thông tin khách hàng — Ghi nhận tên, số điện thoại, email, địa chỉ.
- 🗂️ Phân loại khách hàng — Đánh giá tiềm năng mua hàng dựa trên hội thoại.
- 📅 Đặt lịch tư vấn online — Hỗ trợ khách hàng muốn trao đổi trực tiếp với chuyên viên.
🌟 Điểm Đặc Biệt
- ✅ Hoàn toàn tự động – AI đảm nhiệm từ tư vấn → chốt đơn → đặt lịch.
- ✅ Ngôn ngữ tự nhiên tiếng Việt – Giao tiếp thân thiện, tự nhiên.
- ✅ Công cụ nội bộ mạnh mẽ –
create_order,save_potential_customer,save_consultation_schedule_tool. - ✅ Kết nối MariaDB – Lưu lịch sử chat, khách hàng, đơn hàng, và lịch tư vấn.
🤖 1. Tư Vấn Sản Phẩm Thông Minh
- AI chào khách, hỏi nhu cầu, gợi ý sản phẩm theo danh mục (áo, quần, giày, phụ kiện).
- Gợi ý theo tag: “New Arrival”, “Best Seller”, “Discount”.
- Hiển thị ảnh sản phẩm, giá, mô tả (từ frontend).
🛍️ 2. Xử Lý Đơn Hàng
- Thêm/xóa sản phẩm vào giỏ tạm.
- Hiển thị danh sách giỏ hàng, tổng tiền.
- Xác nhận đơn → gọi tool
create_order.
📋 3. Thu Thập Thông Tin Khách Hàng
- Hỏi: Họ tên, SĐT, Email, Địa chỉ giao hàng.
- Kiểm tra và xác nhận trước khi lưu DB.
💾 4. Lưu Dữ Liệu & Quản Lý Đơn Hàng
- Lưu đơn hàng vào bảng
orders. - Lưu khách tiềm năng vào
potential_customers. - Lưu lịch tư vấn vào
consultations.
💡 5. Phân Loại Khách Hàng
- AI tự động gán loại khách:
- 🟢 Tiềm năng (quan tâm cao)
- 🟡 Quan tâm (chưa quyết định)
- 🔴 Không tiềm năng (chỉ xem)
📅 6. Đặt Lịch Tư Vấn Online
- AI gợi ý khung giờ, kênh tư vấn (Zalo, Zoom).
- Lưu lịch tư vấn vào DB qua
save_consultation_schedule_tool.
🛡️ 7. Bảo Mật & Quản Lý Lỗi
- Tự động xử lý lỗi API/DB.
- CORS hỗ trợ frontend từ mọi domain.
- Log chi tiết giúp debug hành vi AI.
| Công Nghệ | Phiên Bản | Mục Đích |
|---|---|---|
| Python | 3.12+ | Ngôn ngữ chính |
| FastAPI | Latest | Web framework |
| Groq LLM | Llama 3 | Xử lý hội thoại |
| LangChain | Latest | Framework AI Agent |
| Pydantic | V2 | Xác thực dữ liệu |
| MariaDB | 10+ | Lưu dữ liệu đơn hàng & khách hàng |
| dotenv | Latest | Quản lý biến môi trường |
- HTML / CSS / JS thuần
- Gọi API qua
fetch('/chat') - Giao diện “chat bubble” hiển thị sản phẩm và phản hồi
┌─────────────────────────────────────────────────────────────┐
│ FRONTEND │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ index.html│ │ chat.js │ │ products.js │ │ cart.js │ │
│ └────┬─────┘ └────┬──────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │ │
│ └──────────────┴──────────────┴─────────────┘ │
│ │ │
│ Fetch API (HTTP) │
└──────────────────────────┼──────────────────────────────────┘
│
┌──────────────────────────▼──────────────────────────────────┐
│ FASTAPI BACKEND │
│ ┌────────────────────────────────────────────────────┐ │
│ │ main.py - Agent Executor & Routes │ │
│ │ • POST /chat │ │
│ │ • OPTIONS /chat (CORS) │ │
│ │ • Session & Message Management │ │
│ └────┬───────────────────────────┬────────────────┬──┘ │
│ │ │ │ │
│ ┌────▼─────┐ ┌─────────────────▼──┐ ┌─────────▼──────┐ │
│ │ LangChain│ │ Tools │ │ Database │ │
│ │ Agent │ │ classify_customer │ │ MariaDB │ │
│ │ │ │ create_order │ │ (orders, users)│ │
│ │ │ │ save_consultation │ │ │ │
│ └──────────┘ └───────────────────┘ └──────────────────┘ │
└────────────────────────────────────────────────────────────┘
- Python ≥ 3.12
- MariaDB ≥ 10
- Groq API Key
git clone https://github.com/antruong2004/Agenttt.git
cd Agentttpython -m venv venv
venv\Scripts\activate # Windows
source venv/bin/activate # Mac/Linuxpip install fastapi uvicorn langchain langchain-groq pydantic mysql-connector-python python-dotenvFile .env:
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_password
DB_DATABASE=chatdb
API_KEY=your_groq_api_key
MODEL=llama3-8b-8192uvicorn server:app --reload --host 0.0.0.0 --port 8000curl -X POST "http://localhost:8000/chat" -H "Content-Type: application/json" -d '{"input": "Tôi muốn mua áo sơ mi trắng size M"}'- Khách chat → AI gợi ý sản phẩm.
- AI thêm sản phẩm vào giỏ.
- AI hỏi thông tin khách → lưu DB.
- Nếu khách cần tư vấn → đặt lịch tự động.
- Swagger UI: http://localhost:8000/docs
- Endpoints:
POST /chat: Xử lý hội thoại.OPTIONS /chat: Preflight CORS.
- Fork repository
- Tạo branch mới (
feature/atshop-ai) - Commit (
git commit -m "Add AI Sales Assistant feature") - Push & tạo Pull Request
MIT License — xem file LICENSE để biết chi tiết.
An Trương
- GitHub: @antruong2004
- Email: antruongg004@gmail.com
🙏 Acknowledgments
- Groq — Nền tảng LLM tốc độ cao.
- LangChain — Framework Agent AI.
- FastAPI — Backend hiệu năng cao.
- AT Shop Vietnam — Đối tác ứng dụng thực tế.
⭐ Nếu project này hữu ích, đừng quên thả 1⭐ trên GitHub nhé!