API · ตั้งค่า
สถานะการค้นด้วยความหมาย
เปิดไว้หรือยัง พร้อมใช้หรือยัง และสร้างไปถึงไหน
ทุกเส้นอยู่ใต้ https://api.intent-search.dev และยืนยันตัวตนด้วย Authorization: Bearer nsk_… · คีย์บอกเองว่าชุดข้อมูลไหน
ตัวอย่าง
curl "https://api.intent-search.dev/v1/vectors" \
-H "Authorization: Bearer $NS_KEY"คำตอบ
{
"enabled": true,
"ready": true,
"model": "bge-m3@q8",
"progress": null,
"phase": "ready",
"eta_seconds": null,
"pending": 0,
"stalled": null
}สิ่งที่ควรรู้
ตัวอย่างคำตอบด้านบนคือชุดข้อมูลที่เปิดและสร้างเสร็จแล้ว ชุดที่ยังไม่เปิดได้ enabled: false ready: false และคีย์อื่นทุกตัวเป็น null — pending ด้วย ไม่ใช่ 0
enabled คือขอไว้แล้ว ready คือใช้ได้แล้ว — ช่องว่างระหว่างสองอย่างคือเวลาที่โมเดลกำลังอ่านระเบียน (progress บอกว่าไปถึงไหน) ระหว่างนั้นการค้นด้วยคำตอบตามปกติ
eta_seconds คือเวลาที่เหลือโดยประมาณระหว่างสร้างครั้งแรก วัดจากความเร็วจริงของงานนี้ · เป็น null จนกว่าจะวัดได้
pending คือระเบียนที่ส่งมาหลังพร้อมแล้วและกำลังรอเวกเตอร์ ระบบเติมให้เองในดัชนีที่ใช้อยู่ ปกติภายในไม่กี่วินาที ระหว่างนั้นระเบียนเหล่านี้ค้นด้วยคำเจอ แต่การค้นด้วยความหมายยังข้ามไป · เป็น null ระหว่างสร้างครั้งแรกหรือเมื่อปิดอยู่
stalled เป็น null เมื่องานเดินปกติ ถ้างานหยุดเกินหนึ่งนาทีจะเป็น { reason, since, message } — reason คือ worker_offline model_unavailable model_mismatch engine_unavailable หรือ engine_refused ทุกเหตุอยู่ฝั่งเรา ฝั่งคุณไม่ต้องทำอะไร ไม่มีอะไรหาย และการค้นยังตอบด้วยคำ
รอด้วยโปรแกรม: เรียกเส้นนี้ทุก 5–10 วินาทีจน ready เป็น true (ใช้ eta_seconds ตั้งเวลารอได้) · ถ้าเจอ stalled ให้ห่างการเรียกเป็นทุกหนึ่งนาที งานเดินต่อเองเมื่อสาเหตุหาย
PUT /v1/vectorsเปิดหรือปิดการค้นด้วยความหมาย