Tool: rag_files list / search — สำรวจ registered files แบบ deterministic

MCP-RagMax แยกการ “สำรวจคลัง” ออกจาก retrieval เชิงเนื้อหาผ่าน tool เดียวคือ rag_files ที่เลือกงานด้วย action โดยสองงานแรกคือ action="list" และ action="search" (ส่วน action="read" อ่านไฟล์ ดู Tool: rag_files read) ทุกงาน deterministic
rag_files(action="list")
ใช้ดูไฟล์ที่ register อยู่ใน knowledge base จริง รองรับ limit และ offset เพื่อแบ่งหน้า ไม่อ่านเนื้อหาและไม่เรียก LLM
เหมาะกับคำถามอย่าง:
ตอนนี้ KB มีไฟล์อะไรบ้าง
มีทั้งหมดกี่ไฟล์
ขอดูหน้าถัดไปของรายการไฟล์
ผลลัพธ์อิง registry ไม่ใช่การ find ทั้ง filesystem ดังนั้นจะไม่เผยไฟล์นอกขอบเขต source ที่ MCP-RagMax จัดการ
rag_files(action="search")
ใช้ค้นชื่อไฟล์ใน registry แบบ case-insensitive โดยส่ง query และ limit
เหมาะเมื่อรู้ส่วนหนึ่งของชื่อไฟล์ เช่น policy, manual, สัญญา แล้วอยากหา candidate ก่อนเรียก rag_files(action="read")
ต่างจาก rag_retrieve อย่างไร
rag_files(action="list")— สำรวจรายการ registered filesrag_files(action="search")— ค้น ชื่อไฟล์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 ถูกอัปเดต
ความคิดเห็น
กำลังโหลดความคิดเห็น...