ข้ามไปที่เนื้อหา

Maguyva ทำงานอย่างไร

เชื่อมต่อรีโพซิทอรี GitHub แล้ว Maguyva จะเปลี่ยนมันให้เป็นมุมมองที่ค้นหาได้หลายแบบซึ่งเอเจนต์ของคุณเรียกใช้ได้ตามต้องการ แทนที่จะยัดทั้งไฟล์ลงในบริบท โมเดลจะได้เข้าถึงสัญลักษณ์ โครงสร้าง เอกสาร การพึ่งพา และชิ้นส่วนโค้ดที่จัดอันดับแล้วอย่างมีหลักฐานอ้างอิงจริง

ปัญหาเรื่องบริบท#

เมื่อโปรเจกต์ของคุณใหญ่ขึ้น เอเจนต์ AI จะเจอปัญหาต่อไปนี้:

  • ข้อจำกัดของคอนเท็กซ์วินโดว์ - ข้อมูลมากเกินไปทำให้โมเดล AI รับมือไม่ไหว
  • ข้อมูลที่ไม่เกี่ยวข้อง - เอเจนต์ AI เสียโทเคนไปกับข้อมูลที่ไม่จำเป็น
  • ประสิทธิภาพต่ำ - ความแม่นยำลดลงและประมวลผลช้าลง
  • การจัดการด้วยมือ - นักพัฒนาต้องเสียเวลาหลายชั่วโมงจัดระเบียบบริบทด้วยตัวเอง
  • ต้นทุนที่สูงขึ้น - หากไม่มีการจัดการบริบท ต้นทุนโทเคนจะเพิ่มขึ้นทุกครั้งที่ค้นหา

ยิ่งโปรเจกต์ใหญ่ขึ้นเท่าไร ก็ยิ่งมีสัญญาณรบกวนเข้ามาในคอนเท็กซ์วินโดว์มากขึ้นเท่านั้น — และความแม่นยำของเอเจนต์ก็ลดลงตามไปด้วย

ทางแก้ของ Maguyva#

เมื่อคุณเชื่อมต่อรีโพซิทอรี Maguyva จะรันไพพ์ไลน์นำเข้าบนคลาวด์กับโค้ด เอกสาร แมนิเฟสต์ สัญลักษณ์ และเมทาดาทาการพึ่งพา เป้าหมายคือสร้างความทรงจำโค้ดที่คงทนเพียงครั้งเดียว แทนที่จะให้เอเจนต์แต่ละรอบต้องค้นพบรีโพซิทอรีใหม่ตั้งแต่ต้นทุกครั้ง

ไพพ์ไลน์เหล่านั้นสร้างเลเยอร์ข้อมูลเฉพาะทางหลายชั้น: การค้นหาข้อความแบบตรงตัว การสืบค้นเชิงความหมาย การค้นหาสัญลักษณ์และการอ้างอิง มุมมองเชิงโครงสร้าง และการวิเคราะห์กราฟการพึ่งพา คำถามที่ต่างกันจะถูกส่งไปยังเลเยอร์ที่ต่างกัน

การค้นหารวม 5 โหมดการสืบค้นเข้าด้วยกัน: semantic AST symbol dependency และtext ผลลัพธ์จะถูกผสานและจัดอันดับ เพื่อให้สัญลักษณ์สำคัญโผล่ขึ้นมาก่อนฟังก์ชันช่วยเหลือที่มีคุณค่าต่ำ

มุมมองรีโพซิทอรีส่วนตัวอยู่เคียงข้างข้อมูลอ้างอิงสาธารณะสำหรับ ภาษาและเทคโนโลยีที่ใช้ข้อความเป็นฐาน ที่รองรับ เอเจนต์ของคุณเข้าถึงระบบทั้งหมดผ่านเครื่องมือ MCP ซึ่งคุณจะพึ่งพาอย่างหนักระหว่างวางแผนและตรวจสอบ หรือใช้เป็นจุดตรวจสอบระหว่างแก้ไขก็ได้

1. การนำเข้ารีโพซิทอรี#

หลังจากเชื่อมต่อ GitHub แล้ว Maguyva จะสแกนรีโพซิทอรีบนคลาวด์และสกัดส่วนที่เอเจนต์ต้องใช้ในการให้เหตุผลจริงๆ ออกมา:

  • การวิเคราะห์โครงสร้างโค้ด
     - แยกวิเคราะห์ไฟล์ออกเป็นสัญลักษณ์ การอ้างอิง และขอบเขตทางสถาปัตยกรรม
  • การไขปัญหาการพึ่งพา
     - ทำแผนที่ว่าไฟล์ โมดูล และสัญลักษณ์พึ่งพากันอย่างไร
  • การผนวกรวมเอกสาร - ดึงเอกสารของรีโพซิทอรีและเอกสารอ้างอิงที่เกี่ยวข้องมาไว้คู่กับโค้ด

