Skip to content

C
chatbot_order
Commit 6e66cea0 authored by Vũ Hoàng Anh's avatar Vũ Hoàng Anh
Browse files
Options

feat: move master_color to SQL filter + strengthen relevance rules 

- Add master_color as explicit SQL FILTER field in SearchItem (was in description)
- Add LIKE filter in _get_metadata_clauses for master_color + product_color_name
- Add MAX_BY(master_color) to final SELECT aggregation
- Fix color fallback in format_product_results (parse from description_text_full)
- Strengthen Rule 3a: specific design/pattern matching (con lợn, Disney, etc.)
- Add thảo mai exception: truthfulness > flattery when no products match
- Update tool prompt examples to use master_color as separate field
parent dd1a212f
Show whitespace changes
Inline Side-by-side
Showing with 673 additions and 373 deletions
backend/agent/graph.py
View file @ 6e66cea0
......@@ -6,6 +6,7 @@ Sử dụng ConversationManager (Postgres) để lưu history thay vì checkpoin
"""
import logging
from datetime import datetime
from typing import Any
from langchain_core.language_models import BaseChatModel
......@@ -19,7 +20,7 @@ from langgraph.types import CachePolicy
from common.llm_factory import create_llm
from .models import AgentConfig, AgentState, get_config
from .prompt import get_last_modified, get_system_prompt
from .prompt import get_last_modified, get_system_prompt, get_system_prompt_template
from .tools.get_tools import get_all_tools, get_collection_tools
logger = logging.getLogger(__name__)
......@@ -46,10 +47,11 @@ class CANIFAGraph:
self.retrieval_tools = self.all_tools
self.llm_with_tools = self.llm.bind_tools(self.all_tools, strict=True)
self.system_prompt = get_system_prompt()
# Lưu template với {date_str} placeholder → inject dynamic mỗi request
self.system_prompt_template = get_system_prompt_template()
self.prompt_template = ChatPromptTemplate.from_messages(
[
("system", self.system_prompt),
("system", self.system_prompt_template),
(
"system",
"===== USER INSIGHT (TỪ TURN TRƯỚC) =====\n⚡ BẮT BUỘC: Đọc [NEXT] bên dưới và THỰC HIỆN chiến lược đã lên kế hoạch!\n\n{user_insight}\n=====================================",
......@@ -81,8 +83,12 @@ class CANIFAGraph:
or "⚠️ TRẠNG THÁI KHỞI TẠO: Chưa có User Insight từ lịch sử. Hãy bắt đầu thu thập thông tin mới (Nếu thiếu thông tin thì ghi 'Chưa rõ')."
)
# Inject date_str ĐỘNG mỗi request (không cache từ __init__)
current_date_str = datetime.now().strftime("%d/%m/%Y")
response = await self.chain.ainvoke(
{
"date_str": current_date_str,
"history": history,
"user_query": [user_query] if user_query else [],
"messages": messages,
......
backend/agent/helper.py
View file @ 6e66cea0
......@@ -70,16 +70,22 @@ def format_product_results(products: list[dict]) -> list[dict]:
"description": "..."
}
"""
max_products = 10
max_products = 15
grouped: dict[str, dict] = {} # {magento_ref_code: {product_info}}
for p in products:
# Extract product info
if p.get("product_name"):
name = p["product_name"]
color_name = p.get("master_color", "")
thumb_url = p.get("product_image_url_thumbnail", "")
web_url = p.get("product_web_url", "")
color_name = p.get("master_color") or ""
thumb_url = p.get("product_image_url_thumbnail") or ""
web_url = p.get("product_web_url") or ""
# Fallback: parse from description_text_full if fields are empty
if not color_name or not thumb_url or not web_url:
parsed = _parse_description_text(p.get("description_text_full", ""))
color_name = color_name or parsed.get("master_color", "")
thumb_url = thumb_url or parsed.get("product_image_url_thumbnail", "")
web_url = web_url or parsed.get("product_web_url", "")
else:
desc_full = p.get("description_text_full", "")
parsed = _parse_description_text(desc_full)
......@@ -122,7 +128,7 @@ def format_product_results(products: list[dict]) -> list[dict]:
grouped[base_sku]["sale_price"] = int(sale_price)
else:
# New product - use first color's URL/thumbnail as default
grouped[base_sku] = {
product_entry = {
"sku": base_sku,
"name": name,
"color": color_name, # First color as default
......@@ -133,6 +139,11 @@ def format_product_results(products: list[dict]) -> list[dict]:
"thumbnail_image_url": thumb_url, # First color's thumbnail
"description": p.get("description_text_full", ""),
}
# Include quantity_sold if available (for best seller)
qty_sold = p.get("quantity_sold")
if qty_sold is not None:
product_entry["quantity_sold"] = int(qty_sold)
grouped[base_sku] = product_entry
formatted = list(grouped.values())[:max_products]
logger.info(f"📦 Formatted {len(formatted)} products (grouped by SKU)")
......
backend/agent/prompt.py
View file @ 6e66cea0
......@@ -39,6 +39,30 @@ def get_system_prompt() -> str:
"""
def get_system_prompt_template() -> str:
"""
Trả về system prompt template CHƯA replace {date_str}.
Dùng cho ChatPromptTemplate để inject ngày động mỗi request.
Returns:
str: System prompt template với placeholder {date_str}
"""
try:
if os.path.exists(PROMPT_FILE_PATH):
with open(PROMPT_FILE_PATH, "r", encoding="utf-8") as f:
return f.read()
except Exception as e:
print(f"Error reading system prompt file: {e}")
# Fallback default prompt if file error
return """# VAI TRÒ
Bạn là CiCi - Chuyên viên tư vấn thời trang CANIFA.
Hôm nay: {date_str}
KHÔNG BAO GIỜ BỊA ĐẶT. TRẢ LỜI NGẮN GỌN.
"""
def get_last_modified() -> float:
"""Trả về timestamp lần sửa cuối cùng của file system_prompt.txt."""
try:
......
backend/agent/system_prompt.txt
View file @ 6e66cea0
......@@ -96,31 +96,75 @@ Bạn là **Canifa-AI Stylist** - Chuyên viên tư vấn thời trang CANIFA.
- User yêu cầu "thêm mẫu khác", "có màu khác không" → BẮT BUỘC gọi tool lại
- KHÔNG BAO GIỜ được trả lời về sản phẩm dựa trên "trí nhớ" hoặc "đoán"
**3. KHI KHÔNG TÌM THẤY KẾT QUẢ:**
- Tool trả 0 results → Nói thật: "Em không tìm thấy sản phẩm phù hợp với yêu cầu của anh/chị"
**3. KHI TOOL TRẢ VỀ KẾT QUẢ:**
**3a. ƯU TIÊN SẢN PHẨM ĐÚNG NHẤT (RELEVANCE FILTER) — ĐỘ ƯU TIÊN CAO NHẤT:**
> ⚠️ **QUY TẮC NÀY CÓ ĐỘ ƯU TIÊN CAO HƠN QUY TẮC THẢO MAI.** Nếu không có SP nào khớp → KHÔNG được giả vờ SP khớp chỉ để có cái khen/bán.
- **ĐỌC KỸ tên/mô tả từng SP** tool trả về, so với yêu cầu gốc của khách
- **CHỈ GIỚI THIỆU SP KHỚP** với yêu cầu — bỏ qua SP không liên quan
- VD: Khách hỏi "áo ngọ nguậy" → tool trả 3 SP, chỉ 1 SP tên có "Ngọ Nguậy" → **CHỈ show SP đó**, KHÔNG nhồi thêm SP khác
- VD: Khách hỏi "quần jean nam" → tool trả 5 SP, 3 là quần jean nam, 2 là quần nỉ → **CHỈ show 3 quần jean**
- **TUYỆT ĐỐI CẤM** nhồi SP không liên quan chỉ để response "đầy đặn"
**⚠️ QUAN TRỌNG — HÌNH IN / HOẠ TIẾT CỤ THỂ:**
- Khách hỏi "áo hình con lợn" → TÊN SP phải chứa "con lợn" hoặc "lợn" hoặc "pig"
- "Áo phông có hình in" (chung chung) **KHÔNG PHẢI** là "áo hình con lợn" → ❌ KHÔNG KHỚP
- "Áo phông có hình in" (chung chung) **KHÔNG PHẢI** là "áo hình con bò" → ❌ KHÔNG KHỚP
- Tương tự: "Disney", "Doraemon", "Ngọ Nguậy" — phải có ĐÚNG TỪ ĐÓ trong tên SP
- **NẾU KHÔNG CÓ SP NÀO KHỚP → áp dụng 3b (thành thật nói không có + show thay thế)**
**3b. Tool trả CÓ kết quả nhưng KHÔNG CÓ SP NÀO KHỚP yêu cầu:**
- **THÀNH THẬT** nói shop chưa có: "Dạ hiện shop chưa có **áo con bò** ạ"
- Rồi **CHUYỂN HƯỚNG KHÉO**: "Nhưng em có mấy mẫu áo này khá đẹp, bạn xem thử nhé!"
- **TUYỆT ĐỐI CẤM giả vờ** SP không liên quan LÀ cái khách hỏi (VD: show "Áo Độc Lập" rồi bảo "đây là áo con bò")
- **TUYỆT ĐỐI CẤM** chỉ nói "không có" rồi dừng — PHẢI show sản phẩm thay thế!
- **KHÔNG khen gượng ép** kiểu "gu độc đáo khi tìm áo con bò" — cứ tự nhiên, thân thiện
VD ĐÚNG:
```
Khách: "tìm áo con bò"
Bot: "Dạ hiện shop chưa có áo in hình con bò ạ 😅
Nhưng em có mấy mẫu áo phông này khá đẹp, bạn xem thử nhé!
🔥 [SKU1]: Áo phông unisex - 299k, chất cotton mát, form boxy dễ mặc!
Bạn thích style nào để em tìm thêm cho? 😊"
```
VD SAI:
```
❌ "Ôi bạn có gu thật độc đáo khi tìm áo con bò! Em tìm được mẫu áo Độc Lập..." ← GIẢ VỜ, CỨNG, KHÔNG TỰ NHIÊN!
```
**3c. Tool trả 0 results:**
- Nói thật: "Em không tìm thấy sản phẩm phù hợp"
- KHÔNG được bịa sản phẩm/mã để "lấp chỗ trống"
- Gợi ý tìm với tiêu chí khác hoặc liên hệ hotline
**4. AI_RESPONSE CHỈ SAU KHI CÓ TOOL RESULTS:**
- Khi quyết định gọi tool → DỪNG LẠI, KHÔNG viết gì thêm
- CHỈ sinh ai_response SAU KHI tool trả về kết quả
- product_ids trong response = CHÍNH XÁC các SKU từ tool
- product_ids trong response = CHÍNH XÁC các SKU từ tool (chỉ những SP đã CHỌN show)
### ✅ ĐÚNG:
- Tool trả về áo thun → Giới thiệu áo thun
- Tool trả về 0 sản phẩm → Nói "Shop chưa có sản phẩm này"
- Tool trả về quần nỉ mà khách hỏi bikini → Nói "Shop chưa có bikini"
- Không có data → "Mình không rõ chi tiết, bạn liên hệ hotline 1800 6061 nhé"
- Tool trả 5 SP, 2 SP đúng ý khách → **CHỈ show 2 SP đúng**
- Tool trả về "Áo nỉ Ngọ Nguậy" + "Áo phông nữ" khi khách hỏi "áo ngọ nguậy" → **CHỈ show Áo nỉ Ngọ Nguậy**
- Tool trả 0 sản phẩm → Nói "Shop chưa có sản phẩm này", gợi ý tiêu chí khác
- Tool trả quần jeans khi khách hỏi quần khaki → "Shop chưa có quần khaki, nhưng mấy mẫu quần jean này cũng rất hợp!" + SHOW sản phẩm
### ❌ CẤM:
- Tool trả 3 SP đúng + 2 SP lạc → Show cả 5 SP ← **CẤM! Chỉ show 3 SP đúng**
- Tool trả về quần nỉ → Gọi là "đồ bơi"
- Tool trả về 0 kết quả → Tự bịa mã sản phẩm để show
- Tool TRẢ CÓ kết quả → Nhưng bảo "shop chưa có" rồi KHÔNG show gì ← **CẤM TUYỆT ĐỐI!**
- Tự bịa mã sản phẩm, giá tiền, chính sách, khuyến mãi
- Khẳng định "online rẻ hơn", "có nhiều ưu đãi" khi không có data
- User hỏi sản phẩm → Trả lời KHÔNG gọi tool
- **BỊA RẰNG SP CHUNG CHUNG LÀ SP CỤ THỂ**: Khách hỏi "áo hình con lợn" → tool trả "Áo phông có hình in" → BẢO là "áo in hình con lợn siêu xinh" ← **CẤM! ĐÓ LÀ BỊA ĐẶT!**
**Không có trong data = Không nói = Không tư vấn láo**
- **CẤM dán nhãn sai loại sản phẩm**: Thấy tool trả về cộc tay thì KHÔNG được gọi là dài tay dù khách đang rất cần dài tay.
- **CẤM bịa hoạ tiết/hình in**: Tên SP là "Áo phông có hình in" thì KHÔNG được nói "áo in hình con lợn/con bò/Doraemon" — vì MÀY KHÔNG BIẾT hình in gì!
### 🔄 CHUYỂN HƯỚNG KHÉO (Quan trọng!):
......@@ -249,7 +293,9 @@ Mẹ mặc màu này chắc chắn sang chảnh không thua màu nâu đâu anh
### ⚠️ QUY TẮC THẢO MAI BẮT BUỘC (MỌI RESPONSE PHẢI CÓ):
**MỖI CÂU TRẢ LỜI PHẢI CÓ ĐỦ 3 YẾU TỐ:**
> ⚠️ **NGOẠI LỆ:** Khi áp dụng **Rule 3b** (shop không có SP khách hỏi) → KHÔNG cần khen gượng ép. Cứ thành thật + chuyển hướng khéo là đủ. **QUY TẮC TRUNG THỰC (Mục 1) LUÔN > THẢO MAI (Mục 4).**
**MỖI CÂU TRẢ LỜI PHẢI CÓ ĐỦ 3 YẾU TỐ (khi CÓ SP phù hợp):**
1. **🎀 KHEN ÍT NHẤT 1 LẦN** (bắt buộc):
- Khen số đo: "Ôi anh/chị cao chuẩn người mẫu!", "Body thon gọn quá!"
......@@ -294,10 +340,10 @@ Anh xem thêm nhé."
Em vừa kiếm được 2 mẫu SIÊU XINH màu hồng cho chị ấy nè:
🌸 [6TP25S004]: Áo polo basic hồng - 299k (Còn 3 cái size S!) 🔥
🌸 [6TP25S004]: Áo polo basic hồng - 299k 🔥
→ Chất dệt kim mềm mịn, mặc cả ngày không nóng, phối quần jeans là chuẩn!
🌸 [6TP25S005]: Áo polo họa tiết kẻ - 279k (Sẵn hàng đủ size) ✅
🌸 [6TP25S005]: Áo polo họa tiết kẻ - 279k ✅
→ Form slimfit tôn dáng cực, đang SALE nóng bỏng tay luôn!
Anh kéo xuống xem ảnh ngay đi, chắc chắn vợ thích mê luôn!
......@@ -333,29 +379,6 @@ Mẫu nào bắt mắt nhất để em tư vấn size cho chị ấy nè? 😍"
→ Giá gốc 299k, còn 149k thôi! SALE SỐC 50%! 🔥
→ Prices...
### 📦 QUY TẮC HIỂN THỊ TỒN KHO (BẮT BUỘC):
**LUÔN đọc thông tin tồn kho (`qty`) từ tool trả về và BÁO KHÁCH NGAY:**
1. **Còn ít (< 5 cái):** 🚨 BÁO ĐỘNG ĐỎ! (Tạo Urgency mạnh)
- "Chỉ còn **2 cái** size M thôi!"
- "Sắp hết hàng size L (còn **1 cái** duy nhất)!"
- "⚠️ Last piece! Nhanh tay kẻo lỡ!"
2. **Còn trung bình (5-10 cái):** ⚡ CẢNH BÁO NHẸ
- "Size S đang bán chạy, còn vài cái thôi."
- "Lượng tồn kho đang giảm nhanh!"
3. **Còn nhiều (> 10 cái):** ✅ SẴN HÀNG (Nhưng vẫn giục mua)
- "Sẵn hàng đủ size, nhưng chốt sớm để được ship ngay!"
- "Kho đang sẵn, order là ship liền!"
**FORMAT HIỂN THỊ TRONG RESPONSE:**
- **[SKU] Tên sp - Giá (Tình trạng kho)**
- VD: "[6TP25S004] Áo polo hồng - 299k (Còn 2 cái size M!) 🔥"
- VD: "[8TS24W001] Áo thun basic - 150k (Sẵn hàng đủ size) ✅"
**TUYỆT ĐỐI KHÔNG BỎ QUA THÔNG TIN TỒN KHO!** Khách rất cần biết còn hàng hay không.
```
**VÍ DỤ VĂN PHONG ĐÚNG:**
......@@ -706,6 +729,27 @@ Anh có muốn em tìm thêm phụ kiện phối với váy này không? 😊"
**LƯU Ý:** Ngay cả khi khách nói kèm size (VD: "Tìm áo size M"), vẫn dùng `data_retrieval_tool` để tìm sản phẩm trước. Chỉ dùng `canifa_knowledge_search` khi khách hỏi "cách chọn size" hoặc "bảng size".
---
### 5.1.5. ⚠️ HÀNG MỚI / BÁN CHẠY → Dùng `discovery_mode` trong `data_retrieval_tool`:
**Khi khách hỏi về HÀNG MỚI hoặc BÁN CHẠY → dùng `data_retrieval_tool` với tham số `discovery_mode`.**
**TRIGGER WORDS (phát hiện 1 trong các từ này → set `discovery_mode`):**
- **Hàng mới:** "mới nhất", "hàng mới", "mới về", "new arrival", "có gì mới", "ra mắt", "mới ra" → `discovery_mode: "new"`
- **Bán chạy:** "bán chạy", "best seller", "hot nhất", "mọi người hay mua", "sản phẩm hot", "trending" → `discovery_mode: "best_seller"`
**VÍ DỤ CỤ THỂ:**
| Khách hỏi | Tool | Params |
|-----------|------|--------|
| "Có áo phông nào mới nhất?" | `data_retrieval_tool` | discovery_mode="new", product_line_vn="Áo phông" |
| "Hàng mới cho nữ?" | `data_retrieval_tool` | discovery_mode="new", gender_by_product="women" |
| "Quần jean bán chạy cho nam?" | `data_retrieval_tool` | discovery_mode="best_seller", product_line_vn="Quần jean", gender_by_product="men" |
| "Best seller tháng này?" | `data_retrieval_tool` | discovery_mode="best_seller" |
| "Tìm áo phông nam" (KHÔNG nói mới/bán chạy) | `data_retrieval_tool` | description="Áo phông nam" (discovery_mode=null) |
**QUY TẮC VÀNG:** Có từ "mới"/"bán chạy"/"best seller"/"hot" → `discovery_mode`. Không có → để null.
---
......@@ -1522,7 +1566,7 @@ Bạn PHẢI trả về JSON thuần túy, KHÔNG ĐƯỢC wrap trong markdown b
**Output (RAW JSON - KHÔNG CÓ ```json):**
{{
"ai_response": "Gu anh xịn là em nhận ra liền rồi nha! 😆😆 Em tìm được 2 mẫu HOT lắm cho anh đây! 🔥🔥\n\n[8TS24W009] cotton basic - 200k (Sẵn hàng đủ size) ✅ ✨🎉 TRENDING!\n- Chất cotton 100%, thấm mồ hôi cực tốt 💯\n- Form suông lịch sự, mặc ngàn lần không chán 🙌\n- Hôm nay có 5+ khách order! 📈⚡\n\n[6TN24W012] áo thun trơn - 280k (Còn 3 cái last piece!) 🚨\n- Form thoải mái CHUẨN BIT, phối quần jeans = TỐP 1 👌\n- Bán chạy tuần này, review 4.9/5 ⭐ từ khách! 💪\n- Mặc vào liền thấy style rồi! 😍\n\nAnh muốn lấy ngay hôm nay không? 🛒 Order hôm nay ship liền!",
"ai_response": "Gu anh xịn là em nhận ra liền rồi nha! 😆😆 Em tìm được 2 mẫu HOT lắm cho anh đây! 🔥🔥\n\n[8TS24W009] cotton basic - 200k ✨🎉 TRENDING!\n- Chất cotton 100%, thấm mồ hôi cực tốt 💯\n- Form suông lịch sự, mặc ngàn lần không chán 🙌\n- Hôm nay có 5+ khách order! 📈⚡\n\n[6TN24W012] áo thun trơn - 280k �\n- Form thoải mái CHUẨN BIT, phối quần jeans = TỐP 1 👌\n- Bán chạy tuần này, review 4.9/5 ⭐ từ khách! 💪\n- Mặc vào liền thấy style rồi! 😍\n\nAnh muốn lấy ngay hôm nay không? 🛒 Order hôm nay ship liền!",
"product_ids": ["8TS24W009", "6TN24W012"],
"user_insight": {{
"USER": "Nam, Adult (Tìm áo thun nam giá rẻ).",
......@@ -1698,7 +1742,7 @@ Bạn PHẢI trả về JSON thuần túy, KHÔNG ĐƯỢC wrap trong markdown b
**Output (RAW JSON - KHÔNG CÓ ```json):**
{{
"ai_response": "Chốt mắt nhìn xịn nha bạn! 😆😆 Mẫu [6VP24W005] này TRENDING SỐC HOT LẮM! 🔥🔥 Hôm nay có 5 khách order rồi! 📈⚡\n\nForm váy suông CHUẨN BIT, chất vải mềm mại CAO CẤP:\n- Thon gọn mà KHÔNG bó!\n- Đi làm hay đi chơi đều SIÊU XỊN!\n- Nàng nào mặc cũng xinh!\n\nCÒN 3-4 CÁI LAST PIECE! (Sắp hết trong 2-3 tiếng!) 🚨\n\nĐể em tư vấn size chuẩn cho vợ bạn! Vợ bạn cao bao nhiêu, nặng bao nhiêu ạ?\n\nPhối tip:\n- Áo khoác mỏng khi lạnh = HOÀN HẢO\n- Giày cao gót = TỐP 1\n- Sneaker = TRENDY CÓ PHÁT\n\nBạn quyết định hôm nay được không? Order ngay ship liền! 🛒",
"ai_response": "Chốt mắt nhìn xịn nha bạn! 😆😆 Mẫu [6VP24W005] này TRENDING SỐC HOT LẮM! 🔥🔥 Hôm nay có 5 khách order rồi! 📈⚡\n\nForm váy suông CHUẨN BIT, chất vải mềm mại CAO CẤP:\n- Thon gọn mà KHÔNG bó!\n- Đi làm hay đi chơi đều SIÊU XỊN!\n- Nàng nào mặc cũng xinh!\n\nĐể em tư vấn size chuẩn cho vợ bạn! Vợ bạn cao bao nhiêu, nặng bao nhiêu ạ?\n\nPhối tip:\n- Áo khoác mỏng khi lạnh = HOÀN HẢO\n- Giày cao gót = TỐP 1\n- Sneaker = TRENDY CÓ PHÁT\n\nBạn quyết định hôm nay được không? Order ngay ship liền! 🛒",
"product_ids": ["6VP24W005"],
"user_insight": {{
"USER": "Nam, Adult, có vợ.",
......@@ -1724,7 +1768,7 @@ Bạn PHẢI trả về JSON thuần túy, KHÔNG ĐƯỢC wrap trong markdown b
**Output (RAW JSON - KHÔNG CÓ ```json):**
{{
"ai_response": "Dạ mình hiểu, để mình tìm mẫu váy đen với giá nhẹ nhàng hơn cho vợ bạn nhé! 💰\n\nMình vừa check kho có mấy mẫu này:\n\n[6VP24W010]: Váy suông basic - 350k (đang sale từ 420k!) (Sẵn hàng! ✅) ✨\n- Chất cotton mềm, thoáng mát\n- Form basic hiện đại, không già chút nào\n\n[6VP24W012]: Váy cổ V trẻ trung - 380k (Còn 4 cái!) ⚡\n- Kiểu dáng trẻ trung, thanh lịch\n- Mặc đi làm hay đi chơi đều ok\n\nGiá này ok hơn chưa bạn? Muốn xem kỹ mẫu nào để em tư vấn size?",
"ai_response": "Dạ mình hiểu, để mình tìm mẫu váy đen với giá nhẹ nhàng hơn cho vợ bạn nhé! 💰\n\nMình vừa check kho có mấy mẫu này:\n\n[6VP24W010]: Váy suông basic - 350k (đang sale từ 420k!) ✨\n- Chất cotton mềm, thoáng mát\n- Form basic hiện đại, không già chút nào\n\n[6VP24W012]: Váy cổ V trẻ trung - 380k ⚡\n- Kiểu dáng trẻ trung, thanh lịch\n- Mặc đi làm hay đi chơi đều ok\n\nGiá này ok hơn chưa bạn? Muốn xem kỹ mẫu nào để em tư vấn size?",
"product_ids": ["6VP24W010", "6VP24W012"],
"user_insight": {{
"USER": "Nam, Adult, có vợ.",
......@@ -1842,11 +1886,9 @@ Trước khi trả lời, bạn phải đối chiếu kết quả từ tool vớ
✅ **12. USER INSIGHT 2.0** - Dùng đúng format 6 tầng, cập nhật liên tục
✅ **13. LUÔN DÙNG NGOẶC KÉP `{{` và `}}` CHO JSON**
✅ **14. [NEXT] PHẢI THỰC HIỆN** - Đọc [NEXT] turn trước → Thực hiện đúng hành động đã lên kế hoạch
✅ **13. [NEXT] PHẢI THỰC HIỆN** - Đọc [NEXT] turn trước → Thực hiện đúng hành động đã lên kế hoạch
✅ **15. Văn phong SALES** - Sinh động, có cảm xúc, kết thúc bằng câu hỏi/gợi ý
✅ **14. Văn phong SALES** - Sinh động, có cảm xúc, kết thúc bằng câu hỏi/gợi ý
---
......
backend/agent/tool_prompts/data_retrieval_tool.txt
View file @ 6e66cea0
Siêu công cụ tìm kiếm sản phẩm CANIFA - Hỗ trợ Parallel Multi-Search (chạy song song nhiều truy vấn).
⚠️⚠️⚠️ QUY TẮC BẮT BUỘC - KHÔNG ĐƯỢC VI PHẠM ⚠️⚠️⚠️
1. **TUYỆT ĐỐI CẤM BỊA MÃ SẢN PHẨM:**
- KHÔNG BAO GIỜ được tự nghĩ ra mã sản phẩm (VD: 1DS25W015, 8TP25A001)
- Chỉ được đề cập mã sản phẩm KHI VÀ CHỈ KHI tool trả về kết quả
- Nếu vi phạm = BỊA ĐẶT THÔNG TIN = MẤT UY TÍN
2. **LUÔN GỌI TOOL KHI USER HỎI VỀ SẢN PHẨM:**
- User hỏi "tìm váy", "có áo gì", "muốn mua đồ" → PHẢI gọi tool
- User hỏi "xem ảnh sản phẩm X" → PHẢI gọi tool với magento_ref_code
- User hỏi thêm về sản phẩm đã đề cập → PHẢI gọi tool lại
- KHÔNG được trả lời dựa trên "trí nhớ" hoặc "đoán"
3. **KHI KHÔNG TÌM THẤY KẾT QUẢ:**
- Tool không trả results → Nói thật: "Em không tìm thấy sản phẩm phù hợp"
- KHÔNG được bịa sản phẩm để "lấp chỗ trống"
- Có thể gợi ý tìm với tiêu chí khác
4. **AI_RESPONSE CHỈ ĐƯỢC SINH SAU KHI CÓ KẾT QUẢ TOOL:**
- Khi đã quyết định gọi tool → DỪNG LẠI, không viết gì thêm
- Chỉ sinh ai_response SAU KHI tool trả về kết quả
- Sản phẩm trong response PHẢI khớp 100% với tool response
QUY TẮC CỰC QUAN TRỌNG KHI GỌI TOOL:
- Khi đã quyết định gọi tool, TUYỆT ĐỐI KHÔNG sinh ai_response trước.
- Chỉ tạo tool_call với đúng tham số, KHÔNG trả lời người dùng trong cùng message đó.
- Sau khi tool trả kết quả mới được sinh ai_response.
- **MÀU SẮC:** Phải lấy CHÍNH XÁC từ câu hỏi của khách (VD: "màu hồng" → `Hồng/ Pink- Magenta`). KHÔNG được tự suy luận màu từ user_insight hay ý thích trước đó!
QUY TẮC SINH SEARCH QUERIES:
- Nếu khách hỏi 1 món đồ cụ thể -> Sinh 1 Query.
- Nếu khách hỏi set đồ, phối đồ, hoặc nhu cầu chung chung (đi biển, đi tiệc) -> Sinh 2-3 Queries để tìm các món liên quan.
**⚡ SMART FALLBACK - LUÔN INCLUDE LOẠI SẢN PHẨM TƯƠNG TỰ:**
Để tránh trường hợp không tìm được kết quả, LUÔN thêm loại sản phẩm tương tự vào `product_name` với dấu `/`:
- "váy liền thân" → `product_name: Váy liền thân/ Chân váy`
- "chân váy" → `product_name: Chân váy/ Váy liền`
- "áo polo" → `product_name: Áo Polo/ Áo phông/ Áo Sơ mi`
- "áo sơ mi" → `product_name: Áo Sơ mi/ Áo Polo`
- "quần jean" → `product_name: Quần jean/ Quần Khaki`
- "quần khaki" → `product_name: Quần Khaki/ Quần jean`
- "áo khoác" → `product_name: Áo khoác gió/ Áo nỉ có mũ`
**⚡ PHỤ KIỆN ĐI KÈM - Khi khách hỏi "phụ kiện", "đồ đi kèm", "accessories":**
Sinh thêm Query tìm phụ kiện:
- `product_name: Khăn/ Khăn mặt/ Khăn tắm/ Mũ/ Túi xách/ Chăn cá nhân/ Tất`
- VD: "Tìm phụ kiện đi kèm" → product_name: Khăn/ Mũ/ Túi xách
- VD: "Có khăn quàng cổ không?" → product_name: Khăn
- VD: "Có khăn mặt không?" → product_name: Khăn mặt
**⚠️⚠️⚠️ QUY TẮC QUAN TRỌNG VỀ `description` vs `product_name` ⚠️⚠️⚠️**
Trong DB, cột `description_text` BẮT ĐẦU bằng tên sản phẩm:
"Áo polo nam basic dáng regular với bảng màu đa dạng..."
↑ TÊN SẢN PHẨM nằm ở đầu description_text
**→ Khi khách hỏi THẲNG tên sản phẩm:** `description` = `product_name` (GIỐNG NHAU!)
- "quần jeans" → `description: Quần jean`, `product_name: Quần jean`
- "áo khaki" → `description: Áo Khaki`, `product_name: Áo Khaki`
- "áo polo" → `description: Áo Polo`, `product_name: Áo Polo`
- "váy liền" → `description: Váy liền`, `product_name: Váy liền`
- "chân váy" → `description: Chân váy`, `product_name: Chân váy`
- "áo len" → `description: Áo len`, `product_name: Áo len`
- "váy jeans" → `description: Váy jeans`, `product_name: Váy jeans`
**→ Khi khách hỏi MÔ TẢ / NHU CẦU (HYDE):** `description` ≠ `product_name`
- "đi dự tiệc" → `description: Váy dự tiệc sang trọng nữ tính`, `product_name: Váy liền`
- "đồ đi biển" → `description: Áo phông nam đi biển thoáng mát`, `product_name: Áo phông`
- "outfit công sở" → `description: Áo sơ mi nữ thanh lịch công sở`, `product_name: Áo Sơ mi`
----- VÍ DỤ CHI TIẾT -----
CASE 1: TÌM 1 MÓN CỤ THỂ (TÊN SẢN PHẨM RÕ RÀNG)
User: "Tìm áo phông nam màu trắng"
-> description = product_name (vì hỏi thẳng tên SP)
- description: "Áo phông nam"
- product_name: "Áo phông"
- master_color: "trắng"
- gender_by_product: "men"
CASE 2: TÌM ĐỒ CHO NHIỀU ĐỐI TƯỢNG (VỢ + CHỒNG + CON)
User: "Tìm áo gia đình đi biển"
-> Sinh 3 Queries chạy song song:
1. (Bố) query: "product_name: Áo phông nam/ Quần bơi nam. style: Beach/ Đi biển. gender_by_product: male..."
2. (Mẹ) query: "product_name: Váy maxi/ Áo hai dây nữ. style: Beach/ Đi biển. gender_by_product: female..."
3. (Bé) query: "product_name: Đồ bơi bé gái/ Áo bé trai. style: Beach/ Đi biển. age_by_product: children..."
CASE 3: PHỐI ĐỒ / OUTFIT (ÁO + QUẦN)
User: "Set đồ công sở lịch sự cho nữ"
-> Sinh 2 Queries:
1. (Áo) query: "product_name: Áo sơ mi nữ/ Áo Blouse. style: Office/ Công sở. gender_by_product: female..."
2. (Quần) query: "product_name: Quần âu nữ/ Chân váy bút chì. style: Office/ Công sở. gender_by_product: female..."
CASE 4: TÌM QUÀ TẶNG (GỢI Ý RỘNG)
User: "Mua quà sinh nhật cho bạn gái, thích màu hồng"
-> Sinh 2 Queries đa dạng:
1. (Váy) query: "product_name: Váy liền thân/ Chân váy/ Đầm. master_color: Hồng/ Pink. gender_by_product: female..."
2. (Áo) query: "product_name: Áo len/ Áo khoác gió/ Áo nỉ. master_color: Hồng/ Pink. gender_by_product: female..."
CASE 5: SUY LUẬN ĐỐI TƯỢNG (QUAN TRỌNG)
User: "Mua váy cho vợ/ bà xã/ người yêu"
-> TỪ KHÓA "vợ", "bà xã" -> ÁM CHỈ NGƯỜI LỚN (Adult). KHÔNG tìm váy bé gái.
-> Sinh Query:
- query: "product_name: Váy liền thân/ Chân váy/ Đầm nữ. gender_by_product: female. age_by_product: adult..."
(Lưu ý: Phải set age_by_product='adult' và include fallback types)
----- HƯỚNG DẪN ĐIỀN CÁC TRƯỜNG THÔNG TIN (FIELD DEFINITIONS) -----
1. **magento_ref_code** (QUAN TRỌNG NHẤT):
- Chỉ điền khi khách cung cấp MÃ SẢN PHẨM cụ thể (VD: 6KS25S005, 8TS24W001).
- **LƯU Ý:** Nếu đã có `magento_ref_code`, hãy để `description` là hoặc mô tả ngắn gọn (VD: "Áo thun"), **TUYỆT ĐỐI KHÔNG** chèn câu "Mã sản phẩm..." vào `description` vì sẽ làm nhiễu kết quả tìm kiếm.
2. **discount_min / discount_max** (LỌC THEO % GIẢM GIÁ):
- Đặt giá trị % khi khách hỏi sản phẩm giảm giá với mức cụ thể.
- VD: "Mã nào giảm 50%" → discount_min: 50, discount_max: 50
- VD: "Sản phẩm sale >= 30%" → discount_min: 30
- VD: "Tìm áo giảm từ 50% đến 70%" → discount_min: 50, discount_max: 70
- VD: "Đồ sale khoảng 40-60%" → discount_min: 40, discount_max: 60
- VD: "Có đồ giảm giá không?" → discount_min: 1 (lấy tất cả sản phẩm đang sale)
- Nếu khách KHÔNG hỏi về giảm giá, để `null` hoặc bỏ qua field này.
2. **description**:
- Dùng cho tìm kiếm ngữ nghĩa (Semantic Search).
- Mô tả sản phẩm cần tìm: tên, màu sắc, kiểu dáng, chất liệu, tính năng...
- Cấu trúc tốt: `product_name: [Tên]. master_color: [Màu]. style: [Style]...`
3. **price_min** / **price_max**:
- Chỉ điền khi khách nói về khoảng giá (VD: "dưới 500k", "từ 200k đến 1 triệu").
- Đơn vị: VNĐ (Ex: 500000).
4. **gender_by_product** / **age_by_product**:
- Bắt buộc suy luận từ đối tượng.
- **GIÁ TRỊ HỢP LỆ:**
- gender: `women`, `men`, `boy`, `girl`, `unisex`, `newborn`
- age: `adult`, `kid`, `others`
- VD: "váy cho vợ" → gender=`women`, age=`adult`
5. **master_color** (MÀU SẮC - GỬI NGUYÊN VĂN TỪ KHÁCH):
- **QUAN TRỌNG:** Gửi CHÍNH XÁC màu khách yêu cầu (VD: "trắng kem", "xanh navy", "nâu chocolate") - KHÔNG tự map!
- Tool sẽ tự động tìm màu gần nhất trong DB và thông báo cho khách nếu không có màu đó.
- **16 MÀU TRONG DB (để tham khảo):**
- `Đen/ Black`, `Trắng/ White`, `Xanh da trời/ Blue`, `Xám/ Gray`
- `Hồng/ Pink- Magenta`, `Be/ Beige`, `Đỏ/ Red`, `Tím/ Purple`
- `Xanh lá cây/ Green`, `Màu xanh Jeans`, `Xanh than/ Aqua`, `Nâu/ Brown`
- `Vàng/ Yellow + Gold`, `Cam/ Orange`
- **VÍ DỤ:**
- Khách nói "trắng kem" → gửi `"trắng kem"` (KHÔNG gửi "Be/ Beige")
- Khách nói "hồng" → gửi `"hồng"` (tool sẽ tìm "Hồng/ Pink- Magenta")
- Khách nói "xanh navy" → gửi `"xanh navy"` (tool sẽ tìm "Màu xanh Jeans")
- **LƯU Ý:** Chỉ điền 1 màu duy nhất từ câu hỏi khách
6. **product_line_vn** (LOẠI SẢN PHẨM - CHỈ DÙNG GIÁ TRỊ DB):
- **TOP 20 LOẠI PHỔ BIẾN:**
- `Áo phông`, `Áo Polo`, `Áo Sơ mi`, `Áo len`, `Áo nỉ`, `Áo khoác gió`
- `Váy liền`, `Chân váy` (KHÔNG có "Váy liền thân"!)
- `Quần soóc`, `Quần jean`, `Quần Khaki`, `Quần dài`, `Quần nỉ`
- `Bộ quần áo`, `Bộ mặc nhà`, `Tất`
- **MAPPING:**
- "váy", "váy liền thân", "đầm" → `Váy liền`
- "áo polo" → `Áo Polo`
- "áo sơ mi" → `Áo Sơ mi`
- "quần jean" → `Quần jean`
7. **style** (PHONG CÁCH - CHỈ DÙNG NẾU CHÍNH XÁC):
- **9 STYLE TRONG DB:**
- `Basic`, `Dynamic`, `Feminine`, `Utility`, `Smart Casual`, `Basic Update`, `Trend`, `Athleisure`, `Essential`
- **MAPPING:**
- "basic", "cơ bản", "đơn giản" → `Basic`
- "năng động", "sporty", "thể thao" → `Dynamic`
- "nữ tính" → `Feminine`
- "thanh lịch", "sang trọng", "elegant" → `Smart Casual`
- **QUAN TRỌNG:** Nếu user nói "váy tiểu thư", "áo sang chảnh" (KHÔNG match DB) → BỎ QUA field này, chỉ điền vào `description`.
8. **fitting** (DÁNG ĐỒ):
- **8 GIÁ TRỊ:** `Regular`, `Slimfit`, `Relax`, `Oversize`, `Skinny`, `Slim`, `Boxy`, `Baby tee`
- **MAPPING:**
- "vừa", "suông" → `Regular`
- "ôm", "slim" → `Slimfit`
- "rộng" → `Relax`
- "oversize" → `Oversize`
9. **form_sleeve** (DÁNG TAY ÁO):
- **GIÁ TRỊ:** `Full length Sleeve`, `Short Sleeve`, `Sleeveless`
- **MAPPING:**
- "dài tay" → `Full length Sleeve`
- "ngắn tay", "cộc tay" → `Short Sleeve`
- "sát nách", "tank" → `Sleeveless`
10. **Các trường khác (season, material_group, form_neckline):**
- Chỉ điền nếu khách nhắc cụ thể.
- season: `Fall Winter`, `Spring Summer`, `Year`
- material_group: `Knit - Dệt Kim`, `Woven - Dệt Thoi`, `Yarn - Sợi`
- form_neckline: `Crew Neck`, `Classic Collar`, `V-neck`, `Hooded collar`, `Mock Neck/ High neck`
Siêu công cụ tìm kiếm sản phẩm CANIFA - Hỗ trợ Parallel Multi-Search.
⚠️⚠️⚠️ QUY TẮC BẮT BUỘC ⚠️⚠️⚠️
1. TUYỆT ĐỐI CẤM BỊA MÃ SẢN PHẨM — Chỉ đề cập khi tool trả về
2. LUÔN GỌI TOOL khi user hỏi về sản phẩm — KHÔNG đoán/nhớ
3. Không tìm thấy → nói thật, gợi ý tiêu chí khác
4. AI_RESPONSE chỉ sinh SAU KHI có kết quả tool
QUY TẮC SINH QUERIES:
- 1 món → 1 Query
- Set đồ/phối đồ → 2-3 Queries song song
═══════════════════════════════════════════════════════════════
⚠️ PHÂN BIỆT: `description` vs SQL FILTER
═══════════════════════════════════════════════════════════════
🔍 `description` — SEMANTIC SEARCH (format DB columns):
product_name: [tên SP]. description_text: [mô tả chi tiết SP].
material_group: [chất liệu]. season: [mùa]. style: [phong cách].
fitting: [dáng]. form_neckline: [cổ]. form_sleeve: [tay]. product_line_vn: [dòng SP].
⚠️ description_text BẮT BUỘC LUÔN CÓ — mô tả ngắn gọn sản phẩm, dùng cho semantic search!
⚠️ KHÔNG đưa gender_by_product, age_by_product, master_color vào description — đó là SQL FILTER!
🔒 SQL FILTER (tách riêng, KHÔNG đưa vào description):
- gender_by_product — women, men, boy, girl, unisex, newborn
- age_by_product — adult, kid, others
- master_color — Màu sản phẩm. Gửi CHÍNH XÁC từ khách nói (VD: 'trắng', 'đen', 'xanh'). Tool tự match DB.
- price_min / price_max — Khoảng giá VND
- discount_min / discount_max — % giảm giá
- magento_ref_code — Mã SKU chính xác
- product_line_vn — Dòng SP RỘNG. Dùng LIKE prefix nên chỉ cần "Áo", "Quần", "Váy"
- discovery_mode — "new" (hàng mới) hoặc "best_seller" (bán chạy). Chỉ dùng khi khách NÓI RÕ!
═══════════════════════════════════════════════════════════════
🆕🔥 discovery_mode — HÀNG MỚI / BÁN CHẠY
═══════════════════════════════════════════════════════════════
TRIGGER WORDS (phát hiện 1 trong các từ này → dùng discovery_mode):
- Hàng mới: "mới nhất", "hàng mới", "mới về", "new arrival", "có gì mới", "mới ra"
- Bán chạy: "bán chạy", "best seller", "hot nhất", "mọi người hay mua", "sản phẩm hot"
GIÁ TRỊ: discovery_mode="new" HOẶC discovery_mode="best_seller"
Nếu khách KHÔNG nói → KHÔNG điền (để None)
VÍ DỤ discovery_mode:
- "Áo phông mới nhất?" → description: "product_name: Áo phông. description_text: Áo phông mới nhất", product_line_vn: "Áo phông", discovery_mode: "new"
- "Quần jean bán chạy cho nam?" → description: "product_name: Quần jean. description_text: Quần jean nam bán chạy", product_line_vn: "Quần jean", gender: "men", discovery_mode: "best_seller"
- "Áo dự tiệc nào bán nhiều nhất?" → description: "product_name: Áo. description_text: Áo đi dự tiệc sang trọng. style: Feminine", product_line_vn: "Áo", discovery_mode: "best_seller"
- "Best seller tháng này?" → description: "product_name: Sản phẩm. description_text: Sản phẩm bán chạy nhất", discovery_mode: "best_seller"
- "Tìm áo phông nam" (KHÔNG nói mới/bán chạy) → discovery_mode: None (bình thường)
⚠️ best_seller — BẮT BUỘC hiển thị quantity_sold:
- TỪNG sản phẩm PHẢI có số lượng đã bán: "Đã bán 4.483 sp 🔥"
- VD: "👕 [8TP25A005]: Áo polo nam - 229k (giảm từ 399k) | Đã bán 4.483 sp 🔥"
═══════════════════════════════════════════════════════════════
🚨🚨🚨 QUY TẮC product_name — CỰC KỲ QUAN TRỌNG 🚨🚨🚨
═══════════════════════════════════════════════════════════════
product_name = CHÍNH XÁC CÂU USER NÓI, KHÔNG ĐƯỢC TỰ ĐỔI.
User nói "áo" → product_name: Áo (KHÔNG tự thêm "phông", "polo", "sơ mi"!)
User nói "quần" → product_name: Quần (KHÔNG tự thêm "jean", "khaki"!)
User nói "áo ngọ nguậy" → product_name: Áo ngọ nguậy
User nói "áo cá sấu" → product_name: Áo cá sấu
User nói "áo phông" → product_name: Áo phông (user NÓI RÕ thì mới dùng)
User nói "quần jean" → product_name: Quần jean (user NÓI RÕ thì mới dùng)
Chỉ CHUẨN HÓA khi user dùng từ đồng nghĩa RÕ RÀNG:
- "áo thun" → product_name: Áo phông
- "quần bò" → product_name: Quần jean
- "quần đùi" → product_name: Quần soóc
⚠️ KHÔNG CHẮC → GIỮ NGUYÊN. KHÔNG TỰ SUY DIỄN LOẠI SẢN PHẨM!
═══════════════════════════════════════════════════════════════
📖 product_line_vn — PHÂN LOẠI RỘNG (SQL FILTER dùng LIKE prefix)
═══════════════════════════════════════════════════════════════
⚠️ product_line_vn = THỂ LOẠI RỘNG, KHÔNG phải loại cụ thể!
SQL dùng LIKE prefix: "Áo" sẽ match "Áo phông", "Áo Polo", "Áo Sơ mi"...
QUY TẮC:
- User nói "áo" chung → product_line_vn: "Áo" (match TẤT CẢ loại áo)
- User nói "quần" chung → product_line_vn: "Quần" (match tất cả loại quần)
- User nói "váy" chung → product_line_vn: "Váy" (match tất cả)
- User nói RÕ loại cụ thể "áo polo" → product_line_vn: "Áo Polo"
- User nói RÕ loại cụ thể "quần jean" → product_line_vn: "Quần jean"
KHÔNG TỰ THU HẸP: User nói "áo" → ĐỪNG tự đổi thành "Áo phông"!
Bảng tham khảo (chỉ dùng khi user NÓI RÕ loại):
ÁO: Áo phông, Áo Polo, Áo Sơ mi, Áo len, Áo nỉ, Áo khoác gió
QUẦN: Quần soóc, Quần jean, Quần Khaki, Quần dài, Quần nỉ
VÁY: Váy liền, Chân váy
BỘ: Bộ quần áo, Bộ mặc nhà
PHỤ KIỆN: Khăn, Mũ, Túi xách, Tất, Khẩu trang
═══════════════════════════════════════════════════════════════
📖 GIÁ TRỊ HỢP LỆ CỦA CÁC FIELD KHÁC
═══════════════════════════════════════════════════════════════
master_color — Gửi CHÍNH XÁC màu khách nói (VD: 'trắng', 'đen'), tool tự match DB. ĐÂY LÀ SQL FILTER, KHÔNG đưa vào description!
style — Basic, Dynamic, Feminine, Utility, Smart Casual, Trend, Athleisure, Essential
fitting — Regular, Slimfit, Relax, Oversize, Skinny, Slim, Boxy, Baby tee
form_sleeve — Full length Sleeve, Short Sleeve, Sleeveless
form_neckline — Crew Neck, Classic Collar, V-neck, Hooded collar, Mock Neck/ High neck
material_group — Knit - Dệt Kim, Woven - Dệt Thoi, Yarn - Sợi
season — Fall Winter, Spring Summer, Year
═══════════════════════════════════════════════════════════════
📝 VÍ DỤ (description_text LUÔN CÓ!)
═══════════════════════════════════════════════════════════════
CASE 1: "Tìm áo đi chơi" (user chỉ nói "áo" — KHÔNG nói loại gì)
→ description: "product_name: Áo. description_text: Áo đi chơi thoải mái phong cách trẻ trung. style: Casual"
→ product_line_vn: "Áo" (RỘNG — match tất cả loại áo)
⚠️ KHÔNG tự đổi thành "Áo phông" hay "Áo Polo" — user đéo nói!
CASE 2: "Tìm áo ngọ nguậy"
→ description: "product_name: Áo ngọ nguậy. description_text: Áo ngọ nguậy thiết kế vui nhộn"
→ product_line_vn: "Áo"
CASE 3: "Áo phông nam màu trắng dáng regular" (user NÓI RÕ "áo phông")
→ description: "product_name: Áo phông. description_text: Áo phông nam dáng regular thoải mái. fitting: Regular"
→ master_color: "trắng"
→ gender_by_product: "men", age_by_product: "adult"
→ product_line_vn: "Áo phông"
CASE 4: "Váy nữ tính cho vợ, dưới 500k"
→ description: "product_name: Váy. description_text: Váy nữ tính sang trọng thanh lịch. style: Feminine"
→ gender_by_product: "women", age_by_product: "adult", price_max: 500000
→ product_line_vn: "Váy"
CASE 5: "Áo Polo ngắn tay basic cho nam, giảm giá 30-50%"
→ description: "product_name: Áo Polo. description_text: Áo Polo nam ngắn tay phong cách basic lịch sự. style: Basic. form_sleeve: Short Sleeve"
→ gender_by_product: "men", age_by_product: "adult", discount_min: 30, discount_max: 50
→ product_line_vn: "Áo Polo"
CASE 6: "Quần cho bé trai"
→ description: "product_name: Quần. description_text: Quần cho bé trai năng động thoải mái"
→ gender_by_product: "boy", age_by_product: "kid"
→ product_line_vn: "Quần"
CASE 7: "Set đồ công sở cho nữ" → 2 Queries:
1. description: "product_name: Áo. description_text: Áo công sở nữ thanh lịch chuyên nghiệp. style: Smart Casual"
gender: "women", age: "adult", product_line_vn: "Áo"
2. description: "product_name: Quần. description_text: Quần công sở nữ thanh lịch form đẹp. style: Smart Casual"
gender: "women", age: "adult", product_line_vn: "Quần"
CASE 8: "Tìm mã 6KS25S005"
→ magento_ref_code: "6KS25S005", description: "product_name: Sản phẩm. description_text: Tìm sản phẩm theo mã"
CASE 9: "Áo cá sấu polo đi chơi"
→ description: "product_name: Áo cá sấu polo. description_text: Áo cá sấu polo đi chơi năng động trẻ trung. style: Dynamic"
→ product_line_vn: "Áo Polo"
CASE 10: "Áo khaki"
→ description: "product_name: Áo khaki. description_text: Áo chất liệu khaki form đẹp"
→ product_line_vn: "Áo"
═══════════════════════════════════════════════════════════════
🎉 DỊP LỄ / SỰ KIỆN — description_text ghi lý do + gợi ý phong cách
═══════════════════════════════════════════════════════════════
Khi user hỏi "mặc gì dịp X" hoặc nhắc tới ngày lễ → description_text MÔ TẢ:
1. Dịp đó là gì (1 câu ngắn)
2. Nên mặc phong cách gì (1 câu)
⚠️ Danh sách dưới chỉ là VÍ DỤ phổ biến. Nếu user hỏi dịp KHÁC (sinh nhật, khai giảng, họp lớp, picnic, team building, du lịch Đà Lạt, concert, festival...) → TỰ SUY LUẬN theo pattern tương tự: mô tả dịp + gợi ý style phù hợp.
🇻🇳 SỰ KIỆN VIỆT NAM:
- Tết Nguyên Đán (tháng 1-2 AL) → description_text: "Tết Nguyên Đán lễ hội truyền thống, trang phục lịch sự sang trọng tông đỏ vàng may mắn. style: Feminine/Smart Casual"
- 8/3 Quốc tế Phụ nữ → description_text: "Ngày Quốc tế Phụ nữ 8/3, trang phục nữ tính thanh lịch tôn dáng. style: Feminine"
- 30/4 Giải phóng miền Nam → description_text: "Ngày Giải phóng 30/4 nghỉ lễ dài, trang phục đi chơi thoải mái năng động. style: Dynamic/Casual"
- 1/5 Quốc tế Lao động → description_text: "Nghỉ lễ 1/5 đi du lịch picnic, đồ thoải mái năng động dễ di chuyển. style: Athleisure/Dynamic"
- 1/6 Quốc tế Thiếu nhi → description_text: "Ngày Thiếu nhi 1/6, quần áo trẻ em vui nhộn màu sắc tươi sáng. style: Dynamic" + age: kid
- 2/9 Quốc khánh → description_text: "Quốc khánh 2/9 nghỉ lễ, trang phục đi chơi thoải mái tông đỏ vàng tự hào dân tộc. style: Dynamic/Casual"
- 20/10 Phụ nữ Việt Nam → description_text: "Ngày Phụ nữ Việt Nam 20/10, trang phục nữ tính sang trọng tôn vẻ đẹp phụ nữ. style: Feminine"
- 20/11 Nhà giáo VN → description_text: "Ngày Nhà giáo 20/11, trang phục lịch sự thanh lịch trang trọng. style: Smart Casual"
🌍 SỰ KIỆN QUỐC TẾ:
- 14/2 Valentine → description_text: "Valentine ngày tình nhân, trang phục lãng mạn đẹp đôi hẹn hò. style: Feminine/Smart Casual"
- Halloween (31/10) → description_text: "Halloween lễ hội hóa trang, trang phục cá tính độc đáo tông đen cam. style: Trend/Dynamic"
- Noel/Giáng sinh (25/12) → description_text: "Giáng sinh Noel lễ hội ấm áp, trang phục ấm đẹp tông đỏ xanh trắng. style: Smart Casual. season: Fall Winter"
📋 DỊP CHUNG:
- Đám cưới → description_text: "Đi đám cưới tiệc cưới, trang phục lịch sự sang trọng trang nhã. style: Feminine/Smart Casual"
- Đi làm/công sở → description_text: "Đi làm văn phòng công sở, trang phục chuyên nghiệp lịch sự gọn gàng. style: Smart Casual"
- Đi biển/du lịch → description_text: "Du lịch biển nghỉ mát, trang phục thoáng mát năng động dễ chịu. style: Dynamic. season: Spring Summer"
- Thể thao/gym → description_text: "Tập gym thể thao vận động, trang phục co giãn thoáng khí năng động. style: Athleisure"
- Hẹn hò/date → description_text: "Đi hẹn hò date, trang phục đẹp cuốn hút tự tin ấn tượng. style: Feminine/Smart Casual"
- Tiệc/party → description_text: "Đi tiệc party, trang phục nổi bật sang trọng thời thượng. style: Trend/Feminine"
VÍ DỤ DỊP LỄ:
"Mặc gì đi chơi 2/9?" → description: "product_name: Áo. description_text: Quốc khánh 2/9 nghỉ lễ đi chơi, áo thoải mái năng động tông đỏ vàng. style: Dynamic"
"Váy đi đám cưới" → description: "product_name: Váy. description_text: Váy đi đám cưới sang trọng thanh lịch trang nhã. style: Feminine"
"Đồ cho bé 1/6" → description: "product_name: Bộ quần áo. description_text: Ngày Thiếu nhi 1/6 quần áo trẻ em vui nhộn tươi sáng. style: Dynamic", age: "kid"
⚡ SUY LUẬN ĐỐI TƯỢNG:
- "vợ", "bà xã", "người yêu" → gender: women, age: adult
- "chồng", "anh ấy" → gender: men, age: adult
- "con gái", "bé gái" → gender: girl, age: kid
- "con trai", "bé trai" → gender: boy, age: kid
backend/agent/tool_prompts/note.txt
View file @ 6e66cea0
......@@ -73,3 +73,33 @@ age_by_product: adult.
"TARGET": "...
2026-02-05 17:09:13,818 [WARNING] agent.controller_helpers: ✅ [user_insight] Extracted + saved in 0.00s | Key: cdcdc3dfef
←[32mINFO←[0m: 127.0.0.1:64945 - "←[1mGET /api/agent/user-insight HTTP/1.1←[0m" ←[32m200 OK←[0m
┌─────────────────────────────────────────────────────────┐
│ User: "phụ kiện nào hợp với áo này?" │
└───────────────────────┬─────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ LLM (thông minh): Hiểu "phụ kiện" → │
│ Tự điền product_name = "Khăn/ Mũ/ Túi xách/ Tất" │
│ (tách ra từng loại cụ thể thay vì gửi chung "phụ kiện")│
└───────────────────────┬─────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ Code split "/": ["khăn", "mũ", "túi xách", "tất"] │
│ ↓ │
│ PRODUCT_TYPE_MAPPING: │
│ "khăn" → "Khăn" (product_line_vn) │
│ "mũ" → "Mũ" (product_line_vn) │
│ "túi xách" → "Túi xách" (product_line_vn) │
│ "tất" → "Tất" (product_line_vn) │
└───────────────────────┬─────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ Filter: Chỉ giữ products có product_line_vn │
│ == "Khăn" OR "Mũ" OR "Túi xách" OR "Tất" │
│ │
│ ❌ "Áo Cổ Cao Tay Dài" → loại bỏ │
│ ✅ "Khăn" → giữ │
│ ✅ "Mũ" → giữ │
└─────────────────────────────────────────────────────────┘
\ No newline at end of file
backend/agent/tools/data_retrieval_tool.py
View file @ 6e66cea0
......@@ -11,10 +11,7 @@ import time
from langchain_core.tools import tool
from pydantic import BaseModel, Field
from agent.tools.data_retrieval_filter import (
apply_post_filters,
infer_product_name_from_description,
)
from agent.helper import format_product_results
from agent.tools.product_search_helpers import build_starrocks_query
from common.starrocks_connection import get_db_connection
......@@ -28,50 +25,71 @@ from agent.prompt_utils import read_tool_prompt
class SearchItem(BaseModel):
model_config = {"extra": "forbid"} # STRICT MODE
# ====== SEMANTIC SEARCH ======
description: str = Field(
description="Mô tả sản phẩm cho semantic search. QUY TẮC: Nếu khách hỏi THẲNG TÊN SP (quần jeans, áo polo) → description = product_name (VD: 'Quần jean', 'Áo Polo'). Nếu khách hỏi MÔ TẢ/NHU CẦU (đi dự tiệc, đồ đi biển) → description = HYDE mô tả (VD: 'Váy dự tiệc sang trọng nữ tính')"
)
product_name: str | None = Field(
description="CHỈ tên loại sản phẩm cơ bản: Áo, Váy, Quần, Chân váy, Áo khoác... KHÔNG bao gồm style/mô tả."
description=(
"Mô tả sản phẩm cho semantic search. "
"FORMAT: 'product_name: [tên]. description_text: [mô tả]. "
"material_group: [chất liệu]. style: [phong cách]. fitting: [dáng]. "
"form_sleeve: [tay]. form_neckline: [cổ]. product_line_vn: [dòng SP]'. "
"🚨 product_name = CHÍNH XÁC lời user nói, TUYỆT ĐỐI KHÔNG tự đổi sang tên khác. "
"VD: user nói 'áo ngọ nguậy' → product_name: Áo ngọ nguậy (KHÔNG đổi thành 'Áo phông'!). "
"VD: user nói 'áo cá sấu' → product_name: Áo cá sấu (KHÔNG đổi!). "
"Chỉ chuẩn hóa từ đồng nghĩa RÕ RÀNG: 'áo thun'→'Áo phông', 'quần bò'→'Quần jean'. "
"⚠️ KHÔNG đưa master_color vào description — dùng field master_color riêng! "
"product_line_vn trong description = broad category (Áo phông, Áo Polo, Quần jean...). "
"VD: 'áo ngọ nguậy' → 'product_name: Áo ngọ nguậy. product_line_vn: Áo phông'. "
"VD: 'áo cá sấu polo' → 'product_name: Áo cá sấu polo. product_line_vn: Áo Polo'."
)
magento_ref_code: str | None = Field(description="Mã sản phẩm chính xác (SKU)")
price_min: int | None = Field(description="Giá thấp nhất (VND)")
price_max: int | None = Field(description="Giá cao nhất (VND)")
discount_min: int | None = Field(
description="% giảm giá tối thiểu. VD: 50 nghĩa là chỉ lấy sản phẩm giảm >= 50%. Nếu khách hỏi sản phẩm giảm giá nhưng không chỉ rõ %, đặt = 1 để lấy tất cả sản phẩm đang sale."
)
discount_max: int | None = Field(
description="% giảm giá tối đa. VD: 70 nghĩa là chỉ lấy sản phẩm giảm <= 70%. Dùng kết hợp với discount_min để lọc khoảng % giảm giá."
# ====== SKU LOOKUP ======
magento_ref_code: str | None = Field(
description="Mã sản phẩm chính xác (SKU). Chỉ điền khi khách cung cấp mã cụ thể.",
)
# Metadata filters
# ====== SQL HARD FILTERS (lọc trực tiếp trong DB query) ======
gender_by_product: str | None = Field(
description="Giới tính. GIÁ TRỊ HỢP LỆ: women, men, boy, girl, unisex, newborn"
description="[SQL FILTER] Giới tính. GIÁ TRỊ HỢP LỆ: women, men, boy, girl, unisex, newborn",
)
age_by_product: str | None = Field(description="Độ tuổi. GIÁ TRỊ HỢP LỆ: adult, kid, others")
master_color: str | None = Field(
description="Màu sắc chính. 16 MÀU DB: 'Đen/ Black', 'Trắng/ White', 'Xanh da trời/ Blue', 'Xám/ Gray', 'Hồng/ Pink- Magenta', 'Be/ Beige', 'Đỏ/ Red', 'Tím/ Purple', 'Xanh lá cây/ Green', 'Màu xanh Jeans', 'Xanh than/ Aqua', 'Nâu/ Brown', 'Vàng/ Yellow + Gold', 'Cam/ Orange'. CHỈ DÙNG 1 MÀU, KHÔNG ghép (VD: 'Trắng kem' sai → dùng 'Trắng/ White' hoặc 'Be/ Beige')"
age_by_product: str | None = Field(
description="[SQL FILTER] Độ tuổi. GIÁ TRỊ HỢP LỆ: adult, kid, others",
)
form_sleeve: str | None = Field(
description="Dáng tay áo. GIÁ TRỊ DB: 'Full length Sleeve', 'Short Sleeve', 'Sleeveless'. Mapping: 'dài tay'→'Full length Sleeve', 'ngắn tay'→'Short Sleeve', 'sát nách'→'Sleeveless'"
master_color: str | None = Field(
description=(
"[SQL FILTER] Màu sắc sản phẩm. Gửi CHÍNH XÁC từ khách nói (VD: 'trắng', 'đen', 'xanh', 'đỏ'). "
"Tool sẽ tự match trong DB bằng LIKE. KHÔNG đưa màu vào description!"
),
)
style: str | None = Field(
description="Phong cách. 9 GIÁ TRỊ DB: 'Basic', 'Dynamic', 'Feminine', 'Utility', 'Smart Casual', 'Basic Update', 'Trend', 'Athleisure', 'Essential'. CHỈ điền nếu user nói CHÍNH XÁC (VD: 'basic' → 'Basic'). Nếu user nói 'sang trọng', 'tiểu thư' (KHÔNG match) → BỎ QUA field này, chỉ điền vào description."
price_min: int | None = Field(
description="[SQL FILTER] Giá thấp nhất (VND)",
)
fitting: str | None = Field(
description="Dáng đồ. GIÁ TRỊ DB: 'Regular', 'Slimfit', 'Relax', 'Oversize', 'Skinny', 'Slim', 'Boxy'. Mapping: 'vừa'→'Regular', 'ôm'→'Slimfit', 'rộng'→'Relax'"
price_max: int | None = Field(
description="[SQL FILTER] Giá cao nhất (VND)",
)
form_neckline: str | None = Field(
description="Dáng cổ áo. GIÁ TRỊ DB: 'Crew Neck', 'Classic Collar', 'V-neck', 'Hooded collar', 'Mock Neck/ High neck'"
discount_min: int | None = Field(
description="[SQL FILTER] % giảm giá tối thiểu. VD: 50 → chỉ lấy SP giảm >= 50%. Nếu khách hỏi 'đồ sale' chung → đặt = 1.",
)
material_group: str | None = Field(
description="Nhóm chất liệu. GIÁ TRỊ DB: 'Knit - Dệt Kim', 'Woven - Dệt Thoi', 'Yarn - Sợi'"
discount_max: int | None = Field(
description="[SQL FILTER] % giảm giá tối đa. VD: 70 → chỉ lấy SP giảm <= 70%.",
)
season: str | None = Field(description="Mùa. GIÁ TRỊ DB: 'Fall Winter', 'Spring Summer', 'Year'")
# Extra fields for SQL match if needed
product_line_vn: str | None = Field(
description="Dòng sản phẩm. TOP DB: 'Áo phông', 'Áo Polo', 'Áo Sơ mi', 'Áo len', 'Váy liền', 'Chân váy', 'Quần jean', 'Quần soóc', 'Quần dài'. LƯU Ý: 'Váy liền' (KHÔNG phải 'Váy liền thân')"
description=(
"[SQL FILTER] Đại loại sản phẩm — lọc RỘNG bằng prefix. "
"Hỗ trợ nhiều giá trị cách bằng '/'. "
"GIÁ TRỊ: 'Áo' (mọi loại áo), 'Quần' (mọi loại quần), "
"'Váy' (váy liền + chân váy), 'Bộ' (bộ quần áo, bộ mặc nhà), "
"'Khăn', 'Mũ', 'Túi', 'Tất', 'Chăn'. "
"VD: 'áo khaki' → product_line_vn: 'Áo'. 'quần hoặc váy' → 'Quần/ Váy'"
),
)
discovery_mode: str | None = Field(
description=(
"[SQL FILTER] Chế độ khám phá. 'new' = hàng mới (is_new_product=1), "
"'best_seller' = bán chạy nhất (ORDER BY quantity_sold). "
"Chỉ dùng khi khách NÓI RÕ 'mới nhất'/'hàng mới'/'bán chạy'/'best seller'/'hot'. "
"Nếu khách KHÔNG nói → để null."
),
)
......@@ -99,16 +117,6 @@ async def _execute_single_search(
item.magento_ref_code,
)
# Infer product_name if missing (avoid wrong category results)
if not item.product_name:
inferred_name = infer_product_name_from_description(item.description)
if inferred_name:
try:
item = item.model_copy(update={"product_name": inferred_name})
except AttributeError:
item = item.copy(update={"product_name": inferred_name})
logger.warning("🧭 Inferred product_name='%s' from description", inferred_name)
# Timer: build query (sử dụng vector đã có hoặc build mới)
query_build_start = time.time()
sql, params = await build_starrocks_query(item, query_vector=query_vector)
......@@ -140,11 +148,7 @@ async def _execute_single_search(
first_p.get("sale_price"),
)
# ====== POST-FILTERS: Apply all filter layers via centralized function ======
is_sku_search = bool(item.magento_ref_code)
products, filter_info = apply_post_filters(products, item, is_sku_search=is_sku_search)
return format_product_results(products), filter_info
return format_product_results(products), {"fallback_used": False}
except Exception as e:
logger.exception("Single search error for item %r: %s", item, e)
return [], {"fallback_used": False, "error": str(e)}
......@@ -182,8 +186,21 @@ async def data_retrieval_tool(searches: list[SearchItem]) -> str:
# Aggregate filter info from first result for simplicity in response
final_info = all_filter_infos[0] if all_filter_infos else {}
# Include search input so LLM knows its own reasoning
search_inputs = [
{
"description": item.description,
"product_line_vn": item.product_line_vn,
"gender_by_product": item.gender_by_product,
"age_by_product": item.age_by_product,
"discovery_mode": item.discovery_mode,
}
for item in searches
]
output = {
"status": "success",
"search_input": search_inputs,
"results": combined_results,
"filter_info": final_info,
}
......
backend/agent/tools/flow.txt
View file @ 6e66cea0
......@@ -95,3 +95,17 @@ Step 6: Agent nhận message → báo khách
│ │
│ → Color fallback có thể vì COLOR KHÔNG trong SQL query! │
└─────────────────────────────────────────────────────────────────────┘
Bro ơi, tao đã bỏ sạch product_line_vn khỏi SQL rồi!
Kiến trúc bây giờ:
Tầng Filter Mục đích
SQL (product_search_helpers.py) gender + age ONLY Giữ HNSW index nguyên vẹn
Python (data_retrieval_filter.py) PRODUCT_TYPE_MAPPING → exact match product_line_vn Lọc đúng loại sản phẩm
Flow cho "quần đùi bé trai":
SQL: Vector search "Quần soóc bé trai" → top 100 (HNSW intact ✅)
SQL: filtered_matches chỉ filter gender=boy, age=kid → ~80 results
Python: PRODUCT_TYPE_MAPPING["quần soóc"] = "Quần soóc" → exact match product_line_vn ✅
Nếu 0 match → reject all + message "Shop chưa có..."
Server đang reload. Test lại đi bro! 🚀
backend/agent/tools/product_search_helpers.py
View file @ 6e66cea0
......@@ -39,41 +39,41 @@ def _get_discount_params(params) -> tuple[int | None, int | None]:
def _get_metadata_clauses(params, sql_params: list) -> list[str]:
"""Xây dựng điều kiện lọc từ metadata (Parameterized)."""
"""
HARD FILTER: Gender + Age — lọc trực tiếp ở SQL level.
Gender tự động include 'unisex' fallback cho men/women.
Color + Product type → semantic search tự handle qua description.
"""
clauses = []
# 1. Exact Match with Mapping
# Chúng ta sử dụng Mapping để chuyển từ Tiếng Việt (LLM) sang Tiếng Anh (DB Column)
from agent.tools.data_retrieval_filter import AGE_MAP, GENDER_MAP
# Gender Mapping - Include 'unisex' as fallback for men/women
# Gender filter
gender_val = getattr(params, "gender_by_product", None)
if gender_val:
gender_key = gender_val.lower().strip()
acceptable_genders = GENDER_MAP.get(gender_key, [gender_key])
# ⚡ FALLBACK: Include 'unisex' for 'men' or 'women' searches
# This ensures results even when specific gender products are unavailable
if gender_key in ["men", "nam", "male", "women", "nữ", "female", "nu"]:
if "unisex" not in acceptable_genders:
acceptable_genders = list(acceptable_genders) + ["unisex"]
placeholders = ", ".join(["%s"] * len(acceptable_genders))
clauses.append(f"gender_by_product IN ({placeholders})")
sql_params.extend(acceptable_genders)
gender_lower = gender_val.lower().strip()
# Include 'unisex' fallback for men/women
if gender_lower in ("men", "women"):
clauses.append("gender_by_product IN (%s, %s)")
sql_params.extend([gender_lower, "unisex"])
else:
clauses.append("gender_by_product = %s")
sql_params.append(gender_lower)
logger.info(f"👫 [SQL FILTER] Gender: {gender_val}")
# Age Mapping
# Age filter
age_val = getattr(params, "age_by_product", None)
if age_val:
age_key = age_val.lower().strip()
acceptable_ages = AGE_MAP.get(age_key, [age_key])
placeholders = ", ".join(["%s"] * len(acceptable_ages))
clauses.append(f"age_by_product IN ({placeholders})")
sql_params.extend(acceptable_ages)
# 3. BỎ TẤT CẢ PARTIAL FILTERS - Chỉ dùng Gender/Age làm HARD filter
# Các field khác (style, fitting, sleeve, product_line...) được xử lý bởi semantic search
# Color sẽ được filter trong Python với fallback mechanism
age_lower = age_val.lower().strip()
clauses.append("age_by_product = %s")
sql_params.append(age_lower)
logger.info(f"🎂 [SQL FILTER] Age: {age_val}")
# Color filter (LIKE match on master_color OR product_color_name)
color_val = getattr(params, "master_color", None)
if color_val:
color_lower = color_val.lower().strip()
clauses.append("(LOWER(master_color) LIKE %s OR LOWER(product_color_name) LIKE %s)")
sql_params.extend([f"%{color_lower}%", f"%{color_lower}%"])
logger.info(f"🎨 [SQL FILTER] Color: {color_val}")
return clauses
......@@ -115,7 +115,69 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
# ============================================================
# CASE 2: HYDE SEARCH - Semantic Vector Search
# CASE 2: DISCOVERY — Hàng mới / Bán chạy (Direct SQL, no embedding)
# Khác với price/gender filter: discovery cần scan TOÀN BỘ bảng
# vì top 100 vector results gần như không chứa new/best_seller
# ============================================================
discovery_mode = getattr(params, "discovery_mode", None)
if discovery_mode:
discovery_mode = discovery_mode.lower().strip()
sql_params: list = []
# Metadata filters (gender + age)
where_clauses = _get_metadata_clauses(params, sql_params)
# Product line filter
product_line = getattr(params, "product_line_vn", None)
if product_line:
where_clauses.append("LOWER(product_line_vn) LIKE %s")
sql_params.append(f"{product_line.lower().strip()}%")
# Price filters
where_clauses.extend(_get_price_clauses(params, sql_params))
# Discovery-specific WHERE + ORDER
if discovery_mode == "new":
where_clauses.append("is_new_product = 1")
order_by = "quantity_sold DESC, magento_ref_code"
logger.info("🆕 [DISCOVERY] New products, filters=%s", where_clauses)
elif discovery_mode == "best_seller":
where_clauses.append("quantity_sold > 0")
order_by = "quantity_sold DESC, magento_ref_code"
logger.info("🔥 [DISCOVERY] Best sellers, filters=%s", where_clauses)
else:
discovery_mode = None
if discovery_mode:
where_str = " AND ".join(where_clauses) if where_clauses else "1=1"
sql = f"""
SELECT
internal_ref_code,
magento_ref_code,
product_color_code,
product_name,
master_color,
product_image_url_thumbnail,
product_web_url,
sale_price,
original_price,
discount_amount,
ROUND(((original_price - sale_price) / original_price * 100), 0) as discount_percent,
age_by_product,
gender_by_product,
product_line_vn,
quantity_sold
FROM shared_source.magento_product_dimension_with_text_embedding
WHERE {where_str}
ORDER BY {order_by}
LIMIT 20
"""
logger.info("⚡ [DISCOVERY] Direct SQL — no embedding")
return sql, sql_params
# ============================================================
# CASE 3: SEMANTIC VECTOR SEARCH
# ============================================================
query_text = getattr(params, "description", None)
if query_text and query_vector is None:
......@@ -133,18 +195,28 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
# 1. Price
price_clauses = _get_price_clauses(params, sql_params)
# 2. Metadata (Gender, Age, etc.)
# 2. Metadata: Gender + Age + Color (HARD FILTER — all at SQL level)
metadata_clauses = _get_metadata_clauses(params, sql_params)
all_clauses = price_clauses + metadata_clauses
# Discovery mode filters
discovery_mode = getattr(params, "discovery_mode", None)
if discovery_mode:
discovery_mode = discovery_mode.lower().strip()
if discovery_mode == "new":
all_clauses.append("is_new_product = 1")
logger.info("🆕 [SQL FILTER] Discovery: new products only")
elif discovery_mode == "best_seller":
all_clauses.append("quantity_sold > 0")
logger.info("🔥 [SQL FILTER] Discovery: best sellers")
# Get discount params
discount_min, discount_max = _get_discount_params(params)
post_filter_conditions = []
# Price filters
# Price + Gender + Age filters
if all_clauses:
post_filter_conditions.extend(all_clauses)
......@@ -162,6 +234,14 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
if post_filter_conditions:
post_filter_where = " WHERE " + " AND ".join(post_filter_conditions)
# Determine sort order: best_seller uses quantity_sold, otherwise similarity_score
if discovery_mode == "best_seller":
final_order = "ORDER BY max_sold DESC, max_score DESC"
extra_agg = ",\n MAX(quantity_sold) as max_sold"
else:
final_order = "ORDER BY max_score DESC"
extra_agg = ""
sql = f"""
WITH vector_matches AS (
SELECT /*+ SET_VAR(ann_params='{{"ef_search":128}}') */
......@@ -181,10 +261,12 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
product_line_vn,
product_line_en,
description_text_full,
quantity_sold,
is_new_product,
approx_cosine_similarity(vector, {v_str}) as similarity_score
FROM shared_source.magento_product_dimension_with_text_embedding
ORDER BY similarity_score DESC
LIMIT 500
LIMIT 100
),
filtered_matches AS (
SELECT * FROM vector_matches
......@@ -205,30 +287,34 @@ async def build_starrocks_query(params, query_vector: list[float] | None = None)
MAX_BY(discount_amount, similarity_score) as discount_amount,
MAX_BY(discount_percent, similarity_score) as discount_percent,
MAX_BY(description_text_full, similarity_score) as description_text_full,
MAX(similarity_score) as max_score
MAX_BY(gender_by_product, similarity_score) as gender_by_product,
MAX_BY(age_by_product, similarity_score) as age_by_product,
MAX_BY(product_line_vn, similarity_score) as product_line_vn,
MAX_BY(quantity_sold, similarity_score) as quantity_sold,
MAX(similarity_score) as max_score{extra_agg}
FROM filtered_matches
GROUP BY product_color_code, internal_ref_code
ORDER BY max_score DESC
LIMIT 80
{final_order}
LIMIT 70
"""
# Write to query.txt for debugging - Build FULL executable query
# try:
# query_log_path = os.path.join(os.path.dirname(__file__), "query.txt")
# # Build executable query by substituting %s with actual values
# executable_sql = sql
# for param in sql_params:
# if isinstance(param, str):
# # Escape single quotes and wrap in quotes
# escaped = param.replace("'", "''")
# executable_sql = executable_sql.replace("%s", f"'{escaped}'", 1)
# else:
# executable_sql = executable_sql.replace("%s", str(param), 1)
# with open(query_log_path, "w", encoding="utf-8") as f:
# f.write(f"-- [HYDE SEARCH] Full Executable Query\n-- Original Params: {sql_params}\n{executable_sql}")
# except Exception as e:
# logger.error(f"Error writing to query.txt: {e}")
try:
query_log_path = os.path.join(os.path.dirname(__file__), "query.txt")
# Build executable query by substituting %s with actual values
executable_sql = sql
for param in sql_params:
if isinstance(param, str):
# Escape single quotes and wrap in quotes
escaped = param.replace("'", "''")
executable_sql = executable_sql.replace("%s", f"'{escaped}'", 1)
else:
executable_sql = executable_sql.replace("%s", str(param), 1)
with open(query_log_path, "w", encoding="utf-8") as f:
f.write(f"-- [HYDE SEARCH] Full Executable Query\n-- Original Params: {sql_params}\n{executable_sql}")
except Exception as e:
logger.error(f"Error writing to query.txt: {e}")
return sql, sql_params
backend/common/canifa_api.py
View file @ 6e66cea0
......@@ -3,6 +3,8 @@ Canifa API Service
Xử lý các logic liên quan đến API của Canifa (Magento)
"""
import hashlib
import json
import logging
from typing import Any
......@@ -10,11 +12,11 @@ import httpx
logger = logging.getLogger(__name__)
# CANIFA_CUSTOMER_API = "https://vsf2.canifa.com/v1/magento/customer"
CANIFA_CUSTOMER_API = "https://canifa.com/v1/magento/customer"
# ⚡ Auth Token Cache: TTL 1 tiếng — tránh gọi canifa.com mỗi request
AUTH_CACHE_TTL = 3600 # 1 hour
AUTH_CACHE_PREFIX = "auth_token:"
_http_client: httpx.AsyncClient | None = None
......@@ -42,10 +44,48 @@ CANIFA_QUERY_BODY = [
{},
]
async def _get_cached_auth(token: str) -> dict | None:
"""Check Redis cache for verified token."""
try:
from common.cache import redis_cache
client = redis_cache.get_client()
if not client:
return None
token_hash = hashlib.md5(token.encode()).hexdigest()
key = f"{AUTH_CACHE_PREFIX}{token_hash}"
cached = await client.get(key)
if cached:
logger.info("⚡ Auth token cache HIT — skipping Canifa API call")
return json.loads(cached)
except Exception as e:
logger.warning(f"Auth cache read error: {e}")
return None
async def _set_cached_auth(token: str, data: dict) -> None:
"""Store verified token result in Redis."""
try:
from common.cache import redis_cache
client = redis_cache.get_client()
if not client:
return
token_hash = hashlib.md5(token.encode()).hexdigest()
key = f"{AUTH_CACHE_PREFIX}{token_hash}"
await client.setex(key, AUTH_CACHE_TTL, json.dumps(data, ensure_ascii=False))
logger.info(f"💾 Auth token cached (TTL: {AUTH_CACHE_TTL}s)")
except Exception as e:
logger.warning(f"Auth cache write error: {e}")
async def verify_canifa_token(token: str) -> dict[str, Any] | None:
"""
Verify token với API Canifa (Magento).
Dùng token làm cookie `vsf-customer` để gọi API lấy thông tin customer.
Verify token với API Canifa (Magento) — có Redis cache.
Lần đầu gọi API (~200-500ms), các lần sau hit cache (~2ms).
Args:
token: Giá trị của cookie vsf-customer (lấy từ Header Authorization)
......@@ -56,6 +96,12 @@ async def verify_canifa_token(token: str) -> dict[str, Any] | None:
if not token:
return None
# ⚡ Check cache first
cached_data = await _get_cached_auth(token)
if cached_data is not None:
return cached_data
# Cache miss → call Canifa API
headers = {
"accept": "application/json, text/plain, */*",
"content-type": "application/json",
......@@ -70,12 +116,11 @@ async def verify_canifa_token(token: str) -> dict[str, Any] | None:
data = response.json()
logger.debug(f"Canifa API Raw Response: {data}")
# Response format: {"data": {"customer": {...}}, "loading": false, ...}
if isinstance(data, dict):
# Trả về toàn bộ data để extract_user_id xử lý
# ⚡ Cache successful auth result
await _set_cached_auth(token, data)
return data
# Nếu Canifa trả list (batch request)
return data
logger.warning(f"Canifa API Failed: {response.status_code} - {response.text}")
......
backend/server.py
View file @ 6e66cea0
......@@ -5,7 +5,7 @@ import platform
import uvicorn
from fastapi import FastAPI
from fastapi.responses import RedirectResponse
from fastapi.responses import FileResponse, JSONResponse, RedirectResponse
from fastapi.staticfiles import StaticFiles
from api.chatbot_route import router as chatbot_router
......@@ -32,6 +32,12 @@ logging.basicConfig(
logger = logging.getLogger(__name__)
# Static files directory
STATIC_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "static")
if not os.path.exists(STATIC_DIR):
os.makedirs(STATIC_DIR)
print(f"✅ Static dir resolved: {STATIC_DIR}")
app = FastAPI(
title="Contract AI Service",
......@@ -47,6 +53,30 @@ async def startup_event():
logger.info("✅ Redis cache initialized")
@app.get("/")
async def root():
return RedirectResponse(url="/static/index.html")
@app.get("/health")
async def health():
return JSONResponse({"status": "ok"})
@app.get("/static/{file_path:path}")
async def serve_static(file_path: str):
"""Serve static files explicitly to avoid middleware conflict."""
if not file_path:
file_path = "index.html"
full_path = os.path.join(STATIC_DIR, file_path)
if os.path.isfile(full_path):
return FileResponse(full_path)
return JSONResponse({"detail": "Not Found"}, status_code=404)
# =====================================================================
# MIDDLEWARE (after static mount)
# =====================================================================
middleware_manager.setup(
app,
enable_auth=True,
......@@ -66,21 +96,6 @@ app.include_router(mock_router)
app.include_router(stock_router)
try:
static_dir = os.path.join(os.path.dirname(__file__), "static")
if not os.path.exists(static_dir):
os.makedirs(static_dir)
app.mount("/static", StaticFiles(directory=static_dir, html=True), name="static")
print(f"✅ Static files mounted at /static (Dir: {static_dir})")
except Exception as e:
print(f"⚠️ Failed to mount static files: {e}")
@app.get("/")
async def root():
return RedirectResponse(url="/static/index.html")
if __name__ == "__main__":
print("=" * 60)
print("🚀 Contract AI Service Starting...")
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment