Tools: rag_list + rag_search_files — สำรวจ registered files แบบ deterministic

ภาพประกอบ: Tools: rag_list + rag_search_files — สำรวจ registered files แบบ deterministic

MCP-RagMax แยกการ “สำรวจคลัง” ออกจาก retrieval เชิงเนื้อหาเป็นสอง tool เล็กๆ ที่ deterministic: rag_list และ rag_search_files

rag_list

ใช้ดูไฟล์ที่ register อยู่ใน knowledge base จริง รองรับ limit และ offset เพื่อแบ่งหน้า ไม่อ่านเนื้อหาและไม่เรียก LLM

เหมาะกับคำถามอย่าง:

ตอนนี้ KB มีไฟล์อะไรบ้าง
มีทั้งหมดกี่ไฟล์
ขอดูหน้าถัดไปของรายการไฟล์

ผลลัพธ์อิง registry ไม่ใช่การ find ทั้ง filesystem ดังนั้นจะไม่เผยไฟล์นอกขอบเขต source ที่ MCP-RagMax จัดการ

rag_search_files

ใช้ค้นชื่อไฟล์ใน registry แบบ case-insensitive โดยส่ง query และ limit

เหมาะเมื่อรู้ส่วนหนึ่งของชื่อไฟล์ เช่น policy, manual, สัญญา แล้วอยากหา candidate ก่อนเรียก rag_read_file

ต่างจาก rag_retrieve อย่างไร

  • rag_list — สำรวจรายการ registered files
  • rag_search_files — ค้น ชื่อไฟล์
  • rag_retrieve — ค้น เนื้อหา/ความหมาย ผ่าน Dense + BM25 + RRF

แยก contract แบบนี้ช่วยให้ caller agent ไม่ต้องใช้ retrieval pipeline เต็มเมื่อโจทย์แค่ต้องการหาไฟล์จากชื่อ

Registry คือ safety boundary

ทั้งสอง tool เห็นเฉพาะ path ที่ build pipeline ยอมรับและ register แล้ว จึงไม่กลายเป็นช่องทางสำรวจ arbitrary path บน Mac

หากไฟล์เพิ่งถูกเพิ่มลง workspace/knowledge/ แต่ยังไม่ได้ build มันจะยังไม่ปรากฏในรายการนี้จนกว่า build จะเสร็จและ registry ถูกอัปเดต

อ่านต่อ

ความคิดเห็น

กำลังโหลดความคิดเห็น...