2. เลเยอร์การสืบค้นเฉพาะทาง#

แทนที่จะมีดัชนีทั่วไปเพียงหนึ่งเดียว Maguyva สร้างพื้นผิวการสืบค้นหลายแบบที่ตอบคำถามต่างกันได้อย่างรวดเร็วและด้วยหลักฐานที่ต่างกัน:

งบประมาณบริบท: Maguyva ส่งคืนชิ้นส่วนโค้ดที่จัดอันดับแล้วพร้อมพาธไฟล์และหมายเลขบรรทัด แทนที่จะยัดทั้งไฟล์ลงในบริบท การลดโทเคนจริงขึ้นอยู่กับขนาดรีโพซิทอรีและความเจาะจงของคำค้นหา

การจัดเส้นทางและจัดอันดับ#

  • การให้คะแนนความเกี่ยวข้อง
     - เลือกโหมดการสืบค้นที่เหมาะสม และยกผลลัพธ์สำคัญขึ้นมาก่อน
  • การลดสัญญาณรบกวน - ตัดโค้ดซ้ำซาก ชิ้นส่วนที่ซ้ำกัน และผลลัพธ์ที่มีคุณค่าต่ำออก
  • การจัดลำดับความสำคัญของบริบท - จัดเรียงผลลัพธ์ให้เอเจนต์เห็นสัญลักษณ์หลักก่อนฟังก์ชันช่วยเหลือกรณีขอบ

รูปแบบข้อมูลที่จัดเก็บ#

  • การสืบค้นเชิงความหมาย
     - ค้นหาโค้ดและเอกสารที่มีแนวคิดคล้ายกัน แม้คำจะต่างกัน
  • มุมมองสัญลักษณ์และเชิงโครงสร้าง - รองรับการค้นหาสัญลักษณ์แบบตรงตัว การอ้างอิง และคำถามเชิงรูปทรง AST
  • การวิเคราะห์กราฟการพึ่งพา
     - ตามรอยผู้เรียกใช้ การอิมพอร์ต และรัศมีผลกระทบทั่วทั้งโค้ดเบส

3. เลเยอร์เครื่องมือ Model Context Protocol (MCP)#

Maguyva ถูกส่งมอบในรูปแบบเซิร์ฟเวอร์ MCP ที่โฮสต์บนคลาวด์ เอเจนต์ของคุณเรียกใช้เครื่องมือตามมุมมองที่ต้องการ แทนที่จะพึ่งให้โมเดลจำสถาปัตยกรรมของคุณเองตั้งแต่ต้น สี่พื้นผิวด้านบนคือมุมมองแบบจัดกลุ่มของเครื่องมือที่เป็นรูปธรรม: การค้นหาเชิงความหมายครอบคลุม semantic_search และ intelligent_search; การค้นหาสัญลักษณ์ครอบคลุม find_symbol และ get_task_context; การค้นหาเชิงโครงสร้างครอบคลุม structural_search และ text_pattern_search; กราฟการพึ่งพาครอบคลุม dependency_search และ analyze_dependencies — ควบคู่กับ get_file, repository_context, และ ask_maguyva ในฐานะยูทิลิตีสนับสนุน ดู เอกสารอ้างอิง MCP API ฉบับเต็มสำหรับเครื่องมือทั้ง 11 รายการ

ประโยชน์ของความเข้ากันได้กับ MCP#

  • ใช้เครื่องมือมากหรือน้อยตามต้องการ - พึ่งพา Maguyva อย่างหนักตอนวางแผน หรือใช้แค่ตรวจสอบความสมเหตุสมผลของการเปลี่ยนแปลงที่มีความเสี่ยงก็ได้
  • ตรวจสอบแผนได้ดีขึ้น - ตรวจสอบไอเดียกับสัญลักษณ์ การอ้างอิง และเอกสารจริง ก่อนแก้ไข
  • รัศมีผลกระทบที่ชัดเจนขึ้น - เครื่องมือด้านการพึ่งพาและกราฟแสดงให้เห็นว่าอะไรอาจพังถ้าสัญลักษณ์เปลี่ยนแปลง
  • รองรับอนาคต - ทำงานได้กับไคลเอนต์ใดก็ตามที่รองรับมาตรฐาน MCP

สถาปัตยกรรมทางเทคนิค#

ไพพ์ไลน์ประมวลผลที่ปลอดภัย#

