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 filesrag_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 ถูกอัปเดต
ความคิดเห็น
กำลังโหลดความคิดเห็น...