सामग्री पर जाएँ

Maguyva कैसे काम करता है

एक GitHub रिपॉज़िटरी कनेक्ट करें और Maguyva उसे कई ऐसे सर्चेबल व्यू में बदल देता है जिन्हें आपका एजेंट माँग पर इस्तेमाल कर सकता है। पूरी फ़ाइलों को कॉन्टेक्स्ट में डालने के बजाय, मॉडल को सिंबल्स, स्ट्रक्चर, डॉक्स, डिपेंडेंसीज़, और रैंक्ड कोड फ़्रैगमेंट्स तक ग्राउंडेड एक्सेस मिलती है।

कॉन्टेक्स्ट की समस्या#

जैसे-जैसे आपके प्रोजेक्ट बढ़ते हैं, AI एजेंट्स इनसे जूझते हैं:

  • कॉन्टेक्स्ट विंडो की सीमाएँ - बहुत ज़्यादा जानकारी AI मॉडल्स को अभिभूत कर देती है
  • अप्रासंगिक डेटा - AI एजेंट्स अनावश्यक जानकारी पर टोकन बर्बाद करते हैं
  • ख़राब परफ़ॉर्मेंस - सटीकता में कमी और धीमी प्रोसेसिंग
  • मैन्युअल मैनेजमेंट - डेवलपर्स कॉन्टेक्स्ट को मैन्युअली व्यवस्थित करने में घंटों बिताते हैं
  • ज़्यादा लागत - कॉन्टेक्स्ट मैनेजमेंट के बिना, हर क्वेरी के साथ टोकन लागत बढ़ती जाती है

प्रोजेक्ट जितना बड़ा होता जाता है, कॉन्टेक्स्ट विंडो में उतना ही ज़्यादा शोर घुसता है — और इसके नतीजे में एजेंट की सटीकता घटती जाती है।

Maguyva का समाधान#

जब आप कोई रिपॉज़िटरी कनेक्ट करते हैं, तो Maguyva कोड, डॉक्स, मैनिफ़ेस्ट, सिंबल्स, और डिपेंडेंसी मेटाडेटा पर क्लाउड इनजेशन पाइपलाइन्स चलाता है। मक़सद यह है कि टिकाऊ कोड मेमोरी एक बार बना ली जाए, न कि हर एजेंट रन को रिपो को शुरू से फिर से खोजना पड़े।

ये पाइपलाइन्स कई विशेषज्ञ डेटा लेयर्स बनाती हैं: सटीक टेक्स्ट सर्च, सिमेंटिक रिट्रीवल, सिंबल और रेफ़रेंस लुकअप, स्ट्रक्चरल व्यू, और डिपेंडेंसी ग्राफ़ एनालिसिस। अलग-अलग सवाल अलग-अलग लेयर्स पर रूट होते हैं।

सर्च 5 रिट्रीवल मोड्स को जोड़ता है: semantic, AST, symbol, dependency, और text। नतीजों को फ़्यूज़ और रैंक किया जाता है ताकि ज़रूरी सिंबल्स कम-मूल्य वाले हेल्पर्स से पहले सामने आएँ।

प्राइवेट रिपॉज़िटरी व्यू, सपोर्टेड भाषाएँ और टेक्स्ट-आधारित तकनीकें के लिए पब्लिक रेफ़रेंस डेटा के साथ मौजूद रहते हैं। आपका एजेंट MCP टूल्स के ज़रिए पूरे सिस्टम तक पहुँचता है, जिन पर आप प्लानिंग और वैलिडेशन के दौरान भारी भरोसा कर सकते हैं या एडिटिंग के दौरान स्पॉट-चेक के तौर पर इस्तेमाल कर सकते हैं।

1. रिपॉज़िटरी इनजेशन#