คุณสมบัติด้านความปลอดภัย#

  • ความปลอดภัยของการส่งข้อมูล - การเชื่อมต่อกับบริการใช้ HTTPS/TLS
  • พื้นที่จัดเก็บที่มีการจัดการ - ข้อมูลที่ถูกอินเด็กซ์ถูกจัดเก็บบนโครงสร้างพื้นฐานที่มีการจัดการ พร้อมการเข้ารหัสระดับพื้นที่จัดเก็บขณะพัก
  • การแยกเนมสเปซ - ข้อมูลรีโพซิทอรีถูกจำกัดขอบเขตด้วยเวิร์กสเปซและเนมสเปซตลอดเส้นทางไพพ์ไลน์และการสืบค้นฐานข้อมูล
  • การควบคุมการเข้าถึง - การเข้าถึงรีโพซิทอรีถูกจำกัดด้วยขอบเขตองค์กรและเนมสเปซ

คุณลักษณะด้านประสิทธิภาพ#

ประสิทธิภาพแตกต่างกันไปตามขนาดโค้ดเบสและความซับซ้อนของคำค้นหา Maguyva มุ่งเน้นการส่งมอบบริบทที่เกี่ยวข้องที่สุด แทนที่จะยัดทั้งไฟล์ลงไป ดู ความเข้ากันได้ สำหรับภาษาและไคลเอนต์ที่รองรับ

สิ่งที่คาดหวังได้#

ด้วยการกรองและจัดระเบียบบริบทโค้ดเบสของคุณอย่างชาญฉลาด Maguyva ช่วยให้เอเจนต์ AI ทำงานได้อย่างมีประสิทธิภาพมากขึ้น:

  • ความแม่นยำในการวางแผนที่ดีขึ้น - เอเจนต์ตรวจสอบแนวทางกับรีโพซิทอรีจริงได้ ก่อนเริ่มเขียนโค้ด
  • การรีแฟกเตอร์ที่ปลอดภัยขึ้น - การตรวจสอบรัศมีผลกระทบและการพึ่งพาช่วยลดความเสียหายที่ป้องกันได้
  • เสียโทเคนน้อยลง - ส่งคืนเฉพาะชิ้นส่วนที่เกี่ยวข้อง แทนที่จะเป็นทั้งไฟล์
  • เข้าใจรีโพเร็วขึ้น - โมเดลได้คำตอบที่มีหลักฐานอ้างอิงอย่างรวดเร็ว แทนที่จะต้องค้นพบโครงสร้างโปรเจกต์ใหม่ทุกรอบ

ผลลัพธ์จะแตกต่างกันไปตามขนาด ความซับซ้อนของโค้ดเบส และประเภทคำค้นหาที่เอเจนต์ AI ของคุณจัดการ

การรักษาดัชนีของคุณให้ทันสมัย#

การอัปเดตอัตโนมัติ#

  • การซิงค์รีโพซิทอรี - รีเฟรชจากงานซิงค์ GitHub เมื่อโค้ดมีการเปลี่ยนแปลง
  • การประมวลผลแบบส่วนเพิ่ม - ประมวลผลเฉพาะไฟล์ที่เปลี่ยนแปลงเพื่อความมีประสิทธิภาพ
  • บริบทที่รู้จักแบรนช์ - รักษาดัชนีแยกกันตามแบรนช์ git เพื่อให้เอเจนต์เห็นบริบทที่ถูกต้องในแต่ละแบรนช์

เริ่มต้นใช้งาน#

พร้อมลองใช้แล้วหรือยัง?

  1. เริ่มต้นฟรี - ไม่ต้องใช้บัตรเครดิต
  2. เชื่อมต่อรีโพซิทอรีของคุณ - เชื่อมโยงรีโพ GitHub ในพอร์ทัลของ Maguyva
  3. ชี้เอเจนต์ของคุณไปที่ Maguyva - ใช้เครื่องมือ MCP ระหว่างวางแผน ตรวจสอบ หรือแก้ไข (คู่มือติดตั้ง)

เริ่มต้นใช้งานฟรี →

การจัดการรีโพซิทอรี#

เชื่อมต่อรีโพซิทอรี GitHub ของคุณผ่านพอร์ทัลของ Maguyva แพลตฟอร์มจะรีเฟรชดัชนีจากงานซิงค์ GitHub เมื่อโค้ดมีการเปลี่ยนแปลง ทำให้เลเยอร์เครื่องมือ MCP ทันสมัยอยู่เสมอในทุกแบรนช์ พอร์ทัลยังให้ข้อมูลการใช้งาน API เบื้องต้น โดยมีการวิเคราะห์เชิงลึกเพิ่มเติมอยู่ในแผนงาน