53 lines
5.9 KiB
Markdown
53 lines
5.9 KiB
Markdown
# คู่มือการใช้ AI/LLM สร้าง JSON สำหรับนำเข้าสินค้า (Product Catalog Generator)
|
|
|
|
> **DBK Platform tenant examples:** Choose the prompt that matches the active tenant and vertical. HomAroma/wellness, beauty, fashion, and motorcycle examples are not platform defaults.
|
|
|
|
ระบบรองรับการสร้างสินค้าจำนวนมากผ่าน **JSON Import** ในหน้า Admin (`/admin/products` -> คลิกปุ่ม **"Import JSON"**) หรือเรียก API `POST /api/products/bulk`
|
|
|
|
เพื่อป้องกันไม่ให้ AI เกิดความสับสนกับตัวอย่างสินค้าเฉพาะกลุ่ม เอกสารชุดนี้จึงแยก Prompt ออกเป็น **4 ไฟล์เฉพาะทาง (Dedicated Prompts)** ตามหมวดธุรกิจและสภาพแวดล้อม Demo Showcase:
|
|
|
|
---
|
|
|
|
## 📂 รายการ Prompt ทั้ง 4 กลุ่มธุรกิจ (เลือก Copy ไปส่งให้ LLM ได้ทันที)
|
|
|
|
| กลุ่มธุรกิจ | ไฟล์ Prompt สำหรับ Copy | ตัวอย่างแบรนด์ / สินค้า | สภาพแวดล้อม Demo |
|
|
| :--- | :--- | :--- | :--- |
|
|
| **1. Wellness & Luxury** | [LLM_PROMPT_1_WELLNESS_LUXURY.md](file:///c:/Users/ti/git/homaroma/LLM_PROMPT_1_WELLNESS_LUXURY.md) | Panpuri, Jo Malone, Diptyque (น้ำมันหอมระเหย, ก้านไม้หอม, เทียนหอม, สปา) | `wellness.kittisak.com` |
|
|
| **2. Beauty & Multi-Brand** | [LLM_PROMPT_2_BEAUTY_MULTIBRAND.md](file:///c:/Users/ti/git/homaroma/LLM_PROMPT_2_BEAUTY_MULTIBRAND.md) | EVEANDBOY, Beautrium (สกินแคร์, เซรั่ม, กันแดด, ลิปสติก, คุชชั่น) | `beauty.kittisak.com` |
|
|
| **3. Fashion & Lifestyle** | [LLM_PROMPT_3_FASHION_LIFESTYLE.md](file:///c:/Users/ti/git/homaroma/LLM_PROMPT_3_FASHION_LIFESTYLE.md) | Jaspal, CPS CHAPS, Zara, Gentlewoman (เสื้อเชิ้ต, เดรส, กางเกง, กระเป๋าหนัง) | `fashion.kittisak.com` |
|
|
| **4. Motorcycle Parts & Accessories** | [LLM_PROMPT_4_MOTO_PARTS.md](file:///c:/Users/ti/git/homaroma/LLM_PROMPT_4_MOTO_PARTS.md) | RCB Racing Boy, Brembo, Öhlins, YSS (ปั๊มเบรก, คาลิปเปอร์, โช้คอัพ, ล้อแม็ก) | `moto.kittisak.com` |
|
|
|
|
---
|
|
|
|
## 🛠️ ข้อกำหนดทางเทคนิคสากล (Universal Schema Rules)
|
|
|
|
ไม่ว่าจะใช้ไฟล์ใด LLM จะต้องยึดหลักเกณฑ์ทางเทคนิคของระบบดังนี้:
|
|
|
|
1. **Format:** ต้องส่งคืนเฉพาะ **Valid JSON Array** (`[ ... ]`) ล้วนๆ ไม่มีข้อความเกริ่นหรือปิดท้าย
|
|
2. **Numeric Fields:** `price`, `stock`, `order` ต้องเป็นตัวเลข Number แท้จริง (ห้ามครอบเครื่องหมายคำพูด เช่น `"1500"` เป็นต้น)
|
|
3. **Product Types:**
|
|
- **Simple Product (สินค้าเดี่ยว):** ใส่ `price`, `stock`, `sku`, `barcode` ที่ระดับบนสุด ระบบจะแปลงเป็น Base Variant ในฐานข้อมูลให้อัตโนมัติ
|
|
- **Variable Product (สินค้ามีตัวเลือก ไซส์/สี/ขนาด):** กำหนด `options` (เช่น `[{"name": "ขนาด", "values": ["S", "M"]}]`) และใน `variants` ต้องมี `option1` ตรงกับค่าใน `values` ทุกตัวอักษร
|
|
4. **Multilingual (รองรับครบ 8 ภาษา):** ระบบรองรับการแปลภาษาผ่านฟิลด์ `translations` ครบทั้ง 8 ภาษามาตรฐานของระบบ:
|
|
- `th` (ไทย - ภาษาหลัก)
|
|
- `en` (English - สากล)
|
|
- `ja` (日本語 - ญี่ปุ่น)
|
|
- `zh` (简体中文 - จีนตัวย่อ)
|
|
- `vi` (Tiếng Việt - เวียดนาม)
|
|
- `ko` (한국어 - เกาหลี)
|
|
- `lo` (ພາສາລາວ - ลาว)
|
|
- `it` (Italiano - อิตาลี)
|
|
ในแต่ละภาษากำหนด `name`, `description`, `details` ให้สอดคล้องกัน (สามารถสั่งให้ LLM แปลครบทั้ง 8 ภาษา หรือเลือกเฉพาะภาษาเป้าหมายที่ต้องการได้)
|
|
5. **Images:** กำหนดเป็น Array ของ URL รูปภาพจริง เช่น จาก Unsplash หรือ CDN
|
|
|
|
---
|
|
|
|
## 🚀 ขั้นตอนการนำเข้าข้อมูล (Import Workflow)
|
|
|
|
1. เปิดไฟล์ Prompt หมวดที่ต้องการ แล้ว Copy ข้อความในบล็อก `Prompt ส่งให้ LLM`
|
|
2. ส่งให้ LLM เช่น **ChatGPT, Claude 3.5 Sonnet หรือ Google Gemini**
|
|
*(สามารถระบุจำนวนสินค้าที่ต้องการ เช่น "ขอ 20 รายการ" ได้)*
|
|
3. คัดลอก JSON ที่ได้จาก LLM
|
|
4. เข้าไปที่หน้า Admin ของระบบนั้นๆ -> เมนู **สินค้า (Products)** -> กดปุ่ม **"Import JSON"**
|
|
5. ตรวจสอบสถานะการตรวจสอบ (Validation) และกดยืนยัน **"ยืนยันนำเข้าสินค้า"**
|