# 1. Tổng quan (Overview)

Chức năng **AI Image Search** cho phép khách hàng upload một hoặc nhiều tấm ảnh (ví dụ: ảnh người mẫu mặc váy hoa nhí) kèm theo câu lệnh dạng text để tìm kiếm các sản phẩm tương tự trong kho hàng CANIFA.

Điểm đột phá của hệ thống là không sử dụng thuật toán Image-to-Image thuần túy (rất đắt và độ trễ cao) mà kết hợp một **Kiến trúc 2-Agent LangGraph (Multi-modal)** và cơ chế **Cascade Search** sử dụng **Vector Similarity Search (HNSW)** trên StarRocks.

### Core Components:
- **Vision Planner (Agent 1):** Đọc ảnh Base64 + Text của khách hàng bằng Vision LLM (VD: gpt-4o, claude-3-5-sonnet). Bóc tách các yếu tố thời trang như dòng sản phẩm (`product_line_vn`), kiểu dáng (`keywords`), màu sắc (`master_color`), và giới tính/độ tuổi (`gender_by_product`).
- **ProductSearchEngine (Search Layer):** Nhận input từ Planner, thực hiện truy vấn Dual-Lane (Literal vs Inferred) qua database. Nếu không có kết quả Exact Match, engine sẽ kích hoạt fallback cascade tạo **Vector Embedding** (text-embedding-3-small) và thực hiện Vector Search xấp xỉ (`approx_cosine_similarity`) trên StarRocks.
- **Vision Responder (Agent 2):** Format các kết quả trả về từ database thành một câu trả lời tự nhiên, thân thiện và gắn link mua hàng trực tiếp cho người dùng.