تخطَّ إلى المحتوى

كيف يعمل Maguyva

اربط مستودع GitHub، وسيحوّله Maguyva إلى عدة طرق عرض قابلة للبحث يمكن لوكيلك استخدامها عند الطلب. بدلًا من إغراق السياق بملفات كاملة، يحصل النموذج على وصول مرتكز إلى الرموز والبنية والوثائق والتبعيات ومقتطفات الشيفرة المرتَّبة.

مشكلة السياق#

مع نمو مشاريعك، تواجه وكلاء الذكاء الاصطناعي صعوبة في:

  • قيود نافذة السياق - كثرة المعلومات تُثقل كاهل نماذج الذكاء الاصطناعي
  • بيانات غير ذات صلة - تهدر وكلاء الذكاء الاصطناعي الرموز (tokens) على معلومات غير ضرورية
  • أداء ضعيف - دقة أقل وأوقات معالجة أبطأ
  • إدارة يدوية - يقضي المطوّرون ساعات في تنظيم السياق يدويًا
  • تكاليف أعلى - دون إدارة للسياق، ترتفع تكاليف الرموز مع كل استعلام

كلما كبر المشروع، دخل قدر أكبر من الضجيج إلى نافذة السياق — وتنخفض دقة الوكيل نتيجة لذلك.

حل Maguyva#

حين تربط مستودعًا، يشغّل Maguyva خطوط استيعاب سحابية على الشيفرة والوثائق وملفات البيان والرموز وبيانات التبعيات الوصفية. الهدف هو بناء ذاكرة شيفرة دائمة مرة واحدة، بدلًا من جعل كل تشغيل للوكيل يعيد اكتشاف المستودع من الصفر.

تنتج خطوط المعالجة تلك عدة طبقات بيانات متخصصة: البحث النصي الدقيق، والاسترجاع الدلالي، والبحث عن الرموز والمراجع، والعروض البنيوية، وتحليل الرسم البياني للتبعيات. تُوجَّه الأسئلة المختلفة إلى طبقات مختلفة.

يجمع البحث بين 5 أنماط استرجاع: semantic وAST وsymbol وdependency وtext. تُدمَج النتائج وتُرتَّب بحيث تظهر الرموز المهمة قبل الدوال المساعدة الأقل قيمة.

توجد طرق عرض المستودع الخاص جنبًا إلى جنب مع بيانات مرجعية عامة لـلغات وتقنيات نصية المدعومة. يصل وكيلك إلى النظام بأكمله عبر أدوات MCP، التي يمكنك الاعتماد عليها بكثافة أثناء التخطيط والتحقق، أو استخدامها كفحوصات سريعة أثناء التحرير.

1. استيعاب المستودع#

بعد ربط GitHub، يفحص Maguyva المستودع في السحابة ويستخلص الأجزاء التي يحتاجها الوكيل فعليًا للاستدلال حولها:

  • تحليل بنية الشيفرة
     - يحلّل الملفات إلى رموز ومراجع وحدود معمارية
  • حل التبعيات
     - يرسم كيفية اعتماد الملفات والوحدات والرموز على بعضها البعض
  • دمج التوثيق - يستقطب وثائق المستودع والمواد المرجعية ذات الصلة جنبًا إلى جنب مع الشيفرة

2. طبقات الاسترجاع المتخصصة#

بدلًا من فهرس عام واحد، يبني Maguyva عدة واجهات استرجاع تجيب عن أسئلة مختلفة بسرعة وبأدلة مختلفة:

ميزانية السياق: يعيد Maguyva مقتطفات شيفرة مرتَّبة مع مسارات الملفات وأرقام الأسطر، بدلًا من إغراق السياق بملفات كاملة. مقدار تخفيض الرموز (tokens) الفعلي يعتمد على حجم المستودع ومدى تحديد الاستعلام.

التوجيه والترتيب#

  • تقييم الصلة
     - يختار نمط الاسترجاع المناسب ويرفع النتائج المهمة أولاً
  • تقليل الضجيج - يزيل الشيفرة النمطية المكرَّرة، والمقاطع الزائدة، والتطابقات منخفضة القيمة
  • ترتيب أولوية السياق - يرتّب النتائج بحيث يرى الوكيل الرموز الأساسية قبل الدوال المساعدة للحالات الحدّية