GitHub कनेक्ट होने के बाद, Maguyva क्लाउड में रिपॉज़िटरी को स्कैन करता है और उन हिस्सों को एक्सट्रैक्ट करता है जिन पर एजेंट को असल में तर्क करना होता है:

  • कोड स्ट्रक्चर एनालिसिस
     - फ़ाइलों को सिंबल्स, रेफ़रेंस, और आर्किटेक्चरल सीमाओं में पार्स करता है
  • डिपेंडेंसी रिज़ॉल्यूशन
     - यह मैप करता है कि फ़ाइलें, मॉड्यूल, और सिंबल्स एक-दूसरे पर कैसे निर्भर हैं
  • डॉक्यूमेंटेशन इंटीग्रेशन - कोड के साथ-साथ रिपॉज़िटरी डॉक्स और संबंधित रेफ़रेंस सामग्री भी लाता है

2. विशेषज्ञ रिट्रीवल लेयर्स#

एक जेनेरिक इंडेक्स के बजाय, Maguyva कई रिट्रीवल सरफ़ेस बनाता है जो अलग-अलग सवालों के जवाब तेज़ी से और अलग-अलग साक्ष्यों के साथ देते हैं:

कॉन्टेक्स्ट बजट: Maguyva पूरी फ़ाइलों को कॉन्टेक्स्ट में डालने के बजाय, फ़ाइल पाथ और लाइन नंबर के साथ रैंक्ड कोड फ़्रैगमेंट लौटाता है। असल टोकन कमी रिपॉज़िटरी के आकार और क्वेरी की विशिष्टता पर निर्भर करती है।

राउटिंग और रैंकिंग#

  • रेलिवेंस स्कोरिंग
     - सही रिट्रीवल मोड चुनता है और ज़रूरी नतीजों को पहले ऊपर लाता है
  • नॉइज़ रिडक्शन - बॉयलरप्लेट, दोहराए गए हिस्सों, और कम-मूल्य वाले मैच हटा देता है
  • कॉन्टेक्स्ट प्रायोरिटाइज़ेशन - नतीजों को इस तरह क्रमबद्ध करता है कि एजेंट को कोर सिंबल्स एज-केस हेल्पर्स से पहले दिखें

स्टोर्ड रिप्रेज़ेंटेशन्स#

  • सिमेंटिक रिट्रीवल
     - शब्द अलग होने पर भी वैचारिक रूप से मिलते-जुलते कोड और डॉक्स ढूँढ़ता है
  • सिंबल और स्ट्रक्चरल व्यू - सटीक सिंबल लुकअप, रेफ़रेंस, और AST-आधारित सवालों को सपोर्ट करता है
  • डिपेंडेंसी ग्राफ़ एनालिसिस
     - कोडबेस भर में कॉलर्स, इम्पोर्ट्स, और इम्पैक्ट रेडियस को ट्रेस करता है

