intent-search
Get API Key
สารบัญเริ่มต้น

เริ่มต้น

intent-search

เสิร์ชที่เข้าใจภาษาไทยจริง และเข้าใจว่าคนถามอะไร — ต่อผ่าน HTTP เส้นเดียว ไม่ต้องดูแลดัชนีเอง

มันทำอะไรให้

คุณส่งระเบียนของคุณเข้ามาแบบที่มันเป็นอยู่ แล้วค้นมันด้วยคำ ด้วย vector หรือทั้งสองอย่างพร้อมกัน ฝั่งเราเก็บระเบียนเต็มไว้และส่งกลับมาให้ทั้งชิ้น — เอนจินเห็นเฉพาะฟิลด์ที่คุณบอกว่าค้นได้ ส่วนที่เหลือของระเบียนไม่เคยออกจากฐานข้อมูลของเราไปที่ไหน

ที่ต่างจากการต่อกับเสิร์ชเอนจินตรง ๆ คือ คุณไม่ต้องทำเวกเตอร์เอง ส่ง "mode": "hybrid" มาพร้อมคำค้นที่เป็นข้อความ แล้วเราแปลงคำถามเป็น vector ให้ก่อนถามเอนจิน ลูกค้าพิมพ์ “อยากดูเด็กลง” แล้วเจอเซรั่มลดริ้วรอย ทั้งที่ไม่มีคำว่าเด็กอยู่ในหน้าสินค้าเลย — หลังจากเปิด PUT /v1/vectors ครั้งเดียว

ทุกเส้นของ /v1

คีย์หนึ่งดอกผูกกับชุดข้อมูลเดียว ทุกเส้นจึงไม่ต้องบอกว่าชุดไหน — คีย์บอกแทนแล้ว · ทุกเส้นอยู่ใต้ https://api.intent-search.dev

ตั้งค่า

ให้ agent ทำแทน

สมัคร สร้างชุดข้อมูล แล้วส่ง service key ให้ agent พร้อมบอกให้อ่าน /llms.txt — เอกสารทุกหน้าในไฟล์ Markdown เดียว ลำดับงานตั้งแต่ส่งระเบียนจนถึงเปิดการค้นด้วยความหมาย และวิธีรอให้พร้อมโดยไม่ต้องมีคนดู

เขียนด้วย TypeScript? /docs/types.ts คือ type ของทุกคำขอและคำตอบของ /v1 ในไฟล์เดียว ไม่มี import และไม่มีโค้ดที่รัน — วางไว้ในโปรเจกต์แล้ว import type { V1 } ได้เลย ตัวอย่างทุกตัวในเอกสารนี้ถูกตรวจกับไฟล์นี้ทุกครั้งที่ build

สามคำขอ

จากไม่มีอะไรเลย ถึงผลค้นหาแรก
# 1. ส่งระเบียนของคุณแบบที่มันเป็น — ครั้งแรกระบบอ่านแล้วตั้งโครงให้เอง
curl -X POST "https://api.intent-search.dev/v1/documents" \
  -H "Authorization: Bearer $NS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"documents":[{"id":"sku-1042","product_name":"เซรั่มวิตามินซี ลดริ้วรอย","brand":"Aurora","price":890}]}'

# 2. ส่งที่พักไว้เข้าดัชนี
curl -X POST "https://api.intent-search.dev/v1/sync" \
  -H "Authorization: Bearer $NS_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# 3. ค้นด้วยข้อความที่คนพิมพ์ ตรง ๆ
curl -X POST "https://api.intent-search.dev/v1/search" \
  -H "Authorization: Bearer $NS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"เซรั่ม"}'

ยังไม่มีคีย์? เริ่มต้นใช้งาน พาไปทีละขั้นตั้งแต่สมัคร จนถึงค้นด้วยความหมาย

สิ่งที่เปลี่ยน

