تخطَّ إلى المحتوى
cd /languages
  • الحوسبة الإحصائية
  • البرمجة
  • دعم AST والرموز

لغة R في Maguyva: رسوم بيانية لشيفرة التحليل والحزم

يدعم Maguyva لغة R بشجرة AST والرموز والرسم البياني، ليتمكن وكلاء الذكاء الاصطناعي من تتبّع الدوال وتوزيع S3 وS4 واستدعاءات ملاءمة النماذج عبر نصوص R وحزمها.

أين تُربك R أدوات الذكاء الاصطناعي السطحية

تضع R الدوال الأساسية ودوال الحزم ودوالّك أنت في فضاء أسماء مسطّح واحد. النقاط جزء من الأسماء وليست وصولًا إلى عضو: is.na وdata.frame وprint.summary_table معرّفات مفردة. والأداة التي تقرأ print.summary_table بوصفه تابعًا على print تخطئ في البنية، والأداة التي تسجّل كل استدعاء أساسي تدفن دوالّك تحت c() وpaste().

يحافظ Maguyva على أسماء R كاملة ويرشّح ضجيج الدوال الأساسية، فيرى الوكيل الدوال التي يعتمد عليها تحليلك فعلًا.

ما الذي يستخرجه Maguyva من R

يربط Maguyva ملفات .R و.Rmd و.Rnw بلغة R. تُستخرج الدوال المُسندة إلى اسم، مثل clean_survey <- function(df)، تحت ذلك الاسم، ولا تُعامل الدوال المجهولة بوصفها تعريفات. ولا تُقسَّم الأسماء المنقّطة أبدًا إلى مستقبِل وعضو.

تبقى بعض استدعاءات R الأساسية في الرسم البياني عن قصد لأنها تُظهر كيف تترابط شيفرة التحليل: توزيع S3 وS4 (UseMethod وstandardGeneric)، وعائلة apply (lapply وsapply وvapply وmapply)، وملاءمة النماذج (lm وpredict وanova)، وتحميل الحزم (library وrequire)، ومعالجة الأخطاء باستخدام tryCatch.

ويسجّل الرسم البياني أيضًا إنشاء النُسخ والقراءة والكتابة.

أمثلة على مطالبات الوكلاء

  • “من يستدعي clean_survey، وأي النماذج تستخدم مخرجاتها؟” (find_symbol ثم dependency_search في الاتجاه الوارد)
  • “ما الدوال التي تستدعي fit_model؟” (dependency_search)
  • “تتبّع المسار من load_raw_data إلى الانحدار النهائي.” (get_task_context)

القيود المعروفة

  • يُستبعد من العلاقات نحو 800 اسم من R الأساسية وstats وgraphics، مثل print وpaste وc وdata.frame واستدعاءات الرسم ومولّدات الأعداد العشوائية. استخدم text_pattern_search لها.
  • تنشئ R الفئات وتحمّل الحزم باستدعاءات دوال عادية، لذا لا تختار الإعدادات المسبقة classes وimports وvariables في structural_search شيئًا. استخدم find_symbol وtext_pattern_search.
  • تُقرأ ملفات .Rmd و.Rnw كاملة بقواعد R النحوية بدلًا من قراءتها مقطعًا مقطعًا، فتوقّع نتائج جزئية لمستندات R Markdown وSweave.
  • لا تملك R صيغة للمزخرفات، لذا تُعلَّم علاقات المزخرفات بأنها غير قابلة للتطبيق.

الخطوات التالية

اربط مستودعًا عبر دليل البدء السريع، ثم راجع مصفوفة الدعم في صفحة التوافق. ولمستودعات علم البيانات المختلطة، اقرأ أيضًا دليل لغة Python.

الأنسب لـ

  • > حزم R التي تضم دوالًا مُصدَّرة كثيرة وتوابع S3 ودوال مساعدة داخلية.
  • > خطوط التحليل الموزّعة على نصوص تتشارك دوال تنظيف البيانات والنمذجة.
  • > فرق البيانات التي تسلّم شيفرة R إلى وكلاء ذكاء اصطناعي يحتاجون إلى معرفة الدوال التي تغذّي كل نموذج.

سير عمل الوكلاء

  • > العثور على كل مستدعٍ لدالة تنظيف بيانات قبل تغيير الأعمدة التي تُرجعها.
  • > تتبّع الدوال التي توزّع عبر `UseMethod` وأين توجد توابعها.
  • > رسم خريطة للمسار من تحميل البيانات الخام إلى النموذج المُلاءَم.

تفاصيل المحرك

  • > يربط دعم R الملفات `.R` و`.Rmd` و`.Rnw` بلغة R. تُستخرج الدوال المُسندة إلى اسم تحت ذلك الاسم، وتبقى الأسماء المنقّطة مثل `data.frame` كاملة.
  • > يبقى توزيع S3 وS4 (`UseMethod` و`standardGeneric`) وعائلة apply و`lm` و`predict` و`tryCatch` في الرسم البياني عن قصد.
  • > يُستبعد من العلاقات نحو 800 اسم من R الأساسية و`stats` و`graphics`، مثل `print` و`paste` و`c`.

نقاط دخول مفيدة عبر MCP

  • find_symbol

    استخدمه لاسم دالة تنظيف أو نمذجة أو تابع S3 عندما تحتاج إلى التعريف والمستدعين.

  • dependency_search

    استخدم الاجتياز الوارد على دالة مساعدة لرؤية التحليلات التي تعتمد عليها قبل تغيير مخرجاتها.

  • get_task_context

    استخدمه لمطالبات مثل "تتبّع المسار من تحميل البيانات الخام إلى الانحدار النهائي".