Graphene: إطار تحليلات يجعل وكلاء البرمجة يعملون فوق بيانات الشركة وملفاتها
مشروع Graphene يقدّم تحليلات وواجهات بيانات «ككل شيء في ملفات برمجية»، ومصمم ليستخدمه وكلاء البرمجة في الإجابة عن أسئلة البيانات وبناء لوحات المعلومات. يجمع بين SQL وطبقة دلالية لتعريف المقاييس والعلاقات بين الجداول، مع صفحات Markdown قابلة للتحويل إلى تقارير ورسوم تفاعلية.
أبرز النقاط
- Graphene إطار تحليلات مبني كملفات برمجية ومصمم أساساً لوكلاء البرمجة.
- يضيف إلى SQL طبقة دلالية لتعريف المقاييس والعلاقات بين الجداول بصورة موحّدة.
- تُبنى لوحات المعلومات والتقارير في ملفات Markdown، مع رسوم وعناصر تصفية وتفاعلات قابلة للتخصيص.
- يعمل عبر CLI ويدعم Snowflake وBigQuery وClickHouse وPostgres وMotherDuck وDuckDB.
- يخضع المشروع لترخيص Elastic License 2.0؛ الاستخدام الداخلي مجاني، لكنه ليس ترخيصاً مفتوح المصدر بالمعنى التقليدي.
يراهن مشروع Graphene على نقل جزء أكبر من عمل تحليلات البيانات إلى بيئة التطوير نفسها: ملفات داخل المستودع، وواجهة سطر أوامر، ووكيل برمجي يستطيع فهم السياق المحيط بالبيانات والكود.
الفكرة ليست أن يكتب الوكيل استعلام SQL فحسب، بل أن يعمل ضمن إطار يعرّف مسبقاً معنى المقاييس المهمة والعلاقات بين الجداول، ثم يبني لوحات معلومات وتقارير متسقة اعتماداً على هذه التعريفات.
SQL مع تعريفات موحّدة للمقاييس
يعتمد Graphene على ما يسميه الطبقة الدلالية: طبقة تصف الجداول، وحقولها، والعلاقات بينها، والمقاييس الحسابية المعتمدة في الشركة. الهدف هو تقليل خطر أن يحسب كل تقرير المقياس نفسه بطريقة مختلفة.
في ملف بامتداد .gsql، يمكن تعريف مقياس مثل الإيرادات وعلاقة بين جدول الطلبات وجدول المستخدمين. بعد ذلك يستطيع الاستعلام استدعاء المقياس والتنقل عبر العلاقة المعرّفة، من دون إعادة كتابة منطق الربط والحساب في كل مرة.
select
users.name,
revenue
from orders
group by 1
order by 2 desc
تقول Graphene إن لغتها تبقى قريبة من SQL المعتاد، مع دعم عناصر مثل الاستعلامات الفرعية وCTE ودوال النوافذ وعمليات المجموعات، لكنها تضيف مفهومي المقاييس والربط المعرّف بين النماذج.
من الاستعلام إلى لوحة المعلومات
إلى جانب ملفات النمذجة، يستخدم الإطار ملفات Markdown لإنشاء الصفحات. يمكن أن تحتوي الصفحة على استعلامات ورسوم، مثل بطاقات الأرقام والمخططات الشريطية، إضافة إلى عناصر إدخال للتصفية وسلوكيات تفاعلية.
وتدعم الصفحات نمطين للاستخدام: لوحات موجهة للمراقبة، وصفحات سردية أقرب إلى دفاتر التحليل. كما يتيح Graphene استخدام HTML وCSS وJavaScript وECharts عندما تحتاج الواجهة إلى تخصيص أوسع.
لماذا يستهدف وكلاء البرمجة؟
صُمم المشروع ليُشغّل من خلال CLI، مع وضع التوثيق ضمن «مهارة» مخصصة للوكيل داخل حزمة npm. بعد إعداد المشروع وتشغيل خادم التطوير، يمكن توجيه الوكيل إلى الإجابة عن سؤال بيانات، أو بناء لوحة، أو تعديل نموذج البيانات.
يركز المشروع على أن وجود نماذج البيانات ولوحاتها قرب بقية الكود قد يمنح الوكيل سياقاً عملياً أوسع: فبدلاً من تحليل الأرقام في أداة منفصلة، يمكنه ربطها بخصائص المنتج أو التغييرات البرمجية أو المعرفة الموجودة في المستودع.
وتطرح Graphene أيضاً مزايا مألوفة في سير عمل التطوير، مثل التحكم بالإصدارات وCI والاختبارات؛ ما يتيح مراجعة التعديلات أو التراجع عنها، واختبار لوحات المعلومات المهمة قبل اعتمادها.
المصادر المدعومة والترخيص
يدعم Graphene حالياً Snowflake وBigQuery وClickHouse وPostgres وMotherDuck، إضافة إلى البيانات المحلية عبر DuckDB. ويمكن تثبيت أداته عبر npm أو مديري الحزم المتوافقين، فيما يمكن أن يكون المشروع مستودعاً مستقلاً أو مجلداً داخل قاعدة كود أكبر مثل dbt.
المشروع مجاني للاستخدامات الداخلية وفق ترخيص Elastic License 2.0. وتقول الشركة إنها تطور Graphene Cloud لاستضافة اللوحات والتقارير، إلى جانب خادم MCP وبوت Slack ضمن خدمتها المُدارة.
يبقى Graphene موجهاً، في صورته الحالية، إلى فرق مرتاحة للعمل مع Git ووكلاء البرمجة. لكنه يقدم تصوراً واضحاً لكيفية جعل التحليلات جزءاً قابلاً للمراجعة والاختبار من قاعدة الكود، بدلاً من بقائها محصورة في أداة ذكاء أعمال منفصلة.
لماذا يهم؟
قد يساعد هذا النهج الفرق على جعل تعريفات المقاييس ولوحات البيانات جزءاً من المستودع وسير عمل المراجعة والاختبار. بالنسبة لوكلاء البرمجة، تمنحهم النماذج المعرّفة مسبقاً سياقاً يقلل احتمال كتابة استعلامات أو حسابات غير متسقة.