คำตอบที่เปลี่ยนรูปจนโค้ดที่เขียนไว้ก่อนต้องแก้ตาม ใหม่สุดก่อน

  1. GET /v1/pins

    ปิดแล้วทั้ง GET และ PUT ปักหมุดยังไม่เปิดใน phase นี้ และหมุดที่ตั้งไว้ถูกลบทั้งหมด · POST /v1/search ที่ส่ง pinned มาได้ 400 · ที่ต้องแก้: เลิกเรียก /v1/pins และเอา pinned ออกจากคำค้น

  2. POST /v1/search

    ผลแต่ละชิ้นไม่มี "reached": true แล้ว ใช้ words แทน: typed คำที่พิมพ์เจอตรง ๆ · compound เจอเพราะคำที่ยาวกว่าซึ่งขึ้นต้นด้วยคำที่พิมพ์เท่านั้น (คือที่เคยเป็น reached: true) · widened คำที่พิมพ์ไม่เจออะไร ผลนี้มาจากคำถามที่กว้างกว่า · ไม่มี words เมื่อความหมายอย่างเดียวเจอ · ที่ต้องแก้: เปลี่ยน hit.reached เป็น hit.words === "compound"

  3. POST /v1/filters/:field

    บนหน้าที่ไล่ด้วย after คีย์ other นับเฉพาะสิ่งที่อยู่หลังหน้านี้ เดิมรวมหน้าก่อน ๆ ไปด้วย · คีย์ใหม่ other_values คือจำนวนค่าที่ยังเหลือ และ note นับจากตัวนี้ · หน้าสุดท้ายไม่มี next แล้ว เดิมได้ next แล้วหน้าถัดไปว่าง · missing มาด้วยแล้ว · เรียงแบบ value พร้อม size ได้ค่าแรกตามลำดับไทยจริง · ที่ต้องแก้: หยุดไล่เมื่อไม่มี next ไม่ต้องรอหน้าว่าง และอ่านจำนวนค่าที่เหลือจาก other_values ไม่ใช่ other

  4. POST /v1/search

    ตัวกรองวันที่ที่ร้านบันทึกไว้ส่งเฉพาะช่องที่มีสินค้า เดิมส่งช่องว่างระหว่างช่องแรกถึงช่องสุดท้ายด้วย · เลือกขั้นได้ครบ minute hour day week month quarter year แต่ต้องไม่เกิน 200 ช่อง และเมื่อสินค้าใหม่ดันให้เกินจะได้ 200 ช่องล่าสุดพร้อม degraded.reason: "facet_buckets_capped" · ที่ต้องแก้: ถ้าวาดกราฟจาก aggregations ของตัวกรองวันที่ ให้เติมช่องที่ว่างเอง

  5. GET /v1/categories

    สินค้าที่ห่างทุกหมวดเกิน min_score (ค่าเริ่มต้น 0.6) ไม่ถูกจัดเข้าหมวดไหน เดิมได้หมวดที่ใกล้ที่สุดเสมอ · ระเบียนนั้นไม่มีคอลัมน์หมวด ตัวกรองหมวดนับไว้ใน missing และ progress.unfit บอกจำนวน · ตั้ง min_score ได้ใน PUT /v1/categories และเปลี่ยนแค่ค่านี้ไม่ทำให้จัดหมวดใหม่ · ที่ต้องแก้: อย่าถือว่าทุกระเบียนมีหมวด

  6. GET /v1/documents/:id

    id ใน path ถูกถอดรหัสครั้งเดียวตามมาตรฐาน เดิมถอดสองครั้ง id ที่มี % อ่านหรือลบไม่ได้ และ DELETE /v1/documents/sku%2541 ลบ skuA ผิดชิ้น · ใช้กับ DELETE /v1/documents/:id และ POST /v1/filters/:field ด้วย · ที่ต้องแก้: encode id ครั้งเดียวด้วย encodeURIComponent ถ้าเคย encode สองครั้งเพื่อเลี่ยงปัญหานี้ ให้เอาครั้งที่สองออก

  7. POST /v1/search

    counted_from มาคู่กับ counted_over และบอกว่าตัวเลขใน aggregations นับจากอะไร: matches ระเบียนที่คำค้นเจอ · words ระเบียนที่ฝั่งคำของ hybrid เจอ ผลที่ตรงความหมายอย่างเดียวไม่ถูกนับ · all ทุกระเบียนในชุดข้อมูล สำหรับ vector ไม่ใช่เฉพาะผล · การค้นด้วยความหมายที่ไม่ได้นับอะไรไม่มี counted_over แล้ว เดิมได้ค่าเท่ากับ total · ที่ต้องแก้: อ่าน counted_over เฉพาะเมื่อมี และดู counted_from ก่อนขึ้นข้อความว่าตัวเลขนับจากอะไร

  8. POST /v1/search

    reached ออกจาก broadened มาเป็นคีย์ของคำตอบเอง — เดิม {"query":"รองเท้า"} ที่เจอตรง ๆ สี่รายการก็ได้ broadened: {"reached": [...]} มาด้วย ตอนนี้ broadened มีเฉพาะเมื่อคำที่พิมพ์ไม่เจออะไรเลย · ที่ต้องแก้: อ่าน reached แทน broadened.reached · ข้อความ “ไม่พบผลที่ตรง” ที่ขึ้นเมื่อมี broadened ถูกแล้วโดยไม่ต้องแก้

  9. POST /v1/search

    answered มากับทุกคำตอบ ทุก mode — เดิมมีเฉพาะ mode: "auto" · reason เพิ่ม mode_asked และ no_mode · ที่ต้องแก้: ถ้าเคยถือว่ามี answered แปลว่าใช้ auto ให้ดู mode ที่ส่งไปเอง และอ่าน answered.by ว่าตอบด้วยคำหรือความหมาย