3. मॉडल कॉन्टेक्स्ट प्रोटोकॉल (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। सभी 11 टूल्स के लिए पूरा MCP API रेफ़रेंस देखें।

MCP कम्पैटिबिलिटी के फ़ायदे#

  • ज़्यादा या कम टूलिंग इस्तेमाल करें - प्लानिंग के दौरान Maguyva पर भारी भरोसा करें या बस किसी जोखिम भरे बदलाव को सैनिटी-चेक करने के लिए इस्तेमाल करें
  • बेहतर प्लान वैलिडेशन - एडिटिंग से पहले आइडियाज़ को असली सिंबल्स, रेफ़रेंस, और डॉक्स के साथ क्रॉस-चेक करें
  • साफ़ ब्लास्ट रेडियस - डिपेंडेंसी और ग्राफ़ टूल्स दिखाते हैं कि किसी सिंबल के बदलने पर क्या टूट सकता है
  • फ़ॉरवर्ड-कम्पैटिबल - MCP स्टैंडर्ड को सपोर्ट करने वाले किसी भी क्लाइंट के साथ काम करता है

तकनीकी आर्किटेक्चर#

सुरक्षित प्रोसेसिंग पाइपलाइन#

सुरक्षा सुविधाएँ#

  • ट्रांसपोर्ट सिक्योरिटी - सेवा से कनेक्शन HTTPS/TLS का इस्तेमाल करते हैं
  • मैनेज्ड स्टोरेज - इंडेक्स्ड डेटा को मैनेज्ड इन्फ्रास्ट्रक्चर पर स्टोरेज-लेवल एन्क्रिप्शन के साथ रेस्ट में स्टोर किया जाता है
  • नेमस्पेस आइसोलेशन - रिपॉज़िटरी डेटा को पाइपलाइन और डेटाबेस क्वेरी पाथ के ज़रिए वर्कस्पेस और नेमस्पेस के अनुसार सीमित किया जाता है
  • एक्सेस कंट्रोल्स - रिपॉज़िटरी एक्सेस संगठन और नेमस्पेस की सीमाओं से नियंत्रित होता है

परफ़ॉर्मेंस विशेषताएँ#

परफ़ॉर्मेंस कोडबेस के आकार और क्वेरी की जटिलता के अनुसार अलग-अलग होती है। Maguyva पूरी फ़ाइलें डंप करने के बजाय सबसे प्रासंगिक कॉन्टेक्स्ट देने पर ध्यान देता है। सपोर्टेड भाषाओं और क्लाइंट्स के लिए कम्पैटिबिलिटी देखें।

क्या उम्मीद करें#

आपकी कोडबेस के कॉन्टेक्स्ट को समझदारी से फ़िल्टर और व्यवस्थित करके, Maguyva AI एजेंट्स को ज़्यादा कुशलता से काम करने में मदद करता है:

  • बेहतर प्लानिंग सटीकता - एजेंट कोडिंग शुरू करने से पहले किसी तरीक़े को असली रिपॉज़िटरी के आधार पर वैलिडेट कर सकते हैं
  • ज़्यादा सुरक्षित रीफ़ैक्टर - ब्लास्ट-रेडियस और डिपेंडेंसी चेक टालने-लायक़ नुक़सान को कम करते हैं
  • कम टोकन बर्बादी - पूरी फ़ाइलों के बजाय सिर्फ़ प्रासंगिक फ़्रैगमेंट लौटाए जाते हैं
  • तेज़ रिपो समझ - मॉडल को हर रन में प्रोजेक्ट स्ट्रक्चर फिर से खोजने के बजाय जल्दी ग्राउंडेड जवाब मिलते हैं

नतीजे आपकी कोडबेस के आकार, जटिलता, और आपका AI एजेंट किस तरह की क्वेरी हैंडल करता है, इस पर निर्भर करते हुए अलग-अलग होते हैं।

अपना इंडेक्स अप-टू-डेट रखना#

ऑटोमैटिक अपडेट्स#

  • रिपॉज़िटरी सिंक - कोड में बदलाव होने पर GitHub सिंक जॉब्स से रीफ़्रेश होता है
  • इन्क्रीमेंटल प्रोसेसिंग - दक्षता के लिए सिर्फ़ बदली हुई फ़ाइलों को प्रोसेस करता है
  • ब्रांच-अवेयर कॉन्टेक्स्ट - हर git ब्रांच के लिए अलग इंडेक्स बनाए रखता है ताकि एजेंट्स को हर ब्रांच के लिए सही कॉन्टेक्स्ट मिले

शुरुआत करें#

आज़माने के लिए तैयार हैं?

  1. Free से शुरू करें - क्रेडिट कार्ड की ज़रूरत नहीं
  2. अपनी रिपॉज़िटरी कनेक्ट करें - Maguyva पोर्टल में एक GitHub रिपो लिंक करें
  3. अपने एजेंट को Maguyva की ओर पॉइंट करें - प्लानिंग, चेकिंग, या एडिटिंग के दौरान MCP टूल्स इस्तेमाल करें (इंस्टॉलेशन गाइड)

Free से शुरू करें →

रिपॉज़िटरी मैनेजमेंट#

Maguyva पोर्टल के ज़रिए अपनी GitHub रिपॉज़िटरीज़ कनेक्ट करें। कोड में बदलाव होने पर प्लेटफ़ॉर्म GitHub सिंक जॉब्स से इंडेक्स रीफ़्रेश करता है, जिससे हर ब्रांच के लिए MCP टूल लेयर अप-टू-डेट बनी रहती है। पोर्टल बेसिक API उपयोग की जानकारी भी देता है, और ज़्यादा विस्तृत एनालिटिक्स रोडमैप पर हैं।