التمثيلات المخزَّنة#

  • الاسترجاع الدلالي
     - يجد شيفرة ووثائق متشابهة من حيث المفهوم حتى لو اختلفت الكلمات الحرفية
  • عروض الرموز والبنية - يدعم البحث الدقيق عن الرموز، والمراجع، والأسئلة المرتبطة بشكل 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 كأدوات مساندة. راجع مرجع واجهة MCP البرمجية الكامل للاطّلاع على الأدوات الإحدى عشرة كلّها.

فوائد التوافق مع MCP#

  • استخدم الأدوات بقدر ما تشاء - اعتمد على Maguyva بكثافة أثناء التخطيط، أو استخدمه فقط للتحقق السريع من تعديل محفوف بالمخاطر
  • تحقق أفضل من الخطة - قارن أفكارك بالرموز والمراجع والوثائق الفعلية قبل التحرير
  • نطاق تأثير أوضح - تُظهر أدوات التبعيات والرسم البياني ما قد يتعطّل إذا تغيّر أحد الرموز
  • متوافق مع المستقبل - يعمل مع أي عميل يدعم معيار MCP

العمارة التقنية#

خط المعالجة الآمن#

ميزات الأمان#

  • أمان النقل - تستخدم الاتصالات بالخدمة بروتوكول HTTPS/TLS
  • تخزين مُدار - تُخزَّن البيانات المفهرَسة على بنية تحتية مُدارة مع تشفير على مستوى التخزين أثناء السكون
  • عزل مساحات الأسماء - تُحصَر بيانات المستودع حسب مساحة العمل ومساحة الاسم عبر مسارات خط المعالجة واستعلامات قاعدة البيانات
  • ضوابط الوصول - يُقيَّد الوصول إلى المستودع بحدود المؤسسة ومساحة الاسم

خصائص الأداء#

يختلف الأداء حسب حجم قاعدة الشيفرة وتعقيد الاستعلام. يركّز Maguyva على تقديم السياق الأكثر صلة بدلًا من إغراق السياق بملفات كاملة. راجع التوافق للاطلاع على اللغات والعملاء المدعومين.

ما الذي يمكن توقعه#

من خلال تصفية سياق قاعدة شيفرتك وتنظيمه بذكاء، يساعد Maguyva وكلاء الذكاء الاصطناعي على العمل بكفاءة أكبر:

  • دقة تخطيط أفضل - يمكن للوكلاء التحقق من صحة النهج مقابل المستودع الفعلي قبل البدء في كتابة الكود
  • إعادة هيكلة أكثر أمانًا - تقلل فحوصات نطاق التأثير والتبعيات من الأعطال التي يمكن تفاديها
  • هدر أقل للرموز - يتم إرجاع الأجزاء ذات الصلة فقط بدلاً من الملفات كاملةً
  • فهم أسرع للمستودع - يحصل النموذج على إجابات مستندة إلى الكود بسرعة بدلاً من إعادة اكتشاف بنية المشروع في كل تشغيل

تختلف النتائج باختلاف حجم قاعدة شيفرتك، وتعقيدها، وأنواع الاستعلامات التي يتعامل معها وكيل الذكاء الاصطناعي لديك.

إبقاء فهرسك محدَّثًا#

التحديثات التلقائية#

  • مزامنة المستودع - يُحدَّث من مهام مزامنة GitHub مع تغيّر الشيفرة
  • معالجة تراكمية - يعالج الملفات المتغيّرة فقط تحقيقًا للكفاءة
  • سياق واعٍ بالفروع - يحافظ على فهارس منفصلة لكل فرع git بحيث يرى الوكلاء السياق الصحيح لكل فرع

البدء#

مستعد لتجربته؟

  1. ابدأ مجانًا - لا حاجة إلى بطاقة ائتمان
  2. اربط مستودعك - اربط مستودع GitHub في بوابة Maguyva
  3. وجّه وكيلك نحو Maguyva - استخدم أدوات MCP أثناء التخطيط أو الفحص أو التحرير (دليل التثبيت)

ابدأ مجانًا ←

إدارة المستودع#

اربط مستودعات GitHub الخاصة بك عبر بوابة Maguyva. تُحدِّث المنصة الفهارس من مهام مزامنة GitHub مع تغيّر الشيفرة، مما يبقي طبقة أدوات MCP محدَّثة لكل فرع. توفّر البوابة أيضًا رؤية أساسية لاستخدام الواجهة البرمجية (API)، مع تحليلات أكثر تفصيلاً على خارطة الطريق.