API · ตั้งค่า
ตั้งหมวด
บอกชื่อหมวดของร้านคุณ แล้วระบบจัดทุกระเบียนเข้าหมวดด้วยโมเดล — ค้นและกรองด้วยหมวดได้
ทุกเส้นอยู่ใต้ https://api.intent-search.dev และยืนยันตัวตนด้วย Authorization: Bearer nsk_… · คีย์บอกเองว่าชุดข้อมูลไหน
เนื้อคำขอ
| ฟิลด์ | ความหมาย |
|---|---|
categoriesต้องมีarray | หมวดทั้งหมด ไม่เกิน 200 · รายการว่างคือเลิกจัดหมวด |
categories[].nameต้องมีstring | ชื่อหมวด ตามที่ร้านใช้ |
categories[].descriptionstring | อธิบายว่าอะไรอยู่ในหมวดนี้ — โมเดลอ่าน ไม่ได้แสดง |
categories[].examplesarray | ชื่อสินค้าตัวอย่างของหมวดนี้ ไม่เกิน 20 · ช่วยให้แม่นขึ้นมาก |
fieldstring | ชื่อคอลัมน์ที่จะเขียนหมวดลงไป · ค่าเริ่มต้น category · ต้องไม่ซ้ำกับคอลัมน์ที่ระเบียนมีอยู่แล้ว |
fromarray | ฟิลด์ข้อความที่โมเดลอ่าน · ค่าเริ่มต้นคือฟิลด์ที่น้ำหนักค้นหาสูงสุด (ชื่อสินค้า) |
min_scorenumber | สินค้าต้องใกล้หมวดที่ใกล้ที่สุดอย่างน้อยเท่านี้ (cosine 0–1) ถึงจะถูกจัดเข้า ไม่ถึงก็ไม่อยู่หมวดไหน · ค่าเริ่มต้น 0.6 · ส่งรายการเดิมพร้อมค่าใหม่ไม่ทำให้จัดหมวดใหม่ ส่งใหม่เฉพาะสินค้าที่ข้ามเส้น |
ตัวอย่าง
curl -X PUT "https://api.intent-search.dev/v1/categories" \
-H "Authorization: Bearer $NS_KEY" \
-H "Content-Type: application/json" \
-d '{
"categories": [
{
"name": "ความงาม",
"description": "เครื่องสำอาง สกินแคร์ ครีม เซรั่ม"
},
{
"name": "ต้นไม้และสวน",
"examples": [
"กระถางพลาสติก",
"ดินปลูก"
]
}
]
}'คำตอบ
{
"field": "category",
"categories": [
{
"name": "ความงาม",
"description": "เครื่องสำอาง สกินแคร์ ครีม เซรั่ม"
},
{
"name": "ต้นไม้และสวน",
"examples": [
"กระถางพลาสติก",
"ดินปลูก"
]
}
],
"min_score": 0.6,
"version": 1,
"model": null,
"progress": {
"sorted": 0,
"total": 3,
"unfit": 0
},
"updated_at": "2026-09-25T09:30:00.000Z"
}สิ่งที่ควรรู้
โมเดลอ่านชื่อสินค้าทุกชิ้นแล้วเลือกหมวดที่ใกล้ที่สุด โดยเรียนจากสินค้าในร้านคุณเองว่าชื่อหมวดแต่ละชื่อหมายถึงอะไร · ทำเบื้องหลัง ดูความคืบหน้าที่ GET /v1/categories และหมวดที่จัดแล้วขึ้นดัชนีเองโดยไม่ต้อง sync
หมวดอยู่ในคอลัมน์ field ของระเบียนในผลค้นหา ค้นด้วยคำได้ และเป็นตัวกรองได้ทันที (filters: {"category": ["ความงาม"]}) · เปลี่ยนรายการเมื่อไหร่ ทุกระเบียนถูกจัดใหม่ · การค้นด้วยความหมายใช้ได้ตลอด ไม่ต้องรอทำเวกเตอร์ใหม่ เพราะหมวดไม่ได้อยู่ในข้อความที่โมเดลอ่าน
ไม่บังคับให้ทุกชิ้นมีหมวด: สินค้าที่ห่างทุกหมวดเกิน min_score ไม่มีคอลัมน์หมวด ตัวกรองหมวดนับไว้ใน missing และ progress.unfit บอกจำนวน · รายการหมวดที่ไม่ครอบคลุมทั้งร้านจึงไม่ยัดของที่ไม่เข้าพวกลงหมวดที่ใกล้ที่สุด · วัดกับสินค้าจริง: รายการครบ 16 หมวดยังจัดได้ 94% ส่วนรายการ 4 หมวดปล่อยสินค้าที่ไม่ใช่ทั้งสี่หมวดออกได้ราวหนึ่งในสาม
วัดกับสินค้า Shopee ของลูกค้าจริง 1,451 ชิ้น 16 หมวดที่ลูกค้าตรวจแล้ว: ตรง 66.8% จากชื่อหมวดอย่างเดียว เทียบกับ 11.2% ของการค้นด้วยชื่อหมวดแล้วเอาผลมาเป็นหมวด · ใส่ examples หมวดละห้าชิ้นได้ราว 75%
ข้อผิดพลาดของเส้นนี้
| ฟิลด์ | ความหมาย |
|---|---|
402 | แพ็กเกจนี้ไม่มีการค้นด้วยความหมาย ซึ่งการจัดหมวดใช้ |
409 | ชื่อ field ซ้ำกับฟิลด์ในโครงหรือคอลัมน์ที่ระเบียนมีอยู่แล้ว |
รูปของข้อผิดพลาด อัตราต่อวินาที และการลดทอน (degraded) อยู่ที่ ข้อผิดพลาดและเพดาน